diff options
author | ru <ru@FreeBSD.org> | 2006-09-18 11:55:10 +0000 |
---|---|---|
committer | ru <ru@FreeBSD.org> | 2006-09-18 11:55:10 +0000 |
commit | 731fda35ce88946da33482413f668ed0742794f7 (patch) | |
tree | b369038754c0536266106c3ef544221d64ded305 /sbin | |
parent | 6188505097e44ad99cae9c5396c99721c1b0624e (diff) | |
download | FreeBSD-src-731fda35ce88946da33482413f668ed0742794f7.zip FreeBSD-src-731fda35ce88946da33482413f668ed0742794f7.tar.gz |
Markup fixes.
Diffstat (limited to 'sbin')
-rw-r--r-- | sbin/bsdlabel/bsdlabel.8 | 2 | ||||
-rw-r--r-- | sbin/camcontrol/camcontrol.8 | 4 | ||||
-rw-r--r-- | sbin/dump/dump.8 | 18 | ||||
-rw-r--r-- | sbin/fdisk_pc98/fdisk.8 | 6 | ||||
-rw-r--r-- | sbin/fsdb/fsdb.8 | 2 | ||||
-rw-r--r-- | sbin/gbde/gbde.8 | 2 | ||||
-rw-r--r-- | sbin/geom/class/mirror/gmirror.8 | 8 | ||||
-rw-r--r-- | sbin/geom/class/nop/gnop.8 | 7 | ||||
-rw-r--r-- | sbin/ggate/ggatec/ggatec.8 | 2 | ||||
-rw-r--r-- | sbin/ifconfig/ifconfig.8 | 15 | ||||
-rw-r--r-- | sbin/ipfw/ipfw.8 | 6 | ||||
-rw-r--r-- | sbin/mdmfs/mdmfs.8 | 4 | ||||
-rw-r--r-- | sbin/mount/mount.8 | 50 | ||||
-rw-r--r-- | sbin/setkey/setkey.8 | 46 |
14 files changed, 96 insertions, 76 deletions
diff --git a/sbin/bsdlabel/bsdlabel.8 b/sbin/bsdlabel/bsdlabel.8 index 869b411..ba7eea6 100644 --- a/sbin/bsdlabel/bsdlabel.8 +++ b/sbin/bsdlabel/bsdlabel.8 @@ -31,7 +31,7 @@ .\" @(#)disklabel.8 8.2 (Berkeley) 4/19/94 .\" $FreeBSD$ .\" -.Dd September 17, 2005 +.Dd March 8, 2006 .Dt BSDLABEL 8 .Os .Sh NAME diff --git a/sbin/camcontrol/camcontrol.8 b/sbin/camcontrol/camcontrol.8 index dcae091..c6691fc 100644 --- a/sbin/camcontrol/camcontrol.8 +++ b/sbin/camcontrol/camcontrol.8 @@ -27,7 +27,7 @@ .\" .\" $FreeBSD$ .\" -.Dd September 14, 1998 +.Dd August 21, 2006 .Dt CAMCONTROL 8 .Os .Sh NAME @@ -279,7 +279,7 @@ By default, .Nm will print out the list of logical units (LUNs) supported by the target device. There are a couple of options to modify the output: -.Bl -tag -width 01234567890123 +.Bl -tag -width 14n .It Fl c Just print out a count of LUNs, not the actual LUN numbers. .It Fl l diff --git a/sbin/dump/dump.8 b/sbin/dump/dump.8 index cd01a75..6759bda 100644 --- a/sbin/dump/dump.8 +++ b/sbin/dump/dump.8 @@ -453,13 +453,6 @@ program. Pathname of a remote shell program, if not .Xr rsh 1 . .El -.Sh EXAMPLES -Dumps the "/u" file system to dvds using growisofs. -Uses a 16MB cache and creates a snapshot of the dump and records the -dumpdates file. -.Bd -literal -/sbin/dump -0u -L -C16 -B4589840 -P 'growisofs -Z /dev/cd0=/dev/fd/0' /u -.Ed .Sh FILES .Bl -tag -width /etc/dumpdates -compact .It Pa /dev/sa0 @@ -480,6 +473,17 @@ to find group Dump exits with zero status on success. Startup errors are indicated with an exit code of 1; abnormal termination is indicated with an exit code of 3. +.Sh EXAMPLES +Dumps the +.Pa /u +file system to DVDs using +.Nm growisofs . +Uses a 16MB cache, creates a snapshot of the dump, and records the +.Pa dumpdates +file. +.Bd -literal +/sbin/dump -0u -L -C16 -B4589840 -P 'growisofs -Z /dev/cd0=/dev/fd/0' /u +.Ed .Sh DIAGNOSTICS Many, and verbose. .Sh SEE ALSO diff --git a/sbin/fdisk_pc98/fdisk.8 b/sbin/fdisk_pc98/fdisk.8 index c315dd3..94f05f5 100644 --- a/sbin/fdisk_pc98/fdisk.8 +++ b/sbin/fdisk_pc98/fdisk.8 @@ -67,7 +67,8 @@ if .Fl f is given. .It Fl I -Initialize the partition table. One +Initialize the partition table. +One .Fx slice covering the entire disk will be created. Some space at the start of the disk will reserved for the IPL program @@ -99,7 +100,8 @@ is used, you are not asked if you really want to write the partition table (as you are in the interactive mode). Use with caution! .It Fl i -Initialize sector 0 of the disk. This implies +Initialize sector 0 of the disk. +This implies .Fl u , unless .Fl f diff --git a/sbin/fsdb/fsdb.8 b/sbin/fsdb/fsdb.8 index 77adaee..5fc6f24 100644 --- a/sbin/fsdb/fsdb.8 +++ b/sbin/fsdb/fsdb.8 @@ -118,7 +118,7 @@ Print out the block list of the active inode. Note that the printout can become long for large files, since all indirect block pointers will also be printed. .Pp -.It Cm findblk Ar disk block number ... +.It Cm findblk Ar disk_block_number ... Find the inode(s) owning the specified disk block(s) number(s). Note that these are not absolute disk blocks numbers, but offsets from the start of the partition. diff --git a/sbin/gbde/gbde.8 b/sbin/gbde/gbde.8 index d9994ea..96bbb60 100644 --- a/sbin/gbde/gbde.8 +++ b/sbin/gbde/gbde.8 @@ -31,7 +31,7 @@ .\" .\" $FreeBSD$ .\" -.Dd February 12, 2005 +.Dd February 8, 2006 .Dt GBDE 8 .Os .Sh NAME diff --git a/sbin/geom/class/mirror/gmirror.8 b/sbin/geom/class/mirror/gmirror.8 index 8feb316..a58212c 100644 --- a/sbin/geom/class/mirror/gmirror.8 +++ b/sbin/geom/class/mirror/gmirror.8 @@ -120,7 +120,9 @@ indicates an action to be performed: Create a mirror. The order of components is important, because a component's priority is based on its position (starting from 0). -The component with the biggest priority is used by the prefer balance algorithm +The component with the biggest priority is used by the +.Cm prefer +balance algorithm and is also used as a master component when resynchronization is needed, e.g.\& after a power failure when the device was open for writing. .Pp @@ -291,7 +293,8 @@ This is possible, but some conditions have to be met. First of all, a kernel dump will go only to one component and .Nm always chooses the component with the highest priority. -Reading a dump from the mirror on boot will only work if the prefer +Reading a dump from the mirror on boot will only work if the +.Cm prefer balance algorithm is used (that way .Nm will read only from the component with the highest priority). @@ -320,7 +323,6 @@ will find nothing. If on the next boot a component with the highest priority will be synchronized, the prefer balance algorithm will read from the next one, thus will find nothing there. -.Ed .Sh SEE ALSO .Xr geom 4 , .Xr dumpon 8 , diff --git a/sbin/geom/class/nop/gnop.8 b/sbin/geom/class/nop/gnop.8 index 2ec29fa..550ded1 100644 --- a/sbin/geom/class/nop/gnop.8 +++ b/sbin/geom/class/nop/gnop.8 @@ -108,7 +108,7 @@ See .El .Pp Additional options: -.Bl -tag -width ".Fl f Ar rfailprob" +.Bl -tag -width ".Fl r Ar rfailprob" .It Fl e Ar error Specifies the error number to return on failure. .It Fl f @@ -153,10 +153,11 @@ gnop create -v -f 50 da0 gnop destroy -v da0.nop .Ed .Pp -The traffic statistics for the given transparent providers we can get with +The traffic statistics for the given transparent providers can be obtained +with the .Cm list command. -Example below shows how can we obtain number of bytes written with +Example below shows the number of bytes written with .Xr newfs 8 : .Bd -literal -offset indent gnop create da0 diff --git a/sbin/ggate/ggatec/ggatec.8 b/sbin/ggate/ggatec/ggatec.8 index 195f0b7..09f0444 100644 --- a/sbin/ggate/ggatec/ggatec.8 +++ b/sbin/ggate/ggatec/ggatec.8 @@ -164,7 +164,7 @@ Make use of CD-ROM device from remote host. server# cat /etc/gg.exports client RO /dev/acd0 server# ggated -.Pp + client# ggatec create -o ro server /dev/acd0 ggate0 client# mount_cd9660 /dev/ggate0 /cdrom diff --git a/sbin/ifconfig/ifconfig.8 b/sbin/ifconfig/ifconfig.8 index 041cd6c..73ced9a 100644 --- a/sbin/ifconfig/ifconfig.8 +++ b/sbin/ifconfig/ifconfig.8 @@ -28,7 +28,7 @@ .\" From: @(#)ifconfig.8 8.3 (Berkeley) 1/5/94 .\" $FreeBSD$ .\" -.Dd July 25, 2006 +.Dd September 6, 2006 .Dt IFCONFIG 8 .Os .Sh NAME @@ -595,11 +595,11 @@ parameter is specified in TU's (1/1024 msecs). By default beacon frames are transmitted every 100 TU's. .It Cm bmissthreshold Ar count Set the number of consecutive missed beacons at which the station -will attempt to roam (i.e. search for a new access point). +will attempt to roam (i.e., search for a new access point). The .Ar count -parameter is must be in the range 1 to 255; though the -upper bound may be reduced according to device capabilities.. +parameter must be in the range 1 to 255; though the +upper bound may be reduced according to device capabilities. The default threshold is 7 consecutive missed beacons; but this may be overridden by the device driver. Another name for the @@ -719,7 +719,8 @@ mode. Channels identified as .Ql 11a Turbo may be used only for Atheros' Static Turbo mode -.Pq specified with Cm mediaopt turbo . +(specified with +. Cm mediaopt turbo ) . Channels marked with a .Ql * have a regulatory constraint that they be passively scanned. @@ -787,7 +788,7 @@ See the description of the directive for information on the various parameters. .It Cm mcastrate Ar rate Set the rate for transmitting multicast/broadcast frames. -Rates are specified as megabits/second in decimal; e.g. 5.5 for 5.5 Mb/s. +Rates are specified as megabits/second in decimal; e.g.\& 5.5 for 5.5 Mb/s. This rate should be valid for the current operating conditions; if an invalid rate is specified drivers are free to chose an appropriate rate. @@ -1322,7 +1323,7 @@ interfaces: .It Cm maxupd Ar n Set the maximum number of updates for a single state which can be collapsed into one. -This is an 8-bit number; the default value is 128. +This is an 8-bit number; the default value is 128. .El .Pp The following parameters are specific to diff --git a/sbin/ipfw/ipfw.8 b/sbin/ipfw/ipfw.8 index ec70dd7..4efef72 100644 --- a/sbin/ipfw/ipfw.8 +++ b/sbin/ipfw/ipfw.8 @@ -232,7 +232,8 @@ commands in a script .Ql sh\ /etc/rc.firewall ) , or by processing a file of many .Nm -rules across a remote login session. It also stops a table add or delete +rules across a remote login session. +It also stops a table add or delete from failing if the entry already exists or is not present. If a .Cm flush @@ -577,7 +578,8 @@ socket. .Pp To check for previously applied tags, use the .Cm tagged -rule option. To delete previously applied tag, use the +rule option. +To delete previously applied tag, use the .Cm untag keyword. .Pp diff --git a/sbin/mdmfs/mdmfs.8 b/sbin/mdmfs/mdmfs.8 index 9bbf6d3..689e4f3 100644 --- a/sbin/mdmfs/mdmfs.8 +++ b/sbin/mdmfs/mdmfs.8 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd January 2, 2006 +.Dd February 16, 2006 .Dt MDMFS 8 .Os .Sh NAME @@ -206,7 +206,7 @@ See .Xr mount 8 for more information. .It Fl P -Preserve the existing filesystem; +Preserve the existing file system; do not run .Xr newfs 8 . This only makes sense if diff --git a/sbin/mount/mount.8 b/sbin/mount/mount.8 index 2c0497f..db3e477 100644 --- a/sbin/mount/mount.8 +++ b/sbin/mount/mount.8 @@ -39,14 +39,14 @@ .Op Fl adflpruvw .Op Fl F Ar fstab .Op Fl o Ar options -.Op Fl t Ar ufs | external_type +.Op Fl t Cm ufs | Ar external_type .Nm .Op Fl dfpruvw .Ar special | node .Nm .Op Fl dfpruvw .Op Fl o Ar options -.Op Fl t Ar ufs | external_type +.Op Fl t Cm ufs | Ar external_type .Ar special node .Sh DESCRIPTION The @@ -54,8 +54,8 @@ The utility calls the .Xr nmount 2 system call to prepare and graft a -.Ar "special device" -or the remote node (rhost:path) on to the file system tree at the point +.Ar special +device or the remote node (rhost:path) on to the file system tree at the point .Ar node . If either .Ar special @@ -77,9 +77,9 @@ All the file systems described in .Xr fstab 5 are mounted. Exceptions are those marked as -.Dq noauto , +.Dq Li noauto , those marked as -.Dq late +.Dq Li late (unless the .Fl l option was specified), @@ -110,7 +110,7 @@ caution). When used in conjunction with the .Fl a option, also mount those file systems which are marked as -.Dq late . +.Dq Li late . .It Fl o Options are specified with a .Fl o @@ -368,12 +368,12 @@ The same as the argument to the .Fl o option. -.It Fl t Ar ufs | external_type +.It Fl t Cm ufs | Ar external_type The argument following the .Fl t is used to indicate the file system type. The type -.Ar ufs +.Cm ufs is the default. The .Fl t @@ -382,7 +382,7 @@ to indicate that the actions should only be taken on file systems of the specified type. More than one type may be specified in a comma separated list. The list of file system types can be prefixed with -.Dq no +.Dq Li no to specify the file system types for which action should .Em not be taken. @@ -409,20 +409,20 @@ system call in the option. .Pp However, for the following file system types: -.Ar cd9660 , -.Ar mfs , -.Ar msdosfs , -.Ar nfs , -.Ar nfs4 , -.Ar ntfs , -.Ar nwfs , -.Ar nullfs , -.Ar portalfs , -.Ar smbfs , -.Ar udf , -.Ar umapfs , +.Cm cd9660 , +.Cm mfs , +.Cm msdosfs , +.Cm nfs , +.Cm nfs4 , +.Cm ntfs , +.Cm nwfs , +.Cm nullfs , +.Cm portalfs , +.Cm smbfs , +.Cm udf , +.Cm umapfs , and -.Ar unionfs , +.Cm unionfs , .Nm will not call .Xr nmount 2 @@ -499,10 +499,10 @@ support for a particular file system might be provided either on a static .Xr nmount 2 , .Xr acl 3 , .Xr mac 4 , -.Xr fstab 5 , -.Xr kldload 8 , .Xr ext2fs 5 , +.Xr fstab 5 , .Xr procfs 5 , +.Xr kldload 8 , .Xr mount_cd9660 8 , .Xr mount_msdosfs 8 , .Xr mount_nfs 8 , diff --git a/sbin/setkey/setkey.8 b/sbin/setkey/setkey.8 index 1c15219..4ea7d39 100644 --- a/sbin/setkey/setkey.8 +++ b/sbin/setkey/setkey.8 @@ -29,7 +29,7 @@ .\" .\" $FreeBSD$ .\" -.Dd January 8, 2006 +.Dd May 13, 2006 .Dt SETKEY 8 .Os .\" @@ -408,10 +408,11 @@ as well as .Li ip4 , or .Li any . -.Li Any +The word +.Li any stands for .Dq any protocol . -The protocol number may also be used to specify the +The protocol number may also be used to specify the .Ar upperspec . A type and code related to ICMPv6 may also be specified as an .Ar upperspec . @@ -419,8 +420,8 @@ The type is specified first, followed by a comma and then the relevant code. The specification must be placed after .Li icmp6 . -The kernel considers a zero to be a wildcard but -cannot distinguish between a wildcard and an ICMPv6 +The kernel considers a zero to be a wildcard but +cannot distinguish between a wildcard and an ICMPv6 type which is zero. The following example shows a policy where IPSec is not required for inbound Neighbor Solicitations: @@ -452,21 +453,25 @@ The direction of a policy must be specified as one of: .Li out , .Li in , -.Li discard +.Li discard , .Li none , -or +or .Li ipsec . -.Li Discard +The +.Li discard +direction means that packets matching the supplied indices will be discarded -while +while .Li none means that IPsec operations will not take place on the packet and .Li ipsec means that IPsec operation will take place onto the packet. -The +The .Ar protocol/mode/src-dst/level statement gives the rule for how to process the packet. -.Ar Protocol is specified as +The +.Ar protocol +is specified as .Li ah , .Li esp or @@ -485,7 +490,7 @@ you must specify the end-point addresses of the SA as .Ar src and .Ar dst -with a dash, +with a dash, .Sq - , between the addresses. If @@ -507,17 +512,19 @@ If the SA is not available in every level, the kernel will request the SA from the key exchange daemon. A value of .Li default -tells the kernel to use the system wide default protocol -e.g. the one from the +tells the kernel to use the system wide default protocol +e.g.\& the one from the .Li esp_trans_deflev sysctl variable, when the kernel processes the packet. -.Li Use +A value of +.Li use means that the kernel will use an SA if it is available, otherwise the kernel will pass the packet as it would normally. -.Li Require +A value of +.Li require means that an SA is required whenever the kernel sends a packet matched that matches the policy. -The +The .Li unique level is the same as .Li require @@ -535,12 +542,13 @@ as in the following example: .Li unique:number . In order to bind this policy to the SA, .Li number -must be between 1 and 32767, +must be between 1 and 32767, which corresponds to .Ar extensions Fl u of manual SA configuration. .Pp -When you want to use an SA bundle, you can define multiple rules. For +When you want to use an SA bundle, you can define multiple rules. +For example, if an IP header was followed by an AH header followed by an ESP header followed by an upper layer protocol header, the rule would be: |