Annotation of embedaddon/dnsmasq/dnsmasq.conf.example, revision 1.1
1.1 ! misho 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: # The following two options make you a better netizen, since they
! 13: # tell dnsmasq to filter out queries which the public DNS cannot
! 14: # answer, and which load the servers (especially the root servers)
! 15: # unnecessarily. If you have a dial-on-demand link they also stop
! 16: # these requests from bringing up the link unnecessarily.
! 17:
! 18: # Never forward plain names (without a dot or domain part)
! 19: #domain-needed
! 20: # Never forward addresses in the non-routed address spaces.
! 21: #bogus-priv
! 22:
! 23:
! 24: # Uncomment this to filter useless windows-originated DNS requests
! 25: # which can trigger dial-on-demand links needlessly.
! 26: # Note that (amongst other things) this blocks all SRV requests,
! 27: # so don't use it if you use eg Kerberos, SIP, XMMP or Google-talk.
! 28: # This option only affects forwarding, SRV records originating for
! 29: # dnsmasq (via srv-host= lines) are not suppressed by it.
! 30: #filterwin2k
! 31:
! 32: # Change this line if you want dns to get its upstream servers from
! 33: # somewhere other that /etc/resolv.conf
! 34: #resolv-file=
! 35:
! 36: # By default, dnsmasq will send queries to any of the upstream
! 37: # servers it knows about and tries to favour servers to are known
! 38: # to be up. Uncommenting this forces dnsmasq to try each query
! 39: # with each server strictly in the order they appear in
! 40: # /etc/resolv.conf
! 41: #strict-order
! 42:
! 43: # If you don't want dnsmasq to read /etc/resolv.conf or any other
! 44: # file, getting its servers from this file instead (see below), then
! 45: # uncomment this.
! 46: #no-resolv
! 47:
! 48: # If you don't want dnsmasq to poll /etc/resolv.conf or other resolv
! 49: # files for changes and re-read them then uncomment this.
! 50: #no-poll
! 51:
! 52: # Add other name servers here, with domain specs if they are for
! 53: # non-public domains.
! 54: #server=/localnet/192.168.0.1
! 55:
! 56: # Example of routing PTR queries to nameservers: this will send all
! 57: # address->name queries for 192.168.3/24 to nameserver 10.1.2.3
! 58: #server=/3.168.192.in-addr.arpa/10.1.2.3
! 59:
! 60: # Add local-only domains here, queries in these domains are answered
! 61: # from /etc/hosts or DHCP only.
! 62: #local=/localnet/
! 63:
! 64: # Add domains which you want to force to an IP address here.
! 65: # The example below send any host in double-click.net to a local
! 66: # web-server.
! 67: #address=/double-click.net/127.0.0.1
! 68:
! 69: # --address (and --server) work with IPv6 addresses too.
! 70: #address=/www.thekelleys.org.uk/fe80::20d:60ff:fe36:f83
! 71:
! 72: # Add the IPs of all queries to yahoo.com, google.com, and their
! 73: # subdomains to the vpn and search ipsets:
! 74: #ipset=/yahoo.com/google.com/vpn,search
! 75:
! 76: # You can control how dnsmasq talks to a server: this forces
! 77: # queries to 10.1.2.3 to be routed via eth1
! 78: # server=10.1.2.3@eth1
! 79:
! 80: # and this sets the source (ie local) address used to talk to
! 81: # 10.1.2.3 to 192.168.1.1 port 55 (there must be a interface with that
! 82: # IP on the machine, obviously).
! 83: # server=10.1.2.3@192.168.1.1#55
! 84:
! 85: # If you want dnsmasq to change uid and gid to something other
! 86: # than the default, edit the following lines.
! 87: #user=
! 88: #group=
! 89:
! 90: # If you want dnsmasq to listen for DHCP and DNS requests only on
! 91: # specified interfaces (and the loopback) give the name of the
! 92: # interface (eg eth0) here.
! 93: # Repeat the line for more than one interface.
! 94: #interface=
! 95: # Or you can specify which interface _not_ to listen on
! 96: #except-interface=
! 97: # Or which to listen on by address (remember to include 127.0.0.1 if
! 98: # you use this.)
! 99: #listen-address=
! 100: # If you want dnsmasq to provide only DNS service on an interface,
! 101: # configure it as shown above, and then use the following line to
! 102: # disable DHCP and TFTP on it.
! 103: #no-dhcp-interface=
! 104:
! 105: # On systems which support it, dnsmasq binds the wildcard address,
! 106: # even when it is listening on only some interfaces. It then discards
! 107: # requests that it shouldn't reply to. This has the advantage of
! 108: # working even when interfaces come and go and change address. If you
! 109: # want dnsmasq to really bind only the interfaces it is listening on,
! 110: # uncomment this option. About the only time you may need this is when
! 111: # running another nameserver on the same machine.
! 112: #bind-interfaces
! 113:
! 114: # If you don't want dnsmasq to read /etc/hosts, uncomment the
! 115: # following line.
! 116: #no-hosts
! 117: # or if you want it to read another file, as well as /etc/hosts, use
! 118: # this.
! 119: #addn-hosts=/etc/banner_add_hosts
! 120:
! 121: # Set this (and domain: see below) if you want to have a domain
! 122: # automatically added to simple names in a hosts-file.
! 123: #expand-hosts
! 124:
! 125: # Set the domain for dnsmasq. this is optional, but if it is set, it
! 126: # does the following things.
! 127: # 1) Allows DHCP hosts to have fully qualified domain names, as long
! 128: # as the domain part matches this setting.
! 129: # 2) Sets the "domain" DHCP option thereby potentially setting the
! 130: # domain of all systems configured by DHCP
! 131: # 3) Provides the domain part for "expand-hosts"
! 132: #domain=thekelleys.org.uk
! 133:
! 134: # Set a different domain for a particular subnet
! 135: #domain=wireless.thekelleys.org.uk,192.168.2.0/24
! 136:
! 137: # Same idea, but range rather then subnet
! 138: #domain=reserved.thekelleys.org.uk,192.68.3.100,192.168.3.200
! 139:
! 140: # Uncomment this to enable the integrated DHCP server, you need
! 141: # to supply the range of addresses available for lease and optionally
! 142: # a lease time. If you have more than one network, you will need to
! 143: # repeat this for each network on which you want to supply DHCP
! 144: # service.
! 145: #dhcp-range=192.168.0.50,192.168.0.150,12h
! 146:
! 147: # This is an example of a DHCP range where the netmask is given. This
! 148: # is needed for networks we reach the dnsmasq DHCP server via a relay
! 149: # agent. If you don't know what a DHCP relay agent is, you probably
! 150: # don't need to worry about this.
! 151: #dhcp-range=192.168.0.50,192.168.0.150,255.255.255.0,12h
! 152:
! 153: # This is an example of a DHCP range which sets a tag, so that
! 154: # some DHCP options may be set only for this network.
! 155: #dhcp-range=set:red,192.168.0.50,192.168.0.150
! 156:
! 157: # Use this DHCP range only when the tag "green" is set.
! 158: #dhcp-range=tag:green,192.168.0.50,192.168.0.150,12h
! 159:
! 160: # Specify a subnet which can't be used for dynamic address allocation,
! 161: # is available for hosts with matching --dhcp-host lines. Note that
! 162: # dhcp-host declarations will be ignored unless there is a dhcp-range
! 163: # of some type for the subnet in question.
! 164: # In this case the netmask is implied (it comes from the network
! 165: # configuration on the machine running dnsmasq) it is possible to give
! 166: # an explicit netmask instead.
! 167: #dhcp-range=192.168.0.0,static
! 168:
! 169: # Enable DHCPv6. Note that the prefix-length does not need to be specified
! 170: # and defaults to 64 if missing/
! 171: #dhcp-range=1234::2, 1234::500, 64, 12h
! 172:
! 173: # Do Router Advertisements, BUT NOT DHCP for this subnet.
! 174: #dhcp-range=1234::, ra-only
! 175:
! 176: # Do Router Advertisements, BUT NOT DHCP for this subnet, also try and
! 177: # add names to the DNS for the IPv6 address of SLAAC-configured dual-stack
! 178: # hosts. Use the DHCPv4 lease to derive the name, network segment and
! 179: # MAC address and assume that the host will also have an
! 180: # IPv6 address calculated using the SLAAC alogrithm.
! 181: #dhcp-range=1234::, ra-names
! 182:
! 183: # Do Router Advertisements, BUT NOT DHCP for this subnet.
! 184: # Set the lifetime to 46 hours. (Note: minimum lifetime is 2 hours.)
! 185: #dhcp-range=1234::, ra-only, 48h
! 186:
! 187: # Do DHCP and Router Advertisements for this subnet. Set the A bit in the RA
! 188: # so that clients can use SLAAC addresses as well as DHCP ones.
! 189: #dhcp-range=1234::2, 1234::500, slaac
! 190:
! 191: # Do Router Advertisements and stateless DHCP for this subnet. Clients will
! 192: # not get addresses from DHCP, but they will get other configuration information.
! 193: # They will use SLAAC for addresses.
! 194: #dhcp-range=1234::, ra-stateless
! 195:
! 196: # Do stateless DHCP, SLAAC, and generate DNS names for SLAAC addresses
! 197: # from DHCPv4 leases.
! 198: #dhcp-range=1234::, ra-stateless, ra-names
! 199:
! 200: # Do router advertisements for all subnets where we're doing DHCPv6
! 201: # Unless overriden by ra-stateless, ra-names, et al, the router
! 202: # advertisements will have the M and O bits set, so that the clients
! 203: # get addresses and configuration from DHCPv6, and the A bit reset, so the
! 204: # clients don't use SLAAC addresses.
! 205: #enable-ra
! 206:
! 207: # Supply parameters for specified hosts using DHCP. There are lots
! 208: # of valid alternatives, so we will give examples of each. Note that
! 209: # IP addresses DO NOT have to be in the range given above, they just
! 210: # need to be on the same network. The order of the parameters in these
! 211: # do not matter, it's permissible to give name, address and MAC in any
! 212: # order.
! 213:
! 214: # Always allocate the host with Ethernet address 11:22:33:44:55:66
! 215: # The IP address 192.168.0.60
! 216: #dhcp-host=11:22:33:44:55:66,192.168.0.60
! 217:
! 218: # Always set the name of the host with hardware address
! 219: # 11:22:33:44:55:66 to be "fred"
! 220: #dhcp-host=11:22:33:44:55:66,fred
! 221:
! 222: # Always give the host with Ethernet address 11:22:33:44:55:66
! 223: # the name fred and IP address 192.168.0.60 and lease time 45 minutes
! 224: #dhcp-host=11:22:33:44:55:66,fred,192.168.0.60,45m
! 225:
! 226: # Give a host with Ethernet address 11:22:33:44:55:66 or
! 227: # 12:34:56:78:90:12 the IP address 192.168.0.60. Dnsmasq will assume
! 228: # that these two Ethernet interfaces will never be in use at the same
! 229: # time, and give the IP address to the second, even if it is already
! 230: # in use by the first. Useful for laptops with wired and wireless
! 231: # addresses.
! 232: #dhcp-host=11:22:33:44:55:66,12:34:56:78:90:12,192.168.0.60
! 233:
! 234: # Give the machine which says its name is "bert" IP address
! 235: # 192.168.0.70 and an infinite lease
! 236: #dhcp-host=bert,192.168.0.70,infinite
! 237:
! 238: # Always give the host with client identifier 01:02:02:04
! 239: # the IP address 192.168.0.60
! 240: #dhcp-host=id:01:02:02:04,192.168.0.60
! 241:
! 242: # Always give the host with client identifier "marjorie"
! 243: # the IP address 192.168.0.60
! 244: #dhcp-host=id:marjorie,192.168.0.60
! 245:
! 246: # Enable the address given for "judge" in /etc/hosts
! 247: # to be given to a machine presenting the name "judge" when
! 248: # it asks for a DHCP lease.
! 249: #dhcp-host=judge
! 250:
! 251: # Never offer DHCP service to a machine whose Ethernet
! 252: # address is 11:22:33:44:55:66
! 253: #dhcp-host=11:22:33:44:55:66,ignore
! 254:
! 255: # Ignore any client-id presented by the machine with Ethernet
! 256: # address 11:22:33:44:55:66. This is useful to prevent a machine
! 257: # being treated differently when running under different OS's or
! 258: # between PXE boot and OS boot.
! 259: #dhcp-host=11:22:33:44:55:66,id:*
! 260:
! 261: # Send extra options which are tagged as "red" to
! 262: # the machine with Ethernet address 11:22:33:44:55:66
! 263: #dhcp-host=11:22:33:44:55:66,set:red
! 264:
! 265: # Send extra options which are tagged as "red" to
! 266: # any machine with Ethernet address starting 11:22:33:
! 267: #dhcp-host=11:22:33:*:*:*,set:red
! 268:
! 269: # Give a fixed IPv6 address and name to client with
! 270: # DUID 00:01:00:01:16:d2:83:fc:92:d4:19:e2:d8:b2
! 271: # Note the MAC addresses CANNOT be used to identify DHCPv6 clients.
! 272: # Note also the they [] around the IPv6 address are obilgatory.
! 273: #dhcp-host=id:00:01:00:01:16:d2:83:fc:92:d4:19:e2:d8:b2, fred, [1234::5]
! 274:
! 275: # Ignore any clients which are not specified in dhcp-host lines
! 276: # or /etc/ethers. Equivalent to ISC "deny unknown-clients".
! 277: # This relies on the special "known" tag which is set when
! 278: # a host is matched.
! 279: #dhcp-ignore=tag:!known
! 280:
! 281: # Send extra options which are tagged as "red" to any machine whose
! 282: # DHCP vendorclass string includes the substring "Linux"
! 283: #dhcp-vendorclass=set:red,Linux
! 284:
! 285: # Send extra options which are tagged as "red" to any machine one
! 286: # of whose DHCP userclass strings includes the substring "accounts"
! 287: #dhcp-userclass=set:red,accounts
! 288:
! 289: # Send extra options which are tagged as "red" to any machine whose
! 290: # MAC address matches the pattern.
! 291: #dhcp-mac=set:red,00:60:8C:*:*:*
! 292:
! 293: # If this line is uncommented, dnsmasq will read /etc/ethers and act
! 294: # on the ethernet-address/IP pairs found there just as if they had
! 295: # been given as --dhcp-host options. Useful if you keep
! 296: # MAC-address/host mappings there for other purposes.
! 297: #read-ethers
! 298:
! 299: # Send options to hosts which ask for a DHCP lease.
! 300: # See RFC 2132 for details of available options.
! 301: # Common options can be given to dnsmasq by name:
! 302: # run "dnsmasq --help dhcp" to get a list.
! 303: # Note that all the common settings, such as netmask and
! 304: # broadcast address, DNS server and default route, are given
! 305: # sane defaults by dnsmasq. You very likely will not need
! 306: # any dhcp-options. If you use Windows clients and Samba, there
! 307: # are some options which are recommended, they are detailed at the
! 308: # end of this section.
! 309:
! 310: # Override the default route supplied by dnsmasq, which assumes the
! 311: # router is the same machine as the one running dnsmasq.
! 312: #dhcp-option=3,1.2.3.4
! 313:
! 314: # Do the same thing, but using the option name
! 315: #dhcp-option=option:router,1.2.3.4
! 316:
! 317: # Override the default route supplied by dnsmasq and send no default
! 318: # route at all. Note that this only works for the options sent by
! 319: # default (1, 3, 6, 12, 28) the same line will send a zero-length option
! 320: # for all other option numbers.
! 321: #dhcp-option=3
! 322:
! 323: # Set the NTP time server addresses to 192.168.0.4 and 10.10.0.5
! 324: #dhcp-option=option:ntp-server,192.168.0.4,10.10.0.5
! 325:
! 326: # Send DHCPv6 option. Note [] around IPv6 addresses.
! 327: #dhcp-option=option6:dns-server,[1234::77],[1234::88]
! 328:
! 329: # Send DHCPv6 option for namservers as the machine running
! 330: # dnsmasq and another.
! 331: #dhcp-option=option6:dns-server,[::],[1234::88]
! 332:
! 333: # Ask client to poll for option changes every six hours. (RFC4242)
! 334: #dhcp-option=option6:information-refresh-time,6h
! 335:
! 336: # Set the NTP time server address to be the same machine as
! 337: # is running dnsmasq
! 338: #dhcp-option=42,0.0.0.0
! 339:
! 340: # Set the NIS domain name to "welly"
! 341: #dhcp-option=40,welly
! 342:
! 343: # Set the default time-to-live to 50
! 344: #dhcp-option=23,50
! 345:
! 346: # Set the "all subnets are local" flag
! 347: #dhcp-option=27,1
! 348:
! 349: # Send the etherboot magic flag and then etherboot options (a string).
! 350: #dhcp-option=128,e4:45:74:68:00:00
! 351: #dhcp-option=129,NIC=eepro100
! 352:
! 353: # Specify an option which will only be sent to the "red" network
! 354: # (see dhcp-range for the declaration of the "red" network)
! 355: # Note that the tag: part must precede the option: part.
! 356: #dhcp-option = tag:red, option:ntp-server, 192.168.1.1
! 357:
! 358: # The following DHCP options set up dnsmasq in the same way as is specified
! 359: # for the ISC dhcpcd in
! 360: # http://www.samba.org/samba/ftp/docs/textdocs/DHCP-Server-Configuration.txt
! 361: # adapted for a typical dnsmasq installation where the host running
! 362: # dnsmasq is also the host running samba.
! 363: # you may want to uncomment some or all of them if you use
! 364: # Windows clients and Samba.
! 365: #dhcp-option=19,0 # option ip-forwarding off
! 366: #dhcp-option=44,0.0.0.0 # set netbios-over-TCP/IP nameserver(s) aka WINS server(s)
! 367: #dhcp-option=45,0.0.0.0 # netbios datagram distribution server
! 368: #dhcp-option=46,8 # netbios node type
! 369:
! 370: # Send an empty WPAD option. This may be REQUIRED to get windows 7 to behave.
! 371: #dhcp-option=252,"\n"
! 372:
! 373: # Send RFC-3397 DNS domain search DHCP option. WARNING: Your DHCP client
! 374: # probably doesn't support this......
! 375: #dhcp-option=option:domain-search,eng.apple.com,marketing.apple.com
! 376:
! 377: # Send RFC-3442 classless static routes (note the netmask encoding)
! 378: #dhcp-option=121,192.168.1.0/24,1.2.3.4,10.0.0.0/8,5.6.7.8
! 379:
! 380: # Send vendor-class specific options encapsulated in DHCP option 43.
! 381: # The meaning of the options is defined by the vendor-class so
! 382: # options are sent only when the client supplied vendor class
! 383: # matches the class given here. (A substring match is OK, so "MSFT"
! 384: # matches "MSFT" and "MSFT 5.0"). This example sets the
! 385: # mtftp address to 0.0.0.0 for PXEClients.
! 386: #dhcp-option=vendor:PXEClient,1,0.0.0.0
! 387:
! 388: # Send microsoft-specific option to tell windows to release the DHCP lease
! 389: # when it shuts down. Note the "i" flag, to tell dnsmasq to send the
! 390: # value as a four-byte integer - that's what microsoft wants. See
! 391: # http://technet2.microsoft.com/WindowsServer/en/library/a70f1bb7-d2d4-49f0-96d6-4b7414ecfaae1033.mspx?mfr=true
! 392: #dhcp-option=vendor:MSFT,2,1i
! 393:
! 394: # Send the Encapsulated-vendor-class ID needed by some configurations of
! 395: # Etherboot to allow is to recognise the DHCP server.
! 396: #dhcp-option=vendor:Etherboot,60,"Etherboot"
! 397:
! 398: # Send options to PXELinux. Note that we need to send the options even
! 399: # though they don't appear in the parameter request list, so we need
! 400: # to use dhcp-option-force here.
! 401: # See http://syslinux.zytor.com/pxe.php#special for details.
! 402: # Magic number - needed before anything else is recognised
! 403: #dhcp-option-force=208,f1:00:74:7e
! 404: # Configuration file name
! 405: #dhcp-option-force=209,configs/common
! 406: # Path prefix
! 407: #dhcp-option-force=210,/tftpboot/pxelinux/files/
! 408: # Reboot time. (Note 'i' to send 32-bit value)
! 409: #dhcp-option-force=211,30i
! 410:
! 411: # Set the boot filename for netboot/PXE. You will only need
! 412: # this is you want to boot machines over the network and you will need
! 413: # a TFTP server; either dnsmasq's built in TFTP server or an
! 414: # external one. (See below for how to enable the TFTP server.)
! 415: #dhcp-boot=pxelinux.0
! 416:
! 417: # The same as above, but use custom tftp-server instead machine running dnsmasq
! 418: #dhcp-boot=pxelinux,server.name,192.168.1.100
! 419:
! 420: # Boot for Etherboot gPXE. The idea is to send two different
! 421: # filenames, the first loads gPXE, and the second tells gPXE what to
! 422: # load. The dhcp-match sets the gpxe tag for requests from gPXE.
! 423: #dhcp-match=set:gpxe,175 # gPXE sends a 175 option.
! 424: #dhcp-boot=tag:!gpxe,undionly.kpxe
! 425: #dhcp-boot=mybootimage
! 426:
! 427: # Encapsulated options for Etherboot gPXE. All the options are
! 428: # encapsulated within option 175
! 429: #dhcp-option=encap:175, 1, 5b # priority code
! 430: #dhcp-option=encap:175, 176, 1b # no-proxydhcp
! 431: #dhcp-option=encap:175, 177, string # bus-id
! 432: #dhcp-option=encap:175, 189, 1b # BIOS drive code
! 433: #dhcp-option=encap:175, 190, user # iSCSI username
! 434: #dhcp-option=encap:175, 191, pass # iSCSI password
! 435:
! 436: # Test for the architecture of a netboot client. PXE clients are
! 437: # supposed to send their architecture as option 93. (See RFC 4578)
! 438: #dhcp-match=peecees, option:client-arch, 0 #x86-32
! 439: #dhcp-match=itanics, option:client-arch, 2 #IA64
! 440: #dhcp-match=hammers, option:client-arch, 6 #x86-64
! 441: #dhcp-match=mactels, option:client-arch, 7 #EFI x86-64
! 442:
! 443: # Do real PXE, rather than just booting a single file, this is an
! 444: # alternative to dhcp-boot.
! 445: #pxe-prompt="What system shall I netboot?"
! 446: # or with timeout before first available action is taken:
! 447: #pxe-prompt="Press F8 for menu.", 60
! 448:
! 449: # Available boot services. for PXE.
! 450: #pxe-service=x86PC, "Boot from local disk"
! 451:
! 452: # Loads <tftp-root>/pxelinux.0 from dnsmasq TFTP server.
! 453: #pxe-service=x86PC, "Install Linux", pxelinux
! 454:
! 455: # Loads <tftp-root>/pxelinux.0 from TFTP server at 1.2.3.4.
! 456: # Beware this fails on old PXE ROMS.
! 457: #pxe-service=x86PC, "Install Linux", pxelinux, 1.2.3.4
! 458:
! 459: # Use bootserver on network, found my multicast or broadcast.
! 460: #pxe-service=x86PC, "Install windows from RIS server", 1
! 461:
! 462: # Use bootserver at a known IP address.
! 463: #pxe-service=x86PC, "Install windows from RIS server", 1, 1.2.3.4
! 464:
! 465: # If you have multicast-FTP available,
! 466: # information for that can be passed in a similar way using options 1
! 467: # to 5. See page 19 of
! 468: # http://download.intel.com/design/archives/wfm/downloads/pxespec.pdf
! 469:
! 470:
! 471: # Enable dnsmasq's built-in TFTP server
! 472: #enable-tftp
! 473:
! 474: # Set the root directory for files available via FTP.
! 475: #tftp-root=/var/ftpd
! 476:
! 477: # Make the TFTP server more secure: with this set, only files owned by
! 478: # the user dnsmasq is running as will be send over the net.
! 479: #tftp-secure
! 480:
! 481: # This option stops dnsmasq from negotiating a larger blocksize for TFTP
! 482: # transfers. It will slow things down, but may rescue some broken TFTP
! 483: # clients.
! 484: #tftp-no-blocksize
! 485:
! 486: # Set the boot file name only when the "red" tag is set.
! 487: #dhcp-boot=tag:red,pxelinux.red-net
! 488:
! 489: # An example of dhcp-boot with an external TFTP server: the name and IP
! 490: # address of the server are given after the filename.
! 491: # Can fail with old PXE ROMS. Overridden by --pxe-service.
! 492: #dhcp-boot=/var/ftpd/pxelinux.0,boothost,192.168.0.3
! 493:
! 494: # If there are multiple external tftp servers having a same name
! 495: # (using /etc/hosts) then that name can be specified as the
! 496: # tftp_servername (the third option to dhcp-boot) and in that
! 497: # case dnsmasq resolves this name and returns the resultant IP
! 498: # addresses in round robin fasion. This facility can be used to
! 499: # load balance the tftp load among a set of servers.
! 500: #dhcp-boot=/var/ftpd/pxelinux.0,boothost,tftp_server_name
! 501:
! 502: # Set the limit on DHCP leases, the default is 150
! 503: #dhcp-lease-max=150
! 504:
! 505: # The DHCP server needs somewhere on disk to keep its lease database.
! 506: # This defaults to a sane location, but if you want to change it, use
! 507: # the line below.
! 508: #dhcp-leasefile=/var/lib/misc/dnsmasq.leases
! 509:
! 510: # Set the DHCP server to authoritative mode. In this mode it will barge in
! 511: # and take over the lease for any client which broadcasts on the network,
! 512: # whether it has a record of the lease or not. This avoids long timeouts
! 513: # when a machine wakes up on a new network. DO NOT enable this if there's
! 514: # the slightest chance that you might end up accidentally configuring a DHCP
! 515: # server for your campus/company accidentally. The ISC server uses
! 516: # the same option, and this URL provides more information:
! 517: # http://www.isc.org/files/auth.html
! 518: #dhcp-authoritative
! 519:
! 520: # Run an executable when a DHCP lease is created or destroyed.
! 521: # The arguments sent to the script are "add" or "del",
! 522: # then the MAC address, the IP address and finally the hostname
! 523: # if there is one.
! 524: #dhcp-script=/bin/echo
! 525:
! 526: # Set the cachesize here.
! 527: #cache-size=150
! 528:
! 529: # If you want to disable negative caching, uncomment this.
! 530: #no-negcache
! 531:
! 532: # Normally responses which come from /etc/hosts and the DHCP lease
! 533: # file have Time-To-Live set as zero, which conventionally means
! 534: # do not cache further. If you are happy to trade lower load on the
! 535: # server for potentially stale date, you can set a time-to-live (in
! 536: # seconds) here.
! 537: #local-ttl=
! 538:
! 539: # If you want dnsmasq to detect attempts by Verisign to send queries
! 540: # to unregistered .com and .net hosts to its sitefinder service and
! 541: # have dnsmasq instead return the correct NXDOMAIN response, uncomment
! 542: # this line. You can add similar lines to do the same for other
! 543: # registries which have implemented wildcard A records.
! 544: #bogus-nxdomain=64.94.110.11
! 545:
! 546: # If you want to fix up DNS results from upstream servers, use the
! 547: # alias option. This only works for IPv4.
! 548: # This alias makes a result of 1.2.3.4 appear as 5.6.7.8
! 549: #alias=1.2.3.4,5.6.7.8
! 550: # and this maps 1.2.3.x to 5.6.7.x
! 551: #alias=1.2.3.0,5.6.7.0,255.255.255.0
! 552: # and this maps 192.168.0.10->192.168.0.40 to 10.0.0.10->10.0.0.40
! 553: #alias=192.168.0.10-192.168.0.40,10.0.0.0,255.255.255.0
! 554:
! 555: # Change these lines if you want dnsmasq to serve MX records.
! 556:
! 557: # Return an MX record named "maildomain.com" with target
! 558: # servermachine.com and preference 50
! 559: #mx-host=maildomain.com,servermachine.com,50
! 560:
! 561: # Set the default target for MX records created using the localmx option.
! 562: #mx-target=servermachine.com
! 563:
! 564: # Return an MX record pointing to the mx-target for all local
! 565: # machines.
! 566: #localmx
! 567:
! 568: # Return an MX record pointing to itself for all local machines.
! 569: #selfmx
! 570:
! 571: # Change the following lines if you want dnsmasq to serve SRV
! 572: # records. These are useful if you want to serve ldap requests for
! 573: # Active Directory and other windows-originated DNS requests.
! 574: # See RFC 2782.
! 575: # You may add multiple srv-host lines.
! 576: # The fields are <name>,<target>,<port>,<priority>,<weight>
! 577: # If the domain part if missing from the name (so that is just has the
! 578: # service and protocol sections) then the domain given by the domain=
! 579: # config option is used. (Note that expand-hosts does not need to be
! 580: # set for this to work.)
! 581:
! 582: # A SRV record sending LDAP for the example.com domain to
! 583: # ldapserver.example.com port 389
! 584: #srv-host=_ldap._tcp.example.com,ldapserver.example.com,389
! 585:
! 586: # A SRV record sending LDAP for the example.com domain to
! 587: # ldapserver.example.com port 389 (using domain=)
! 588: #domain=example.com
! 589: #srv-host=_ldap._tcp,ldapserver.example.com,389
! 590:
! 591: # Two SRV records for LDAP, each with different priorities
! 592: #srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,1
! 593: #srv-host=_ldap._tcp.example.com,ldapserver.example.com,389,2
! 594:
! 595: # A SRV record indicating that there is no LDAP server for the domain
! 596: # example.com
! 597: #srv-host=_ldap._tcp.example.com
! 598:
! 599: # The following line shows how to make dnsmasq serve an arbitrary PTR
! 600: # record. This is useful for DNS-SD. (Note that the
! 601: # domain-name expansion done for SRV records _does_not
! 602: # occur for PTR records.)
! 603: #ptr-record=_http._tcp.dns-sd-services,"New Employee Page._http._tcp.dns-sd-services"
! 604:
! 605: # Change the following lines to enable dnsmasq to serve TXT records.
! 606: # These are used for things like SPF and zeroconf. (Note that the
! 607: # domain-name expansion done for SRV records _does_not
! 608: # occur for TXT records.)
! 609:
! 610: #Example SPF.
! 611: #txt-record=example.com,"v=spf1 a -all"
! 612:
! 613: #Example zeroconf
! 614: #txt-record=_http._tcp.example.com,name=value,paper=A4
! 615:
! 616: # Provide an alias for a "local" DNS name. Note that this _only_ works
! 617: # for targets which are names from DHCP or /etc/hosts. Give host
! 618: # "bert" another name, bertrand
! 619: #cname=bertand,bert
! 620:
! 621: # For debugging purposes, log each DNS query as it passes through
! 622: # dnsmasq.
! 623: #log-queries
! 624:
! 625: # Log lots of extra information about DHCP transactions.
! 626: #log-dhcp
! 627:
! 628: # Include another lot of configuration options.
! 629: #conf-file=/etc/dnsmasq.more.conf
! 630: #conf-dir=/etc/dnsmasq.d
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to dnsmasq.conf.example CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / dnsmasq