Blame | Last modification | View Log | RSS feed
# Configuration file for dnsmasq.## Format is one option per line, legal options are the same# as the long options legal on the command line. See# "/usr/sbin/dnsmasq --help" or "man 8 dnsmasq" for details.# The following two options make you a better netizen, since they# tell dnsmasq to filter out queries which the public DNS cannot# answer, and which load the servers (especially the root servers)# uneccessarily. If you have a dial-on-demand link they also stop# these requests from bringing up the link uneccessarily.# Never forward plain names (without a dot or domain part)#domain-needed# Never forward addresses in the non-routed address spaces.#bogus-priv# Uncomment this to filter useless windows-originated DNS requests# which can trigger dial-on-demand links needlessly.# Note that (amongst other things) this blocks all SRV requests,# so don't use it if you use eg Kerberos, SIP, XMMP or Google-talk.# This option only affects forwarding, SRV records originating for# dnsmasq (via srv-host= lines) are not suppressed by it.#filterwin2k# Change this line if you want dns to get its upstream servers from# somewhere other that /etc/resolv.conf#resolv-file=# By default, dnsmasq will send queries to any of the upstream# servers it knows about and tries to favour servers to are known# to be up. Uncommenting this forces dnsmasq to try each query# with each server strictly in the order they appear in# /etc/resolv.conf#strict-order# If you don't want dnsmasq to read /etc/resolv.conf or any other# file, getting its servers from this file instead (see below), then# uncomment this.#no-resolv# If you don't want dnsmasq to poll /etc/resolv.conf or other resolv# files for changes and re-read them then uncomment this.#no-poll# Add other name servers here, with domain specs if they are for# non-public domains.#server=/localnet/192.168.0.1# Example of routing PTR queries to nameservers: this will send all# address->name queries for 192.168.3/24 to nameserver 10.1.2.3#server=/3.168.192.in-addr.arpa/10.1.2.3# Add local-only domains here, queries in these domains are answered# from /etc/hosts or DHCP only.#local=/localnet/# Add domains which you want to force to an IP address here.# The example below send any host in doubleclick.net to a local# webserver.#address=/doubleclick.net/127.0.0.1# --address (and --server) work with IPv6 addresses too.#address=/www.thekelleys.org.uk/fe80::20d:60ff:fe36:f83# You can control how dnsmasq talks to a server: this forces# queries to 10.1.2.3 to be routed via eth1# --server=10.1.2.3@eth1# and this sets the source (ie local) address used to talk to# 10.1.2.3 to 192.168.1.1 port 55 (there must be a interface with that# IP on the machine, obviously).# --server=10.1.2.3@192.168.1.1#55# If you want dnsmasq to change uid and gid to something other# than the default, edit the following lines.#user=#group=# If you want dnsmasq to listen for DHCP and DNS requests only on# specified interfaces (and the loopback) give the name of the# interface (eg eth0) here.# Repeat the line for more than one interface.#interface=# Or you can specify which interface _not_ to listen on#except-interface=# Or which to listen on by address (remember to include 127.0.0.1 if# you use this.)#listen-address=# If you want dnsmasq to provide only DNS service on an interface,# configure it as shown above, and then use the following line to# disable DHCP on it.#no-dhcp-interface=# On systems which support it, dnsmasq binds the wildcard address,# even when it is listening on only some interfaces. It then discards# requests that it shouldn't reply to. This has the advantage of# working even when interfaces come and go and change address. If you# want dnsmasq to really bind only the interfaces it is listening on,# uncomment this option. About the only time you may need this is when# running another nameserver on the same machine.#bind-interfaces# If you don't want dnsmasq to read /etc/hosts, uncomment the# following line.#no-hosts# or if you want it to read another file, as well as /etc/hosts, use# this.#addn-hosts=/etc/banner_add_hosts# Set this (and domain: see below) if you want to have a domain# automatically added to simple names in a hosts-file.#expand-hosts# Set the domain for dnsmasq. this is optional, but if it is set, it# does the following things.# 1) Allows DHCP hosts to have fully qualified domain names, as long# as the domain part matches this setting.# 2) Sets the "domain" DHCP option thereby potentially setting the# domain of all systems configured by DHCP# 3) Provides the domain part for "expand-hosts"#domain=thekelleys.org.uk# Set a different domain for a particular subnet#domain=wireless.thekelleys.org.uk,192.168.2.0/24# Same idea, but range rather then subnet#domain=reserved.thekelleys.org.uk,192.68.3.100,192.168.3.200# Uncomment this to enable the integrated DHCP server, you need# to supply the range of addresses available for lease and optionally# a lease time. If you have more than one network, you will need to# repeat this for each network on which you want to supply DHCP# service.#dhcp-range=192.168.0.50,192.168.0.150,12h# This is an example of a DHCP range where the netmask is given. This# is needed for networks we reach the dnsmasq DHCP server via a relay# agent. If you don't know what a DHCP relay agent is, you probably# don't need to worry about this.#dhcp-range=192.168.0.50,192.168.0.150,255.255.255.0,12h# This is an example of a DHCP range with a network-id, so that# some DHCP options may be set only for this network.#dhcp-range=red,192.168.0.50,192.168.0.150# Supply parameters for specified hosts using DHCP. There are lots# of valid alternatives, so we will give examples of each. Note that# IP addresses DO NOT have to be in the range given above, they just# need to be on the same network. The order of the parameters in these# do not matter, it's permissble to give name,adddress and MAC in any order# Always allocate the host with ethernet address 11:22:33:44:55:66# The IP address 192.168.0.60#dhcp-host=11:22:33:44:55:66,192.168.0.60# Always set the name of the host with hardware address# 11:22:33:44:55:66 to be "fred"#dhcp-host=11:22:33:44:55:66,fred# Always give the host with ethernet address 11:22:33:44:55:66# the name fred and IP address 192.168.0.60 and lease time 45 minutes#dhcp-host=11:22:33:44:55:66,fred,192.168.0.60,45m# Give a host with ethernet address 11:22:33:44:55:66 or# 12:34:56:78:90:12 the IP address 192.168.0.60. Dnsmasq will assume# that these two ethernet interfaces will never be in use at the same# time, and give the IP address to the second, even if it is already# in use by the first. Useful for laptops with wired and wireless# addresses.#dhcp-host=11:22:33:44:55:66,12:34:56:78:90:12,192.168.0.60# Give the machine which says its name is "bert" IP address# 192.168.0.70 and an infinite lease#dhcp-host=bert,192.168.0.70,infinite# Always give the host with client identifier 01:02:02:04# the IP address 192.168.0.60#dhcp-host=id:01:02:02:04,192.168.0.60# Always give the host with client identifier "marjorie"# the IP address 192.168.0.60#dhcp-host=id:marjorie,192.168.0.60# Enable the address given for "judge" in /etc/hosts# to be given to a machine presenting the name "judge" when# it asks for a DHCP lease.#dhcp-host=judge# Never offer DHCP service to a machine whose ethernet# address is 11:22:33:44:55:66#dhcp-host=11:22:33:44:55:66,ignore# Ignore any client-id presented by the machine with ethernet# address 11:22:33:44:55:66. This is useful to prevent a machine# being treated differently when running under different OS's or# between PXE boot and OS boot.#dhcp-host=11:22:33:44:55:66,id:*# Send extra options which are tagged as "red" to# the machine with ethernet address 11:22:33:44:55:66#dhcp-host=11:22:33:44:55:66,net:red# Send extra options which are tagged as "red" to# any machine with ethernet address starting 11:22:33:#dhcp-host=11:22:33:*:*:*,net:red# Ignore any clients which are specified in dhcp-host lines# or /etc/ethers. Equivalent to ISC "deny unkown-clients".# This relies on the special "known" tag which is set when# a host is matched.#dhcp-ignore=#known# Send extra options which are tagged as "red" to any machine whose# DHCP vendorclass string includes the substring "Linux"#dhcp-vendorclass=red,Linux# Send extra options which are tagged as "red" to any machine one# of whose DHCP userclass strings includes the substring "accounts"#dhcp-userclass=red,accounts# Send extra options which are tagged as "red" to any machine whose# MAC address matches the pattern.#dhcp-mac=red,00:60:8C:*:*:*# If this line is uncommented, dnsmasq will read /etc/ethers and act# on the ethernet-address/IP pairs found there just as if they had# been given as --dhcp-host options. Useful if you keep# MAC-address/host mappings there for other purposes.#read-ethers# Send options to hosts which ask for a DHCP lease.# See RFC 2132 for details of available options.# Common options can be given to dnsmasq by name:# run "dnsmasq --help dhcp" to get a list.# Note that all the common settings, such as netmask and# broadcast address, DNS server and default route, are given# sane defaults by dnsmasq. You very likely will not need# any dhcp-options. If you use Windows clients and Samba, there# are some options which are recommended, they are detailed at the# end of this section.# Override the default route supplied by dnsmasq, which assumes the# router is the same machine as the one running dnsmasq.#dhcp-option=3,1.2.3.4# Do the same thing, but using the option name#dhcp-option=option:router,1.2.3.4# Override the default route supplied by dnsmasq and send no default# route at all. Note that this only works for the options sent by# default (1, 3, 6, 12, 28) the same line will send a zero-length option# for all other option numbers.#dhcp-option=3# Set the NTP time server addresses to 192.168.0.4 and 10.10.0.5#dhcp-option=option:ntp-server,192.168.0.4,10.10.0.5# Set the NTP time server address to be the same machine as# is running dnsmasq#dhcp-option=42,0.0.0.0# Set the NIS domain name to "welly"#dhcp-option=40,welly# Set the default time-to-live to 50#dhcp-option=23,50# Set the "all subnets are local" flag#dhcp-option=27,1# Send the etherboot magic flag and then etherboot options (a string).#dhcp-option=128,e4:45:74:68:00:00#dhcp-option=129,NIC=eepro100# Specify an option which will only be sent to the "red" network# (see dhcp-range for the declaration of the "red" network)# Note that the net: part must precede the option: part.#dhcp-option = net:red, option:ntp-server, 192.168.1.1# The following DHCP options set up dnsmasq in the same way as is specified# for the ISC dhcpcd in# http://www.samba.org/samba/ftp/docs/textdocs/DHCP-Server-Configuration.txt# adapted for a typical dnsmasq installation where the host running# dnsmasq is also the host running samba.# you may want to uncomment some or all of them if you use# Windows clients and Samba.#dhcp-option=19,0 # option ip-forwarding off#dhcp-option=44,0.0.0.0 # set netbios-over-TCP/IP nameserver(s) aka WINS server(s)#dhcp-option=45,0.0.0.0 # netbios datagram distribution server#dhcp-option=46,8 # netbios node type# Send RFC-3397 DNS domain search DHCP option. WARNING: Your DHCP client# probably doesn't support this......#dhcp-option=option:domain-search,eng.apple.com,marketing.apple.com# Send RFC-3442 classless static routes (note the netmask encoding)#dhcp-option=121,192.168.1.0/24,1.2.3.4,10.0.0.0/8,5.6.7.8# Send vendor-class specific options encapsulated in DHCP option 43.# The meaning of the options is defined by the vendor-class so# options are sent only when the client supplied vendor class# matches the class given here. (A substring match is OK, so "MSFT"# matches "MSFT" and "MSFT 5.0"). This example sets the# mtftp address to 0.0.0.0 for PXEClients.#dhcp-option=vendor:PXEClient,1,0.0.0.0# Send microsoft-specific option to tell windows to release the DHCP lease# when it shuts down. Note the "i" flag, to tell dnsmasq to send the# value as a four-byte integer - that's what microsoft wants. See# http://technet2.microsoft.com/WindowsServer/en/library/a70f1bb7-d2d4-49f0-96d6-4b7414ecfaae1033.mspx?mfr=true#dhcp-option=vendor:MSFT,2,1i# Send the Encapsulated-vendor-class ID needed by some configurations of# Etherboot to allow is to recognise the DHCP server.#dhcp-option=vendor:Etherboot,60,"Etherboot"# Send options to PXELinux. Note that we need to send the options even# though they don't appear in the parameter request list, so we need# to use dhcp-option-force here.# See http://syslinux.zytor.com/pxe.php#special for details.# Magic number - needed before anything else is recognised#dhcp-option-force=208,f1:00:74:7e# Configuration file name#dhcp-option-force=209,configs/common# Path prefix#dhcp-option-force=210,/tftpboot/pxelinux/files/# Reboot time. (Note 'i' to send 32-bit value)#dhcp-option-force=211,30i# Set the boot filename for netboot/PXE. You will only need# this is you want to boot machines over the network and you will need# a TFTP server; either dnsmasq's built in TFTP server or an# external one. (See below for how to enable the TFTP server.)#dhcp-boot=pxelinux.0# Boot for Etherboot gPXE. The idea is to send two different# filenames, the first loads gPXE, and the second tells gPXE what to# load. The dhcp-match sets the gpxe tag for requests from gPXE.#dhcp-match=gpxe,175 # gPXE sends a 175 option.#dhcp-boot=net:#gpxe,undionly.kpxe#dhcp-boot=mybootimage# Encapsulated options for Etherboot gPXE. All the options are# encapsulated within option 175#dhcp-option=encap:175, 1, 5b # priority code#dhcp-option=encap:175, 176, 1b # no-proxydhcp#dhcp-option=encap:175, 177, string # bus-id#dhcp-option=encap:175, 189, 1b # BIOS drive code#dhcp-option=encap:175, 190, user # iSCSI username#dhcp-option=encap:175, 191, pass # iSCSI password# Test for the architecture of a netboot client. PXE clients are# supposed to send their architecture as option 93. (See RFC 4578)#dhcp-match=peecees, option:client-arch, 0 #x86-32#dhcp-match=itanics, option:client-arch, 2 #IA64#dhcp-match=hammers, option:client-arch, 6 #x86-64#dhcp-match=mactels, option:client-arch, 7 #EFI x86-64# Do real PXE, rather than just booting a single file, this is an# alternative to dhcp-boot.#pxe-prompt="What system shall I netboot?"# or with timeout before first available action is taken:#pxe-prompt="Press F8 for menu.", 60# Available boot services. for PXE.#pxe-service=x86PC, "Boot from local disk", 0# Loads <tftp-root>/pxelinux.0 from dnsmasq TFTP server.#pxe-service=x86PC, "Install Linux", pxelinux# Loads <tftp-root>/pxelinux.0 from TFTP server at 1.2.3.4.# Beware this fails on old PXE ROMS.#pxe-service=x86PC, "Install Linux", pxelinux, 1.2.3.4# Use bootserver on network, found my multicast or broadcast.#pxe-service=x86PC, "Install windows from RIS server", 1# Use bootserver at a known IP address.#pxe-service=x86PC, "Install windows from RIS server", 1, 1.2.3.4# If you have multicast-FTP available,# information for that can be passed in a similar way using options 1# to 5. See page 19 of# http://download.intel.com/design/archives/wfm/downloads/pxespec.pdf# Enable dnsmasq's built-in TFTP server#enable-tftp# Set the root directory for files availble via FTP.#tftp-root=/var/ftpd# Make the TFTP server more secure: with this set, only files owned by# the user dnsmasq is running as will be send over the net.#tftp-secure# Set the boot file name only when the "red" tag is set.#dhcp-boot=net:red,pxelinux.red-net# An example of dhcp-boot with an external TFTP server: the name and IP# address of the server are given after the filename.# Can fail with old PXE ROMS. Overridden by --pxe-service.#dhcp-boot=/var/ftpd/pxelinux.0,boothost,192.168.0.3# Set the limit on DHCP leases, the default is 150#dhcp-lease-max=150# The DHCP server needs somewhere on disk to keep its lease database.# This defaults to a sane location, but if you want to change it, use# the line below.#dhcp-leasefile=/var/lib/dnsmasq/dnsmasq.leases# Set the DHCP server to authoritative mode. In this mode it will barge in# and take over the lease for any client which broadcasts on the network,# whether it has a record of the lease or not. This avoids long timeouts# when a machine wakes up on a new network. DO NOT enable this if there's# the slighest chance that you might end up accidentally configuring a DHCP# server for your campus/company accidentally. The ISC server uses# the same option, and this URL provides more information:# http://www.isc.org/index.pl?/sw/dhcp/authoritative.php#dhcp-authoritative# Run an executable when a DHCP lease is created or destroyed.# The arguments sent to the script are "add" or "del",# then the MAC address, the IP address and finally the hostname# if there is one.#dhcp-script=/bin/echo# Set the cachesize here.#cache-size=150# If you want to disable negative caching, uncomment this.#no-negcache# Normally responses which come form /etc/hosts and the DHCP lease# file have Time-To-Live set as zero, which conventionally means# do not cache further. If you are happy to trade lower load on the# server for potentially stale date, you can set a time-to-live (in# seconds) here.#local-ttl=# If you want dnsmasq to detect attempts by Verisign to send queries# to unregistered .com and .net hosts to its sitefinder service and# have dnsmasq instead return the correct NXDOMAIN response, uncomment# this line. You can add similar lines to do the same for other# registries which have implemented wildcard A records.#bogus-nxdomain=64.94.110.11# If you want to fix up DNS results from upstream servers, use the# alias option. This only works for IPv4.# This alias makes a result of 1.2.3.4 appear as 5.6.7.8#alias=1.2.3.4,5.6.7.8# and this maps 1.2.3.x to 5.6.7.x#alias=1.2.3.0,5.6.7.0,255.255.255.0# and this maps 192.168.0.10->192.168.0.40 to 10.0.0.10->10.0.0.40#alias=192.168.0.10-192.168.0.40,10.0.0.0,255.255.255.0# Change these lines if you want dnsmasq to serve MX records.# Return an MX record named "maildomain.com" with target# servermachine.com and preference 50#mx-host=maildomain.com,servermachine.com,50# Set the default target for MX records created using the localmx option.#mx-target=servermachine.com# Return an MX record pointing to the mx-target for all local# machines.#localmx# Return an MX record pointing to itself for all local machines.#selfmx# Change the following lines if you want dnsmasq to serve SRV# records. These are useful if you want to serve ldap requests for# Active Directory and other windows-originated DNS requests.# See RFC 2782.# You may add multiple srv-host lines.# The fields are <name>,<target>,<port>,<priority>,<weight># If the domain part if missing from the name (so that is just has the# service and protocol sections) then the domain given by the domain=# config option is used. (Note that expand-hosts does not need to be# set for this to work.)# A SRV record sending LDAP for the example.com domain to# ldapserver.example.com port 289#srv-host=_ldap._tcp.example.com,ldapserver.example.com,389# A SRV record sending LDAP for the example.com domain to# ldapserver.example.com port 289 (using domain=)#domain=example.com#srv-host=_ldap._tcp,ldapserver.example.com,389# Two SRV records for LDAP, each with different priorities#srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,1#srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,2# A SRV record indicating that there is no LDAP server for the domain# example.com#srv-host=_ldap._tcp.example.com# The following line shows how to make dnsmasq serve an arbitrary PTR# record. This is useful for DNS-SD. (Note that the# domain-name expansion done for SRV records _does_not# occur for PTR records.)#ptr-record=_http._tcp.dns-sd-services,"New Employee Page._http._tcp.dns-sd-services"# Change the following lines to enable dnsmasq to serve TXT records.# These are used for things like SPF and zeroconf. (Note that the# domain-name expansion done for SRV records _does_not# occur for TXT records.)#Example SPF.#txt-record=example.com,"v=spf1 a -all"#Example zeroconf#txt-record=_http._tcp.example.com,name=value,paper=A4# Provide an alias for a "local" DNS name. Note that this _only_ works# for targets which are names from DHCP or /etc/hosts. Give host# "bert" another name, bertrand#cname=bertand,bert# For debugging purposes, log each DNS query as it passes through# dnsmasq.#log-queries# Log lots of extra information about DHCP transactions.#log-dhcp# Include a another lot of configuration options.#conf-file=/etc/dnsmasq.more.conf#conf-dir=/etc/dnsmasq.d