~davewalker/ubuntu/lucid/dnsmasq/bug674645

The dnsmasq DHCP server supports static address assignments and multiple

networks. It automatically

.B \-V, --alias=[<old-ip>]|[<start-ip>-<end-ip>],<new-ip>[,<mask>]

Cisco PIX routers call "DNS doctoring". If the old IP is given as

range, then only addresses in the range, rather than a whole subnet,

are re-written. So 

.B --alias=192.168.0.10-192.168.0.40,10.0.0.0,255.255.255.0

maps 192.168.0.10->192.168.0.40 to 10.0.0.10->10.0.0.40

.B --cname=<cname>,<target>

Return a CNAME record which indicates that <cname> is really

<target>. There are significant limitations on the target; it must be a

DNS name which is known to dnsmasq from /etc/hosts (or additional

hosts files) or from DHCP. If the target does not satisfy this

criteria, the whole cname is ignored. The cname must be unique, but it

is permissable to have more than one cname pointing to the same target.

.TP

 

 

be used by some machines.

 

The net:<network-id> sets the network-id tag

whenever this dhcp-host directive is in use. This can be used to 

in the configuration file.

 

Hardware addresses normally match any

is 6. 

 

As a special case, it is possible to include more than one

hardware address. eg:

.B --dhcp-host=11:22:33:44:55:66,12:34:56:78:90:12,192.168.0.2

This allows an IP address to be associated with

multiple hardware addresses, and gives dnsmasq permission to abandon a

DHCP lease to one of the hardware addresses when another one asks for

a lease. Beware that this is a dangerous thing to do, it will only

work reliably if only one of the hardware addresses is active at any

time and there is no way for dnsmasq to enforce this. It is, for instance,

useful to allocate a stable IP address to a laptop which

has both wired and wireless interfaces.

.B \-O, --dhcp-option=[<network-id>,[<network-id>,]][encap:<opt>,][vendor:[<vendor-class>],][<opt>|option:<opt-name>],[<value>[,<value>]]

 

Options may be encapsulated within other options: for instance

.B --dhcp-option=encap:175, 190, "iscsi-client0"

will send option 175, within which is the option 190. If multiple

options are given which are encapsulated with the same option number

then they will be correctly combined into one encapsulated option.

encap: and vendor: are may not both be set in the same dhcp-option.

 

encapsulated options.

.B --dhcp-option-force=[<network-id>,[<network-id>,]][encap:<opt>,][vendor:[<vendor-class>],]<opt>,[<value>[,<value>]]

.B --dhcp-match=<network-id>,<option number>|option:<option name>[,<value>]

Without a value, set the network-id tag if the client sends a DHCP

option of the given number or name. When a value is given, set the tag only if

the option is sent and matches the value. The value may be of the form

"01:ff:*:02" in which case the value must match (apart from widcards)

but the option sent may have unmatched data past the end of the

value. The value may also be of the same form as in 

.B dhcp-option

in which case the option sent is treated as an array, and one element

must match, so

 

--dhcp-match=efi-ia32,option:client-arch,6

 

will set the tag "efi-ia32" if the the number 6 appears in the list of

architectures sent by the client in option 93. (See RFC 4578 for

details.)  If the value is a string, substring matching is used. 

.B \-3, --bootp-dynamic[=<network-id>[,<network-id>]]

other hosts. if this is given without tags, then it unconditionally

enables dynamic allocation. With tags, only when the tags are all

set. It may be repeated with different tag sets. 

Use the specified file to store DHCP lease information.

executable specified by this option is run. The arguments to the process

address of the host, the IP address, and the hostname,

If the MAC address is from a network type other than ethernet,

it will have the network type prepended, eg "06-01:23:45:67:89:ab" for

token ring. The process is run as root (assuming that dnsmasq was originally run as

DNSMASQ_CLIENT_ID. If the fully-qualified domain name of the host is

known, the domain part is stored in DNSMASQ_DOMAIN. 

If the client provides vendor-class or user-class 

.B \-s, --domain=<domain>[,<address range>]

Specifies DNS domains for the DHCP server. Domains may be be given 

unconditionally (without the IP range) or for limited IP ranges. This has two effects;

in /etc/resolv.conf (or equivalent). The address range can be of the form

<ip address>,<ip address> or <ip address>/<netmask> or just a single

<ip address>. See 

.B --dhcp-fqdn

which can change the behaviour of dnsmasq with domains.

.TP

.B --dhcp-fqdn

In the default mode, dnsmasq inserts the unqualified names of

DHCP clients into the DNS. For this reason, the names must be unique,

even if two clients which have the same name are in different

domains. If a second DHCP client appears which has the same name as an

existing client, the name is transfered to the new client. If 

.B --dhcp-fqdn

is set, this behaviour changes: the unqualified name is no longer

put in the DNS, only the qualified name. Two DHCP clients with the

same name may both keep the name, provided that the domain part is

different (ie the fully qualified names differ.) To ensure that all

names have a domain part, there must be at least 

.B --domain 

without an address specified when 

.B --dhcp-fqdn 

is set.

(and "known" if a dhcp-host matches) 

the tag "bootp" for BOOTP requests, a tag whose name is the 

name if the interface on which the request arrived,