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