~cyphermox/ubuntu/precise/dnsmasq/dbus

« back to all changes in this revision

Viewing changes to dnsmasq.conf.example

  • Committer: Bazaar Package Importer
  • Author(s): Simon Kelley
  • Date: 2005-09-03 20:02:32 UTC
  • mfrom: (0.2.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20050903200232-76u3kbiz1hm4ok3u
Tags: 2.24-1
 * New upstream. (closes: #330422)
 * Fix typo and clean up dnsmasq.conf (closes: #326057) (closes: #304446)
 * Add build support for I18N and gettext.
 * Fixed manpage typos. (closes: #336413)
 * Create a dnsmasq-unique userid for the daemon to run as. (closes: #338353)

Show diffs side-by-side

added added

removed removed

Lines of Context:
4
4
# as the long options legal on the command line. See
5
5
# "/usr/sbin/dnsmasq --help" or "man 8 dnsmasq" for details.
6
6
 
7
 
# The following two options make you a better netizen, since they 
 
7
# The following two options make you a better netizen, since they
8
8
# tell dnsmasq to filter out queries which the public DNS cannot
9
 
# answer, and which load the servers (especially the root servers) 
 
9
# answer, and which load the servers (especially the root servers)
10
10
# uneccessarily. If you have a dial-on-demand link they also stop
11
11
# these requests from bringing up the link uneccessarily.
12
12
 
13
 
# Never forward plain names (with a dot or domain part)
 
13
# Never forward plain names (without a dot or domain part)
14
14
domain-needed
15
15
# Never forward addresses in the non-routed address spaces.
16
16
bogus-priv
18
18
 
19
19
# Uncomment this to filter useless windows-originated DNS requests
20
20
# which can trigger dial-on-demand links needlessly.
21
 
# Note that (amongst other things) this blocks all SRV requests, 
 
21
# Note that (amongst other things) this blocks all SRV requests,
22
22
# so don't use it if you use eg Kerberos.
23
23
# This option only affects forwarding, SRV records originating for
24
24
# dnsmasq (via srv-host= lines) are not suppressed by it.
25
25
#filterwin2k
26
26
 
27
27
# Change this line if you want dns to get its upstream servers from
28
 
# somewhere other that /etc/resolv.conf 
 
28
# somewhere other that /etc/resolv.conf
29
29
#resolv-file=
30
30
 
31
31
# By  default,  dnsmasq  will  send queries to any of the upstream
36
36
#strict-order
37
37
 
38
38
# If you don't want dnsmasq to read /etc/resolv.conf or any other
39
 
# file, getting its servers for this file instead (see below), then
 
39
# file, getting its servers from this file instead (see below), then
40
40
# uncomment this
41
41
#no-resolv
42
42
 
44
44
# files for changes and re-read them then uncomment this.
45
45
#no-poll
46
46
 
47
 
# Add other name servers here, with domain specs if they are for 
 
47
# Add other name servers here, with domain specs if they are for
48
48
# non-public domains.
49
49
#server=/localnet/192.168.0.1
50
50
 
62
62
#user=
63
63
#group=
64
64
 
65
 
# If you want dnsmasq to listen for requests only on specified interfaces
66
 
# (and the loopback) give the name of the interface (eg eth0) here. 
 
65
# If you want dnsmasq to listen for DHCP and DNS requests only on
 
66
# specified interfaces (and the loopback) give the name of the
 
67
# interface (eg eth0) here.
67
68
# Repeat the line for more than one interface.
68
69
#interface=
69
70
# Or you can specify which interface _not_ to listen on
71
72
# Or which to listen on by address (remember to include 127.0.0.1 if
72
73
# you use this.)
73
74
#listen-address=
 
75
# If you want dnsmasq to provide only DNS service on an interface,
 
76
# configure it as shown above, and then use the following line to
 
77
# disable DHCP on it.
 
78
#no-dhcp-interface=
74
79
 
75
80
# On systems which support it, dnsmasq binds the wildcard address,
76
81
# even when it is listening on only some interfaces. It then discards
77
 
# requests that it shouldn't reply to. This has the advantage of 
 
82
# requests that it shouldn't reply to. This has the advantage of
78
83
# working even when interfaces come and go and change address. If you
79
84
# want dnsmasq to really bind only the interfaces it is listening on,
80
 
# uncomment this option. About the only time you may need this is when 
 
85
# uncomment this option. About the only time you may need this is when
81
86
# running another nameserver on the same machine.
82
 
#bind-interfaces 
 
87
#bind-interfaces
83
88
 
84
89
# If you don't want dnsmasq to read /etc/hosts, uncomment the
85
90
# following line.
100
105
#    domain of all systems configured by DHCP
101
106
# 3) Provides the domain part for "expand-hosts"
102
107
#domain=thekelleys.org.uk
103
 
  
 
108
 
104
109
# Uncomment this to enable the integrated DHCP server, you need
105
 
# to supply the range of addresses available for lease and optionally 
 
110
# to supply the range of addresses available for lease and optionally
106
111
# a lease time. If you have more than one network, you will need to
107
112
# repeat this for each network on which you want to supply DHCP
108
113
# service.
109
114
#dhcp-range=192.168.0.50,192.168.0.150,12h
110
115
 
111
116
# This is an example of a DHCP range where the netmask is given. This
112
 
# is needed for networks we reach the dnsmasq DHCP server via a relay 
 
117
# is needed for networks we reach the dnsmasq DHCP server via a relay
113
118
# agent. If you don't know what a DHCP relay agent is, you probably
114
119
# don't need to worry about this.
115
120
#dhcp-range=192.168.0.50,192.168.0.150,255.255.255.0,12h
124
129
# need to be on the same network. The order of the parameters in these
125
130
# do not matter, it's permissble to give name,adddress and MAC in any order
126
131
 
127
 
# Always allocate the host with ethernet address 11:22:33:44:55:66 
 
132
# Always allocate the host with ethernet address 11:22:33:44:55:66
128
133
# The IP address 192.168.0.60
129
134
#dhcp-host=11:22:33:44:55:66,192.168.0.60
130
135
 
140
145
# 192.168.0.70 and an infinite lease
141
146
#dhcp-host=bert,192.168.0.70,infinite
142
147
 
143
 
# Always give the host with client identifier 01:02:02:04 
 
148
# Always give the host with client identifier 01:02:02:04
144
149
# the IP address 192.168.0.60
145
150
#dhcp-host=id:01:02:02:04,192.168.0.60
146
151
 
153
158
# it asks for a DHCP lease.
154
159
#dhcp-host=judge
155
160
 
156
 
# Never offer DHCP service to a machine whose ethernet 
 
161
# Never offer DHCP service to a machine whose ethernet
157
162
# address is 11:22:33:44:55:66
158
163
#dhcp-host=11:22:33:44:55:66,ignore
159
164
 
160
165
# Ignore any client-id presented by the machine with ethernet
161
 
# address 11:22:33:44:55:66. This is useful to prevent a machine 
 
166
# address 11:22:33:44:55:66. This is useful to prevent a machine
162
167
# being treated differently when running under different OS's or
163
168
# between PXE boot and OS boot.
164
169
#dhcp-host=11:22:33:44:55:66,id:*
165
170
 
166
 
# Send extra options which are tagged as "red" to 
 
171
# Send extra options which are tagged as "red" to
167
172
# the machine with ethernet address 11:22:33:44:55:66
168
173
#dhcp-host=11:22:33:44:55:66,net:red
169
174
 
170
 
# Send extra options which are tagged as "red" to 
 
175
# Send extra options which are tagged as "red" to
171
176
# any machine with ethernet address starting 11:22:33:
172
177
#dhcp-host=11:22:33:*:*:*,net:red
173
178
 
175
180
# DHCP vendorclass string includes the substring "Linux"
176
181
#dhcp-vendorclass=red,Linux
177
182
 
178
 
# Send extra options which are tagged as "red" to any machine one 
 
183
# Send extra options which are tagged as "red" to any machine one
179
184
# of whose DHCP userclass strings includes the substring "accounts"
180
185
#dhcp-userclass=red,accounts
181
186
 
202
207
# Set the NTP time server addresses to 192.168.0.4 and 10.10.0.5
203
208
#dhcp-option=42,192.168.0.4,10.10.0.5
204
209
 
205
 
# Set the NTP time server address to be the same machine as 
 
210
# Set the NTP time server address to be the same machine as
206
211
# is running dnsmasq
207
212
#dhcp-option=42,0.0.0.0
208
213
 
219
224
#dhcp-option=128,e4:45:74:68:00:00
220
225
#dhcp-option=129,NIC=eepro100
221
226
 
222
 
# Specify an option which will only be sent to the "red" network 
 
227
# Specify an option which will only be sent to the "red" network
223
228
# (see dhcp-range for the declaration of the "red" network)
224
229
#dhcp-option=red,42,192.168.1.1
225
230
 
226
231
# The following DHCP options set up dnsmasq in the same way as is specified
227
 
# for the ISC dhcpcd in 
 
232
# for the ISC dhcpcd in
228
233
# http://www.samba.org/samba/ftp/docs/textdocs/DHCP-Server-Configuration.txt
229
234
# adapted for a typical dnsmasq installation where the host running
230
235
# dnsmasq is also the host running samba.
231
236
# you may want to uncomment them if you use Windows clients and Samba.
232
 
#dhcp-option=19,0           # option ip-forwarding off 
 
237
#dhcp-option=19,0           # option ip-forwarding off
233
238
#dhcp-option=44,0.0.0.0     # set netbios-over-TCP/IP nameserver(s) aka WINS server(s)
234
239
#dhcp-option=45,0.0.0.0     # netbios datagram distribution server
235
240
#dhcp-option=46,8           # netbios node type
237
242
 
238
243
# Send RFC-3397 DNS domain search DHCP option. WARNING: Your DHCP client
239
244
# probably doesn't support this......
240
 
#dhcp-option=119,eng.apple.com,marketing.apple.com 
 
245
#dhcp-option=119,eng.apple.com,marketing.apple.com
241
246
 
242
247
# Send encapsulated vendor-class specific options. The vendor-class
243
248
# is sent as DHCP option 60, and all the options marked with the
244
249
# vendor class are send encapsulated in DHCP option 43. The meaning of
245
 
# the options is defined by the vendor-class. This example sets the 
 
250
# the options is defined by the vendor-class. This example sets the
246
251
# mtftp address to 0.0.0.0 for PXEClients
247
252
#dhcp-option=vendor:PXEClient,1,0.0.0.0
248
253
 
259
264
# the line below.
260
265
#dhcp-leasefile=/var/lib/misc/dnsmasq.leases
261
266
 
262
 
# Set the DHCP server to authoritative mode. In this mode it will barge in 
263
 
# and take over the lease for any client which broadcasts on the network, 
 
267
# Set the DHCP server to authoritative mode. In this mode it will barge in
 
268
# and take over the lease for any client which broadcasts on the network,
264
269
# whether it has a record of the lease or not. This avoids long timeouts
265
 
# when a machine wakes up on a new network. DO NOT enable this if there's 
 
270
# when a machine wakes up on a new network. DO NOT enable this if there's
266
271
# the slighest chance that you might end up accidentally configuring a DHCP
267
272
# server for your campus/company accidentally. The ISC server uses the same
268
273
# the same option, and this URL provides more information:
277
282
 
278
283
# Normally responses which come form /etc/hosts and the DHCP lease
279
284
# file have Time-To-Live set as zero, which conventionally means
280
 
# do not cache further. If you are happy to trade lower load on the 
281
 
# server for potentially stale date, you can set a time-to-live (in 
 
285
# do not cache further. If you are happy to trade lower load on the
 
286
# server for potentially stale date, you can set a time-to-live (in
282
287
# seconds) here.
283
288
#local-ttl=
284
289
 
313
318
# Return an MX record pointing to itself for all local machines.
314
319
#selfmx
315
320
 
316
 
# Change the following lines if you want dnsmasq to serve SRV 
 
321
# Change the following lines if you want dnsmasq to serve SRV
317
322
# records.  These are useful if you want to serve ldap requests for
318
323
# Active Directory and other windows-originated DNS requests.
319
324
# See RFC 2782.
320
 
# You may add multiple srv-host lines. 
 
325
# You may add multiple srv-host lines.
321
326
# The fields are <name>,<target>,<port>,<priority>,<weight>
322
327
# If the domain part if missing from the name (so that is just has the
323
328
# service and protocol sections) then the domain given by the domain=
338
343
#srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,2
339
344
 
340
345
# A SRV record indicating that there is no LDAP server for the domain
341
 
# example.com 
 
346
# example.com
342
347
#srv-host=_ldap._tcp.example.com
343
348
 
344
349
 
345
350
# Change the following lines to enable dnsmasq to serve TXT records.
346
351
# These are used for things like SPF and zeroconf. (Note that the
347
 
# domain-name expansion done for SRV records _does_not 
 
352
# domain-name expansion done for SRV records _does_not
348
353
# occur for TXT records.)
349
354
 
350
355
#Example SPF.
360
365
 
361
366
# Include a another lot of configuration options.
362
367
#conf-file=/etc/dnsmasq.more.conf
363
 
 
364
 
 
365
 
 
366
 
 
367