changelog shortlog graph tags branches changeset files file revisions raw help

Mercurial > infra > etc / annotate dnsmasq.conf

changeset 1: 71488d7123d0
child: 0c85895d4e27
author: Richard Westhaver <ellis@rwest.io>
date: Sat, 27 Apr 2024 01:57:33 +0000
permissions: -rw-r--r--
description: bootstrap
1
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
1
 # Configuration file for dnsmasq.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
2
 #
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
3
 # Format is one option per line, legal options are the same
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
4
 # as the long options legal on the command line. See
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
5
 # "/usr/sbin/dnsmasq --help" or "man 8 dnsmasq" for details.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
6
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
7
 # Listen on this specific port instead of the standard DNS port
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
8
 # (53). Setting this to zero completely disables DNS function,
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
9
 # leaving only DHCP and/or TFTP.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
10
 #port=5353
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
11
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
12
 # The following two options make you a better netizen, since they
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
13
 # tell dnsmasq to filter out queries which the public DNS cannot
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
14
 # answer, and which load the servers (especially the root servers)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
15
 # unnecessarily. If you have a dial-on-demand link they also stop
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
16
 # these requests from bringing up the link unnecessarily.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
17
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
18
 # Never forward plain names (without a dot or domain part)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
19
 #domain-needed
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
20
 # Never forward addresses in the non-routed address spaces.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
21
 #bogus-priv
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
22
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
23
 # Uncomment these to enable DNSSEC validation and caching:
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
24
 # (Requires dnsmasq to be built with DNSSEC option.)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
25
 #conf-file=/usr/share/dnsmasq/trust-anchors.conf
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
26
 #dnssec
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
27
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
28
 # Replies which are not DNSSEC signed may be legitimate, because the domain
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
29
 # is unsigned, or may be forgeries. Setting this option tells dnsmasq to
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
30
 # check that an unsigned reply is OK, by finding a secure proof that a DS 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
31
 # record somewhere between the root and the domain does not exist. 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
32
 # The cost of setting this is that even queries in unsigned domains will need
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
33
 # one or more extra DNS queries to verify.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
34
 #dnssec-check-unsigned
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
35
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
36
 # Uncomment this to filter useless windows-originated DNS requests
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
37
 # which can trigger dial-on-demand links needlessly.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
38
 # Note that (amongst other things) this blocks all SRV requests,
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
39
 # so don't use it if you use eg Kerberos, SIP, XMMP or Google-talk.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
40
 # This option only affects forwarding, SRV records originating for
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
41
 # dnsmasq (via srv-host= lines) are not suppressed by it.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
42
 #filterwin2k
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
43
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
44
 # Change this line if you want dns to get its upstream servers from
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
45
 # somewhere other that /etc/resolv.conf
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
46
 #resolv-file=
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
47
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
48
 # By  default,  dnsmasq  will  send queries to any of the upstream
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
49
 # servers it knows about and tries to favour servers to are  known
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
50
 # to  be  up.  Uncommenting this forces dnsmasq to try each query
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
51
 # with  each  server  strictly  in  the  order  they   appear   in
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
52
 # /etc/resolv.conf
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
53
 #strict-order
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
54
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
55
 # If you don't want dnsmasq to read /etc/resolv.conf or any other
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
56
 # file, getting its servers from this file instead (see below), then
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
57
 # uncomment this.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
58
 #no-resolv
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
59
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
60
 # If you don't want dnsmasq to poll /etc/resolv.conf or other resolv
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
61
 # files for changes and re-read them then uncomment this.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
62
 #no-poll
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
63
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
64
 # Add other name servers here, with domain specs if they are for
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
65
 # non-public domains.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
66
 #server=/localnet/192.168.0.1
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
67
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
68
 # Example of routing PTR queries to nameservers: this will send all
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
69
 # address->name queries for 192.168.3/24 to nameserver 10.1.2.3
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
70
 #server=/3.168.192.in-addr.arpa/10.1.2.3
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
71
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
72
 # Add local-only domains here, queries in these domains are answered
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
73
 # from /etc/hosts or DHCP only.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
74
 #local=/localnet/
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
75
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
76
 # Add domains which you want to force to an IP address here.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
77
 # The example below send any host in double-click.net to a local
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
78
 # web-server.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
79
 #address=/double-click.net/127.0.0.1
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
80
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
81
 # --address (and --server) work with IPv6 addresses too.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
