From owner-svn-doc-all@FreeBSD.ORG Thu Oct 17 01:53:44 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 1CC2FDD7; Thu, 17 Oct 2013 01:53:44 +0000 (UTC) (envelope-from dru@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 09A8F2910; Thu, 17 Oct 2013 01:53:44 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r9H1rhY9031577; Thu, 17 Oct 2013 01:53:43 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r9H1rhT3031576; Thu, 17 Oct 2013 01:53:43 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201310170153.r9H1rhT3031576@svn.freebsd.org> From: Dru Lavigne Date: Thu, 17 Oct 2013 01:53:43 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42979 - head/en_US.ISO8859-1/books/handbook/network-servers X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 17 Oct 2013 01:53:44 -0000 Author: dru Date: Thu Oct 17 01:53:43 2013 New Revision: 42979 URL: http://svnweb.freebsd.org/changeset/doc/42979 Log: White space fix only. Translators can ignore. Modified: head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Wed Oct 16 23:41:26 2013 (r42978) +++ head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Thu Oct 17 01:53:43 2013 (r42979) @@ -2646,29 +2646,29 @@ result: 0 Success This section describes how to use the built-in DHCP client. It then describes how to install and configure a DHCP server. - - - In &os;, the &man.bpf.4; device is needed by both the - DHCP server and DHCP client. - This device is included in the GENERIC - kernel that is installed with &os;. Users who prefer to create - a custom kernel need to keep this device if - DHCP is used. - - Those who are security conscious should - note that bpf also - allows packet sniffers to function correctly. - + + + In &os;, the &man.bpf.4; device is needed by both the + DHCP server and DHCP + client. This device is included in the + GENERIC kernel that is installed with + &os;. Users who prefer to create a custom kernel need to keep + this device if DHCP is used. + + Those who are security conscious should note that + bpf also allows packet sniffers to + function correctly. + Configuring a <acronym>DHCP</acronym> Client DHCP client support is included in the - &os; installer, making it easy to configure a newly installed system to - automatically receive its networking addressing information - from an existing DHCP server. Refer to - for examples of network - configuration. + &os; installer, making it easy to configure a newly installed + system to automatically receive its networking addressing + information from an existing DHCP server. + Refer to for examples of + network configuration. UDP When dhclient is executed on the client @@ -2682,49 +2682,48 @@ result: 0 Success in the form of a DHCP lease and is valid for a configurable time. This allows stale IP addresses for clients - no longer connected to the network to automatically be - reused. DHCP clients can obtain a great deal of + no longer connected to the network to automatically be reused. + DHCP clients can obtain a great deal of information from the server. An exhaustive list may be found in &man.dhcp-options.5;. - By default, when a &os; system boots, its DHCP client - runs in the background, or + By default, when a &os; system boots, its + DHCP client runs in the background, or asynchronously. Other startup scripts - continue to run while the DHCP process completes, - which speeds up system startup. + continue to run while the DHCP process + completes, which speeds up system startup. Background DHCP works well when the - DHCP server responds quickly to the client's requests. - However, DHCP may take a long - time to complete on some systems. If network services attempt - to run before DHCP has assigned the network addressing information, they will - fail. Using DHCP in - synchronous mode prevents this problem as it - pauses startup until the DHCP configuration - has completed. + DHCP server responds quickly to the + client's requests. However, DHCP may take + a long time to complete on some systems. If network services + attempt to run before DHCP has assigned the + network addressing information, they will fail. Using + DHCP in synchronous + mode prevents this problem as it pauses startup until the + DHCP configuration has completed. This line in /etc/rc.conf is used to - configure - background or asynchronous mode: + configure background or asynchronous mode: ifconfig_fxp0="DHCP" - This line may already exist if the system was configured - to use DHCP during installation. Replace - the fxp0 shown - in these examples with the name of the interface to be - dynamically configured, as described in - . - - To instead configure the system to use synchronous mode, - and to pause during startup while DHCP completes, - use + This line may already exist if the system was configured + to use DHCP during installation. Replace + the fxp0 shown in these examples + with the name of the interface to be dynamically configured, + as described in . + + To instead configure the system to use synchronous mode, + and to pause during startup while DHCP + completes, use SYNCDHCP: ifconfig_fxp0="SYNCDHCP" Additional client options are available. Search for - dhclient in &man.rc.conf.5; for details. + dhclient in &man.rc.conf.5; for + details. DHCP @@ -2738,9 +2737,10 @@ result: 0 Success /etc/dhclient.conf - The configuration file used by dhclient. Typically, - this file contains only comments as the defaults are suitable for most clients. - This configuration file is described in + The configuration file used by + dhclient. Typically, this file + contains only comments as the defaults are suitable for + most clients. This configuration file is described in &man.dhclient.conf.5;. @@ -2765,8 +2765,8 @@ result: 0 Success /var/db/dhclient.leases.interface The DHCP client keeps a database of - valid leases in this file, which is written as a log and is described in - &man.dhclient.leases.5;. + valid leases in this file, which is written as a log and + is described in &man.dhclient.leases.5;. @@ -2775,12 +2775,12 @@ result: 0 Success Installing and Configuring a <acronym>DHCP</acronym> Server - This section demonstrates how to configure a - &os; system to act as a DHCP server using - the Internet Systems Consortium (ISC) implementation of the - DHCP server. This implementation and its documentation can be - installed using the net/isc-dhcp42-server package or + This section demonstrates how to configure a &os; system + to act as a DHCP server using the Internet + Systems Consortium (ISC) implementation of + the DHCP server. This implementation and + its documentation can be installed using the net/isc-dhcp42-server package or port. @@ -2793,25 +2793,23 @@ result: 0 Success installation - The installation of - net/isc-dhcp42-server - installs a sample configuration file. Copy - /usr/local/etc/dhcpd.conf.example - to - /usr/local/etc/dhcpd.conf and make any edits - to this new file. + The installation of net/isc-dhcp42-server installs a + sample configuration file. Copy + /usr/local/etc/dhcpd.conf.example to + /usr/local/etc/dhcpd.conf and make any + edits to this new file. - - DHCP + + DHCP dhcpd.conf - - The configuration file is comprised of - declarations for subnets and hosts which define the - information that is provided to DHCP - clients. For example, these - lines configure the following: + + The configuration file is comprised of declarations for + subnets and hosts which define the information that is + provided to DHCP clients. For example, + these lines configure the following: - option domain-name "example.org"; + option domain-name "example.org"; option domain-name-servers ns1.example.org; option subnet-mask 255.255.255.0; @@ -2831,16 +2829,16 @@ host fantasia { - This option specifies the default search domain that will be - provided to clients. Refer to + This option specifies the default search domain that + will be provided to clients. Refer to &man.resolv.conf.5; for more information. This option specifies a comma separated list of DNS servers that the client should - use. They can be listed by their Fully Qualified Domain - Names (FQDN), as seen in the example, + use. They can be listed by their Fully Qualified Domain + Names (FQDN), as seen in the example, or by their IP addresses. @@ -2850,68 +2848,68 @@ host fantasia { - The default - lease expiry time in - seconds. A client can be configured to override this - value. + The default lease expiry time in seconds. A client + can be configured to override this value. - The maximum allowed length of time, in seconds, for a - lease. Should a client request a longer - lease, a lease will still be issued, but it will only - be valid for max-lease-time. + The maximum allowed length of time, in seconds, for + a lease. Should a client request a longer lease, a + lease will still be issued, but it will only be valid + for max-lease-time. - The default of disables dynamic DNS updates. - Changing this to configures the - DHCP server to update a - DNS server whenever it hands out a - lease so that the DNS server knows - which IP addresses are associated - with which computers in the network. Do not change the default - setting unless the DNS server has - been configured to support dynamic + The default of disables + dynamic DNS updates. Changing this to + configures the + DHCP server to update a + DNS server whenever it hands out a + lease so that the DNS server knows + which IP addresses are associated + with which computers in the network. Do not change the + default setting unless the DNS server + has been configured to support dynamic DNS. - This line creates a pool of available IP addresses - which are reserved for allocation to DHCP - clients. The range of addresses must be valid for the - network or subnet specified in the previous line. + This line creates a pool of available + IP addresses which are reserved for + allocation to DHCP clients. The + range of addresses must be valid for the network or + subnet specified in the previous line. Declares the default gateway that is valid for the - network or subnet specified before the opening + network or subnet specified before the opening { bracket. - Specifies the hardware MAC address of a client so that the - DHCP server can recognize the client when - it makes a request. + Specifies the hardware MAC + address of a client so that the + DHCP server can recognize the client + when it makes a request. Specifies that this host should always be given the - same IP address. Using the - hostname is correct, since the - DHCP server will resolve the - hostname before returning the lease + same IP address. Using the hostname + is correct, since the DHCP server + will resolve the hostname before returning the lease information. - This configuration file supports many more options. Refer - to dhcpd.conf(5), installed with the server, for details and - examples. + This configuration file supports many more options. + Refer to dhcpd.conf(5), installed with the server, for + details and examples. Once the configuration of - dhcpd.conf is complete, - enable the DHCP server in + dhcpd.conf is complete, enable the + DHCP server in /etc/rc.conf: dhcpd_enable="YES" @@ -2928,13 +2926,12 @@ dhcpd_ifaces="dc0" &prompt.root; service isc-dhcpd start Any future changes to the configuration of the server - will require the - dhcpd service to be stopped and then started using - &man.service.8;. - - The DHCP server uses the following - files. Note that the manual pages are installed with the - server software. + will require the dhcpd service to + be stopped and then started using &man.service.8;. + + The DHCP server uses the following + files. Note that the manual pages are installed with the + server software. DHCP @@ -2953,11 +2950,10 @@ dhcpd_ifaces="dc0" /usr/local/etc/dhcpd.conf - The server configuration file - needs to contain all the information that should be - provided to clients, along with - information regarding the operation of the server. This - configuration file is described in + The server configuration file needs to contain all + the information that should be provided to clients, + along with information regarding the operation of the + server. This configuration file is described in dhcpd.conf(5). @@ -2966,21 +2962,21 @@ dhcpd_ifaces="dc0" The DHCP server keeps a database of leases it has issued in this file, which is written - as a log. Refer to dhcpd.leases(5), which - gives a slightly longer description. + as a log. Refer to dhcpd.leases(5), which gives a + slightly longer description. /usr/local/sbin/dhcrelay - This daemon is used in - advanced environments where one DHCP - server forwards a request from a client to another - DHCP server on a separate network. - If this functionality is required, install the - net/isc-dhcp42-relay - package or port. The installation includes dhcrelay(8) which - provides more detail. + This daemon is used in advanced environments where + one DHCP server forwards a request + from a client to another DHCP server + on a separate network. If this functionality is + required, install the net/isc-dhcp42-relay + package or port. The installation includes dhcrelay(8) + which provides more detail.