~cyphermox/ubuntu/precise/dnsmasq/dbus

« back to all changes in this revision

Viewing changes to debian/readme

  • Committer: Bazaar Package Importer
  • Author(s): Simon Kelley
  • Date: 2005-05-04 13:25:23 UTC
  • mfrom: (0.2.1 upstream) (1.1.2 hoary)
  • Revision ID: james.westby@ubuntu.com-20050504132523-29x9nzdnkypp62nc
Tags: 2.22-2
Make the resolv.conf polling code resistant to 
backwards-moving system clocks. (closes: #306117) (closes: #300694)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
Notes on configuring the Debian package of dnsmasq.
2
 
 
3
 
(1) To configure dnsmasq edit /etc/default/dnsmasq.
4
 
    This file includes options to pick up DHCP-allocated addresses
5
 
    from the ISC dhpcd leases file and to use the other features
6
 
    detailed in dnsmasq(8).
7
 
 
8
 
(2) The Debian dhcpcd package makes /etc/resolv.conf a link to 
9
 
    /etc/dhcpc/resolv.conf. If you want to use automatic DNS configuration
10
 
    via DHCP, you will have to remove this link before setting the 
11
 
    configuration as described in /usr/share/doc/dnsmasq/doc.html.
12
 
 
13
 
 
14
 
 
 
1
Notes on configuring dnsmasq as packaged for Debian.
 
2
 
 
3
(1) To configure dnsmasq edit /etc/dnsmasq.conf. The file is well
 
4
    commented; see also the dnsmasq.8 man page for explanation of
 
5
    the options. The file /etc/default/dnsmasq also exists but it
 
6
    shouldn't need to be touched in most cases. To set up DHCP
 
7
    options you might need to refer to a copy of RFC 2132. This is 
 
8
    available on Debian systems in the package doc-rfc-std as the file
 
9
    /usr/share/doc/RFC/draft-standard/rfc2132.txt.gz .
 
10
 
 
11
(2) If the Debian resolvconf package is installed then, regardless
 
12
    of what interface configuration daemons are employed, the list of
 
13
    nameservers to which dnsmasq should forward queries can be found
 
14
    in /var/run/dnsmasq/resolv.conf; also, 127.0.0.1 is listed as the
 
15
    first nameserver address in /etc/resolv.conf. This works using the
 
16
    default configurations of resolvconf and dnsmasq.
 
17
 
 
18
(3) In the absence of resolvconf, if you are using dhcpcd then
 
19
    dnsmasq should read the list of nameservers from the automatically
 
20
    generated file /etc/dhcpc/resolv.conf.  You should list 127.0.0.1
 
21
    as the first nameserver address in /etc/resolv.conf.
 
22
 
 
23
(4) In the absence of resolvconf, if you are using pppd then
 
24
    dnsmasq should read the list of nameservers from the automatically
 
25
    generated file /etc/ppp/resolv.conf.  You should list 127.0.0.1
 
26
    as the first nameserver address in /etc/resolv.conf.
 
27
 
 
28
(5) If you run multiple DNS servers on a single machine, each
 
29
    listening on a different interface, then it is necessary from
 
30
    version 2.3 on to use the bind-interfaces option by uncommenting
 
31
    "bind-interfaces" in /etc/dnsmasq.conf. This option stops dnsmasq
 
32
    from binding the wildcard address and allows servers listening on
 
33
    port 53 on interfaces not in use by dnsmasq to work.