82
 #address=/www.thekelleys.org.uk/fe80::20d:60ff:fe36:f83
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
83
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
84
 # Add the IPs of all queries to yahoo.com, google.com, and their
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
85
 # subdomains to the vpn and search ipsets:
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
86
 #ipset=/yahoo.com/google.com/vpn,search
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
87
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
88
 # Add the IPs of all queries to yahoo.com, google.com, and their
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
89
 # subdomains to netfilters sets, which is equivalent to
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
90
 # 'nft add element ip test vpn { ... }; nft add element ip test search { ... }'
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
91
 #nftset=/yahoo.com/google.com/ip#test#vpn,ip#test#search
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
92
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
93
 # Use netfilters sets for both IPv4 and IPv6:
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
94
 # This adds all addresses in *.yahoo.com to vpn4 and vpn6 for IPv4 and IPv6 addresses.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
95
 #nftset=/yahoo.com/4#ip#test#vpn4
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
96
 #nftset=/yahoo.com/6#ip#test#vpn6
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
97
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
98
 # You can control how dnsmasq talks to a server: this forces
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
99
 # queries to 10.1.2.3 to be routed via eth1
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
100
 # server=10.1.2.3@eth1
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
101
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
102
 # and this sets the source (ie local) address used to talk to
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
103
 # 10.1.2.3 to 192.168.1.1 port 55 (there must be an interface with that
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
104
 # IP on the machine, obviously).
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
105
 # server=10.1.2.3@192.168.1.1#55
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
106
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
107
 # If you want dnsmasq to change uid and gid to something other
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
108
 # than the default, edit the following lines.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
109
 #user=
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
110
 #group=
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
111
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
112
 # If you want dnsmasq to listen for DHCP and DNS requests only on
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
113
 # specified interfaces (and the loopback) give the name of the
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
114
 # interface (eg eth0) here.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
115
 # Repeat the line for more than one interface.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
116
 #interface=
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
117
 # Or you can specify which interface _not_ to listen on
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
118
 #except-interface=
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
119
 # Or which to listen on by address (remember to include 127.0.0.1 if
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
120
 # you use this.)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
121
 #listen-address=
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
122
 # If you want dnsmasq to provide only DNS service on an interface,
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
123
 # configure it as shown above, and then use the following line to
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
124
 # disable DHCP and TFTP on it.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
125
 #no-dhcp-interface=
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
126
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
127
 # On systems which support it, dnsmasq binds the wildcard address,
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
128
 # even when it is listening on only some interfaces. It then discards
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
129
 # requests that it shouldn't reply to. This has the advantage of
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
130
 # working even when interfaces come and go and change address. If you
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
131
 # want dnsmasq to really bind only the interfaces it is listening on,
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
132
 # uncomment this option. About the only time you may need this is when
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
133
 # running another nameserver on the same machine.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
134
 #bind-interfaces
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
135
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
136
 # If you don't want dnsmasq to read /etc/hosts, uncomment the
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
137
 # following line.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
138
 #no-hosts
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
139
 # or if you want it to read another file, as well as /etc/hosts, use
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
140
 # this.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
141
 #addn-hosts=/etc/banner_add_hosts
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
142
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
143
 # Set this (and domain: see below) if you want to have a domain
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
144
 # automatically added to simple names in a hosts-file.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
145
 #expand-hosts
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
146
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
147
 # Set the domain for dnsmasq. this is optional, but if it is set, it
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
148
 # does the following things.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
149
 # 1) Allows DHCP hosts to have fully qualified domain names, as long
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
150
 #     as the domain part matches this setting.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
151
 # 2) Sets the "domain" DHCP option thereby potentially setting the
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
152
 #    domain of all systems configured by DHCP
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
153
 # 3) Provides the domain part for "expand-hosts"
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
154
 #domain=thekelleys.org.uk
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
155
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
156
 # Set a different domain for a particular subnet
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
157
 #domain=wireless.thekelleys.org.uk,192.168.2.0/24
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
158
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
159
 # Same idea, but range rather then subnet
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
160
 #domain=reserved.thekelleys.org.uk,192.68.3.100,192.168.3.200
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
161
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
162
 # Uncomment this to enable the integrated DHCP server, you need
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
163
 # to supply the range of addresses available for lease and optionally
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
164
 # a lease time. If you have more than one network, you will need to
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
165
 # repeat this for each network on which you want to supply DHCP
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
166
 # service.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
167
 #dhcp-range=192.168.0.50,192.168.0.150,12h
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
168
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
169
 # This is an example of a DHCP range where the netmask is given. This
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
170
 # is needed for networks we reach the dnsmasq DHCP server via a relay
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
171
 # agent. If you don't know what a DHCP relay agent is, you probably
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
172
 # don't need to worry about this.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
173
 #dhcp-range=192.168.0.50,192.168.0.150,255.255.255.0,12h
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
174
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
175
 # This is an example of a DHCP range which sets a tag, so that
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
176
 # some DHCP options may be set only for this network.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
