]>
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 | ||
c1bb8504 | 7 | # The following two options make you a better netizen, since they |
9e4abcb5 SK |
8 | # tell dnsmasq to filter out queries which the public DNS cannot |
9 | # answer, and which load the servers (especially the root servers) | |
10 | # uneccessarily. If you have a dial-on-demand link they also stop | |
11 | # these requests from bringing up the link uneccessarily. | |
12 | ||
3d8df260 | 13 | # Never forward plain names (without a dot or domain part) |
9e4abcb5 | 14 | domain-needed |
c1bb8504 | 15 | # Never forward addresses in the non-routed address spaces. |
9e4abcb5 | 16 | bogus-priv |
9e4abcb5 SK |
17 | |
18 | ||
c1bb8504 SK |
19 | # Uncomment this to filter useless windows-originated DNS requests |
20 | # which can trigger dial-on-demand links needlessly. | |
21 | # Note that (amongst other things) this blocks all SRV requests, | |
22 | # so don't use it if you use eg Kerberos. | |
f6b7dc47 SK |
23 | # This option only affects forwarding, SRV records originating for |
24 | # dnsmasq (via srv-host= lines) are not suppressed by it. | |
c1bb8504 SK |
25 | #filterwin2k |
26 | ||
9e4abcb5 SK |
27 | # Change this line if you want dns to get its upstream servers from |
28 | # somewhere other that /etc/resolv.conf | |
29 | #resolv-file= | |
30 | ||
1ab84e2f SK |
31 | # By default, dnsmasq will send queries to any of the upstream |
32 | # servers it knows about and tries to favour servers to are known | |
33 | # to be up. Uncommenting this forces dnsmasq to try each query | |
34 | # with each server strictly in the order they appear in | |
35 | # /etc/resolv.conf | |
36 | #strict-order | |
37 | ||
9e4abcb5 SK |
38 | # If you don't want dnsmasq to read /etc/resolv.conf or any other |
39 | # file, getting its servers for this file instead (see below), then | |
40 | # uncomment this | |
41 | #no-resolv | |
42 | ||
43 | # If you don't want dnsmasq to poll /etc/resolv.conf or other resolv | |
44 | # files for changes and re-read them then uncomment this. | |
45 | #no-poll | |
46 | ||
47 | # Add other name servers here, with domain specs if they are for | |
48 | # non-public domains. | |
49 | #server=/localnet/192.168.0.1 | |
50 | ||
51 | # Add local-only domains here, queries in these domains are answered | |
52 | # from /etc/hosts or DHCP only. | |
53 | #local=/localnet/ | |
54 | ||
55 | # Add domains which you want to force to an IP address here. | |
56 | # The example below send any host in doubleclick.net to a local | |
57 | # webserver. | |
58 | #address=/doubleclick.net/127.0.0.1 | |
59 | ||
f6b7dc47 SK |
60 | # If you want dnsmasq to change uid and gid to something other |
61 | # than the default, edit the following lines. | |
9e4abcb5 SK |
62 | #user= |
63 | #group= | |
64 | ||
3d8df260 SK |
65 | # If you want dnsmasq to listen for DHCP and DNS requests only on |
66 | # specified interfaces (and the loopback) give the name of the | |
67 | # interface (eg eth0) here. | |
9e4abcb5 SK |
68 | # Repeat the line for more than one interface. |
69 | #interface= | |
70 | # Or you can specify which interface _not_ to listen on | |
71 | #except-interface= | |
72 | # Or which to listen on by address (remember to include 127.0.0.1 if | |
73 | # you use this.) | |
74 | #listen-address= | |
3d8df260 SK |
75 | # If you want dnsmasq to provide only DNS service on an interface, |
76 | # configure it as shown above, and then use the following line to | |
77 | # disable DHCP on it. | |
78 | #no-dhcp-interface= | |
9e4abcb5 | 79 | |
44a2a316 SK |
80 | # On systems which support it, dnsmasq binds the wildcard address, |
81 | # even when it is listening on only some interfaces. It then discards | |
82 | # requests that it shouldn't reply to. This has the advantage of | |
83 | # working even when interfaces come and go and change address. If you | |
84 | # want dnsmasq to really bind only the interfaces it is listening on, | |
85 | # uncomment this option. About the only time you may need this is when | |
86 | # running another nameserver on the same machine. | |
87 | #bind-interfaces | |
88 | ||
9e4abcb5 SK |
89 | # If you don't want dnsmasq to read /etc/hosts, uncomment the |
90 | # following line. | |
91 | #no-hosts | |
92 | # or if you want it to read another file, as well as /etc/hosts, use | |
93 | # this. | |
94 | #addn-hosts=/etc/banner_add_hosts | |
95 | ||
96 | # Set this (and domain: see below) if you want to have a domain | |
97 | # automatically added to simple names in a hosts-file. | |
98 | #expand-hosts | |
99 | ||
44a2a316 SK |
100 | # Set the domain for dnsmasq. this is optional, but if it is set, it |
101 | # does the following things. | |
102 | # 1) Allows DHCP hosts to have fully qualified domain names, as long | |
103 | # as the domain part matches this setting. | |
104 | # 2) Sets the "domain" DHCP option thereby potentially setting the | |
105 | # domain of all systems configured by DHCP | |
106 | # 3) Provides the domain part for "expand-hosts" | |
107 | #domain=thekelleys.org.uk | |
108 | ||
9e4abcb5 SK |
109 | # Uncomment this to enable the integrated DHCP server, you need |
110 | # to supply the range of addresses available for lease and optionally | |
44a2a316 SK |
111 | # a lease time. If you have more than one network, you will need to |
112 | # repeat this for each network on which you want to supply DHCP | |
9e4abcb5 SK |
113 | # service. |
114 | #dhcp-range=192.168.0.50,192.168.0.150,12h | |
115 | ||
44a2a316 SK |
116 | # This is an example of a DHCP range where the netmask is given. This |
117 | # is needed for networks we reach the dnsmasq DHCP server via a relay | |
118 | # agent. If you don't know what a DHCP relay agent is, you probably | |
119 | # don't need to worry about this. | |
120 | #dhcp-range=192.168.0.50,192.168.0.150,255.255.255.0,12h | |
121 | ||
122 | # This is an example of a DHCP range with a network-id, so that | |
123 | # some DHCP options may be set only for this network. | |
124 | #dhcp-range=red,192.168.0.50,192.168.0.150 | |
125 | ||
9e4abcb5 | 126 | # Supply parameters for specified hosts using DHCP. There are lots |
1ab84e2f | 127 | # of valid alternatives, so we will give examples of each. Note that |
9e4abcb5 | 128 | # IP addresses DO NOT have to be in the range given above, they just |
1ab84e2f SK |
129 | # need to be on the same network. The order of the parameters in these |
130 | # do not matter, it's permissble to give name,adddress and MAC in any order | |
9e4abcb5 SK |
131 | |
132 | # Always allocate the host with ethernet address 11:22:33:44:55:66 | |
133 | # The IP address 192.168.0.60 | |
134 | #dhcp-host=11:22:33:44:55:66,192.168.0.60 | |
135 | ||
136 | # Always set the name of the host with hardware address | |
137 | # 11:22:33:44:55:66 to be "fred" | |
138 | #dhcp-host=11:22:33:44:55:66,fred | |
139 | ||
140 | # Always give the host with ethernet address 11:22:33:44:55:66 | |
141 | # the name fred and IP address 192.168.0.60 and lease time 45 minutes | |
142 | #dhcp-host=11:22:33:44:55:66,fred,192.168.0.60,45m | |
143 | ||
144 | # Give the machine which says it's name is "bert" IP address | |
145 | # 192.168.0.70 and an infinite lease | |
146 | #dhcp-host=bert,192.168.0.70,infinite | |
147 | ||
148 | # Always give the host with client identifier 01:02:02:04 | |
149 | # the IP address 192.168.0.60 | |
150 | #dhcp-host=id:01:02:02:04,192.168.0.60 | |
151 | ||
152 | # Always give the host with client identifier "marjorie" | |
153 | # the IP address 192.168.0.60 | |
154 | #dhcp-host=id:marjorie,192.168.0.60 | |
155 | ||
1ab84e2f SK |
156 | # Enable the address given for "judge" in /etc/hosts |
157 | # to be given to a machine presenting the name "judge" when | |
158 | # it asks for a DHCP lease. | |
159 | #dhcp-host=judge | |
160 | ||
33820b7e SK |
161 | # Never offer DHCP service to a machine whose ethernet |
162 | # address is 11:22:33:44:55:66 | |
163 | #dhcp-host=11:22:33:44:55:66,ignore | |
164 | ||
a84fa1d0 SK |
165 | # Ignore any client-id presented by the machine with ethernet |
166 | # address 11:22:33:44:55:66. This is useful to prevent a machine | |
167 | # being treated differently when running under different OS's or | |
168 | # between PXE boot and OS boot. | |
169 | #dhcp-host=11:22:33:44:55:66,id:* | |
170 | ||
33820b7e SK |
171 | # Send extra options which are tagged as "red" to |
172 | # the machine with ethernet address 11:22:33:44:55:66 | |
173 | #dhcp-host=11:22:33:44:55:66,net:red | |
174 | ||
0a852541 SK |
175 | # Send extra options which are tagged as "red" to |
176 | # any machine with ethernet address starting 11:22:33: | |
177 | #dhcp-host=11:22:33:*:*:*,net:red | |
178 | ||
a222641c SK |
179 | # Send extra options which are tagged as "red" to any machine whose |
180 | # DHCP vendorclass string includes the substring "Linux" | |
181 | #dhcp-vendorclass=red,Linux | |
182 | ||
183 | # Send extra options which are tagged as "red" to any machine one | |
184 | # of whose DHCP userclass strings includes the substring "accounts" | |
185 | #dhcp-userclass=red,accounts | |
186 | ||
44a2a316 SK |
187 | # If this line is uncommented, dnsmasq will read /etc/ethers and act |
188 | # on the ethernet-address/IP pairs found there just as if they had | |
189 | # been given as --dhcp-host options. Useful if you keep | |
190 | # MAC-address/host mappings there for other purposes. | |
191 | #read-ethers | |
192 | ||
9e4abcb5 SK |
193 | # Send options to hosts which ask for a DHCP lease. |
194 | # See RFC 2132 for details of available options. | |
1ab84e2f SK |
195 | # Note that all the common settings, such as netmask and |
196 | # broadcast address, DNS server and default route, are given | |
197 | # sane defaults by dnsmasq. You very likely will not need any | |
198 | # any dhcp-options. If you use Windows clients and Samba, there | |
199 | # are some options which are recommended, they are detailed at the | |
200 | # end of this section. | |
201 | # For reference, the common options are: | |
202 | # subnet mask - 1 | |
203 | # default router - 3 | |
204 | # DNS server - 6 | |
205 | # broadcast address - 28 | |
9e4abcb5 SK |
206 | |
207 | # Set the NTP time server addresses to 192.168.0.4 and 10.10.0.5 | |
208 | #dhcp-option=42,192.168.0.4,10.10.0.5 | |
209 | ||
1ab84e2f SK |
210 | # Set the NTP time server address to be the same machine as |
211 | # is running dnsmasq | |
212 | #dhcp-option=42,0.0.0.0 | |
213 | ||
9e4abcb5 SK |
214 | # Set the NIS domain name to "welly" |
215 | #dhcp-option=40,welly | |
216 | ||
1ab84e2f SK |
217 | # Set the default time-to-live to 50 |
218 | #dhcp-option=23,50 | |
219 | ||
220 | # Set the "all subnets are local" flag | |
221 | #dhcp-option=27,1 | |
222 | ||
33820b7e SK |
223 | # Send the etherboot magic flag and then etherboot options (a string). |
224 | #dhcp-option=128,e4:45:74:68:00:00 | |
225 | #dhcp-option=129,NIC=eepro100 | |
226 | ||
44a2a316 SK |
227 | # Specify an option which will only be sent to the "red" network |
228 | # (see dhcp-range for the declaration of the "red" network) | |
229 | #dhcp-option=red,42,192.168.1.1 | |
230 | ||
1ab84e2f SK |
231 | # The following DHCP options set up dnsmasq in the same way as is specified |
232 | # for the ISC dhcpcd in | |
233 | # http://www.samba.org/samba/ftp/docs/textdocs/DHCP-Server-Configuration.txt | |
234 | # adapted for a typical dnsmasq installation where the host running | |
235 | # dnsmasq is also the host running samba. | |
236 | # you may want to uncomment them if you use Windows clients and Samba. | |
237 | #dhcp-option=19,0 # option ip-forwarding off | |
238 | #dhcp-option=44,0.0.0.0 # set netbios-over-TCP/IP nameserver(s) aka WINS server(s) | |
239 | #dhcp-option=45,0.0.0.0 # netbios datagram distribution server | |
240 | #dhcp-option=46,8 # netbios node type | |
241 | #dhcp-option=47 # empty netbios scope. | |
fd9fa481 SK |
242 | |
243 | # Send RFC-3397 DNS domain search DHCP option. WARNING: Your DHCP client | |
244 | # probably doesn't support this...... | |
245 | #dhcp-option=119,eng.apple.com,marketing.apple.com | |
1ab84e2f | 246 | |
91dccd09 SK |
247 | # Send encapsulated vendor-class specific options. The vendor-class |
248 | # is sent as DHCP option 60, and all the options marked with the | |
249 | # vendor class are send encapsulated in DHCP option 43. The meaning of | |
250 | # the options is defined by the vendor-class. This example sets the | |
251 | # mtftp address to 0.0.0.0 for PXEClients | |
252 | #dhcp-option=vendor:PXEClient,1,0.0.0.0 | |
253 | ||
9e4abcb5 SK |
254 | # Set the boot filename and tftpd server name and address |
255 | # for BOOTP. You will only need this is you want to | |
256 | # boot machines over the network. | |
257 | #dhcp-boot=/var/ftpd/pxelinux.0,boothost,192.168.0.3 | |
258 | ||
44a2a316 SK |
259 | # Set the limit on DHCP leases, the default is 150 |
260 | #dhcp-lease-max=150 | |
261 | ||
9e4abcb5 SK |
262 | # The DHCP server needs somewhere on disk to keep its lease database. |
263 | # This defaults to a sane location, but if you want to change it, use | |
264 | # the line below. | |
1ab84e2f | 265 | #dhcp-leasefile=/var/lib/misc/dnsmasq.leases |
9e4abcb5 | 266 | |
fd9fa481 SK |
267 | # Set the DHCP server to authoritative mode. In this mode it will barge in |
268 | # and take over the lease for any client which broadcasts on the network, | |
269 | # whether it has a record of the lease or not. This avoids long timeouts | |
270 | # when a machine wakes up on a new network. DO NOT enable this if there's | |
271 | # the slighest chance that you might end up accidentally configuring a DHCP | |
272 | # server for your campus/company accidentally. The ISC server uses the same | |
273 | # the same option, and this URL provides more information: | |
274 | # http://www.isc.org/index.pl?/sw/dhcp/authoritative.php | |
275 | #dhcp-authoritative | |
276 | ||
9e4abcb5 | 277 | # Set the cachesize here. |
1ab84e2f | 278 | #cache-size=150 |
9e4abcb5 SK |
279 | |
280 | # If you want to disable negative caching, uncomment this. | |
281 | #no-negcache | |
282 | ||
283 | # Normally responses which come form /etc/hosts and the DHCP lease | |
284 | # file have Time-To-Live set as zero, which conventionally means | |
285 | # do not cache further. If you are happy to trade lower load on the | |
286 | # server for potentially stale date, you can set a time-to-live (in | |
287 | # seconds) here. | |
288 | #local-ttl= | |
289 | ||
290 | # If you want dnsmasq to detect attempts by Verisign to send queries | |
291 | # to unregistered .com and .net hosts to its sitefinder service and | |
292 | # have dnsmasq instead return the correct NXDOMAIN response, uncomment | |
293 | # this line. You can add similar lines to do the same for other | |
294 | # registries which have implemented wildcard A records. | |
295 | #bogus-nxdomain=64.94.110.11 | |
296 | ||
1cff166d SK |
297 | # If you want to fix up DNS results from upstream servers, use the |
298 | # alias option. This only works for IPv4. | |
299 | # This alias makes a result of 1.2.3.4 appear as 5.6.7.8 | |
300 | #alias=1.2.3.4,5.6.7.8 | |
301 | # and this maps 1.2.3.x to 5.6.7.x | |
302 | #alias=1.2.3.0,5.6.7.0,255.255.255.0 | |
303 | ||
f6b7dc47 SK |
304 | |
305 | # Change these lines if you want dnsmasq to serve MX records. | |
306 | ||
307 | # Return an MX record named "maildomain.com" with target | |
308 | # servermachine.com and preference 50 | |
309 | #mx-host=maildomain.com,servermachine.com,50 | |
310 | ||
311 | # Set the default target for MX records created using the localmx option. | |
312 | #mx-target=servermachine.com | |
313 | ||
314 | # Return an MX record pointing to the mx-target for all local | |
315 | # machines. | |
316 | #localmx | |
317 | ||
318 | # Return an MX record pointing to itself for all local machines. | |
319 | #selfmx | |
320 | ||
321 | # Change the following lines if you want dnsmasq to serve SRV | |
322 | # records. These are useful if you want to serve ldap requests for | |
323 | # Active Directory and other windows-originated DNS requests. | |
324 | # See RFC 2782. | |
325 | # You may add multiple srv-host lines. | |
326 | # The fields are <name>,<target>,<port>,<priority>,<weight> | |
327 | # If the domain part if missing from the name (so that is just has the | |
328 | # service and protocol sections) then the domain given by the domain= | |
0a852541 SK |
329 | # config option is used. (Note that expand-hosts does not need to be |
330 | # set for this to work.) | |
f6b7dc47 SK |
331 | |
332 | # A SRV record sending LDAP for the example.com domain to | |
333 | # ldapserver.example.com port 289 | |
334 | #srv-host=_ldap._tcp.example.com,ldapserver.example.com,389 | |
335 | ||
336 | # A SRV record sending LDAP for the example.com domain to | |
337 | # ldapserver.example.com port 289 (using domain=) | |
338 | #domain=example.com | |
339 | #srv-host=_ldap._tcp,ldapserver.example.com,389 | |
340 | ||
341 | # Two SRV records for LDAP, each with different priorities | |
342 | #srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,1 | |
343 | #srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,2 | |
344 | ||
345 | # A SRV record indicating that there is no LDAP server for the domain | |
346 | # example.com | |
347 | #srv-host=_ldap._tcp.example.com | |
348 | ||
0a852541 SK |
349 | |
350 | # Change the following lines to enable dnsmasq to serve TXT records. | |
351 | # These are used for things like SPF and zeroconf. (Note that the | |
352 | # domain-name expansion done for SRV records _does_not | |
353 | # occur for TXT records.) | |
354 | ||
355 | #Example SPF. | |
356 | #txt-record=example.com,v=spf1 a -all | |
357 | ||
358 | #Example zeroconf | |
359 | #txt-record=_http._tcp.example.com,name=value,paper=A4 | |
360 | ||
361 | ||
9e4abcb5 SK |
362 | # For debugging purposes, log each DNS query as it passes through |
363 | # dnsmasq. | |
364 | #log-queries | |
365 | ||
33820b7e SK |
366 | # Include a another lot of configuration options. |
367 | #conf-file=/etc/dnsmasq.more.conf | |
368 | ||
9e4abcb5 SK |
369 | |
370 | ||
371 | ||
372 |