• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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
7# The following two options make you a better netizen, since they
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
13# Never forward plain names (without a dot or domain part)
14#domain-needed
15# Never forward addresses in the non-routed address spaces.
16#bogus-priv
17
18
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, SIP, XMMP or Google-talk.
23# This option only affects forwarding, SRV records originating for
24# dnsmasq (via srv-host= lines) are not suppressed by it.
25#filterwin2k
26
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
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
38# If you don't want dnsmasq to read /etc/resolv.conf or any other
39# file, getting its servers from 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# Example of routing PTR queries to nameservers: this will send all
52# address->name queries for 192.168.3/24 to nameserver 10.1.2.3
53#server=/3.168.192.in-addr.arpa/10.1.2.3
54
55# Add local-only domains here, queries in these domains are answered
56# from /etc/hosts or DHCP only.
57#local=/localnet/
58
59# Add domains which you want to force to an IP address here.
60# The example below send any host in doubleclick.net to a local
61# webserver.
62#address=/doubleclick.net/127.0.0.1
63
64# --address (and --server) work with IPv6 addresses too.
65#address=/www.thekelleys.org.uk/fe80::20d:60ff:fe36:f83
66
67# You can control how dnsmasq talks to a server: this forces
68# queries to 10.1.2.3 to be routed via eth1
69# --server=10.1.2.3@eth1
70
71# and this sets the source (ie local) address used to talk to
72# 10.1.2.3 to 192.168.1.1 port 55 (there must be a interface with that
73# IP on the machine, obviously).
74# --server=10.1.2.3@192.168.1.1#55
75
76# If you want dnsmasq to change uid and gid to something other
77# than the default, edit the following lines.
78#user=
79#group=
80
81# If you want dnsmasq to listen for DHCP and DNS requests only on
82# specified interfaces (and the loopback) give the name of the
83# interface (eg eth0) here.
84# Repeat the line for more than one interface.
85#interface=
86# Or you can specify which interface _not_ to listen on
87#except-interface=
88# Or which to listen on by address (remember to include 127.0.0.1 if
89# you use this.)
90#listen-address=
91# If you want dnsmasq to provide only DNS service on an interface,
92# configure it as shown above, and then use the following line to
93# disable DHCP on it.
94#no-dhcp-interface=
95
96# On systems which support it, dnsmasq binds the wildcard address,
97# even when it is listening on only some interfaces. It then discards
98# requests that it shouldn't reply to. This has the advantage of
99# working even when interfaces come and go and change address. If you
100# want dnsmasq to really bind only the interfaces it is listening on,
101# uncomment this option. About the only time you may need this is when
102# running another nameserver on the same machine.
103#bind-interfaces
104
105# If you don't want dnsmasq to read /etc/hosts, uncomment the
106# following line.
107#no-hosts
108# or if you want it to read another file, as well as /etc/hosts, use
109# this.
110#addn-hosts=/etc/banner_add_hosts
111
112# Set this (and domain: see below) if you want to have a domain
113# automatically added to simple names in a hosts-file.
114#expand-hosts
115
116# Set the domain for dnsmasq. this is optional, but if it is set, it
117# does the following things.
118# 1) Allows DHCP hosts to have fully qualified domain names, as long
119#     as the domain part matches this setting.
120# 2) Sets the "domain" DHCP option thereby potentially setting the
121#    domain of all systems configured by DHCP
122# 3) Provides the domain part for "expand-hosts"
123#domain=thekelleys.org.uk
124
125# Set a different domain for a particular subnet
126#domain=wireless.thekelleys.org.uk,192.168.2.0/24
127
128# Same idea, but range rather then subnet
129#domain=reserved.thekelleys.org.uk,192.68.3.100,192.168.3.200
130
131# Uncomment this to enable the integrated DHCP server, you need
132# to supply the range of addresses available for lease and optionally
133# a lease time. If you have more than one network, you will need to
134# repeat this for each network on which you want to supply DHCP
135# service.
136#dhcp-range=192.168.0.50,192.168.0.150,12h
137
138# This is an example of a DHCP range where the netmask is given. This
139# is needed for networks we reach the dnsmasq DHCP server via a relay
140# agent. If you don't know what a DHCP relay agent is, you probably
141# don't need to worry about this.
142#dhcp-range=192.168.0.50,192.168.0.150,255.255.255.0,12h
143
144# This is an example of a DHCP range with a network-id, so that
145# some DHCP options may be set only for this network.
146#dhcp-range=red,192.168.0.50,192.168.0.150
147
148# Supply parameters for specified hosts using DHCP. There are lots
149# of valid alternatives, so we will give examples of each. Note that
150# IP addresses DO NOT have to be in the range given above, they just
151# need to be on the same network. The order of the parameters in these
152# do not matter, it's permissble to give name,adddress and MAC in any order
153
154# Always allocate the host with ethernet address 11:22:33:44:55:66
155# The IP address 192.168.0.60
156#dhcp-host=11:22:33:44:55:66,192.168.0.60
157
158# Always set the name of the host with hardware address
159# 11:22:33:44:55:66 to be "fred"
160#dhcp-host=11:22:33:44:55:66,fred
161
162# Always give the host with ethernet address 11:22:33:44:55:66
163# the name fred and IP address 192.168.0.60 and lease time 45 minutes
164#dhcp-host=11:22:33:44:55:66,fred,192.168.0.60,45m
165
166# Give a host with ethernet address 11:22:33:44:55:66 or
167# 12:34:56:78:90:12 the IP address 192.168.0.60. Dnsmasq will assume
168# that these two ethernet interfaces will never be in use at the same
169# time, and give the IP address to the second, even if it is already
170# in use by the first. Useful for laptops with wired and wireless
171# addresses.
172#dhcp-host=11:22:33:44:55:66,12:34:56:78:90:12,192.168.0.60
173
174# Give the machine which says its name is "bert" IP address
175# 192.168.0.70 and an infinite lease
176#dhcp-host=bert,192.168.0.70,infinite
177
178# Always give the host with client identifier 01:02:02:04
179# the IP address 192.168.0.60
180#dhcp-host=id:01:02:02:04,192.168.0.60
181
182# Always give the host with client identifier "marjorie"
183# the IP address 192.168.0.60
184#dhcp-host=id:marjorie,192.168.0.60
185
186# Enable the address given for "judge" in /etc/hosts
187# to be given to a machine presenting the name "judge" when
188# it asks for a DHCP lease.
189#dhcp-host=judge
190
191# Never offer DHCP service to a machine whose ethernet
192# address is 11:22:33:44:55:66
193#dhcp-host=11:22:33:44:55:66,ignore
194
195# Ignore any client-id presented by the machine with ethernet
196# address 11:22:33:44:55:66. This is useful to prevent a machine
197# being treated differently when running under different OS's or
198# between PXE boot and OS boot.
199#dhcp-host=11:22:33:44:55:66,id:*
200
201# Send extra options which are tagged as "red" to
202# the machine with ethernet address 11:22:33:44:55:66
203#dhcp-host=11:22:33:44:55:66,net:red
204
205# Send extra options which are tagged as "red" to
206# any machine with ethernet address starting 11:22:33:
207#dhcp-host=11:22:33:*:*:*,net:red
208
209# Ignore any clients which are specified in dhcp-host lines
210# or /etc/ethers. Equivalent to ISC "deny unkown-clients".
211# This relies on the special "known" tag which is set when
212# a host is matched.
213#dhcp-ignore=#known
214
215# Send extra options which are tagged as "red" to any machine whose
216# DHCP vendorclass string includes the substring "Linux"
217#dhcp-vendorclass=red,Linux
218
219# Send extra options which are tagged as "red" to any machine one
220# of whose DHCP userclass strings includes the substring "accounts"
221#dhcp-userclass=red,accounts
222
223# Send extra options which are tagged as "red" to any machine whose
224# MAC address matches the pattern.
225#dhcp-mac=red,00:60:8C:*:*:*
226
227# If this line is uncommented, dnsmasq will read /etc/ethers and act
228# on the ethernet-address/IP pairs found there just as if they had
229# been given as --dhcp-host options. Useful if you keep
230# MAC-address/host mappings there for other purposes.
231#read-ethers
232
233# Send options to hosts which ask for a DHCP lease.
234# See RFC 2132 for details of available options.
235# Common options can be given to dnsmasq by name:
236# run "dnsmasq --help dhcp" to get a list.
237# Note that all the common settings, such as netmask and
238# broadcast address, DNS server and default route, are given
239# sane defaults by dnsmasq. You very likely will not need
240# any dhcp-options. If you use Windows clients and Samba, there
241# are some options which are recommended, they are detailed at the
242# end of this section.
243
244# Override the default route supplied by dnsmasq, which assumes the
245# router is the same machine as the one running dnsmasq.
246#dhcp-option=3,1.2.3.4
247
248# Do the same thing, but using the option name
249#dhcp-option=option:router,1.2.3.4
250
251# Override the default route supplied by dnsmasq and send no default
252# route at all. Note that this only works for the options sent by
253# default (1, 3, 6, 12, 28) the same line will send a zero-length option
254# for all other option numbers.
255#dhcp-option=3
256
257# Set the NTP time server addresses to 192.168.0.4 and 10.10.0.5
258#dhcp-option=option:ntp-server,192.168.0.4,10.10.0.5
259
260# Set the NTP time server address to be the same machine as
261# is running dnsmasq
262#dhcp-option=42,0.0.0.0
263
264# Set the NIS domain name to "welly"
265#dhcp-option=40,welly
266
267# Set the default time-to-live to 50
268#dhcp-option=23,50
269
270# Set the "all subnets are local" flag
271#dhcp-option=27,1
272
273# Send the etherboot magic flag and then etherboot options (a string).
274#dhcp-option=128,e4:45:74:68:00:00
275#dhcp-option=129,NIC=eepro100
276
277# Specify an option which will only be sent to the "red" network
278# (see dhcp-range for the declaration of the "red" network)
279# Note that the net: part must precede the option: part.
280#dhcp-option = net:red, option:ntp-server, 192.168.1.1
281
282# The following DHCP options set up dnsmasq in the same way as is specified
283# for the ISC dhcpcd in
284# http://www.samba.org/samba/ftp/docs/textdocs/DHCP-Server-Configuration.txt
285# adapted for a typical dnsmasq installation where the host running
286# dnsmasq is also the host running samba.
287# you may want to uncomment some or all of them if you use
288# Windows clients and Samba.
289#dhcp-option=19,0           # option ip-forwarding off
290#dhcp-option=44,0.0.0.0     # set netbios-over-TCP/IP nameserver(s) aka WINS server(s)
291#dhcp-option=45,0.0.0.0     # netbios datagram distribution server
292#dhcp-option=46,8           # netbios node type
293
294# Send RFC-3397 DNS domain search DHCP option. WARNING: Your DHCP client
295# probably doesn't support this......
296#dhcp-option=option:domain-search,eng.apple.com,marketing.apple.com
297
298# Send RFC-3442 classless static routes (note the netmask encoding)
299#dhcp-option=121,192.168.1.0/24,1.2.3.4,10.0.0.0/8,5.6.7.8
300
301# Send vendor-class specific options encapsulated in DHCP option 43.
302# The meaning of the options is defined by the vendor-class so
303# options are sent only when the client supplied vendor class
304# matches the class given here. (A substring match is OK, so "MSFT"
305# matches "MSFT" and "MSFT 5.0"). This example sets the
306# mtftp address to 0.0.0.0 for PXEClients.
307#dhcp-option=vendor:PXEClient,1,0.0.0.0
308
309# Send microsoft-specific option to tell windows to release the DHCP lease
310# when it shuts down. Note the "i" flag, to tell dnsmasq to send the
311# value as a four-byte integer - that's what microsoft wants. See
312# http://technet2.microsoft.com/WindowsServer/en/library/a70f1bb7-d2d4-49f0-96d6-4b7414ecfaae1033.mspx?mfr=true
313#dhcp-option=vendor:MSFT,2,1i
314
315# Send the Encapsulated-vendor-class ID needed by some configurations of
316# Etherboot to allow is to recognise the DHCP server.
317#dhcp-option=vendor:Etherboot,60,"Etherboot"
318
319# Send options to PXELinux. Note that we need to send the options even
320# though they don't appear in the parameter request list, so we need
321# to use dhcp-option-force here.
322# See http://syslinux.zytor.com/pxe.php#special for details.
323# Magic number - needed before anything else is recognised
324#dhcp-option-force=208,f1:00:74:7e
325# Configuration file name
326#dhcp-option-force=209,configs/common
327# Path prefix
328#dhcp-option-force=210,/tftpboot/pxelinux/files/
329# Reboot time. (Note 'i' to send 32-bit value)
330#dhcp-option-force=211,30i
331
332# Set the boot filename for netboot/PXE. You will only need
333# this is you want to boot machines over the network and you will need
334# a TFTP server; either dnsmasq's built in TFTP server or an
335# external one. (See below for how to enable the TFTP server.)
336#dhcp-boot=pxelinux.0
337
338# Boot for Etherboot gPXE. The idea is to send two different
339# filenames, the first loads gPXE, and the second tells gPXE what to
340# load. The dhcp-match sets the gpxe tag for requests from gPXE.
341#dhcp-match=gpxe,175 # gPXE sends a 175 option.
342#dhcp-boot=net:#gpxe,undionly.kpxe
343#dhcp-boot=mybootimage
344
345# Encapsulated options for Etherboot gPXE. All the options are
346# encapsulated within option 175
347#dhcp-option=encap:175, 1, 5b         # priority code
348#dhcp-option=encap:175, 176, 1b       # no-proxydhcp
349#dhcp-option=encap:175, 177, string   # bus-id
350#dhcp-option=encap:175, 189, 1b       # BIOS drive code
351#dhcp-option=encap:175, 190, user     # iSCSI username
352#dhcp-option=encap:175, 191, pass     # iSCSI password
353
354# Test for the architecture of a netboot client. PXE clients are
355# supposed to send their architecture as option 93. (See RFC 4578)
356#dhcp-match=peecees, option:client-arch, 0 #x86-32
357#dhcp-match=itanics, option:client-arch, 2 #IA64
358#dhcp-match=hammers, option:client-arch, 6 #x86-64
359#dhcp-match=mactels, option:client-arch, 7 #EFI x86-64
360
361# Do real PXE, rather than just booting a single file, this is an
362# alternative to dhcp-boot.
363#pxe-prompt="What system shall I netboot?"
364# or with timeout before first available action is taken:
365#pxe-prompt="Press F8 for menu.", 60
366
367# Available boot services. for PXE.
368#pxe-service=x86PC, "Boot from local disk", 0
369
370# Loads <tftp-root>/pxelinux.0 from dnsmasq TFTP server.
371#pxe-service=x86PC, "Install Linux", pxelinux
372
373# Loads <tftp-root>/pxelinux.0 from TFTP server at 1.2.3.4.
374# Beware this fails on old PXE ROMS.
375#pxe-service=x86PC, "Install Linux", pxelinux, 1.2.3.4
376
377# Use bootserver on network, found my multicast or broadcast.
378#pxe-service=x86PC, "Install windows from RIS server", 1
379
380# Use bootserver at a known IP address.
381#pxe-service=x86PC, "Install windows from RIS server", 1, 1.2.3.4
382
383# If you have multicast-FTP available,
384# information for that can be passed in a similar way using options 1
385# to 5. See page 19 of
386# http://download.intel.com/design/archives/wfm/downloads/pxespec.pdf
387
388
389# Enable dnsmasq's built-in TFTP server
390#enable-tftp
391
392# Set the root directory for files availble via FTP.
393#tftp-root=/var/ftpd
394
395# Make the TFTP server more secure: with this set, only files owned by
396# the user dnsmasq is running as will be send over the net.
397#tftp-secure
398
399# This option stops dnsmasq from negotiating a larger blocksize for TFTP
400# transfers. It will slow things down, but may rescue some broken TFTP
401# clients.
402#tftp-no-blocksize
403
404# Set the boot file name only when the "red" tag is set.
405#dhcp-boot=net:red,pxelinux.red-net
406
407# An example of dhcp-boot with an external TFTP server: the name and IP
408# address of the server are given after the filename.
409# Can fail with old PXE ROMS. Overridden by --pxe-service.
410#dhcp-boot=/var/ftpd/pxelinux.0,boothost,192.168.0.3
411
412# Set the limit on DHCP leases, the default is 150
413#dhcp-lease-max=150
414
415# The DHCP server needs somewhere on disk to keep its lease database.
416# This defaults to a sane location, but if you want to change it, use
417# the line below.
418#dhcp-leasefile=/var/lib/misc/dnsmasq.leases
419
420# Set the DHCP server to authoritative mode. In this mode it will barge in
421# and take over the lease for any client which broadcasts on the network,
422# whether it has a record of the lease or not. This avoids long timeouts
423# when a machine wakes up on a new network. DO NOT enable this if there's
424# the slighest chance that you might end up accidentally configuring a DHCP
425# server for your campus/company accidentally. The ISC server uses
426# the same option, and this URL provides more information:
427# http://www.isc.org/index.pl?/sw/dhcp/authoritative.php
428#dhcp-authoritative
429
430# Run an executable when a DHCP lease is created or destroyed.
431# The arguments sent to the script are "add" or "del",
432# then the MAC address, the IP address and finally the hostname
433# if there is one.
434#dhcp-script=/bin/echo
435
436# Set the cachesize here.
437#cache-size=150
438
439# If you want to disable negative caching, uncomment this.
440#no-negcache
441
442# Normally responses which come form /etc/hosts and the DHCP lease
443# file have Time-To-Live set as zero, which conventionally means
444# do not cache further. If you are happy to trade lower load on the
445# server for potentially stale date, you can set a time-to-live (in
446# seconds) here.
447#local-ttl=
448
449# If you want dnsmasq to detect attempts by Verisign to send queries
450# to unregistered .com and .net hosts to its sitefinder service and
451# have dnsmasq instead return the correct NXDOMAIN response, uncomment
452# this line. You can add similar lines to do the same for other
453# registries which have implemented wildcard A records.
454#bogus-nxdomain=64.94.110.11
455
456# If you want to fix up DNS results from upstream servers, use the
457# alias option. This only works for IPv4.
458# This alias makes a result of 1.2.3.4 appear as 5.6.7.8
459#alias=1.2.3.4,5.6.7.8
460# and this maps 1.2.3.x to 5.6.7.x
461#alias=1.2.3.0,5.6.7.0,255.255.255.0
462# and this maps 192.168.0.10->192.168.0.40 to 10.0.0.10->10.0.0.40
463#alias=192.168.0.10-192.168.0.40,10.0.0.0,255.255.255.0
464
465# Change these lines if you want dnsmasq to serve MX records.
466
467# Return an MX record named "maildomain.com" with target
468# servermachine.com and preference 50
469#mx-host=maildomain.com,servermachine.com,50
470
471# Set the default target for MX records created using the localmx option.
472#mx-target=servermachine.com
473
474# Return an MX record pointing to the mx-target for all local
475# machines.
476#localmx
477
478# Return an MX record pointing to itself for all local machines.
479#selfmx
480
481# Change the following lines if you want dnsmasq to serve SRV
482# records.  These are useful if you want to serve ldap requests for
483# Active Directory and other windows-originated DNS requests.
484# See RFC 2782.
485# You may add multiple srv-host lines.
486# The fields are <name>,<target>,<port>,<priority>,<weight>
487# If the domain part if missing from the name (so that is just has the
488# service and protocol sections) then the domain given by the domain=
489# config option is used. (Note that expand-hosts does not need to be
490# set for this to work.)
491
492# A SRV record sending LDAP for the example.com domain to
493# ldapserver.example.com port 289
494#srv-host=_ldap._tcp.example.com,ldapserver.example.com,389
495
496# A SRV record sending LDAP for the example.com domain to
497# ldapserver.example.com port 289 (using domain=)
498#domain=example.com
499#srv-host=_ldap._tcp,ldapserver.example.com,389
500
501# Two SRV records for LDAP, each with different priorities
502#srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,1
503#srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,2
504
505# A SRV record indicating that there is no LDAP server for the domain
506# example.com
507#srv-host=_ldap._tcp.example.com
508
509# The following line shows how to make dnsmasq serve an arbitrary PTR
510# record. This is useful for DNS-SD. (Note that the
511# domain-name expansion done for SRV records _does_not
512# occur for PTR records.)
513#ptr-record=_http._tcp.dns-sd-services,"New Employee Page._http._tcp.dns-sd-services"
514
515# Change the following lines to enable dnsmasq to serve TXT records.
516# These are used for things like SPF and zeroconf. (Note that the
517# domain-name expansion done for SRV records _does_not
518# occur for TXT records.)
519
520#Example SPF.
521#txt-record=example.com,"v=spf1 a -all"
522
523#Example zeroconf
524#txt-record=_http._tcp.example.com,name=value,paper=A4
525
526# Provide an alias for a "local" DNS name. Note that this _only_ works
527# for targets which are names from DHCP or /etc/hosts. Give host
528# "bert" another name, bertrand
529#cname=bertand,bert
530
531# For debugging purposes, log each DNS query as it passes through
532# dnsmasq.
533#log-queries
534
535# Log lots of extra information about DHCP transactions.
536#log-dhcp
537
538# Include a another lot of configuration options.
539#conf-file=/etc/dnsmasq.more.conf
540#conf-dir=/etc/dnsmasq.d
541