177
 #dhcp-range=set:red,192.168.0.50,192.168.0.150
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
178
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
179
 # Use this DHCP range only when the tag "green" is set.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
180
 #dhcp-range=tag:green,192.168.0.50,192.168.0.150,12h
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
181
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
182
 # Specify a subnet which can't be used for dynamic address allocation,
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
183
 # is available for hosts with matching --dhcp-host lines. Note that
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
184
 # dhcp-host declarations will be ignored unless there is a dhcp-range
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
185
 # of some type for the subnet in question.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
186
 # In this case the netmask is implied (it comes from the network
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
187
 # configuration on the machine running dnsmasq) it is possible to give
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
188
 # an explicit netmask instead.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
189
 #dhcp-range=192.168.0.0,static
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
190
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
191
 # Enable DHCPv6. Note that the prefix-length does not need to be specified
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
192
 # and defaults to 64 if missing/
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
193
 #dhcp-range=1234::2, 1234::500, 64, 12h
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
194
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
195
 # Do Router Advertisements, BUT NOT DHCP for this subnet.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
196
 #dhcp-range=1234::, ra-only 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
197
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
198
 # Do Router Advertisements, BUT NOT DHCP for this subnet, also try and
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
199
 # add names to the DNS for the IPv6 address of SLAAC-configured dual-stack 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
200
 # hosts. Use the DHCPv4 lease to derive the name, network segment and 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
201
 # MAC address and assume that the host will also have an
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
202
 # IPv6 address calculated using the SLAAC algorithm.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
203
 #dhcp-range=1234::, ra-names
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
204
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
205
 # Do Router Advertisements, BUT NOT DHCP for this subnet.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
206
 # Set the lifetime to 46 hours. (Note: minimum lifetime is 2 hours.)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
207
 #dhcp-range=1234::, ra-only, 48h
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
208
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
209
 # Do DHCP and Router Advertisements for this subnet. Set the A bit in the RA
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
210
 # so that clients can use SLAAC addresses as well as DHCP ones.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
211
 #dhcp-range=1234::2, 1234::500, slaac
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
212
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
213
 # Do Router Advertisements and stateless DHCP for this subnet. Clients will
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
214
 # not get addresses from DHCP, but they will get other configuration information.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
215
 # They will use SLAAC for addresses.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
216
 #dhcp-range=1234::, ra-stateless
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
217
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
218
 # Do stateless DHCP, SLAAC, and generate DNS names for SLAAC addresses
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
219
 # from DHCPv4 leases.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
220
 #dhcp-range=1234::, ra-stateless, ra-names
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
221
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
222
 # Do router advertisements for all subnets where we're doing DHCPv6
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
223
 # Unless overridden by ra-stateless, ra-names, et al, the router 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
224
 # advertisements will have the M and O bits set, so that the clients
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
225
 # get addresses and configuration from DHCPv6, and the A bit reset, so the 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
226
 # clients don't use SLAAC addresses.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
227
 #enable-ra
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
228
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
229
 # Supply parameters for specified hosts using DHCP. There are lots
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
230
 # of valid alternatives, so we will give examples of each. Note that
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
231
 # IP addresses DO NOT have to be in the range given above, they just
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
232
 # need to be on the same network. The order of the parameters in these
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
233
 # do not matter, it's permissible to give name, address and MAC in any
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
234
 # order.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
235
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
236
 # Always allocate the host with Ethernet address 11:22:33:44:55:66
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
237
 # The IP address 192.168.0.60
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
238
 #dhcp-host=11:22:33:44:55:66,192.168.0.60
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
239
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
240
 # Always set the name of the host with hardware address
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
241
 # 11:22:33:44:55:66 to be "fred"
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
242
 #dhcp-host=11:22:33:44:55:66,fred
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
243
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
244
 # Always give the host with Ethernet address 11:22:33:44:55:66
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
245
 # the name fred and IP address 192.168.0.60 and lease time 45 minutes
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
246
 #dhcp-host=11:22:33:44:55:66,fred,192.168.0.60,45m
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
247
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
248
 # Give a host with Ethernet address 11:22:33:44:55:66 or
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
249
 # 12:34:56:78:90:12 the IP address 192.168.0.60. Dnsmasq will assume
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
250
 # that these two Ethernet interfaces will never be in use at the same
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
251
 # time, and give the IP address to the second, even if it is already
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
252
 # in use by the first. Useful for laptops with wired and wireless
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
253
 # addresses.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
