Annotation of embedaddon/dnsmasq/doc.html, revision 1.1.1.1
1.1 misho 1: <HTML>
2: <HEAD>
3: <TITLE> Dnsmasq - a DNS forwarder for NAT firewalls.</TITLE>
4: <link rel="icon"
5: href="http://www.thekelleys.org.uk/dnsmasq/images/favicon.ico">
6: </HEAD>
7: <BODY BGCOLOR="WHITE">
8: <table width="100%" border="0" cellpadding="0" cellspacing="0">
9: <tr>
10: <td align="left" valign="middle"><img border="0" src="http://www.thekelleys.org.uk/dnsmasq/images/icon.png" /></td>
11: <td align="middle" valign="middle"><h1>Dnsmasq</h1></td>
12: <td align="right" valign="middle"><img border="0" src="http://www.thekelleys.org.uk/dnsmasq/images/icon.png" /></td></tr>
13: </table>
14:
15: Dnsmasq is a lightweight, easy to configure DNS forwarder and DHCP
16: server. It is designed to provide DNS and, optionally, DHCP, to a
17: small network. It can serve the names of local machines which are
18: not in the global DNS. The DHCP server integrates with the DNS
19: server and allows machines with DHCP-allocated addresses
20: to appear in the DNS with names configured either in each host or
21: in a central configuration file. Dnsmasq supports static and dynamic
22: DHCP leases and BOOTP/TFTP/PXE for network booting of diskless machines.
23: <P>
24: Dnsmasq is targeted at home networks using NAT and
25: connected to the internet via a modem, cable-modem or ADSL
26: connection but would be a good choice for any smallish network (up to
27: 1000 clients is known to work) where low
28: resource use and ease of configuration are important.
29: <P>
30: Supported platforms include Linux (with glibc and uclibc), Android, *BSD,
31: Solaris and Mac OS X.
32: Dnsmasq is included in at least the following Linux distributions:
33: Gentoo, Debian, Slackware, Suse, Fedora,
34: Smoothwall, IP-Cop, floppyfw, Firebox, LEAF, Freesco, fli4l,
35: CoyoteLinux, Endian Firewall and
36: Clarkconnect. It is also available as FreeBSD, OpenBSD and NetBSD ports and is used in
37: Linksys wireless routers (dd-wrt, openwrt and the stock firmware) and the m0n0wall project.
38: <P>
39: Dnsmasq provides the following features:
40: <DIR>
41:
42: <LI>
43: The DNS configuration of machines behind the firewall is simple and
44: doesn't depend on the details of the ISP's dns servers
45: <LI>
46: Clients which try to do DNS lookups while a modem link to the
47: internet is down will time out immediately.
48: </LI>
49: <LI>
50: Dnsmasq will serve names from the /etc/hosts file on the firewall
51: machine: If the names of local machines are there, then they can all
52: be addressed without having to maintain /etc/hosts on each machine.
53: </LI>
54: <LI>
55: The integrated DHCP server supports static and dynamic DHCP leases and
56: multiple networks and IP ranges. It works across BOOTP relays and
57: supports DHCP options including RFC3397 DNS search lists.
58: Machines which are configured by DHCP have their names automatically
59: included in the DNS and the names can specified by each machine or
60: centrally by associating a name with a MAC address in the dnsmasq
61: config file.
62: </LI>
63: <LI>
64: Dnsmasq caches internet addresses (A records and AAAA records) and address-to-name
65: mappings (PTR records), reducing the load on upstream servers and
66: improving performance (especially on modem connections).
67: </LI>
68: <LI>
69: Dnsmasq can be configured to automatically pick up the addresses of
70: its upstream nameservers from ppp or dhcp configuration. It will
71: automatically reload this information if it changes. This facility
72: will be of particular interest to maintainers of Linux firewall
73: distributions since it allows dns configuration to be made automatic.
74: </LI>
75: <LI>
76: On IPv6-enabled boxes, dnsmasq can both talk to upstream servers via IPv6
77: and offer DNS service via IPv6. On dual-stack (IPv4 and IPv6) boxes it talks
78: both protocols and can even act as IPv6-to-IPv4 or IPv4-to-IPv6 forwarder.
79: </LI>
80: <LI>
81: Dnsmasq can be configured to send queries for certain domains to
82: upstream servers handling only those domains. This makes integration
83: with private DNS systems easy.
84: </LI>
85: <LI>
86: Dnsmasq supports MX and SRV records and can be configured to return MX records
87: for any or all local machines.
88: </LI>
89: </DIR>
90:
91: <H2>Get code.</H2>
92:
93: <A HREF="http://www.thekelleys.org.uk/dnsmasq/">Download</A> dnsmasq here.
94: The tarball includes this documentation, source, and manpage.
95: There is also a <A HREF="CHANGELOG"> CHANGELOG</A> and a <A HREF="FAQ">FAQ</A>.
96:
97: Dnsmasq has a git repository which contains the complete release
98: history of version 2 and development history from 2.60. You can
99: <A HREF="http://thekelleys.org.uk/gitweb/?p=dnsmasq.git;a=summary">browse</A>
100: the repo, or get a copy using git protocol with the command
101:
102: <PRE><TT>git clone git://thekelleys.org.uk/dnsmasq.git </TT></PRE>
103:
104: <H2>License.</H2>
105: Dnsmasq is distributed under the GPL. See the file COPYING in the distribution
106: for details.
107:
108: <H2>Contact.</H2>
109: There is a dnsmasq mailing list at <A
110: HREF="http://lists.thekelleys.org.uk/mailman/listinfo/dnsmasq-discuss">
111: http://lists.thekelleys.org.uk/mailman/listinfo/dnsmasq-discuss</A> which should be the
112: first location for queries, bugreports, suggestions etc.
113: Dnsmasq was written by Simon Kelley. You can contact me at <A
114: HREF="mailto:simon@thekelleys.org.uk">simon@thekelleys.org.uk</A>.
115: </BODY>
116:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>