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>