From owner-svn-doc-all@FreeBSD.ORG Thu Aug 8 17:21:07 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 E129D9DD; Thu, 8 Aug 2013 17:21:07 +0000 (UTC) (envelope-from wblock@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 C86A82654; Thu, 8 Aug 2013 17:21:07 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r78HL7LV068077; Thu, 8 Aug 2013 17:21:07 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r78HL7Ei068076; Thu, 8 Aug 2013 17:21:07 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201308081721.r78HL7Ei068076@svn.freebsd.org> From: Warren Block Date: Thu, 8 Aug 2013 17:21:07 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42524 - head/en_US.ISO8859-1/books/handbook/config 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, 08 Aug 2013 17:21:08 -0000 Author: wblock Date: Thu Aug 8 17:21:07 2013 New Revision: 42524 URL: http://svnweb.freebsd.org/changeset/doc/42524 Log: Whitespace-only fixes. Translators, please ignore. Modified: head/en_US.ISO8859-1/books/handbook/config/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/config/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/config/chapter.xml Thu Aug 8 17:00:17 2013 (r42523) +++ head/en_US.ISO8859-1/books/handbook/config/chapter.xml Thu Aug 8 17:21:07 2013 (r42524) @@ -270,7 +270,6 @@ sshd_enable="YES" keyrate="fast" defaultrouter="10.1.1.254" - @@ -278,7 +277,6 @@ defaultrouter="10.1.1.254"hostname="node1.example.org" ifconfig_fxp0="inet 10.1.1.1/8" - @@ -608,9 +606,9 @@ PATH=/etc:/bin:/sbin:/usr/bin:/usr/sbin Users who wish to begin their own crontab file from scratch, without the - use of a template, can use crontab -e. This - will invoke the default editor with an empty file. When this - file is saved, it will be automatically installed by + use of a template, can use crontab -e. + This will invoke the default editor with an empty file. When + this file is saved, it will be automatically installed by &man.crontab.1;. In order to remove a user &man.crontab.5; completely, @@ -633,12 +631,13 @@ PATH=/etc:/bin:/sbin:/usr/bin:/usr/sbin Using &man.rc.8; Under &os; In 2002, &os; integrated the NetBSD &man.rc.8; system for - system initialization. The files listed in /etc/rc.d provide basic services - which can be controlled with the , - , and options - to &man.service.8;. For instance, &man.sshd.8; can be restarted - with the following command: + system initialization. The files listed in + /etc/rc.d provide basic + services which can be controlled with the + , , and + options to &man.service.8;. For + instance, &man.sshd.8; can be restarted with the following + command: &prompt.root; service sshd restart @@ -1262,15 +1261,15 @@ round-trip min/avg/max/stddev = 0.700/0. host. This can happen if no default route is specified or if a cable is unplugged. Check the output of netstat -rn and make sure there is a - valid route to the host. If there is not, read . + valid route to the host. If there is not, read + . ping: sendto: Permission denied error messages are often caused by a misconfigured firewall. If a firewall is enabled on &os; but no rules have been defined, the default policy is to deny all traffic, even - &man.ping.8;. Refer to for more information. + &man.ping.8;. Refer to + for more information. Sometimes performance of the card is poor or below average. In these cases, try setting the media @@ -1314,9 +1313,9 @@ round-trip min/avg/max/stddev = 0.700/0. given interface, there must be one address which correctly represents the network's netmask. Any other addresses which fall within this network must have a netmask of all - 1s, expressed as either 255.255.255.255 or 0xffffffff. + 1s, expressed as either + 255.255.255.255 or + 0xffffffff. For example, consider the case where the fxp0 interface is connected to two @@ -1324,18 +1323,18 @@ round-trip min/avg/max/stddev = 0.700/0. netmask of 255.255.255.0 and 202.0.75.16 with a netmask of 255.255.255.240. The system - is to be configured to appear in the ranges 10.1.1.1 through 10.1.1.5 and 202.0.75.17 through 202.0.75.20. Only the first address - in a given network range should have a real netmask. All the - rest (10.1.1.2 through 10.1.1.5 and 202.0.75.18 through 202.0.75.20) must be configured with - a netmask of 255.255.255.255. + is to be configured to appear in the ranges + 10.1.1.1 through + 10.1.1.5 and + 202.0.75.17 through + 202.0.75.20. Only the first + address in a given network range should have a real netmask. + All the rest (10.1.1.2 through + 10.1.1.5 and + 202.0.75.18 through + 202.0.75.20) must be configured + with a netmask of + 255.255.255.255. The following /etc/rc.conf entries configure the adapter correctly for this scenario: @@ -1349,7 +1348,6 @@ ifconfig_fxp0_alias4="inet 202.0.75.17 n ifconfig_fxp0_alias5="inet 202.0.75.18 netmask 255.255.255.255" ifconfig_fxp0_alias6="inet 202.0.75.19 netmask 255.255.255.255" ifconfig_fxp0_alias7="inet 202.0.75.20 netmask 255.255.255.255" - @@ -1396,8 +1394,8 @@ ifconfig_fxp0_alias7="inet 202.0.75.20 n syslogd_flags in /etc/rc.conf. Refer to &man.syslogd.8; for more information on the arguments, and &man.rc.conf.5;, - and for more information about + and + for more information about /etc/rc.conf and the &man.rc.8; subsystem. @@ -1537,8 +1535,8 @@ cron.* facilities, refer to &man.syslog.3; and &man.syslogd.8;. For more information about /etc/syslog.conf, its syntax, and more - advanced usage examples, see &man.syslog.conf.5; and . + advanced usage examples, see &man.syslog.conf.5; and + . @@ -1632,14 +1630,14 @@ cron.* &man.newsyslog.8; further instructions, such as how to compress the rotated file or to create the log file if it is missing. The last two fields are optional, and - specify the PID file of a process - and a signal number to send to that process when the file - is rotated. For more information on all fields, valid + specify the + PID file of a + process and a signal number to send to that process when the + file is rotated. For more information on all fields, valid flags, and how to specify the rotation time, refer to - &man.newsyslog.conf.5;. Since &man.newsyslog.8; is run - from &man.cron.8;, it can not rotate files more often than - it is run from &man.cron.8;. + &man.newsyslog.conf.5;. Since &man.newsyslog.8; is run from + &man.cron.8;, it can not rotate files more often than it is + run from &man.cron.8;. @@ -1735,9 +1733,8 @@ cron.* resolv.conf - How a - &os; system accesses the Internet Domain Name System - (DNS) is controlled by + How a &os; system accesses the Internet Domain Name + System (DNS) is controlled by &man.resolv.conf.5;. The most common entries to @@ -1896,8 +1893,8 @@ kern.maxfiles: 2088 -> 5000 To automatically set some variables each time the machine boots, add them to /etc/sysctl.conf. For - more information, refer to &man.sysctl.conf.5; and . + more information, refer to &man.sysctl.conf.5; and + . <filename>sysctl.conf</filename> @@ -1923,7 +1920,6 @@ kern.logsigexit=0 # Prevent users from seeing information about processes that # are being run under another UID. security.bsd.see_other_uids=0 - @@ -2189,16 +2185,16 @@ device_probe_and_attach: cbb0 attach ret data blocks of a file did not find their way out of the buffer cache onto the disk by the time of the crash, &man.fsck.8; recognizes this and repairs the file system - by setting the file length to - 0. Additionally, the implementation is - clear and simple. The disadvantage is that meta-data - changes are slow. For example, rm -r - touches all the files in a directory sequentially, but each - directory change will be written synchronously to the - disk. This includes updates to the directory itself, to - the inode table, and possibly to indirect blocks allocated - by the file. Similar considerations apply for unrolling - large hierarchies using tar -x. + by setting the file length to 0. + Additionally, the implementation is clear and simple. The + disadvantage is that meta-data changes are slow. For + example, rm -r touches all the files in a + directory sequentially, but each directory change will be + written synchronously to the disk. This includes updates to + the directory itself, to the inode table, and possibly to + indirect blocks allocated by the file. Similar + considerations apply for unrolling large hierarchies using + tar -x. The second approach is to use asynchronous meta-data updates. This is the default for a UFS @@ -2266,7 +2262,7 @@ device_probe_and_attach: cbb0 attach ret in use are marked as such in their blocks and inodes. After a crash, the only resource allocation error that occurs is that resources are marked as used - which are actually free. &man.fsck.8; + which are actually free. &man.fsck.8; recognizes this situation, and frees the resources that are no longer used. It is safe to ignore the dirty state of the file system after a crash by forcibly mounting it @@ -2381,7 +2377,7 @@ device_probe_and_attach: cbb0 attach ret compile software. The most important table set by maxusers is the maximum number of processes, which is set to - 20 + 16 * maxusers. If + 20 + 16 * maxusers. If maxusers is set to 1, there can only be 36 simultaneous processes, including @@ -2493,12 +2489,11 @@ device_probe_and_attach: cbb0 attach ret The net.inet.ip.portrange.* - &man.sysctl.8; - variables control the port number ranges automatically bound - to TCP and UDP - sockets. There are three ranges: a low range, a default - range, and a high range. Most network programs use the - default range which is controlled by + &man.sysctl.8; variables control the port number ranges + automatically bound to TCP and + UDP sockets. There are three ranges: a + low range, a default range, and a high range. Most network + programs use the default range which is controlled by net.inet.ip.portrange.first and net.inet.ip.portrange.last, which default to 1024 and 5000, @@ -2570,12 +2565,12 @@ device_probe_and_attach: cbb0 attach ret conditions, but it can also result in higher &man.ping.8; times over slow links, though still much lower than without the inflight algorithm. In such cases, try reducing this - parameter to 15, - 10, or 5 and - reducing net.inet.tcp.inflight.min - to a value such as 3500 to get the - desired effect. Reducing these parameters should be done - as a last resort only. + parameter to 15, 10, + or 5 and reducing + net.inet.tcp.inflight.min to a value such + as 3500 to get the desired effect. + Reducing these parameters should be done as a last resort + only. @@ -2634,9 +2629,9 @@ kern.maxvnodes: 100000 Adding a new hard drive for swap gives better performance than adding a partition on an existing drive. Setting up - partitions and hard drives is explained in while discusses partition + partitions and hard drives is explained in + while + discusses partition layouts and swap partition size considerations. Use &man.swapon.8; to add a swap partition to the system. @@ -2645,7 +2640,6 @@ kern.maxvnodes: 100000 &prompt.root; swapon /dev/ada1s1b - It is possible to use any partition not currently mounted, even if it already contains data. Using &man.swapon.8; on a partition that contains data will @@ -2685,7 +2679,6 @@ kern.maxvnodes: 100000 - The GENERIC kernel already includes the memory disk driver (&man.md.4;) required for this operation. When building a custom kernel, @@ -2761,8 +2754,8 @@ kern.maxvnodes: 100000 temperature increases unexpectedly. This section provides comprehensive information about - ACPI. References will be provided for further - reading. + ACPI. References will be provided for + further reading. What Is ACPI? @@ -2979,13 +2972,12 @@ kern.maxvnodes: 100000 Most &os; developers watch &a.current;, but one should submit problems to &a.acpi.name; to be sure it is seen. Be patient when waiting for a response. If the bug is not - immediately apparent, submit a - PR using &man.send-pr.1;. When entering a - PR, include the same information as - requested above. This helps developers to track the problem - and resolve it. Do not send a PR without - emailing &a.acpi.name; first as it is likely that the problem - has been reported before. + immediately apparent, submit a PR using + &man.send-pr.1;. When entering a PR, + include the same information as requested above. This helps + developers to track the problem and resolve it. Do not send a + PR without emailing &a.acpi.name; first as + it is likely that the problem has been reported before. @@ -3278,8 +3270,9 @@ hw.acpi.s4bios: 0 ASL, use &man.acpidump.8;. Include both , to show the contents of the fixed tables, and , to disassemble the - AML. Refer to for an example syntax. + AML. Refer to + for an example + syntax. The simplest first check is to recompile the ASL to check for errors. Warnings can