254
 #dhcp-host=11:22:33:44:55:66,12:34:56:78:90:12,192.168.0.60
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
255
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
256
 # Give the machine which says its name is "bert" IP address
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
257
 # 192.168.0.70 and an infinite lease
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
258
 #dhcp-host=bert,192.168.0.70,infinite
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
259
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
260
 # Always give the host with client identifier 01:02:02:04
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
261
 # the IP address 192.168.0.60
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
262
 #dhcp-host=id:01:02:02:04,192.168.0.60
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
263
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
264
 # Always give the InfiniBand interface with hardware address
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
265
 # 80:00:00:48:fe:80:00:00:00:00:00:00:f4:52:14:03:00:28:05:81 the
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
266
 # ip address 192.168.0.61. The client id is derived from the prefix
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
267
 # ff:00:00:00:00:00:02:00:00:02:c9:00 and the last 8 pairs of
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
268
 # hex digits of the hardware address.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
269
 #dhcp-host=id:ff:00:00:00:00:00:02:00:00:02:c9:00:f4:52:14:03:00:28:05:81,192.168.0.61
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
270
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
271
 # Always give the host with client identifier "marjorie"
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
272
 # the IP address 192.168.0.60
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
273
 #dhcp-host=id:marjorie,192.168.0.60
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
274
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
275
 # Enable the address given for "judge" in /etc/hosts
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
276
 # to be given to a machine presenting the name "judge" when
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
277
 # it asks for a DHCP lease.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
278
 #dhcp-host=judge
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
279
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
280
 # Never offer DHCP service to a machine whose Ethernet
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
281
 # address is 11:22:33:44:55:66
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
282
 #dhcp-host=11:22:33:44:55:66,ignore
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
283
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
284
 # Ignore any client-id presented by the machine with Ethernet
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
285
 # address 11:22:33:44:55:66. This is useful to prevent a machine
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
286
 # being treated differently when running under different OS's or
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
287
 # between PXE boot and OS boot.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
288
 #dhcp-host=11:22:33:44:55:66,id:*
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
289
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
290
 # Send extra options which are tagged as "red" to
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
291
 # the machine with Ethernet address 11:22:33:44:55:66
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
292
 #dhcp-host=11:22:33:44:55:66,set:red
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
293
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
294
 # Send extra options which are tagged as "red" to
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
295
 # any machine with Ethernet address starting 11:22:33:
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
296
 #dhcp-host=11:22:33:*:*:*,set:red
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
297
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
298
 # Give a fixed IPv6 address and name to client with 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
299
 # DUID 00:01:00:01:16:d2:83:fc:92:d4:19:e2:d8:b2
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
300
 # Note the MAC addresses CANNOT be used to identify DHCPv6 clients.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
301
 # Note also that the [] around the IPv6 address are obligatory.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
302
 #dhcp-host=id:00:01:00:01:16:d2:83:fc:92:d4:19:e2:d8:b2, fred, [1234::5] 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
303
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
304
 # Ignore any clients which are not specified in dhcp-host lines
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
305
 # or /etc/ethers. Equivalent to ISC "deny unknown-clients".
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
306
 # This relies on the special "known" tag which is set when
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
307
 # a host is matched.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
308
 #dhcp-ignore=tag:!known
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
309
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
310
 # Send extra options which are tagged as "red" to any machine whose
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
311
 # DHCP vendorclass string includes the substring "Linux"
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
312
 #dhcp-vendorclass=set:red,Linux
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
313
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
314
 # Send extra options which are tagged as "red" to any machine one
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
315
 # of whose DHCP userclass strings includes the substring "accounts"
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
316
 #dhcp-userclass=set:red,accounts
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
317
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
318
 # Send extra options which are tagged as "red" to any machine whose
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
319
 # MAC address matches the pattern.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
320
 #dhcp-mac=set:red,00:60:8C:*:*:*
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
321
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
322
 # If this line is uncommented, dnsmasq will read /etc/ethers and act
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
323
 # on the ethernet-address/IP pairs found there just as if they had
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
324
 # been given as --dhcp-host options. Useful if you keep
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
325
 # MAC-address/host mappings there for other purposes.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
326
 #read-ethers
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
327
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
328
 # Send options to hosts which ask for a DHCP lease.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
329
 # See RFC 2132 for details of available options.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
330
 # Common options can be given to dnsmasq by name:
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
331
 # run "dnsmasq --help dhcp" to get a list.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
332
 # Note that all the common settings, such as netmask and
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
333
 # broadcast address, DNS server and default route, are given
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
334
 # sane defaults by dnsmasq. You very likely will not need
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
335
 # any dhcp-options. If you use Windows clients and Samba, there
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
336
 # are some options which are recommended, they are detailed at the
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
337
 # end of this section.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
338
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
339
 # Override the default route supplied by dnsmasq, which assumes the
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
340
 # router is the same machine as the one running dnsmasq.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
