src/external/bsd/dhcpcd/dist/README.md - diff

Return to README.md CVS log

Up to [cvs.NetBSD.org] / src / external / bsd / dhcpcd / dist

Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.

Diff for /src/external/bsd/dhcpcd/dist/README.md between version 1.1.1.1.4.1 and 1.1.1.1.4.2

-version 1.1.1.1.4.1, 2017/03/31 20:51:15
+version 1.1.1.1.4.2, 2017/04/26 02:52:22
-Line 0
+Line 1
 Line 0
 Line 1
+ # dhcpcd
+ dhcpcd is a
+ [DHCP](http://en.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol) and a
+ [DHCPv6](http://en.wikipedia.org/wiki/DHCPv6) client.
+ It's also an IPv4LL (aka [ZeroConf](http://en.wikipedia.org/wiki/Zeroconf))
+ client.
+ In layman's terms, dhcpcd runs on your machine and silently configures your
+ computer to work on the attached networks without trouble and mostly without
+ configuration.
+ If you're a desktop user then you may also be interested in
+ [Network Configurator (dhcpcd-ui)](http://roy.marples.name/projects/dhcpcd-ui)
+ which sits in the notification area and monitors the state of the network via
+ dhcpcd.
+ It also has a nice configuration dialog and the ability to enter a pass phrase
+ for wireless networks.
+ dhcpcd may not be the only daemon running that wants to configure DNS on the
+ host, so it uses [openresolv](http://roy.marples.name/projects/openresolv)
+ to ensure they can co-exist.
+ See [BUILDING.md](BUILDING.md) for how to build dhcpcd.
+ If you wish to file a support ticket or help out with development, please
+ [visit the Development Area](https://dev.marples.name/project/profile/101/)
+ or join the mailing list below.
+ ## Configuration
+ You should read the
+ [dhcpcd.conf man page](http://roy.marples.name/man/html5/dhcpcd.conf.html)
+ and put your options into `/etc/dhcpcd.conf`.
+ The default configuration file should work for most people just fine.
+ Here it is, in case you lose it.
+ ```
+ # A sample configuration for dhcpcd.
+ # See dhcpcd.conf(5) for details.
+ # Allow users of this group to interact with dhcpcd via the control socket.
+ #controlgroup wheel
+ # Inform the DHCP server of our hostname for DDNS.
+ hostname
+ # Use the hardware address of the interface for the Client ID.
+ #clientid
+ # or
+ # Use the same DUID + IAID as set in DHCPv6 for DHCPv4 ClientID as per RFC4361.
+ # Some non-RFC compliant DHCP servers do not reply with this set.
+ # In this case, comment out duid and enable clientid above.
+ duid
+ # A list of options to request from the DHCP server.
+ option domain_name_servers, domain_name, domain_search, host_name
+ option classless_static_routes
+ # Respect the network MTU.
+ option interface_mtu
+ # Most distributions have NTP support.
+ #option ntp_servers
+ # A ServerID is required by RFC2131.
+ require dhcp_server_identifier
+ # Generate Stable Private IPv6 Addresses instead of hardware based ones
+ slaac private
+ ```
+ The [dhcpcd man page](/man/html8/dhcpcd.html) has a lot of the same options and more, which only apply to calling dhcpcd from the command line.
+ ## Compatibility
+ dhcpcd-5 is only fully command line compatible with dhcpcd-4
+ For compatibility with older versions, use dhcpcd-4
+ ## Upgrading
+ dhcpcd-7 defaults the database directory to `/var/db/dhcpcd` instead of
+ `/var/db` and now stores dhcpcd.duid and dhcpcd.secret in there instead of
+ in /etc.
+ The Makefile `_confinstall` target will attempt to move the files correctly from
+ the old locations to the new locations.
+ Of course this won't work if dhcpcd-7 is packaged up, so packagers will need to
+ install similar logic into their dhcpcd package.
+ ## ChangeLog
+ We no longer supply a ChangeLog.
+ However, you're more than welcome to read the
+ [commit log](http://roy.marples.name/git/dhcpcd.git/log/) and
+ [archived release annoucements](http://roy.marples.name/archives/dhcpcd-discuss/).

CVSweb <webmaster@jp.NetBSD.org>