blob: 7fbe6690245211483447b1dc0bdb2bac4f842e86 [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
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 three 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# Reply to reverse queries for addresses in the non-routed address
24# space with the dotted.quad address
25bogus-priv
26# Filter useless windows-originated DNS requests
27filterwin2k
28
29
30# Change this line if you want dns to get its upstream servers from
31# somewhere other that /etc/resolv.conf
32#resolv-file=
33
Simon Kelley1ab84e22004-01-29 16:48:35 +000034# By default, dnsmasq will send queries to any of the upstream
35# servers it knows about and tries to favour servers to are known
36# to be up. Uncommenting this forces dnsmasq to try each query
37# with each server strictly in the order they appear in
38# /etc/resolv.conf
39#strict-order
40
Simon Kelley9e4abcb2004-01-22 19:47:41 +000041# If you don't want dnsmasq to read /etc/resolv.conf or any other
42# file, getting its servers for this file instead (see below), then
43# uncomment this
44#no-resolv
45
46# If you don't want dnsmasq to poll /etc/resolv.conf or other resolv
47# files for changes and re-read them then uncomment this.
48#no-poll
49
50# Add other name servers here, with domain specs if they are for
51# non-public domains.
52#server=/localnet/192.168.0.1
53
54# Add local-only domains here, queries in these domains are answered
55# from /etc/hosts or DHCP only.
56#local=/localnet/
57
58# Add domains which you want to force to an IP address here.
59# The example below send any host in doubleclick.net to a local
60# webserver.
61#address=/doubleclick.net/127.0.0.1
62
63# You no longer (as of version 1.7) need to set these to enable
64# dnsmasq to read /etc/ppp/resolv.conf since dnsmasq now uses the
65# "dip" group to achieve this.
66#user=
67#group=
68
69# If you want dnsmasq to listen for requests only on specified interfaces
70# (and the loopback) give the name of the interface (eg eth0) here.
71# Repeat the line for more than one interface.
72#interface=
73# Or you can specify which interface _not_ to listen on
74#except-interface=
75# Or which to listen on by address (remember to include 127.0.0.1 if
76# you use this.)
77#listen-address=
78
79# If you don't want dnsmasq to read /etc/hosts, uncomment the
80# following line.
81#no-hosts
82# or if you want it to read another file, as well as /etc/hosts, use
83# this.
84#addn-hosts=/etc/banner_add_hosts
85
86# Set this (and domain: see below) if you want to have a domain
87# automatically added to simple names in a hosts-file.
88#expand-hosts
89
90# Uncomment this to enable the integrated DHCP server, you need
91# to supply the range of addresses available for lease and optionally
92# a lease time. If you have more than one interface, you will need to
93# repeat this for each interface on which you want to supply DHCP
94# service.
95#dhcp-range=192.168.0.50,192.168.0.150,12h
96
97# Supply parameters for specified hosts using DHCP. There are lots
Simon Kelley1ab84e22004-01-29 16:48:35 +000098# of valid alternatives, so we will give examples of each. Note that
Simon Kelley9e4abcb2004-01-22 19:47:41 +000099# IP addresses DO NOT have to be in the range given above, they just
Simon Kelley1ab84e22004-01-29 16:48:35 +0000100# need to be on the same network. The order of the parameters in these
101# do not matter, it's permissble to give name,adddress and MAC in any order
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000102
103# Always allocate the host with ethernet address 11:22:33:44:55:66
104# The IP address 192.168.0.60
105#dhcp-host=11:22:33:44:55:66,192.168.0.60
106
107# Always set the name of the host with hardware address
108# 11:22:33:44:55:66 to be "fred"
109#dhcp-host=11:22:33:44:55:66,fred
110
111# Always give the host with ethernet address 11:22:33:44:55:66
112# the name fred and IP address 192.168.0.60 and lease time 45 minutes
113#dhcp-host=11:22:33:44:55:66,fred,192.168.0.60,45m
114
115# Give the machine which says it's name is "bert" IP address
116# 192.168.0.70 and an infinite lease
117#dhcp-host=bert,192.168.0.70,infinite
118
119# Always give the host with client identifier 01:02:02:04
120# the IP address 192.168.0.60
121#dhcp-host=id:01:02:02:04,192.168.0.60
122
123# Always give the host with client identifier "marjorie"
124# the IP address 192.168.0.60
125#dhcp-host=id:marjorie,192.168.0.60
126
Simon Kelley1ab84e22004-01-29 16:48:35 +0000127# Enable the address given for "judge" in /etc/hosts
128# to be given to a machine presenting the name "judge" when
129# it asks for a DHCP lease.
130#dhcp-host=judge
131
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000132# Send options to hosts which ask for a DHCP lease.
133# See RFC 2132 for details of available options.
Simon Kelley1ab84e22004-01-29 16:48:35 +0000134# Note that all the common settings, such as netmask and
135# broadcast address, DNS server and default route, are given
136# sane defaults by dnsmasq. You very likely will not need any
137# any dhcp-options. If you use Windows clients and Samba, there
138# are some options which are recommended, they are detailed at the
139# end of this section.
140# For reference, the common options are:
141# subnet mask - 1
142# default router - 3
143# DNS server - 6
144# broadcast address - 28
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000145
146# Set the NTP time server addresses to 192.168.0.4 and 10.10.0.5
147#dhcp-option=42,192.168.0.4,10.10.0.5
148
Simon Kelley1ab84e22004-01-29 16:48:35 +0000149# Set the NTP time server address to be the same machine as
150# is running dnsmasq
151#dhcp-option=42,0.0.0.0
152
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000153# Set the NIS domain name to "welly"
154#dhcp-option=40,welly
155
Simon Kelley1ab84e22004-01-29 16:48:35 +0000156# Set the default time-to-live to 50
157#dhcp-option=23,50
158
159# Set the "all subnets are local" flag
160#dhcp-option=27,1
161
162# The following DHCP options set up dnsmasq in the same way as is specified
163# for the ISC dhcpcd in
164# http://www.samba.org/samba/ftp/docs/textdocs/DHCP-Server-Configuration.txt
165# adapted for a typical dnsmasq installation where the host running
166# dnsmasq is also the host running samba.
167# you may want to uncomment them if you use Windows clients and Samba.
168#dhcp-option=19,0 # option ip-forwarding off
169#dhcp-option=44,0.0.0.0 # set netbios-over-TCP/IP nameserver(s) aka WINS server(s)
170#dhcp-option=45,0.0.0.0 # netbios datagram distribution server
171#dhcp-option=46,8 # netbios node type
172#dhcp-option=47 # empty netbios scope.
173
174
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000175# Set the boot filename and tftpd server name and address
176# for BOOTP. You will only need this is you want to
177# boot machines over the network.
178#dhcp-boot=/var/ftpd/pxelinux.0,boothost,192.168.0.3
179
180# The DHCP server needs somewhere on disk to keep its lease database.
181# This defaults to a sane location, but if you want to change it, use
182# the line below.
Simon Kelley1ab84e22004-01-29 16:48:35 +0000183#dhcp-leasefile=/var/lib/misc/dnsmasq.leases
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000184
185# Set the cachesize here.
Simon Kelley1ab84e22004-01-29 16:48:35 +0000186#cache-size=150
Simon Kelley9e4abcb2004-01-22 19:47:41 +0000187
188# If you want to disable negative caching, uncomment this.
189#no-negcache
190
191# Normally responses which come form /etc/hosts and the DHCP lease
192# file have Time-To-Live set as zero, which conventionally means
193# do not cache further. If you are happy to trade lower load on the
194# server for potentially stale date, you can set a time-to-live (in
195# seconds) here.
196#local-ttl=
197
198# If you want dnsmasq to detect attempts by Verisign to send queries
199# to unregistered .com and .net hosts to its sitefinder service and
200# have dnsmasq instead return the correct NXDOMAIN response, uncomment
201# this line. You can add similar lines to do the same for other
202# registries which have implemented wildcard A records.
203#bogus-nxdomain=64.94.110.11
204
205# For debugging purposes, log each DNS query as it passes through
206# dnsmasq.
207#log-queries
208
209
210
211
212
213