341
 #dhcp-option=3,1.2.3.4
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
342
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
343
 # Do the same thing, but using the option name
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
344
 #dhcp-option=option:router,1.2.3.4
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
345
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
346
 # Override the default route supplied by dnsmasq and send no default
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
347
 # route at all. Note that this only works for the options sent by
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
348
 # default (1, 3, 6, 12, 28) the same line will send a zero-length option
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
349
 # for all other option numbers.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
350
 #dhcp-option=3
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
351
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
352
 # Set the NTP time server addresses to 192.168.0.4 and 10.10.0.5
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
353
 #dhcp-option=option:ntp-server,192.168.0.4,10.10.0.5
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
354
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
355
 # Send DHCPv6 option. Note [] around IPv6 addresses.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
356
 #dhcp-option=option6:dns-server,[1234::77],[1234::88]
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
357
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
358
 # Send DHCPv6 option for namservers as the machine running 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
359
 # dnsmasq and another.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
360
 #dhcp-option=option6:dns-server,[::],[1234::88]
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
361
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
362
 # Ask client to poll for option changes every six hours. (RFC4242)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
363
 #dhcp-option=option6:information-refresh-time,6h
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
364
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
365
 # Set option 58 client renewal time (T1). Defaults to half of the
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
366
 # lease time if not specified. (RFC2132)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
367
 #dhcp-option=option:T1,1m
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
368
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
369
 # Set option 59 rebinding time (T2). Defaults to 7/8 of the
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
370
 # lease time if not specified. (RFC2132)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
371
 #dhcp-option=option:T2,2m
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
372
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
373
 # Set the NTP time server address to be the same machine as
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
374
 # is running dnsmasq
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
375
 #dhcp-option=42,0.0.0.0
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
376
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
377
 # Set the NIS domain name to "welly"
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
378
 #dhcp-option=40,welly
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
379
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
380
 # Set the default time-to-live to 50
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
381
 #dhcp-option=23,50
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
382
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
383
 # Set the "all subnets are local" flag
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
384
 #dhcp-option=27,1
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
385
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
386
 # Send the etherboot magic flag and then etherboot options (a string).
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
387
 #dhcp-option=128,e4:45:74:68:00:00
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
388
 #dhcp-option=129,NIC=eepro100
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
389
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
390
 # Specify an option which will only be sent to the "red" network
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
391
 # (see dhcp-range for the declaration of the "red" network)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
392
 # Note that the tag: part must precede the option: part.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
393
 #dhcp-option = tag:red, option:ntp-server, 192.168.1.1
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
394
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
395
 # The following DHCP options set up dnsmasq in the same way as is specified
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
396
 # for the ISC dhcpcd in
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
397
 # https://web.archive.org/web/20040313070105/http://us1.samba.org/samba/ftp/docs/textdocs/DHCP-Server-Configuration.txt
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
398
 # adapted for a typical dnsmasq installation where the host running
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
399
 # dnsmasq is also the host running samba.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
400
 # you may want to uncomment some or all of them if you use
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
401
 # Windows clients and Samba.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
402
 #dhcp-option=19,0           # option ip-forwarding off
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
403
 #dhcp-option=44,0.0.0.0     # set netbios-over-TCP/IP nameserver(s) aka WINS server(s)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
404
 #dhcp-option=45,0.0.0.0     # netbios datagram distribution server
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
405
 #dhcp-option=46,8           # netbios node type
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
406
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
407
 # Send an empty WPAD option. This may be REQUIRED to get windows 7 to behave.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
408
 #dhcp-option=252,"\n"
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
409
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
410
 # Send RFC-3397 DNS domain search DHCP option. WARNING: Your DHCP client
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
411
 # probably doesn't support this......
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
412
 #dhcp-option=option:domain-search,eng.apple.com,marketing.apple.com
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
413
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
414
 # Send RFC-3442 classless static routes (note the netmask encoding)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
415
 #dhcp-option=121,192.168.1.0/24,1.2.3.4,10.0.0.0/8,5.6.7.8
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
416
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
417
 # Send vendor-class specific options encapsulated in DHCP option 43.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
418
 # The meaning of the options is defined by the vendor-class so
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
419
 # options are sent only when the client supplied vendor class
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
420
 # matches the class given here. (A substring match is OK, so "MSFT"
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
421
 # matches "MSFT" and "MSFT 5.0"). This example sets the
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
422
 # mtftp address to 0.0.0.0 for PXEClients.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
