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