blob: 4f2bcf33b459541ac95776a4a68cad1ed3455963 [file] [log] [blame]
Simon Kelley9e4abcb2004-01-22 19:47:41 +00001# 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
Simon Kelley2f777972012-04-16 14:58:53 +01007# 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
Simon Kelleyb8187c82005-11-26 21:46:27 +000012# The following two options make you a better netizen, since they
Simon Kelley9e4abcb2004-01-22 19:47:41 +000013# tell dnsmasq to filter out queries which the public DNS cannot
Simon Kelleyb8187c82005-11-26 21:46:27 +000014# answer, and which load the servers (especially the root servers)
Simon Kelley572b41e2011-02-18 18:11:18 +000015# unnecessarily. If you have a dial-on-demand link they also stop
16# these requests from bringing up the link unnecessarily.
Simon Kelley9e4abcb2004-01-22 19:47:41 +000017
Simon Kelley3d8df262005-08-29 12:19:27 +010018# Never forward plain names (without a dot or domain part)
Simon Kelley16972692006-10-16 20:04:18 +010019#domain-needed
Simon Kelleyc1bb8502004-08-11 18:40:17 +010020# Never forward addresses in the non-routed address spaces.
Simon Kelley16972692006-10-16 20:04:18 +010021#bogus-priv
Simon Kelley9e4abcb2004-01-22 19:47:41 +000022
Simon Kelley854cf262014-02-06 12:07:10 +000023# 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
Simon Kelley9e4abcb2004-01-22 19:47:41 +000027
Simon Kelleyc1bb8502004-08-11 18:40:17 +010028# Uncomment this to filter useless windows-originated DNS requests
29# which can trigger dial-on-demand links needlessly.
Simon Kelleyb8187c82005-11-26 21:46:27 +000030# Note that (amongst other things) this blocks all SRV requests,
Simon Kelley824af852008-02-12 20:43:05 +000031# so don't use it if you use eg Kerberos, SIP, XMMP or Google-talk.
Simon Kelleyf6b7dc42005-01-23 12:06:08 +000032# This option only affects forwarding, SRV records originating for
33# dnsmasq (via srv-host= lines) are not suppressed by it.
Simon Kelleyc1bb8502004-08-11 18:40:17 +010034#filterwin2k
35
Simon Kelley9e4abcb2004-01-22 19:47:41 +000036# Change this line if you want dns to get its upstream servers from
Simon Kelleyb8187c82005-11-26 21:46:27 +000037# somewhere other that /etc/resolv.conf
Simon Kelley9e4abcb2004-01-22 19:47:41 +000038#resolv-file=
39
Simon Kelley1ab84e22004-01-29 16:48:35 +000040# By default, dnsmasq will send queries to any of the upstream
41# servers it knows about and tries to favour servers to are known
42# to be up. Uncommenting this forces dnsmasq to try each query
43# with each server strictly in the order they appear in
44# /etc/resolv.conf
45#strict-order
46
Simon Kelley9e4abcb2004-01-22 19:47:41 +000047# If you don't want dnsmasq to read /etc/resolv.conf or any other
Simon Kelleyb8187c82005-11-26 21:46:27 +000048# file, getting its servers from this file instead (see below), then
Simon Kelley832af0b2007-01-21 20:01:28 +000049# uncomment this.
Simon Kelley9e4abcb2004-01-22 19:47:41 +000050#no-resolv
51
52# If you don't want dnsmasq to poll /etc/resolv.conf or other resolv
53# files for changes and re-read them then uncomment this.
54#no-poll
55
Simon Kelleyb8187c82005-11-26 21:46:27 +000056# Add other name servers here, with domain specs if they are for
Simon Kelley9e4abcb2004-01-22 19:47:41 +000057# non-public domains.
58#server=/localnet/192.168.0.1
59
Simon Kelley28866e92011-02-14 20:19:14 +000060# Example of routing PTR queries to nameservers: this will send all
Simon Kelleyf2621c72007-04-29 19:47:21 +010061# address->name queries for 192.168.3/24 to nameserver 10.1.2.3
62#server=/3.168.192.in-addr.arpa/10.1.2.3
63
Simon Kelley9e4abcb2004-01-22 19:47:41 +000064# Add local-only domains here, queries in these domains are answered
65# from /etc/hosts or DHCP only.
66#local=/localnet/
67
68# Add domains which you want to force to an IP address here.
Simon Kelley28866e92011-02-14 20:19:14 +000069# The example below send any host in double-click.net to a local
70# web-server.
71#address=/double-click.net/127.0.0.1
Simon Kelley9e4abcb2004-01-22 19:47:41 +000072
Simon Kelley824af852008-02-12 20:43:05 +000073# --address (and --server) work with IPv6 addresses too.
74#address=/www.thekelleys.org.uk/fe80::20d:60ff:fe36:f83
75
Jason A. Donenfeld13d86c72013-02-22 18:20:53 +000076# Add the IPs of all queries to yahoo.com, google.com, and their
77# subdomains to the vpn and search ipsets:
78#ipset=/yahoo.com/google.com/vpn,search
79
Simon Kelley28866e92011-02-14 20:19:14 +000080# You can control how dnsmasq talks to a server: this forces
Simon Kelley824af852008-02-12 20:43:05 +000081# queries to 10.1.2.3 to be routed via eth1
Simon Kelley8ef5ada2010-06-03 19:42:45 +010082# server=10.1.2.3@eth1
Simon Kelley824af852008-02-12 20:43:05 +000083
84# and this sets the source (ie local) address used to talk to
85# 10.1.2.3 to 192.168.1.1 port 55 (there must be a interface with that
86# IP on the machine, obviously).
Simon Kelley8ef5ada2010-06-03 19:42:45 +010087# server=10.1.2.3@192.168.1.1#55
Simon Kelley824af852008-02-12 20:43:05 +000088
Simon Kelleyf6b7dc42005-01-23 12:06:08 +000089# If you want dnsmasq to change uid and gid to something other
90# than the default, edit the following lines.
Simon Kelley9e4abcb2004-01-22 19:47:41 +000091#user=
92#group=
93
Simon Kelleyb8187c82005-11-26 21:46:27 +000094# If you want dnsmasq to listen for DHCP and DNS requests only on
95# specified interfaces (and the loopback) give the name of the
96# interface (eg eth0) here.
Simon Kelley9e4abcb2004-01-22 19:47:41 +000097# Repeat the line for more than one interface.
98#interface=
99# Or you can specify which interface _not_ to listen on
100#except-interface=
101# Or which to listen on by address (remember to include 127.0.0.1 if
102# you use this.)
103#listen-address=
Simon Kelley3d8df262005-08-29 12:19:27 +0100104# If you want dnsmasq to provide only DNS service on an interface,
105# configure it as shown above, and then use the following line to
Simon Kelley28866e92011-02-14 20:19:14 +0000106# disable DHCP and TFTP on it.
Simon Kelley3d8df262005-08-29 12:19:27 +0100107#no-dhcp-interface=
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000108
Simon Kelley44a2a312004-03-10 20:04:35 +0000109# On systems which support it, dnsmasq binds the wildcard address,
110# even when it is listening on only some interfaces. It then discards
Simon Kelleyb8187c82005-11-26 21:46:27 +0000111# requests that it shouldn't reply to. This has the advantage of
Simon Kelley44a2a312004-03-10 20:04:35 +0000112# working even when interfaces come and go and change address. If you
113# want dnsmasq to really bind only the interfaces it is listening on,
Simon Kelleyb8187c82005-11-26 21:46:27 +0000114# uncomment this option. About the only time you may need this is when
Simon Kelley44a2a312004-03-10 20:04:35 +0000115# running another nameserver on the same machine.
Simon Kelleyb8187c82005-11-26 21:46:27 +0000116#bind-interfaces
Simon Kelley44a2a312004-03-10 20:04:35 +0000117
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000118# If you don't want dnsmasq to read /etc/hosts, uncomment the
119# following line.
120#no-hosts
121# or if you want it to read another file, as well as /etc/hosts, use
122# this.
123#addn-hosts=/etc/banner_add_hosts
124
125# Set this (and domain: see below) if you want to have a domain
126# automatically added to simple names in a hosts-file.
127#expand-hosts
128
Simon Kelley44a2a312004-03-10 20:04:35 +0000129# Set the domain for dnsmasq. this is optional, but if it is set, it
130# does the following things.
131# 1) Allows DHCP hosts to have fully qualified domain names, as long
132# as the domain part matches this setting.
133# 2) Sets the "domain" DHCP option thereby potentially setting the
134# domain of all systems configured by DHCP
135# 3) Provides the domain part for "expand-hosts"
136#domain=thekelleys.org.uk
Simon Kelleyb8187c82005-11-26 21:46:27 +0000137
Simon Kelley9009d742008-11-14 20:04:27 +0000138# Set a different domain for a particular subnet
139#domain=wireless.thekelleys.org.uk,192.168.2.0/24
140
141# Same idea, but range rather then subnet
142#domain=reserved.thekelleys.org.uk,192.68.3.100,192.168.3.200
143
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000144# Uncomment this to enable the integrated DHCP server, you need
Simon Kelleyb8187c82005-11-26 21:46:27 +0000145# to supply the range of addresses available for lease and optionally
Simon Kelley44a2a312004-03-10 20:04:35 +0000146# a lease time. If you have more than one network, you will need to
147# repeat this for each network on which you want to supply DHCP
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000148# service.
149#dhcp-range=192.168.0.50,192.168.0.150,12h
150
Simon Kelley44a2a312004-03-10 20:04:35 +0000151# This is an example of a DHCP range where the netmask is given. This
Simon Kelleyb8187c82005-11-26 21:46:27 +0000152# is needed for networks we reach the dnsmasq DHCP server via a relay
Simon Kelley44a2a312004-03-10 20:04:35 +0000153# agent. If you don't know what a DHCP relay agent is, you probably
154# don't need to worry about this.
155#dhcp-range=192.168.0.50,192.168.0.150,255.255.255.0,12h
156
Simon Kelley8ef5ada2010-06-03 19:42:45 +0100157# This is an example of a DHCP range which sets a tag, so that
Simon Kelley44a2a312004-03-10 20:04:35 +0000158# some DHCP options may be set only for this network.
Simon Kelley8ef5ada2010-06-03 19:42:45 +0100159#dhcp-range=set:red,192.168.0.50,192.168.0.150
Simon Kelley44a2a312004-03-10 20:04:35 +0000160
Simon Kelley28866e92011-02-14 20:19:14 +0000161# Use this DHCP range only when the tag "green" is set.
Simon Kelley8ef5ada2010-06-03 19:42:45 +0100162#dhcp-range=tag:green,192.168.0.50,192.168.0.150,12h
163
164# Specify a subnet which can't be used for dynamic address allocation,
165# is available for hosts with matching --dhcp-host lines. Note that
166# dhcp-host declarations will be ignored unless there is a dhcp-range
167# of some type for the subnet in question.
168# In this case the netmask is implied (it comes from the network
Simon Kelley28866e92011-02-14 20:19:14 +0000169# configuration on the machine running dnsmasq) it is possible to give
170# an explicit netmask instead.
Simon Kelley8ef5ada2010-06-03 19:42:45 +0100171#dhcp-range=192.168.0.0,static
Simon Kelley28866e92011-02-14 20:19:14 +0000172
Simon Kelley843c96b2012-02-27 17:42:38 +0000173# Enable DHCPv6. Note that the prefix-length does not need to be specified
174# and defaults to 64 if missing/
175#dhcp-range=1234::2, 1234::500, 64, 12h
176
Simon Kelley0010b472012-02-29 12:18:30 +0000177# Do Router Advertisements, BUT NOT DHCP for this subnet.
Simon Kelley843c96b2012-02-27 17:42:38 +0000178#dhcp-range=1234::, ra-only
179
Simon Kelley7023e382012-03-09 12:05:49 +0000180# Do Router Advertisements, BUT NOT DHCP for this subnet, also try and
181# add names to the DNS for the IPv6 address of SLAAC-configured dual-stack
182# hosts. Use the DHCPv4 lease to derive the name, network segment and
183# MAC address and assume that the host will also have an
184# IPv6 address calculated using the SLAAC alogrithm.
Simon Kelley7023e382012-03-09 12:05:49 +0000185#dhcp-range=1234::, ra-names
186
Simon Kelley0010b472012-02-29 12:18:30 +0000187# Do Router Advertisements, BUT NOT DHCP for this subnet.
188# Set the lifetime to 46 hours. (Note: minimum lifetime is 2 hours.)
189#dhcp-range=1234::, ra-only, 48h
190
Simon Kelleye8ca69e2012-03-26 21:23:26 +0100191# Do DHCP and Router Advertisements for this subnet. Set the A bit in the RA
192# so that clients can use SLAAC addresses as well as DHCP ones.
193#dhcp-range=1234::2, 1234::500, slaac
194
195# Do Router Advertisements and stateless DHCP for this subnet. Clients will
196# not get addresses from DHCP, but they will get other configuration information.
197# They will use SLAAC for addresses.
198#dhcp-range=1234::, ra-stateless
199
200# Do stateless DHCP, SLAAC, and generate DNS names for SLAAC addresses
201# from DHCPv4 leases.
202#dhcp-range=1234::, ra-stateless, ra-names
203
204# Do router advertisements for all subnets where we're doing DHCPv6
205# Unless overriden by ra-stateless, ra-names, et al, the router
206# advertisements will have the M and O bits set, so that the clients
207# get addresses and configuration from DHCPv6, and the A bit reset, so the
208# clients don't use SLAAC addresses.
209#enable-ra
210
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000211# Supply parameters for specified hosts using DHCP. There are lots
Simon Kelley1ab84e22004-01-29 16:48:35 +0000212# of valid alternatives, so we will give examples of each. Note that
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000213# IP addresses DO NOT have to be in the range given above, they just
Simon Kelley1ab84e22004-01-29 16:48:35 +0000214# need to be on the same network. The order of the parameters in these
Simon Kelley572b41e2011-02-18 18:11:18 +0000215# do not matter, it's permissible to give name, address and MAC in any
216# order.
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000217
Simon Kelley28866e92011-02-14 20:19:14 +0000218# Always allocate the host with Ethernet address 11:22:33:44:55:66
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000219# The IP address 192.168.0.60
220#dhcp-host=11:22:33:44:55:66,192.168.0.60
221
222# Always set the name of the host with hardware address
223# 11:22:33:44:55:66 to be "fred"
224#dhcp-host=11:22:33:44:55:66,fred
225
Simon Kelley28866e92011-02-14 20:19:14 +0000226# Always give the host with Ethernet address 11:22:33:44:55:66
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000227# the name fred and IP address 192.168.0.60 and lease time 45 minutes
228#dhcp-host=11:22:33:44:55:66,fred,192.168.0.60,45m
229
Simon Kelley28866e92011-02-14 20:19:14 +0000230# Give a host with Ethernet address 11:22:33:44:55:66 or
Simon Kelley9009d742008-11-14 20:04:27 +0000231# 12:34:56:78:90:12 the IP address 192.168.0.60. Dnsmasq will assume
Simon Kelley28866e92011-02-14 20:19:14 +0000232# that these two Ethernet interfaces will never be in use at the same
Simon Kelley9009d742008-11-14 20:04:27 +0000233# time, and give the IP address to the second, even if it is already
234# in use by the first. Useful for laptops with wired and wireless
235# addresses.
236#dhcp-host=11:22:33:44:55:66,12:34:56:78:90:12,192.168.0.60
237
Simon Kelley824af852008-02-12 20:43:05 +0000238# Give the machine which says its name is "bert" IP address
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000239# 192.168.0.70 and an infinite lease
240#dhcp-host=bert,192.168.0.70,infinite
241
Simon Kelleyb8187c82005-11-26 21:46:27 +0000242# Always give the host with client identifier 01:02:02:04
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000243# the IP address 192.168.0.60
244#dhcp-host=id:01:02:02:04,192.168.0.60
245
246# Always give the host with client identifier "marjorie"
247# the IP address 192.168.0.60
248#dhcp-host=id:marjorie,192.168.0.60
249
Simon Kelley1ab84e22004-01-29 16:48:35 +0000250# Enable the address given for "judge" in /etc/hosts
251# to be given to a machine presenting the name "judge" when
252# it asks for a DHCP lease.
253#dhcp-host=judge
254
Simon Kelley28866e92011-02-14 20:19:14 +0000255# Never offer DHCP service to a machine whose Ethernet
Simon Kelley33820b72004-04-03 21:10:00 +0100256# address is 11:22:33:44:55:66
257#dhcp-host=11:22:33:44:55:66,ignore
258
Simon Kelley28866e92011-02-14 20:19:14 +0000259# Ignore any client-id presented by the machine with Ethernet
Simon Kelleyb8187c82005-11-26 21:46:27 +0000260# address 11:22:33:44:55:66. This is useful to prevent a machine
Simon Kelleya84fa1d2004-04-23 22:21:21 +0100261# being treated differently when running under different OS's or
262# between PXE boot and OS boot.
263#dhcp-host=11:22:33:44:55:66,id:*
264
Simon Kelleyb8187c82005-11-26 21:46:27 +0000265# Send extra options which are tagged as "red" to
Simon Kelley28866e92011-02-14 20:19:14 +0000266# the machine with Ethernet address 11:22:33:44:55:66
Simon Kelley8ef5ada2010-06-03 19:42:45 +0100267#dhcp-host=11:22:33:44:55:66,set:red
Simon Kelley33820b72004-04-03 21:10:00 +0100268
Simon Kelleyb8187c82005-11-26 21:46:27 +0000269# Send extra options which are tagged as "red" to
Simon Kelley28866e92011-02-14 20:19:14 +0000270# any machine with Ethernet address starting 11:22:33:
Simon Kelley8ef5ada2010-06-03 19:42:45 +0100271#dhcp-host=11:22:33:*:*:*,set:red
Simon Kelley0a852542005-03-23 20:28:59 +0000272
Simon Kelley843c96b2012-02-27 17:42:38 +0000273# Give a fixed IPv6 address and name to client with
274# DUID 00:01:00:01:16:d2:83:fc:92:d4:19:e2:d8:b2
275# Note the MAC addresses CANNOT be used to identify DHCPv6 clients.
276# Note also the they [] around the IPv6 address are obilgatory.
277#dhcp-host=id:00:01:00:01:16:d2:83:fc:92:d4:19:e2:d8:b2, fred, [1234::5]
278
Simon Kelley3862deb2012-01-06 20:16:07 +0000279# Ignore any clients which are not specified in dhcp-host lines
Simon Kelley28866e92011-02-14 20:19:14 +0000280# or /etc/ethers. Equivalent to ISC "deny unknown-clients".
281# This relies on the special "known" tag which is set when
Simon Kelley5aabfc72007-08-29 11:24:47 +0100282# a host is matched.
Simon Kelley8ef5ada2010-06-03 19:42:45 +0100283#dhcp-ignore=tag:!known
Simon Kelley5aabfc72007-08-29 11:24:47 +0100284
Simon Kelleya2226412004-05-13 20:27:08 +0100285# Send extra options which are tagged as "red" to any machine whose
286# DHCP vendorclass string includes the substring "Linux"
Simon Kelley8ef5ada2010-06-03 19:42:45 +0100287#dhcp-vendorclass=set:red,Linux
Simon Kelleya2226412004-05-13 20:27:08 +0100288
Simon Kelleyb8187c82005-11-26 21:46:27 +0000289# Send extra options which are tagged as "red" to any machine one
Simon Kelleya2226412004-05-13 20:27:08 +0100290# of whose DHCP userclass strings includes the substring "accounts"
Simon Kelley8ef5ada2010-06-03 19:42:45 +0100291#dhcp-userclass=set:red,accounts
Simon Kelleya2226412004-05-13 20:27:08 +0100292
Simon Kelleycdeda282006-03-16 20:16:06 +0000293# Send extra options which are tagged as "red" to any machine whose
294# MAC address matches the pattern.
Simon Kelley8ef5ada2010-06-03 19:42:45 +0100295#dhcp-mac=set:red,00:60:8C:*:*:*
Simon Kelleycdeda282006-03-16 20:16:06 +0000296
Simon Kelley44a2a312004-03-10 20:04:35 +0000297# If this line is uncommented, dnsmasq will read /etc/ethers and act
298# on the ethernet-address/IP pairs found there just as if they had
299# been given as --dhcp-host options. Useful if you keep
300# MAC-address/host mappings there for other purposes.
301#read-ethers
302
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000303# Send options to hosts which ask for a DHCP lease.
304# See RFC 2132 for details of available options.
Simon Kelley28866e92011-02-14 20:19:14 +0000305# Common options can be given to dnsmasq by name:
Simon Kelleyf2621c72007-04-29 19:47:21 +0100306# run "dnsmasq --help dhcp" to get a list.
Simon Kelley1ab84e22004-01-29 16:48:35 +0000307# Note that all the common settings, such as netmask and
308# broadcast address, DNS server and default route, are given
Simon Kelley28866e92011-02-14 20:19:14 +0000309# sane defaults by dnsmasq. You very likely will not need
Simon Kelley1ab84e22004-01-29 16:48:35 +0000310# any dhcp-options. If you use Windows clients and Samba, there
311# are some options which are recommended, they are detailed at the
312# end of this section.
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000313
Simon Kelleycdeda282006-03-16 20:16:06 +0000314# Override the default route supplied by dnsmasq, which assumes the
315# router is the same machine as the one running dnsmasq.
316#dhcp-option=3,1.2.3.4
317
Simon Kelleyf2621c72007-04-29 19:47:21 +0100318# Do the same thing, but using the option name
319#dhcp-option=option:router,1.2.3.4
320
Simon Kelley832af0b2007-01-21 20:01:28 +0000321# Override the default route supplied by dnsmasq and send no default
322# route at all. Note that this only works for the options sent by
Simon Kelley28866e92011-02-14 20:19:14 +0000323# default (1, 3, 6, 12, 28) the same line will send a zero-length option
Simon Kelley832af0b2007-01-21 20:01:28 +0000324# for all other option numbers.
325#dhcp-option=3
326
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000327# Set the NTP time server addresses to 192.168.0.4 and 10.10.0.5
Simon Kelleyf2621c72007-04-29 19:47:21 +0100328#dhcp-option=option:ntp-server,192.168.0.4,10.10.0.5
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000329
Simon Kelley843c96b2012-02-27 17:42:38 +0000330# Send DHCPv6 option. Note [] around IPv6 addresses.
Simon Kelley0010b472012-02-29 12:18:30 +0000331#dhcp-option=option6:dns-server,[1234::77],[1234::88]
332
333# Send DHCPv6 option for namservers as the machine running
334# dnsmasq and another.
335#dhcp-option=option6:dns-server,[::],[1234::88]
Simon Kelley843c96b2012-02-27 17:42:38 +0000336
Simon Kelley23245c02012-07-18 16:21:11 +0100337# Ask client to poll for option changes every six hours. (RFC4242)
338#dhcp-option=option6:information-refresh-time,6h
339
Simon Kelleyb8187c82005-11-26 21:46:27 +0000340# Set the NTP time server address to be the same machine as
Simon Kelley1ab84e22004-01-29 16:48:35 +0000341# is running dnsmasq
342#dhcp-option=42,0.0.0.0
343
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000344# Set the NIS domain name to "welly"
345#dhcp-option=40,welly
346
Simon Kelley1ab84e22004-01-29 16:48:35 +0000347# Set the default time-to-live to 50
348#dhcp-option=23,50
349
350# Set the "all subnets are local" flag
351#dhcp-option=27,1
352
Simon Kelley33820b72004-04-03 21:10:00 +0100353# Send the etherboot magic flag and then etherboot options (a string).
354#dhcp-option=128,e4:45:74:68:00:00
355#dhcp-option=129,NIC=eepro100
356
Simon Kelleyb8187c82005-11-26 21:46:27 +0000357# Specify an option which will only be sent to the "red" network
Simon Kelley44a2a312004-03-10 20:04:35 +0000358# (see dhcp-range for the declaration of the "red" network)
Simon Kelley8ef5ada2010-06-03 19:42:45 +0100359# Note that the tag: part must precede the option: part.
360#dhcp-option = tag:red, option:ntp-server, 192.168.1.1
Simon Kelley44a2a312004-03-10 20:04:35 +0000361
Simon Kelley1ab84e22004-01-29 16:48:35 +0000362# The following DHCP options set up dnsmasq in the same way as is specified
Simon Kelleyb8187c82005-11-26 21:46:27 +0000363# for the ISC dhcpcd in
Simon Kelley1ab84e22004-01-29 16:48:35 +0000364# http://www.samba.org/samba/ftp/docs/textdocs/DHCP-Server-Configuration.txt
365# adapted for a typical dnsmasq installation where the host running
366# dnsmasq is also the host running samba.
Simon Kelley28866e92011-02-14 20:19:14 +0000367# you may want to uncomment some or all of them if you use
Simon Kelley9009d742008-11-14 20:04:27 +0000368# Windows clients and Samba.
Simon Kelleyb8187c82005-11-26 21:46:27 +0000369#dhcp-option=19,0 # option ip-forwarding off
Simon Kelley1ab84e22004-01-29 16:48:35 +0000370#dhcp-option=44,0.0.0.0 # set netbios-over-TCP/IP nameserver(s) aka WINS server(s)
371#dhcp-option=45,0.0.0.0 # netbios datagram distribution server
372#dhcp-option=46,8 # netbios node type
Simon Kelleyfd9fa482004-10-21 20:24:00 +0100373
Simon Kelley03bfcf62012-01-07 14:37:37 +0000374# Send an empty WPAD option. This may be REQUIRED to get windows 7 to behave.
375#dhcp-option=252,"\n"
376
Simon Kelleyfd9fa482004-10-21 20:24:00 +0100377# Send RFC-3397 DNS domain search DHCP option. WARNING: Your DHCP client
378# probably doesn't support this......
Simon Kelleyf2621c72007-04-29 19:47:21 +0100379#dhcp-option=option:domain-search,eng.apple.com,marketing.apple.com
Simon Kelley1ab84e22004-01-29 16:48:35 +0000380
Simon Kelleycdeda282006-03-16 20:16:06 +0000381# Send RFC-3442 classless static routes (note the netmask encoding)
382#dhcp-option=121,192.168.1.0/24,1.2.3.4,10.0.0.0/8,5.6.7.8
383
Simon Kelley28866e92011-02-14 20:19:14 +0000384# Send vendor-class specific options encapsulated in DHCP option 43.
Simon Kelley1b7ecd12007-02-05 14:57:57 +0000385# The meaning of the options is defined by the vendor-class so
386# options are sent only when the client supplied vendor class
Simon Kelley28866e92011-02-14 20:19:14 +0000387# matches the class given here. (A substring match is OK, so "MSFT"
Simon Kelley1b7ecd12007-02-05 14:57:57 +0000388# matches "MSFT" and "MSFT 5.0"). This example sets the
389# mtftp address to 0.0.0.0 for PXEClients.
Simon Kelley91dccd02005-03-31 17:48:32 +0100390#dhcp-option=vendor:PXEClient,1,0.0.0.0
391
Simon Kelley1b7ecd12007-02-05 14:57:57 +0000392# Send microsoft-specific option to tell windows to release the DHCP lease
393# when it shuts down. Note the "i" flag, to tell dnsmasq to send the
394# value as a four-byte integer - that's what microsoft wants. See
395# http://technet2.microsoft.com/WindowsServer/en/library/a70f1bb7-d2d4-49f0-96d6-4b7414ecfaae1033.mspx?mfr=true
396#dhcp-option=vendor:MSFT,2,1i
397
Simon Kelley6b010842007-02-12 20:32:07 +0000398# Send the Encapsulated-vendor-class ID needed by some configurations of
399# Etherboot to allow is to recognise the DHCP server.
400#dhcp-option=vendor:Etherboot,60,"Etherboot"
401
402# Send options to PXELinux. Note that we need to send the options even
403# though they don't appear in the parameter request list, so we need
Simon Kelley28866e92011-02-14 20:19:14 +0000404# to use dhcp-option-force here.
Simon Kelley6b010842007-02-12 20:32:07 +0000405# See http://syslinux.zytor.com/pxe.php#special for details.
406# Magic number - needed before anything else is recognised
407#dhcp-option-force=208,f1:00:74:7e
408# Configuration file name
409#dhcp-option-force=209,configs/common
410# Path prefix
411#dhcp-option-force=210,/tftpboot/pxelinux/files/
412# Reboot time. (Note 'i' to send 32-bit value)
413#dhcp-option-force=211,30i
414
Simon Kelley28866e92011-02-14 20:19:14 +0000415# Set the boot filename for netboot/PXE. You will only need
Simon Kelley832af0b2007-01-21 20:01:28 +0000416# this is you want to boot machines over the network and you will need
417# a TFTP server; either dnsmasq's built in TFTP server or an
418# external one. (See below for how to enable the TFTP server.)
419#dhcp-boot=pxelinux.0
420
Simon Kelley7de060b2011-08-26 17:24:52 +0100421# The same as above, but use custom tftp-server instead machine running dnsmasq
422#dhcp-boot=pxelinux,server.name,192.168.1.100
423
Simon Kelley824af852008-02-12 20:43:05 +0000424# Boot for Etherboot gPXE. The idea is to send two different
425# filenames, the first loads gPXE, and the second tells gPXE what to
426# load. The dhcp-match sets the gpxe tag for requests from gPXE.
Simon Kelley8ef5ada2010-06-03 19:42:45 +0100427#dhcp-match=set:gpxe,175 # gPXE sends a 175 option.
428#dhcp-boot=tag:!gpxe,undionly.kpxe
Simon Kelley824af852008-02-12 20:43:05 +0000429#dhcp-boot=mybootimage
Simon Kelley28866e92011-02-14 20:19:14 +0000430
Simon Kelley73a08a22009-02-05 20:28:08 +0000431# Encapsulated options for Etherboot gPXE. All the options are
432# encapsulated within option 175
433#dhcp-option=encap:175, 1, 5b # priority code
Simon Kelley28866e92011-02-14 20:19:14 +0000434#dhcp-option=encap:175, 176, 1b # no-proxydhcp
435#dhcp-option=encap:175, 177, string # bus-id
Simon Kelley73a08a22009-02-05 20:28:08 +0000436#dhcp-option=encap:175, 189, 1b # BIOS drive code
437#dhcp-option=encap:175, 190, user # iSCSI username
438#dhcp-option=encap:175, 191, pass # iSCSI password
439
440# Test for the architecture of a netboot client. PXE clients are
441# supposed to send their architecture as option 93. (See RFC 4578)
442#dhcp-match=peecees, option:client-arch, 0 #x86-32
443#dhcp-match=itanics, option:client-arch, 2 #IA64
444#dhcp-match=hammers, option:client-arch, 6 #x86-64
Simon Kelley28866e92011-02-14 20:19:14 +0000445#dhcp-match=mactels, option:client-arch, 7 #EFI x86-64
Simon Kelley73a08a22009-02-05 20:28:08 +0000446
Simon Kelley7622fc02009-06-04 20:32:05 +0100447# Do real PXE, rather than just booting a single file, this is an
448# alternative to dhcp-boot.
449#pxe-prompt="What system shall I netboot?"
450# or with timeout before first available action is taken:
451#pxe-prompt="Press F8 for menu.", 60
452
453# Available boot services. for PXE.
Simon Kelley316e2732010-01-22 20:16:09 +0000454#pxe-service=x86PC, "Boot from local disk"
Simon Kelley7622fc02009-06-04 20:32:05 +0100455
456# Loads <tftp-root>/pxelinux.0 from dnsmasq TFTP server.
Simon Kelley28866e92011-02-14 20:19:14 +0000457#pxe-service=x86PC, "Install Linux", pxelinux
Simon Kelley7622fc02009-06-04 20:32:05 +0100458
459# Loads <tftp-root>/pxelinux.0 from TFTP server at 1.2.3.4.
460# Beware this fails on old PXE ROMS.
Simon Kelley28866e92011-02-14 20:19:14 +0000461#pxe-service=x86PC, "Install Linux", pxelinux, 1.2.3.4
Simon Kelley7622fc02009-06-04 20:32:05 +0100462
463# Use bootserver on network, found my multicast or broadcast.
464#pxe-service=x86PC, "Install windows from RIS server", 1
465
466# Use bootserver at a known IP address.
467#pxe-service=x86PC, "Install windows from RIS server", 1, 1.2.3.4
468
469# If you have multicast-FTP available,
470# information for that can be passed in a similar way using options 1
471# to 5. See page 19 of
Simon Kelley28866e92011-02-14 20:19:14 +0000472# http://download.intel.com/design/archives/wfm/downloads/pxespec.pdf
Simon Kelley7622fc02009-06-04 20:32:05 +0100473
Simon Kelley28866e92011-02-14 20:19:14 +0000474
Simon Kelley832af0b2007-01-21 20:01:28 +0000475# Enable dnsmasq's built-in TFTP server
476#enable-tftp
477
Simon Kelley28866e92011-02-14 20:19:14 +0000478# Set the root directory for files available via FTP.
Simon Kelley832af0b2007-01-21 20:01:28 +0000479#tftp-root=/var/ftpd
480
481# Make the TFTP server more secure: with this set, only files owned by
482# the user dnsmasq is running as will be send over the net.
483#tftp-secure
484
Simon Kelley28866e92011-02-14 20:19:14 +0000485# This option stops dnsmasq from negotiating a larger blocksize for TFTP
Simon Kelley1f15b812009-10-13 17:49:32 +0100486# transfers. It will slow things down, but may rescue some broken TFTP
487# clients.
488#tftp-no-blocksize
489
Simon Kelley832af0b2007-01-21 20:01:28 +0000490# Set the boot file name only when the "red" tag is set.
Simon Kelleycf568a32012-10-09 20:51:31 +0100491#dhcp-boot=tag:red,pxelinux.red-net
Simon Kelley832af0b2007-01-21 20:01:28 +0000492
Simon Kelley7622fc02009-06-04 20:32:05 +0100493# An example of dhcp-boot with an external TFTP server: the name and IP
Simon Kelley832af0b2007-01-21 20:01:28 +0000494# address of the server are given after the filename.
Simon Kelley7622fc02009-06-04 20:32:05 +0100495# Can fail with old PXE ROMS. Overridden by --pxe-service.
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000496#dhcp-boot=/var/ftpd/pxelinux.0,boothost,192.168.0.3
497
Simon Kelley7de060b2011-08-26 17:24:52 +0100498# If there are multiple external tftp servers having a same name
499# (using /etc/hosts) then that name can be specified as the
500# tftp_servername (the third option to dhcp-boot) and in that
501# case dnsmasq resolves this name and returns the resultant IP
502# addresses in round robin fasion. This facility can be used to
503# load balance the tftp load among a set of servers.
504#dhcp-boot=/var/ftpd/pxelinux.0,boothost,tftp_server_name
505
Simon Kelley44a2a312004-03-10 20:04:35 +0000506# Set the limit on DHCP leases, the default is 150
507#dhcp-lease-max=150
508
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000509# The DHCP server needs somewhere on disk to keep its lease database.
510# This defaults to a sane location, but if you want to change it, use
511# the line below.
Simon Kelley1ab84e22004-01-29 16:48:35 +0000512#dhcp-leasefile=/var/lib/misc/dnsmasq.leases
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000513
Simon Kelleyb8187c82005-11-26 21:46:27 +0000514# Set the DHCP server to authoritative mode. In this mode it will barge in
515# and take over the lease for any client which broadcasts on the network,
Simon Kelleyfd9fa482004-10-21 20:24:00 +0100516# whether it has a record of the lease or not. This avoids long timeouts
Simon Kelleyb8187c82005-11-26 21:46:27 +0000517# when a machine wakes up on a new network. DO NOT enable this if there's
Simon Kelley28866e92011-02-14 20:19:14 +0000518# the slightest chance that you might end up accidentally configuring a DHCP
Simon Kelley5aabfc72007-08-29 11:24:47 +0100519# server for your campus/company accidentally. The ISC server uses
Simon Kelleyfd9fa482004-10-21 20:24:00 +0100520# the same option, and this URL provides more information:
Simon Kelley28866e92011-02-14 20:19:14 +0000521# http://www.isc.org/files/auth.html
Simon Kelleyfd9fa482004-10-21 20:24:00 +0100522#dhcp-authoritative
523
Simon Kelley7cebd202006-05-06 14:13:33 +0100524# Run an executable when a DHCP lease is created or destroyed.
Simon Kelley28866e92011-02-14 20:19:14 +0000525# The arguments sent to the script are "add" or "del",
Simon Kelley7cebd202006-05-06 14:13:33 +0100526# then the MAC address, the IP address and finally the hostname
Simon Kelley28866e92011-02-14 20:19:14 +0000527# if there is one.
Simon Kelley7cebd202006-05-06 14:13:33 +0100528#dhcp-script=/bin/echo
529
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000530# Set the cachesize here.
Simon Kelley1ab84e22004-01-29 16:48:35 +0000531#cache-size=150
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000532
533# If you want to disable negative caching, uncomment this.
534#no-negcache
535
Simon Kelleybe0f45c2012-07-16 13:35:25 +0100536# Normally responses which come from /etc/hosts and the DHCP lease
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000537# file have Time-To-Live set as zero, which conventionally means
Simon Kelleyb8187c82005-11-26 21:46:27 +0000538# do not cache further. If you are happy to trade lower load on the
539# server for potentially stale date, you can set a time-to-live (in
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000540# seconds) here.
541#local-ttl=
542
543# If you want dnsmasq to detect attempts by Verisign to send queries
544# to unregistered .com and .net hosts to its sitefinder service and
545# have dnsmasq instead return the correct NXDOMAIN response, uncomment
546# this line. You can add similar lines to do the same for other
547# registries which have implemented wildcard A records.
548#bogus-nxdomain=64.94.110.11
549
Simon Kelley1cff1662004-03-12 08:12:58 +0000550# If you want to fix up DNS results from upstream servers, use the
551# alias option. This only works for IPv4.
552# This alias makes a result of 1.2.3.4 appear as 5.6.7.8
553#alias=1.2.3.4,5.6.7.8
554# and this maps 1.2.3.x to 5.6.7.x
555#alias=1.2.3.0,5.6.7.0,255.255.255.0
Simon Kelley73a08a22009-02-05 20:28:08 +0000556# and this maps 192.168.0.10->192.168.0.40 to 10.0.0.10->10.0.0.40
557#alias=192.168.0.10-192.168.0.40,10.0.0.0,255.255.255.0
Simon Kelleyf6b7dc42005-01-23 12:06:08 +0000558
559# Change these lines if you want dnsmasq to serve MX records.
560
561# Return an MX record named "maildomain.com" with target
562# servermachine.com and preference 50
563#mx-host=maildomain.com,servermachine.com,50
564
565# Set the default target for MX records created using the localmx option.
566#mx-target=servermachine.com
567
568# Return an MX record pointing to the mx-target for all local
569# machines.
570#localmx
571
572# Return an MX record pointing to itself for all local machines.
573#selfmx
574
Simon Kelleyb8187c82005-11-26 21:46:27 +0000575# Change the following lines if you want dnsmasq to serve SRV
Simon Kelleyf6b7dc42005-01-23 12:06:08 +0000576# records. These are useful if you want to serve ldap requests for
577# Active Directory and other windows-originated DNS requests.
578# See RFC 2782.
Simon Kelleyb8187c82005-11-26 21:46:27 +0000579# You may add multiple srv-host lines.
Simon Kelleyf6b7dc42005-01-23 12:06:08 +0000580# The fields are <name>,<target>,<port>,<priority>,<weight>
581# If the domain part if missing from the name (so that is just has the
582# service and protocol sections) then the domain given by the domain=
Simon Kelley0a852542005-03-23 20:28:59 +0000583# config option is used. (Note that expand-hosts does not need to be
584# set for this to work.)
Simon Kelleyf6b7dc42005-01-23 12:06:08 +0000585
586# A SRV record sending LDAP for the example.com domain to
Simon Kelley8ef5ada2010-06-03 19:42:45 +0100587# ldapserver.example.com port 389
Simon Kelleyf6b7dc42005-01-23 12:06:08 +0000588#srv-host=_ldap._tcp.example.com,ldapserver.example.com,389
589
590# A SRV record sending LDAP for the example.com domain to
Simon Kelley8ef5ada2010-06-03 19:42:45 +0100591# ldapserver.example.com port 389 (using domain=)
Simon Kelleyf6b7dc42005-01-23 12:06:08 +0000592#domain=example.com
593#srv-host=_ldap._tcp,ldapserver.example.com,389
594
595# Two SRV records for LDAP, each with different priorities
596#srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,1
597#srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,2
598
599# A SRV record indicating that there is no LDAP server for the domain
Simon Kelleyb8187c82005-11-26 21:46:27 +0000600# example.com
Simon Kelleyf6b7dc42005-01-23 12:06:08 +0000601#srv-host=_ldap._tcp.example.com
602
Simon Kelley832af0b2007-01-21 20:01:28 +0000603# The following line shows how to make dnsmasq serve an arbitrary PTR
604# record. This is useful for DNS-SD. (Note that the
605# domain-name expansion done for SRV records _does_not
606# occur for PTR records.)
607#ptr-record=_http._tcp.dns-sd-services,"New Employee Page._http._tcp.dns-sd-services"
Simon Kelley0a852542005-03-23 20:28:59 +0000608
609# Change the following lines to enable dnsmasq to serve TXT records.
610# These are used for things like SPF and zeroconf. (Note that the
Simon Kelleyb8187c82005-11-26 21:46:27 +0000611# domain-name expansion done for SRV records _does_not
Simon Kelley0a852542005-03-23 20:28:59 +0000612# occur for TXT records.)
613
614#Example SPF.
Simon Kelley832af0b2007-01-21 20:01:28 +0000615#txt-record=example.com,"v=spf1 a -all"
Simon Kelley0a852542005-03-23 20:28:59 +0000616
617#Example zeroconf
618#txt-record=_http._tcp.example.com,name=value,paper=A4
619
Simon Kelley9009d742008-11-14 20:04:27 +0000620# Provide an alias for a "local" DNS name. Note that this _only_ works
621# for targets which are names from DHCP or /etc/hosts. Give host
622# "bert" another name, bertrand
623#cname=bertand,bert
Simon Kelley0a852542005-03-23 20:28:59 +0000624
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000625# For debugging purposes, log each DNS query as it passes through
626# dnsmasq.
627#log-queries
628
Simon Kelleyf2621c72007-04-29 19:47:21 +0100629# Log lots of extra information about DHCP transactions.
630#log-dhcp
631
Simon Kelleycf568a32012-10-09 20:51:31 +0100632# Include another lot of configuration options.
Simon Kelley33820b72004-04-03 21:10:00 +0100633#conf-file=/etc/dnsmasq.more.conf
Simon Kelley16972692006-10-16 20:04:18 +0100634#conf-dir=/etc/dnsmasq.d