423
 #dhcp-option=vendor:PXEClient,1,0.0.0.0
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
424
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
425
 # Send microsoft-specific option to tell windows to release the DHCP lease
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
426
 # when it shuts down. Note the "i" flag, to tell dnsmasq to send the
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
427
 # value as a four-byte integer - that's what microsoft wants. See
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
428
 # http://technet2.microsoft.com/WindowsServer/en/library/a70f1bb7-d2d4-49f0-96d6-4b7414ecfaae1033.mspx?mfr=true
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
429
 #dhcp-option=vendor:MSFT,2,1i
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
430
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
431
 # Send the Encapsulated-vendor-class ID needed by some configurations of
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
432
 # Etherboot to allow is to recognise the DHCP server.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
433
 #dhcp-option=vendor:Etherboot,60,"Etherboot"
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
434
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
435
 # Send options to PXELinux. Note that we need to send the options even
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
436
 # though they don't appear in the parameter request list, so we need
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
437
 # to use dhcp-option-force here.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
438
 # See http://syslinux.zytor.com/pxe.php#special for details.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
439
 # Magic number - needed before anything else is recognised
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
440
 #dhcp-option-force=208,f1:00:74:7e
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
441
 # Configuration file name
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
442
 #dhcp-option-force=209,configs/common
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
443
 # Path prefix
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
444
 #dhcp-option-force=210,/tftpboot/pxelinux/files/
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
445
 # Reboot time. (Note 'i' to send 32-bit value)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
446
 #dhcp-option-force=211,30i
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
447
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
448
 # Set the boot filename for netboot/PXE. You will only need
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
449
 # this if you want to boot machines over the network and you will need
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
450
 # a TFTP server; either dnsmasq's built-in TFTP server or an
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
451
 # external one. (See below for how to enable the TFTP server.)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
452
 #dhcp-boot=pxelinux.0
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
453
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
454
 # The same as above, but use custom tftp-server instead machine running dnsmasq
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
455
 #dhcp-boot=pxelinux,server.name,192.168.1.100
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
456
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
457
 # Boot for iPXE. The idea is to send two different
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
458
 # filenames, the first loads iPXE, and the second tells iPXE what to
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
459
 # load. The dhcp-match sets the ipxe tag for requests from iPXE.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
460
 #dhcp-boot=undionly.kpxe
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
461
 #dhcp-match=set:ipxe,175 # iPXE sends a 175 option.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
462
 #dhcp-boot=tag:ipxe,http://boot.ipxe.org/demo/boot.php
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
463
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
464
 # Encapsulated options for iPXE. All the options are
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
465
 # encapsulated within option 175
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
466
 #dhcp-option=encap:175, 1, 5b         # priority code
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
467
 #dhcp-option=encap:175, 176, 1b       # no-proxydhcp
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
468
 #dhcp-option=encap:175, 177, string   # bus-id
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
469
 #dhcp-option=encap:175, 189, 1b       # BIOS drive code
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
470
 #dhcp-option=encap:175, 190, user     # iSCSI username
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
471
 #dhcp-option=encap:175, 191, pass     # iSCSI password
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
472
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
473
 # Test for the architecture of a netboot client. PXE clients are
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
474
 # supposed to send their architecture as option 93. (See RFC 4578)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
475
 #dhcp-match=peecees, option:client-arch, 0 #x86-32
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
476
 #dhcp-match=itanics, option:client-arch, 2 #IA64
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
477
 #dhcp-match=hammers, option:client-arch, 6 #x86-64
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
478
 #dhcp-match=mactels, option:client-arch, 7 #EFI x86-64
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
479
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
480
 # Do real PXE, rather than just booting a single file, this is an
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
481
 # alternative to dhcp-boot.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
482
 #pxe-prompt="What system shall I netboot?"
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
483
 # or with timeout before first available action is taken:
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
484
 #pxe-prompt="Press F8 for menu.", 60
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
485
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
486
 # Available boot services. for PXE.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
487
 #pxe-service=x86PC, "Boot from local disk"
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
488
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
489
 # Loads <tftp-root>/pxelinux.0 from dnsmasq TFTP server.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
490
 #pxe-service=x86PC, "Install Linux", pxelinux
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
491
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
492
 # Loads <tftp-root>/pxelinux.0 from TFTP server at 1.2.3.4.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
493
 # Beware this fails on old PXE ROMS.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
494
 #pxe-service=x86PC, "Install Linux", pxelinux, 1.2.3.4
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
495
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
496
 # Use bootserver on network, found my multicast or broadcast.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
497
 #pxe-service=x86PC, "Install windows from RIS server", 1
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
498
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
499
 # Use bootserver at a known IP address.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
500
 #pxe-service=x86PC, "Install windows from RIS server", 1, 1.2.3.4
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
501
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
502
 # If you have multicast-FTP available,
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
503
 # information for that can be passed in a similar way using options 1
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
504
 # to 5. See page 19 of
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
505
 # http://download.intel.com/design/archives/wfm/downloads/pxespec.pdf
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
506
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
507
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
508
 # Enable dnsmasq's built-in TFTP server
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
509
 #enable-tftp
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
510
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
511
 # Set the root directory for files available via FTP.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
512
 #tftp-root=/var/ftpd
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
513
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
514
 # Do not abort if the tftp-root is unavailable
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
515
 #tftp-no-fail
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
516
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
517
 # Make the TFTP server more secure: with this set, only files owned by
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
518
 # the user dnsmasq is running as will be send over the net.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
519
 #tftp-secure
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
520
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
521
 # This option stops dnsmasq from negotiating a larger blocksize for TFTP
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
522
 # transfers. It will slow things down, but may rescue some broken TFTP
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
523
 # clients.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
524
 #tftp-no-blocksize
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
525
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
526
 # Set the boot file name only when the "red" tag is set.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
527
 #dhcp-boot=tag:red,pxelinux.red-net
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
528
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
529
 # An example of dhcp-boot with an external TFTP server: the name and IP
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
530
 # address of the server are given after the filename.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
531
 # Can fail with old PXE ROMS. Overridden by --pxe-service.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
532
 #dhcp-boot=/var/ftpd/pxelinux.0,boothost,192.168.0.3
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
533
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
534
 # If there are multiple external tftp servers having a same name
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
535
 # (using /etc/hosts) then that name can be specified as the
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
536
 # tftp_servername (the third option to dhcp-boot) and in that
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
537
 # case dnsmasq resolves this name and returns the resultant IP
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
538
 # addresses in round robin fashion. This facility can be used to
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
539
 # load balance the tftp load among a set of servers.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
540
 #dhcp-boot=/var/ftpd/pxelinux.0,boothost,tftp_server_name
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
541
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
542
 # Set the limit on DHCP leases, the default is 150
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
543
 #dhcp-lease-max=150
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
544
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
545
 # The DHCP server needs somewhere on disk to keep its lease database.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
546
 # This defaults to a sane location, but if you want to change it, use
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
547
 # the line below.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
548
 #dhcp-leasefile=/var/lib/misc/dnsmasq.leases
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
549
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
550
 # Set the DHCP server to authoritative mode. In this mode it will barge in
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
551
 # and take over the lease for any client which broadcasts on the network,
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
552
 # whether it has a record of the lease or not. This avoids long timeouts
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
553
 # when a machine wakes up on a new network. DO NOT enable this if there's
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
554
 # the slightest chance that you might end up accidentally configuring a DHCP
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
555
 # server for your campus/company accidentally. The ISC server uses
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
556
 # the same option, and this URL provides more information:
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
557
 # http://www.isc.org/files/auth.html
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
558
 #dhcp-authoritative
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
559
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
560
 # Set the DHCP server to enable DHCPv4 Rapid Commit Option per RFC 4039.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
561
 # In this mode it will respond to a DHCPDISCOVER message including a Rapid Commit
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
562
 # option with a DHCPACK including a Rapid Commit option and fully committed address
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
563
 # and configuration information. This must only be enabled if either the server is 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
564
 # the only server for the subnet, or multiple servers are present and they each
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
565
 # commit a binding for all clients.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
566
 #dhcp-rapid-commit
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
567
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
568
 # Run an executable when a DHCP lease is created or destroyed.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
569
 # The arguments sent to the script are "add" or "del",
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
570
 # then the MAC address, the IP address and finally the hostname
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
571
 # if there is one.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
572
 #dhcp-script=/bin/echo
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
573
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
574
 # Set the cachesize here.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
575
 #cache-size=150
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
576
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
577
 # If you want to disable negative caching, uncomment this.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
578
 #no-negcache
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
579
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
580
 # Normally responses which come from /etc/hosts and the DHCP lease
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
581
 # file have Time-To-Live set as zero, which conventionally means
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
582
 # do not cache further. If you are happy to trade lower load on the
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
583
 # server for potentially stale date, you can set a time-to-live (in
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
584
 # seconds) here.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
585
 #local-ttl=
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
586
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
587
 # If you want dnsmasq to detect attempts by Verisign to send queries
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
588
 # to unregistered .com and .net hosts to its sitefinder service and
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
589
 # have dnsmasq instead return the correct NXDOMAIN response, uncomment
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
590
 # this line. You can add similar lines to do the same for other
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
591
 # registries which have implemented wildcard A records.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
592
 #bogus-nxdomain=64.94.110.11
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
593
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
594
 # If you want to fix up DNS results from upstream servers, use the
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
595
 # alias option. This only works for IPv4.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
