From owner-svn-doc-all@FreeBSD.ORG Sun Feb 15 05:37:24 2015 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 64FFF6D8; Sun, 15 Feb 2015 05:37:24 +0000 (UTC) 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)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 4D7F5ABF; Sun, 15 Feb 2015 05:37:24 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t1F5bOJx019403; Sun, 15 Feb 2015 05:37:24 GMT (envelope-from jgh@FreeBSD.org) Received: (from jgh@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t1F5bLHV019386; Sun, 15 Feb 2015 05:37:21 GMT (envelope-from jgh@FreeBSD.org) Message-Id: <201502150537.t1F5bLHV019386@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: jgh set sender to jgh@FreeBSD.org using -f From: Jason Helfman Date: Sun, 15 Feb 2015 05:37:21 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46272 - in head/en_US.ISO8859-1/books/handbook: advanced-networking basics cutting-edge disks firewalls install jails linuxemu network-servers ports ppp-and-slip 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.18-1 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: Sun, 15 Feb 2015 05:37:24 -0000 Author: jgh Date: Sun Feb 15 05:37:20 2015 New Revision: 46272 URL: https://svnweb.freebsd.org/changeset/doc/46272 Log: - remove directory class Differential Revision: https://reviews.freebsd.org/D1747 Approved by: wblock (mentor) Modified: head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml head/en_US.ISO8859-1/books/handbook/basics/chapter.xml head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml head/en_US.ISO8859-1/books/handbook/disks/chapter.xml head/en_US.ISO8859-1/books/handbook/firewalls/chapter.xml head/en_US.ISO8859-1/books/handbook/install/chapter.xml head/en_US.ISO8859-1/books/handbook/jails/chapter.xml head/en_US.ISO8859-1/books/handbook/linuxemu/chapter.xml head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml head/en_US.ISO8859-1/books/handbook/ports/chapter.xml head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml Sun Feb 15 05:29:24 2015 (r46271) +++ head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml Sun Feb 15 05:37:20 2015 (r46272) @@ -2210,7 +2210,7 @@ freebsdap 00:11:95:c3:0d:ac 1 support layer using &man.wlandebug.8;. On a &os; system prior to &os; 9.1, this program can be found in /usr/src/tools/tools/net80211. + >/usr/src/tools/tools/net80211. For example, to enable console messages related to scanning for access points and the 802.11 protocol handshakes required to arrange communication: @@ -2220,7 +2220,7 @@ freebsdap 00:11:95:c3:0d:ac 1 Many useful statistics are maintained by the 802.11 layer and wlanstats, found in /usr/src/tools/tools/net80211, + >/usr/src/tools/tools/net80211, will dump this information. These statistics should display all errors identified by the 802.11 layer. However, some errors are identified in the device drivers Modified: head/en_US.ISO8859-1/books/handbook/basics/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/basics/chapter.xml Sun Feb 15 05:29:24 2015 (r46271) +++ head/en_US.ISO8859-1/books/handbook/basics/chapter.xml Sun Feb 15 05:37:20 2015 (r46272) @@ -533,9 +533,9 @@ console none on the system. This is the user's starting directory when the user logs in. A common convention is to put all user home directories under /home/username + >/home/username or /usr/home/username. + >/usr/home/username. Each user stores their personal files and subdirectories in their own home directory. @@ -1784,16 +1784,16 @@ root 5211 0.0 0.2 3620 1724 2 Local executables and libraries. Also used as the default destination for the &os; ports framework. Within - /usr/local, the + /usr/local, the general layout sketched out by &man.hier.7; for - /usr should be + /usr should be used. Exceptions are the man directory, which is directly under /usr/local rather than + >/usr/local rather than under /usr/local/share, and + >/usr/local/share, and the ports documentation is in share/doc/port. + >share/doc/port. Modified: head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml Sun Feb 15 05:29:24 2015 (r46271) +++ head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml Sun Feb 15 05:37:20 2015 (r46272) @@ -565,7 +565,7 @@ before running "/usr/sbin/freebsd-update &prompt.root; ./install.sh GENERIC Replace X.Y-RELEASE + >X.Y-RELEASE with the version of the release being used. The GENERIC kernel will be installed in /boot/GENERIC by default. @@ -1418,7 +1418,7 @@ Script started, output file is /var/tmp/ If the build world process has previously been run on this system, a copy of the previous build may still exist - in /usr/obj. To + in /usr/obj. To speed up the new build world process, and possibly save some dependency headaches, remove this directory if it already exists: @@ -1431,7 +1431,7 @@ Script started, output file is /var/tmp/ Compile the new compiler and a few related tools, then use the new compiler to compile the rest of the new world. The result is saved to /usr/obj. + >/usr/obj. &prompt.root; cd /usr/src &prompt.root; make buildworld @@ -1439,7 +1439,7 @@ Script started, output file is /var/tmp/ Use the new compiler residing in /usr/obj to build the new + >/usr/obj to build the new kernel, in order to protect against compiler-kernel mismatches. This is necessary, as certain memory structures may have changed, and programs like @@ -1512,7 +1512,7 @@ Script started, output file is /var/tmp/ /var and /usr, with new or changed configuration files. The next step is to perform some initial configuration file updates - to /etc in + to /etc in preparation for the new world. The following command compares only those files that are essential for the success of installworld. For @@ -1529,7 +1529,7 @@ Script started, output file is /var/tmp/ Install the new world and system binaries from - /usr/obj. + /usr/obj. &prompt.root; cd /usr/src &prompt.root; make installworld @@ -2051,7 +2051,7 @@ a good job of merging. - Can /usr/obj + Can /usr/obj be removed when finished? @@ -2113,21 +2113,21 @@ Building everything.. Careful file system design or the use of ZFS datasets can make a difference. Consider putting - /usr/src and - /usr/obj on + /usr/src and + /usr/obj on separate file systems. If possible, place the file systems on separate disks on separate disk controllers. When mounting /usr/src, use + >/usr/src, use which prevents the file system from recording the file access time. If /usr/src is not on its + >/usr/src is not on its own file system, consider remounting /usr with + >/usr with . The file system holding /usr/obj can be mounted + >/usr/obj can be mounted or remounted with so that disk writes happen asynchronously. The write completes immediately, and the data is written to the disk a few @@ -2252,7 +2252,7 @@ Building everything.. should list them all in its KERNCONF, listing its own kernel first. The build machine must have the kernel configuration files for each machine in its /usr/src/sys/arch/conf. + >/usr/src/sys/arch/conf. On the build machine, build the kernel and world as described in , but do not install Modified: head/en_US.ISO8859-1/books/handbook/disks/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/disks/chapter.xml Sun Feb 15 05:29:24 2015 (r46271) +++ head/en_US.ISO8859-1/books/handbook/disks/chapter.xml Sun Feb 15 05:37:20 2015 (r46272) @@ -479,7 +479,7 @@ vfs.usermount: 0 -> 1 the user that is to mount the file system. One way to do that is for root to create a subdirectory owned by that user as /mnt/username. + >/mnt/username. In the following example, replace username with the login name of the user and usergroup with the user's @@ -3216,7 +3216,7 @@ Device 1K-blocks Used Av size for HAST operation. The HAST pool, sometimes referred to as a resource or the GEOM provider in /dev/hast/, will be called + >/dev/hast/, will be called test. Configuration of HAST is done using Modified: head/en_US.ISO8859-1/books/handbook/firewalls/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/firewalls/chapter.xml Sun Feb 15 05:29:24 2015 (r46271) +++ head/en_US.ISO8859-1/books/handbook/firewalls/chapter.xml Sun Feb 15 05:37:20 2015 (r46272) @@ -1309,7 +1309,7 @@ pass inet proto tcp from any to $localne or port. In order to use spamd's greylisting features, &man.fdescfs.5; must be mounted at /dev/fd. Add the + >/dev/fd. Add the following line to /etc/fstab: @@ -2795,7 +2795,7 @@ ipnat_rules="/etc/ipnat.rules" # rule later matching rule that is a block, the packet will be dropped. Sample rulesets can be found in /usr/share/examples/ipfilter. + >/usr/share/examples/ipfilter. When creating rules, a # character is used to mark the start of a comment and may appear at the end Modified: head/en_US.ISO8859-1/books/handbook/install/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/install/chapter.xml Sun Feb 15 05:29:24 2015 (r46271) +++ head/en_US.ISO8859-1/books/handbook/install/chapter.xml Sun Feb 15 05:37:20 2015 (r46272) @@ -582,7 +582,7 @@ Memory stick images for &os; 8.X can be downloaded from the ISO-IMAGES/ directory at + >ISO-IMAGES/ directory at ftp://ftp.FreeBSD.org/pub/FreeBSD/releases/arch/ISO-IMAGES/version/&os;-version-RELEASE-arch-memstick.img. Replace arch and version with the architecture @@ -704,7 +704,7 @@ The floppy images have a .flp extension. floppies/ contains a number + >floppies/ contains a number of different images. Download boot.flp as well as the number of files associated with the type of installation, such as @@ -1810,7 +1810,7 @@ Mounting root from ufs:/dev/md0c &man.sysinstall.8; uses it, so following it makes the installation slightly cleaner. This filesystem can be mounted anywhere; this example mounts it as /diskn, + >/diskn, where n is a number that changes for each disk. Modified: head/en_US.ISO8859-1/books/handbook/jails/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/jails/chapter.xml Sun Feb 15 05:29:24 2015 (r46271) +++ head/en_US.ISO8859-1/books/handbook/jails/chapter.xml Sun Feb 15 05:37:20 2015 (r46272) @@ -278,10 +278,10 @@ done point. This is where the jail will physically reside within the file system of the jail's host. A good choice can be /usr/jail/jailname, + >/usr/jail/jailname, where jailname is the hostname identifying the jail. The - /usr/ file system + /usr/ file system usually has enough space for the jail file system, which for complete jails is, essentially, a replication of every file present in a default installation of the &os; @@ -307,10 +307,10 @@ done make installs every needed configuration file. In simple words, it installs every installable file of - /usr/src/etc/ to the - /etc directory of the + /usr/src/etc/ to the + /etc directory of the jail environment: - $D/etc/. + $D/etc/. @@ -830,12 +830,12 @@ jail_www_devfs_enable="YES"The jail_name_rootdir variable is set to - /usr/home instead - of /home because + /usr/home instead + of /home because the physical path of /home on a default &os; + >/home on a default &os; installation is /usr/home. The + >/usr/home. The jail_name_rootdir variable must not be set to a path which includes a symbolic link, otherwise the jails will Modified: head/en_US.ISO8859-1/books/handbook/linuxemu/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/linuxemu/chapter.xml Sun Feb 15 05:29:24 2015 (r46271) +++ head/en_US.ISO8859-1/books/handbook/linuxemu/chapter.xml Sun Feb 15 05:37:20 2015 (r46272) @@ -379,23 +379,23 @@ Installation complete. need to be copied from the CDROM or from a host with &mathematica; installed to the local machine. These fonts are normally stored in /cdrom/Unix/Files/SystemFiles/Fonts + >/cdrom/Unix/Files/SystemFiles/Fonts on the CDROM, or /usr/local/mathematica/SystemFiles/Fonts + >/usr/local/mathematica/SystemFiles/Fonts on the hard drive. The actual fonts are in the subdirectories - Type1 and - X. There are several + Type1 and + X. There are several ways to use them, as described below. The first way is to copy the fonts into one of the existing font directories in /usr/local/lib/X11/fonts then + >/usr/local/lib/X11/fonts then running &man.mkfontdir.1; within the directory containing the new fonts. The second way to do this is to copy the directories to /usr/local/lib/X11/fonts: + >/usr/local/lib/X11/fonts: &prompt.root; cd /usr/local/lib/X11/fonts &prompt.root; mkdir X @@ -421,11 +421,11 @@ Installation complete. fonts If /usr/local/lib/X11/fonts/Type1 + >/usr/local/lib/X11/fonts/Type1 does not already exist, change the name of the MathType1 directory in the + >MathType1 directory in the example above to Type1. + >Type1. --> @@ -473,7 +473,7 @@ Installation complete. RedHat option when prompted by the installation program. A typical installation directory might be /usr/local/maple. + >/usr/local/maple. Copy the license to @@ -775,7 +775,7 @@ exit 0 Place the following startup script in /usr/local/bin/matlab: + >/usr/local/bin/matlab: #!/bin/sh /compat/linux/bin/sh /compat/linux/usr/local/matlab/bin/matlab "$@" @@ -1024,7 +1024,7 @@ export PATH Installing &oracle; Before starting the installer, create a directory named - /var/tmp/.oracle which + /var/tmp/.oracle which is owned by the oracle user. The installation of &oracle; should work without any problems. If errors are encountered, check @@ -1055,7 +1055,7 @@ export PATH some actions, which need to be performed as root, are recorded in a shell script called root.sh. This script is - found in orainst. + found in orainst. Apply the following patch to root.sh so that it can find the &os; location of chown. Alternatively, run the script @@ -1082,7 +1082,7 @@ export PATH If &oracle; is not installed from CD, patch the source for root.sh. It is called rthd.sh and is located in - orainst in the source + orainst in the source tree. @@ -1203,9 +1203,9 @@ export PATH lookups. This is, in effect, equivalent to the option to file system mounts. First, an attempt is made to lookup the file in /compat/linux/original-path. + >/compat/linux/original-path. If that fails, the lookup is done in /original-path. + >/original-path. This makes sure that binaries that require other binaries can run. For example, the &linux; toolchain can all run under &linux; ABI support. It also means that the Modified: head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Sun Feb 15 05:29:24 2015 (r46271) +++ head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml Sun Feb 15 05:37:20 2015 (r46272) @@ -957,7 +957,7 @@ Exports list on foobar: attempt to access a file within /net/foobar/usr would tell &man.automountd.8; to mount the /usr export from the host + >/usr export from the host foobar. @@ -976,9 +976,9 @@ Exports list on foobar: The output from showmount shows - /usr as an export. + /usr as an export. When changing directories to /host/foobar/usr, + >/host/foobar/usr, &man.automountd.8; intercepts the request and attempts to resolve the hostname foobar. If successful, @@ -4486,7 +4486,7 @@ $include Kexample.com.+005+nnnnn.ZSK.key Binaries are stored in the bin and sbin subdirectories of the server root and configuration files are stored in the etc/apache2x + >etc/apache2x subdirectory. Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Sun Feb 15 05:29:24 2015 (r46271) +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Sun Feb 15 05:37:20 2015 (r46272) @@ -1645,7 +1645,7 @@ The deinstallation will free 229 kB It may be convenient to put poudriere datasets in an isolated tree mounted at /poudriere. Defaults for the + >/poudriere. Defaults for the other configuration values are adequate. The number of processor cores detected is used to define how @@ -1726,7 +1726,7 @@ Building new INDEX files... done.The basic configuration shown here puts a single jail-, port-, and set-specific make.conf in /usr/local/etc/poudriere.d. + >/usr/local/etc/poudriere.d. The filename in this example is created by combining the jail name, port name, and set name: 10amd64-local-workstation-make.conf. Modified: head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Sun Feb 15 05:29:24 2015 (r46271) +++ head/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.xml Sun Feb 15 05:37:20 2015 (r46272) @@ -581,7 +581,7 @@ exec /usr/sbin/ppp -direct $IDENTpchilds:*:1011:300:Peter Childs PPP:/home/ppp:/etc/ppp/ppp-dialup Create a /home/ppp directory that + >/home/ppp directory that is world readable containing the following 0 byte files: