aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRuslan Ermilov <ru@FreeBSD.org>2006-09-18 11:55:10 +0000
committerRuslan Ermilov <ru@FreeBSD.org>2006-09-18 11:55:10 +0000
commit8266d476702faafb2467afd308fad40249a195c3 (patch)
treeb369038754c0536266106c3ef544221d64ded305
parentbe3253cad8900e2bb72db13502b3797579977560 (diff)
downloadsrc-8266d476702faafb2467afd308fad40249a195c3.tar.gz
src-8266d476702faafb2467afd308fad40249a195c3.zip
Notes
-rw-r--r--sbin/bsdlabel/bsdlabel.82
-rw-r--r--sbin/camcontrol/camcontrol.84
-rw-r--r--sbin/dump/dump.818
-rw-r--r--sbin/fdisk_pc98/fdisk.86
-rw-r--r--sbin/fsdb/fsdb.82
-rw-r--r--sbin/gbde/gbde.82
-rw-r--r--sbin/geom/class/mirror/gmirror.88
-rw-r--r--sbin/geom/class/nop/gnop.87
-rw-r--r--sbin/ggate/ggatec/ggatec.82
-rw-r--r--sbin/ifconfig/ifconfig.815
-rw-r--r--sbin/ipfw/ipfw.86
-rw-r--r--sbin/mdmfs/mdmfs.84
-rw-r--r--sbin/mount/mount.850
-rw-r--r--sbin/setkey/setkey.846
14 files changed, 96 insertions, 76 deletions
diff --git a/sbin/bsdlabel/bsdlabel.8 b/sbin/bsdlabel/bsdlabel.8
index 869b41148fde..ba7eea6b9a68 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 dcae09110d45..c6691fc10cff 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 cd01a75a6254..6759bdaabdd4 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 c315dd3b9e1a..94f05f5e919b 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 77adaee38815..5fc6f2414b4c 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 d9994ea2ecbb..96bbb607d002 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 8feb316c1767..a58212cae735 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 2ec29faef8ad..550ded1def03 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 195f0b751da1..09f0444fa6a5 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 041cd6c3d201..73ced9a09813 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 ec70dd724b22..4efef7212222 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 9bbf6d3cbdda..689e4f32158f 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 2c0497f65cb2..db3e47703d3b 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 1c15219b0d67..4ea7d390acdd 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: