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