596
 # This alias makes a result of 1.2.3.4 appear as 5.6.7.8
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
597
 #alias=1.2.3.4,5.6.7.8
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
598
 # and this maps 1.2.3.x to 5.6.7.x
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
599
 #alias=1.2.3.0,5.6.7.0,255.255.255.0
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
600
 # and this maps 192.168.0.10->192.168.0.40 to 10.0.0.10->10.0.0.40
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
601
 #alias=192.168.0.10-192.168.0.40,10.0.0.0,255.255.255.0
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
602
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
603
 # Change these lines if you want dnsmasq to serve MX records.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
604
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
605
 # Return an MX record named "maildomain.com" with target
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
606
 # servermachine.com and preference 50
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
607
 #mx-host=maildomain.com,servermachine.com,50
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
608
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
609
 # Set the default target for MX records created using the localmx option.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
610
 #mx-target=servermachine.com
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
611
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
612
 # Return an MX record pointing to the mx-target for all local
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
613
 # machines.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
614
 #localmx
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
615
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
616
 # Return an MX record pointing to itself for all local machines.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
617
 #selfmx
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
618
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
619
 # Change the following lines if you want dnsmasq to serve SRV
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
620
 # records.  These are useful if you want to serve ldap requests for
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
621
 # Active Directory and other windows-originated DNS requests.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
622
 # See RFC 2782.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
623
 # You may add multiple srv-host lines.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
624
 # The fields are <name>,<target>,<port>,<priority>,<weight>
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
625
 # If the domain part if missing from the name (so that is just has the
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
626
 # service and protocol sections) then the domain given by the domain=
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
627
 # config option is used. (Note that expand-hosts does not need to be
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
628
 # set for this to work.)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
629
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
630
 # A SRV record sending LDAP for the example.com domain to
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
631
 # ldapserver.example.com port 389
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
632
 #srv-host=_ldap._tcp.example.com,ldapserver.example.com,389
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
633
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
634
 # A SRV record sending LDAP for the example.com domain to
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
635
 # ldapserver.example.com port 389 (using domain=)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
636
 #domain=example.com
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
637
 #srv-host=_ldap._tcp,ldapserver.example.com,389
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
638
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
639
 # Two SRV records for LDAP, each with different priorities
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
640
 #srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,1
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
641
 #srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,2
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
642
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
643
 # A SRV record indicating that there is no LDAP server for the domain
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
644
 # example.com
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
645
 #srv-host=_ldap._tcp.example.com
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
646
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
647
 # The following line shows how to make dnsmasq serve an arbitrary PTR
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
648
 # record. This is useful for DNS-SD. (Note that the
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
649
 # domain-name expansion done for SRV records _does_not
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
650
 # occur for PTR records.)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
651
 #ptr-record=_http._tcp.dns-sd-services,"New Employee Page._http._tcp.dns-sd-services"
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
652
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
653
 # Change the following lines to enable dnsmasq to serve TXT records.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
654
 # These are used for things like SPF and zeroconf. (Note that the
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
655
 # domain-name expansion done for SRV records _does_not
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
656
 # occur for TXT records.)
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
657
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
658
 #Example SPF.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
659
 #txt-record=example.com,"v=spf1 a -all"
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
660
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
661
 #Example zeroconf
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
662
 #txt-record=_http._tcp.example.com,name=value,paper=A4
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
663
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
664
 # Provide an alias for a "local" DNS name. Note that this _only_ works
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
665
 # for targets which are names from DHCP or /etc/hosts. Give host
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
666
 # "bert" another name, bertrand
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
667
 #cname=bertrand,bert
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
668
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
669
 # For debugging purposes, log each DNS query as it passes through
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
670
 # dnsmasq.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
671
 #log-queries
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
672
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
673
 # Log lots of extra information about DHCP transactions.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
674
 #log-dhcp
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
675
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
676
 # Include another lot of configuration options.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
677
 #conf-file=/etc/dnsmasq.more.conf
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
678
 #conf-dir=/etc/dnsmasq.d
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
679
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
680
 # Include all the files in a directory except those ending in .bak
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
681
 #conf-dir=/etc/dnsmasq.d,.bak
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
682
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
683
 # Include all files in a directory which end in .conf
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
684
 #conf-dir=/etc/dnsmasq.d/,*.conf
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
685
 
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
686
 # If a DHCP client claims that its name is "wpad", ignore that.
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
687
 # This fixes a security hole. see CERT Vulnerability VU#598349
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
688
 #dhcp-name-match=set:wpad-ignore,wpad
71488d7123d0 bootstrap
Richard Westhaver <ellis@rwest.io>
parents:
diff changeset
689
 #dhcp-ignore-names=tag:wpad-ignore