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# Change these lines if you want dnsmasq to serve MX records.
8# Only one of mx-host and mx-target need be set, the other defaults
9# to the name of the host  running dnsmasq.
10#mx-host=
11#mx-target=
12#selfmx
13#localmx
14
15# The following two options make you a better netizen, since they 
16# tell dnsmasq to filter out queries which the public DNS cannot
17# answer, and which load the servers (especially the root servers) 
18# uneccessarily. If you have a dial-on-demand link they also stop
19# these requests from bringing up the link uneccessarily.
20
21# Never forward plain names (with a dot or domain part)
22domain-needed
23# Never forward addresses in the non-routed address spaces.
24bogus-priv
25
26
27# Uncomment this to filter useless windows-originated DNS requests
28# which can trigger dial-on-demand links needlessly.
29# Note that (amongst other things) this blocks all SRV requests, 
30# so don't use it if you use eg Kerberos.
31#filterwin2k
32
33# Change this line if you want dns to get its upstream servers from
34# somewhere other that /etc/resolv.conf 
35#resolv-file=
36
37# By  default,  dnsmasq  will  send queries to any of the upstream
38# servers it knows about and tries to favour servers to are  known
39# to  be  up.  Uncommenting this forces dnsmasq to try each query
40# with  each  server  strictly  in  the  order  they   appear   in
41# /etc/resolv.conf
42#strict-order
43
44# If you don't want dnsmasq to read /etc/resolv.conf or any other
45# file, getting its servers for this file instead (see below), then
46# uncomment this
47#no-resolv
48
49# If you don't want dnsmasq to poll /etc/resolv.conf or other resolv
50# files for changes and re-read them then uncomment this.
51#no-poll
52
53# Add other name servers here, with domain specs if they are for 
54# non-public domains.
55#server=/localnet/192.168.0.1
56
57# Add local-only domains here, queries in these domains are answered
58# from /etc/hosts or DHCP only.
59#local=/localnet/
60
61# Add domains which you want to force to an IP address here.
62# The example below send any host in doubleclick.net to a local
63# webserver.
64#address=/doubleclick.net/127.0.0.1
65
66# You no longer (as of version 1.7) need to set these to enable 
67# dnsmasq to read /etc/ppp/resolv.conf since dnsmasq now uses the
68# "dip" group to achieve this.
69#user=
70#group=
71
72# If you want dnsmasq to listen for requests only on specified interfaces
73# (and the loopback) give the name of the interface (eg eth0) here. 
74# Repeat the line for more than one interface.
75#interface=
76# Or you can specify which interface _not_ to listen on
77#except-interface=
78# Or which to listen on by address (remember to include 127.0.0.1 if
79# you use this.)
80#listen-address=
81
82# On systems which support it, dnsmasq binds the wildcard address,
83# even when it is listening on only some interfaces. It then discards
84# requests that it shouldn't reply to. This has the advantage of 
85# working even when interfaces come and go and change address. If you
86# want dnsmasq to really bind only the interfaces it is listening on,
87# uncomment this option. About the only time you may need this is when 
88# running another nameserver on the same machine.
89#bind-interfaces 
90
91# If you don't want dnsmasq to read /etc/hosts, uncomment the
92# following line.
93#no-hosts
94# or if you want it to read another file, as well as /etc/hosts, use
95# this.
96#addn-hosts=/etc/banner_add_hosts
97
98# Set this (and domain: see below) if you want to have a domain
99# automatically added to simple names in a hosts-file.
100#expand-hosts
101
102# Set the domain for dnsmasq. this is optional, but if it is set, it
103# does the following things.
104# 1) Allows DHCP hosts to have fully qualified domain names, as long
105#     as the domain part matches this setting.
106# 2) Sets the "domain" DHCP option thereby potentially setting the
107#    domain of all systems configured by DHCP
108# 3) Provides the domain part for "expand-hosts"
109#domain=thekelleys.org.uk
110  
111# Uncomment this to enable the integrated DHCP server, you need
112# to supply the range of addresses available for lease and optionally 
113# a lease time. If you have more than one network, you will need to
114# repeat this for each network on which you want to supply DHCP
115# service.
116#dhcp-range=192.168.0.50,192.168.0.150,12h
117
118# This is an example of a DHCP range where the netmask is given. This
119# is needed for networks we reach the dnsmasq DHCP server via a relay 
120# agent. If you don't know what a DHCP relay agent is, you probably
121# don't need to worry about this.
122#dhcp-range=192.168.0.50,192.168.0.150,255.255.255.0,12h
123
124# This is an example of a DHCP range with a network-id, so that
125# some DHCP options may be set only for this network.
126#dhcp-range=red,192.168.0.50,192.168.0.150
127
128# Supply parameters for specified hosts using DHCP. There are lots
129# of valid alternatives, so we will give examples of each. Note that
130# IP addresses DO NOT have to be in the range given above, they just
131# need to be on the same network. The order of the parameters in these
132# do not matter, it's permissble to give name,adddress and MAC in any order
133
134# Always allocate the host with ethernet address 11:22:33:44:55:66 
135# The IP address 192.168.0.60
136#dhcp-host=11:22:33:44:55:66,192.168.0.60
137
138# Always set the name of the host with hardware address
139# 11:22:33:44:55:66 to be "fred"
140#dhcp-host=11:22:33:44:55:66,fred
141
142# Always give the host with ethernet address 11:22:33:44:55:66
143# the name fred and IP address 192.168.0.60 and lease time 45 minutes
144#dhcp-host=11:22:33:44:55:66,fred,192.168.0.60,45m
145
146# Give the machine which says it's name is "bert" IP address
147# 192.168.0.70 and an infinite lease
148#dhcp-host=bert,192.168.0.70,infinite
149
150# Always give the host with client identifier 01:02:02:04 
151# the IP address 192.168.0.60
152#dhcp-host=id:01:02:02:04,192.168.0.60
153
154# Always give the host with client identifier "marjorie"
155# the IP address 192.168.0.60
156#dhcp-host=id:marjorie,192.168.0.60
157
158# Enable the address given for "judge" in /etc/hosts
159# to be given to a machine presenting the name "judge" when
160# it asks for a DHCP lease.
161#dhcp-host=judge
162
163# Never offer DHCP service to a machine whose ethernet 
164# address is 11:22:33:44:55:66
165#dhcp-host=11:22:33:44:55:66,ignore
166
167# Ignore any client-id presented by the machine with ethernet
168# address 11:22:33:44:55:66. This is useful to prevent a machine 
169# being treated differently when running under different OS's or
170# between PXE boot and OS boot.
171#dhcp-host=11:22:33:44:55:66,id:*
172
173# Send extra options which are tagged as "red" to 
174# the machine with ethernet address 11:22:33:44:55:66
175#dhcp-host=11:22:33:44:55:66,net:red
176
177# Send extra options which are tagged as "red" to any machine whose
178# DHCP vendorclass string includes the substring "Linux"
179#dhcp-vendorclass=red,Linux
180
181# Send extra options which are tagged as "red" to any machine one 
182# of whose DHCP userclass strings includes the substring "accounts"
183#dhcp-userclass=red,accounts
184
185# If this line is uncommented, dnsmasq will read /etc/ethers and act
186# on the ethernet-address/IP pairs found there just as if they had
187# been given as --dhcp-host options. Useful if you keep
188# MAC-address/host mappings there for other purposes.
189#read-ethers
190
191# Send options to hosts which ask for a DHCP lease.
192# See RFC 2132 for details of available options.
193# Note that all the common settings, such as netmask and
194# broadcast address, DNS server and default route, are given
195# sane defaults by dnsmasq. You very likely will not need any
196# any dhcp-options. If you use Windows clients and Samba, there
197# are some options which are recommended, they are detailed at the
198# end of this section.
199# For reference, the common options are:
200# subnet mask - 1
201# default router - 3
202# DNS server - 6
203# broadcast address - 28
204
205# Set the NTP time server addresses to 192.168.0.4 and 10.10.0.5
206#dhcp-option=42,192.168.0.4,10.10.0.5
207
208# Set the NTP time server address to be the same machine as 
209# is running dnsmasq
210#dhcp-option=42,0.0.0.0
211
212# Set the NIS domain name to "welly"
213#dhcp-option=40,welly
214
215# Set the default time-to-live to 50
216#dhcp-option=23,50
217
218# Set the "all subnets are local" flag
219#dhcp-option=27,1
220
221# Send the etherboot magic flag and then etherboot options (a string).
222#dhcp-option=128,e4:45:74:68:00:00
223#dhcp-option=129,NIC=eepro100
224
225# Specify an option which will only be sent to the "red" network 
226# (see dhcp-range for the declaration of the "red" network)
227#dhcp-option=red,42,192.168.1.1
228
229# The following DHCP options set up dnsmasq in the same way as is specified
230# for the ISC dhcpcd in 
231# http://www.samba.org/samba/ftp/docs/textdocs/DHCP-Server-Configuration.txt
232# adapted for a typical dnsmasq installation where the host running
233# dnsmasq is also the host running samba.
234# you may want to uncomment them if you use Windows clients and Samba.
235#dhcp-option=19,0           # option ip-forwarding off 
236#dhcp-option=44,0.0.0.0     # set netbios-over-TCP/IP nameserver(s) aka WINS server(s)
237#dhcp-option=45,0.0.0.0     # netbios datagram distribution server
238#dhcp-option=46,8           # netbios node type
239#dhcp-option=47             # empty netbios scope.
240 
241
242# Set the boot filename and tftpd server name and address
243# for BOOTP. You will only need this is you want to
244# boot machines over the network.
245#dhcp-boot=/var/ftpd/pxelinux.0,boothost,192.168.0.3
246
247# Set the limit on DHCP leases, the default is 150
248#dhcp-lease-max=150
249
250# The DHCP server needs somewhere on disk to keep its lease database.
251# This defaults to a sane location, but if you want to change it, use
252# the line below.
253#dhcp-leasefile=/var/lib/misc/dnsmasq.leases
254
255# Set the cachesize here.
256#cache-size=150
257
258# If you want to disable negative caching, uncomment this.
259#no-negcache
260
261# Normally responses which come form /etc/hosts and the DHCP lease
262# file have Time-To-Live set as zero, which conventionally means
263# do not cache further. If you are happy to trade lower load on the 
264# server for potentially stale date, you can set a time-to-live (in 
265# seconds) here.
266#local-ttl=
267
268# If you want dnsmasq to detect attempts by Verisign to send queries
269# to unregistered .com and .net hosts to its sitefinder service and
270# have dnsmasq instead return the correct NXDOMAIN response, uncomment
271# this line. You can add similar lines to do the same for other
272# registries which have implemented wildcard A records.
273#bogus-nxdomain=64.94.110.11
274
275# If you want to fix up DNS results from upstream servers, use the
276# alias option. This only works for IPv4.
277# This alias makes a result of 1.2.3.4 appear as 5.6.7.8
278#alias=1.2.3.4,5.6.7.8
279# and this maps 1.2.3.x to 5.6.7.x
280#alias=1.2.3.0,5.6.7.0,255.255.255.0
281
282# For debugging purposes, log each DNS query as it passes through
283# dnsmasq.
284#log-queries
285
286# Include a another lot of configuration options.
287#conf-file=/etc/dnsmasq.more.conf
288 
289 
290
291
292
293