d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Sort sections.

Browse Source
This commit is contained in:
ru 2005-01-18 10:09:38 +00:00
parent d95b3c4c8d
commit 13fe9ea5a2
43 changed files with 345 additions and 345 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
sbin/adjkerntz/adjkerntz.8
View File

@ -171,6 +171,13 @@ Empty file.
Its presence indicates that the machine's CMOS clock is set to local
time, while its absence indicates a UTC CMOS clock.
.El
.Sh DIAGNOSTICS
No diagnostics.
If an error occurs,
.Nm
logs an error message via
.Xr syslog 3
and exits with a nonzero return code.
.Sh SEE ALSO
.Xr tzset 3 ,
.Xr crontab 5 ,
@ -179,17 +186,10 @@ time, while its absence indicates a UTC CMOS clock.
.Xr sysctl 8 ,
.Xr tzsetup 8 ,
.Xr zic 8
.Sh DIAGNOSTICS
No diagnostics.
If an error occurs,
.Nm
logs an error message via
.Xr syslog 3
and exits with a nonzero return code.
.Sh AUTHORS
.An Andrey A. Chernov Aq ache@astral.msk.su
.Sh HISTORY
The
.Nm
utility appeared in
.Fx 1.0 .
.Sh AUTHORS
.An Andrey A. Chernov Aq ache@astral.msk.su

4
sbin/atm/fore_dnld/fore_dnld.8
View File

@ -98,8 +98,6 @@ adapters.
.It Pa ~harp/doc/Install
HARP installation instructions.
.El
.Sh BUGS
None known.
.Sh COPYRIGHT
Copyright (c) 1994-1998, Network Computing Services, Inc.
.Sh AUTHORS
@ -113,3 +111,5 @@ Minnesota Supercomputer Center, Inc.
This software was developed under the sponsorship of the
Defense Advanced Research Projects Agency (DARPA) under
contract numbers F19628-92-C-0072 and F19628-95-C-0215.
.Sh BUGS
None known.

6
sbin/atm/ilmid/ilmid.8
View File

@ -94,9 +94,6 @@ The ATM Forum,
.%T "ATM User-Network Interface, Version 3.1 (UNI 3.1) Specification"
for details on the ILMI protocols and address registration
procedures.
.Sh BUGS
Please report any bugs to
.Aq harp\-bugs@magic.net .
.Sh COPYRIGHT
Copyright (c) 1994-1998, Network Computing Services, Inc.
.Sh AUTHORS
@ -109,3 +106,6 @@ Network Computing Services, Inc.
.Sh ACKNOWLEDGMENTS
This software was developed with the support of the
Defense Advanced Research Projects Agency (DARPA).
.Sh BUGS
Please report any bugs to
.Aq harp\-bugs@magic.net .

14
sbin/badsect/badsect.8
View File

@ -112,22 +112,22 @@ it will ask
A positive response will cause
.Xr fsck 8
to convert the inode to a regular file containing the bad block.
.Sh SEE ALSO
.Xr fsck 8
.Sh DIAGNOSTICS
The
.Nm
utility refuses to attach a block that
resides in a critical area or is out of range of the file system.
A warning is issued if the block is already in use.
.Sh SEE ALSO
.Xr fsck 8
.Sh HISTORY
The
.Nm
utility appeared in
.Bx 4.1 .
.Sh BUGS
If more than one sector which comprise a file system fragment are bad,
you should specify only one of them to
.Nm ,
as the blocks in the bad sector files actually cover all the sectors in a
file system fragment.
.Sh HISTORY
The
.Nm
utility appeared in
.Bx 4.1 .

20
sbin/ccdconfig/ccdconfig.8
View File

@ -129,6 +129,11 @@ The component devices need to name partitions of type
.Dq 4.2BSD
as shown by
.Xr disklabel 8 ) .
.Sh FILES
.Bl -tag -width /etc/ccd.conf -compact
.It Pa /etc/ccd.conf
default ccd configuration file
.El
.Sh EXAMPLES
A number of
.Nm
@ -209,11 +214,6 @@ or software RAID systems such as
.Xr geom 8
and
.Xr vinum 8 .
.Sh FILES
.Bl -tag -width /etc/ccd.conf -compact
.It Pa /etc/ccd.conf
default ccd configuration file
.El
.Sh SEE ALSO
.Xr dd 1 ,
.Xr ccd 4 ,
@ -222,6 +222,11 @@ default ccd configuration file
.Xr fdisk 8 ,
.Xr rc 8 ,
.Xr vinum 8
.Sh HISTORY
The
.Nm
utility first appeared in
.Nx 1.0a .
.Sh BUGS
The initial disklabel returned by
.Xr ccd 4
@ -231,8 +236,3 @@ One needs to change the number of paritions to 8 using
to get the usual
.Bx
expectations.
.Sh HISTORY
The
.Nm
utility first appeared in
.Nx 1.0a .

10
sbin/comcontrol/comcontrol.8
View File

@ -45,9 +45,6 @@ The standard way to use
is to put invocations of it in the
.Pa /etc/rc.d/serial
startup script.
.Sh SEE ALSO
.Xr stty 1 ,
.Xr sio 4
.Sh FILES
.Bl -tag -width /dev/ttyd? -compact
.It Pa /dev/ttyd?
@ -55,11 +52,14 @@ dialin devices, hardwired terminals
.It Pa /dev/cuad?
dialout devices
.El
.Sh AUTHORS
.An Christopher G. Demetriou
.Sh SEE ALSO
.Xr stty 1 ,
.Xr sio 4
.Sh HISTORY
Originally part of cgd's com package patches, version 0.2.1, to
.Bx 386 0.1 .
Once controlled bidirectional capabilities.
Little is left to control now
that these capabilities are standard.
.Sh AUTHORS
.An Christopher G. Demetriou

22
sbin/dump/dump.8
View File

@ -464,17 +464,22 @@ dump table: file systems and frequency
to find group
.Em operator
.El
.Sh EXIT STATUS
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 DIAGNOSTICS
Many, and verbose.
.Sh SEE ALSO
.Xr chflags 1 ,
.Xr fstab 5 ,
.Xr restore 8 ,
.Xr rmt 8
.Sh DIAGNOSTICS
Many, and verbose.
.Sh EXIT STATUS
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 HISTORY
A
.Nm
utility appeared in
.At v6 .
.Sh BUGS
Fewer than 32 read errors on the file system are ignored, though all
errors will generate a warning message.
@ -526,8 +531,3 @@ This will be fixed in a later version of
.Fx .
Presently, it works if you set it setuid (like it used to be), but this
might constitute a security risk.
.Sh HISTORY
A
.Nm
utility appeared in
.At v6 .

20
sbin/dumpon/dumpon.8
View File

@ -116,6 +116,13 @@ variable of
.Xr loader 8
must be used to enable dumps for system panics which occur
during kernel initialization.
.Sh FILES
.Bl -tag -width "/dev/{ad,da}?s?b" -compact
.It Pa /dev/{ad,da}?s?b
standard swap areas
.It Pa /etc/rc.conf
boot-time system configuration
.El
.Sh SEE ALSO
.Xr fstab 5 ,
.Xr rc.conf 5 ,
@ -126,18 +133,11 @@ during kernel initialization.
.Xr savecore 8 ,
.Xr swapon 8 ,
.Xr panic 9
.Sh FILES
.Bl -tag -width "/dev/{ad,da}?s?b" -compact
.It Pa /dev/{ad,da}?s?b
standard swap areas
.It Pa /etc/rc.conf
boot-time system configuration
.El
.Sh BUGS
Because the file system layer is already dead by the time a crash dump
is taken, it is not possible to send crash dumps directly to a file.
.Sh HISTORY
The
.Nm
utility appeared in
.Fx 2.1 .
.Sh BUGS
Because the file system layer is already dead by the time a crash dump
is taken, it is not possible to send crash dumps directly to a file.

20
sbin/ffsinfo/ffsinfo.8
View File

@ -119,12 +119,6 @@ is provided, output will be sent to stdout.
will dump
.Pa /dev/vinum/testvol
with all available information.
.Sh BUGS
Snapshots are handled like plain files.
They should get their own level to provide for independent control of the
amount of what gets dumped.
It probably also makes sense to some extend to dump the snapshot as a
file system.
.Sh SEE ALSO
.Xr disklabel 8 ,
.Xr dumpfs 8 ,
@ -133,12 +127,18 @@ file system.
.Xr newfs 8 ,
.Xr tunefs 8 ,
.Xr vinum 8
.Sh AUTHORS
.An Christoph Herrmann Aq chm@FreeBSD.org
.An Thomas-Henning von Kamptz Aq tomsoft@FreeBSD.org
.An The GROWFS team Aq growfs@Tomsoft.COM
.Sh HISTORY
The
.Nm
utility first appeared in
.Fx 4.4 .
.Sh AUTHORS
.An Christoph Herrmann Aq chm@FreeBSD.org
.An Thomas-Henning von Kamptz Aq tomsoft@FreeBSD.org
.An The GROWFS team Aq growfs@Tomsoft.COM
.Sh BUGS
Snapshots are handled like plain files.
They should get their own level to provide for independent control of the
amount of what gets dumped.
It probably also makes sense to some extend to dump the snapshot as a
file system.

10
sbin/fsck_msdosfs/fsck_msdosfs.8
View File

@ -114,13 +114,13 @@ as the answer to all operator questions.
.Xr fsck 8 ,
.Xr fsck_ffs 8 ,
.Xr mount_msdosfs 8
.Sh BUGS
The
.Nm
utility is
.Ud .
.Sh HISTORY
The
.Nm
utility first appeared in
.Fx 4.4 .
.Sh BUGS
The
.Nm
utility is
.Ud .

18
sbin/fsdb/fsdb.8
View File

@ -225,15 +225,6 @@ Exit the program.
.Xr fs 5 ,
.Xr clri 8 ,
.Xr fsck 8
.Sh BUGS
Manipulation of ``short'' symlinks doesn't work (in particular, don't
try changing a symlink's type).
.Pp
You must specify modes as numbers rather than symbolic names.
.Pp
There are a bunch of other things that you might want to do which
.Nm
doesn't implement.
.Sh HISTORY
The
.Nm
@ -250,6 +241,15 @@ written by
.An Peter Wemm
ported it to
.Fx .
.Sh BUGS
Manipulation of ``short'' symlinks doesn't work (in particular, don't
try changing a symlink's type).
.Pp
You must specify modes as numbers rather than symbolic names.
.Pp
There are a bunch of other things that you might want to do which
.Nm
doesn't implement.
.Sh WARNING
Use this tool with extreme caution--you can damage an FFS file system
beyond what

4
sbin/geom/class/concat/gconcat.8
View File

@ -153,6 +153,8 @@ This can be set to a number between 0 and 3 inclusive.
If set to 0 minimal debug information is printed, and if set to 3 the
maximum amount of debug information is printed.
.El
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh EXAMPLES
The following example shows how to configure four disks for automatic
concatenation, create a file system on it, and mount it:
@ -165,8 +167,6 @@ umount /mnt
gconcat stop data
gconcat unload
.Ed
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh SEE ALSO
.Xr geom 4 ,
.Xr loader.conf 5 ,

4
sbin/geom/class/label/glabel.8
View File

@ -178,6 +178,8 @@ This can be set to a number between 0 and 2 inclusive.
If set to 0 minimal debug information is printed, and if set to 2 the
maximum amount of debug information is printed.
.El
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh EXAMPLES
The following example shows how to set up a label for disk
.Dq Li da2 ,
@ -197,8 +199,6 @@ The next example shows how to set up a label for a UFS file system:
tunefs -L data /dev/da4s1a
mount /dev/ufs/data /mnt/data
.Ed
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh SEE ALSO
.Xr geom 4 ,
.Xr loader.conf 5 ,

4
sbin/geom/class/mirror/gmirror.8
View File

@ -220,6 +220,8 @@ Additional options include:
.It Fl v
Be more verbose.
.El
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh EXAMPLES
Use 3 disks to setup a mirror.
Choose split balance algorithm, split only
@ -268,8 +270,6 @@ gmirror deactivate data da1
dd if=/dev/da1 of=/backup/data.img bs=1m
gmirror activate data da1
.Ed
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh SEE ALSO
.Xr geom 4 ,
.Xr geom 8 ,

4
sbin/geom/class/nop/gnop.8
View File

@ -128,6 +128,8 @@ This can be set to a number between 0 and 2 inclusive.
If set to 0 minimal debug information is printed, and if set to 2 the
maximum amount of debug information is printed.
.El
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh EXAMPLES
The following example shows how to create a transparent provider for disk
.Pa /dev/da0
@ -136,8 +138,6 @@ with 50% failure probability, and how to destroy it.
gnop create -v -f 50 da0
gnop destroy -v da0.nop
.Ed
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh SEE ALSO
.Xr geom 4 ,
.Xr geom 8

4
sbin/geom/class/raid3/graid3.8
View File

@ -191,6 +191,8 @@ Additional options include:
.It Fl v
Be more verbose.
.El
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh EXAMPLES
Use 3 disks to setup a RAID3 array (with the round-robin reading feature).
Create a file system, mount it, then unmount it and stop device:
@ -217,8 +219,6 @@ Replace one data disk with a brand new one:
graid3 remove -n 0 data
graid3 insert -n 0 data da5
.Ed
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh SEE ALSO
.Xr geom 4 ,
.Xr geom 8 ,

4
sbin/geom/class/shsec/gshsec.8
View File

@ -101,6 +101,8 @@ Hardcode providers' names in metadata.
.It Fl v
Be more verbose.
.El
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh EXAMPLES
The following example shows how to created a shared secret device.
Secret will be split between a slice on the local disk and a USB Pen drive.
@ -113,8 +115,6 @@ From now on, when USB Pen drive will be inserted, it will be automatically
detected and connected making secret available via
.Pa /dev/shsec/secret
device.
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh SEE ALSO
.Xr geom 4 ,
.Xr gbde 8 ,

4
sbin/geom/class/stripe/gstripe.8
View File

@ -190,6 +190,8 @@ If this value is large, you should consider increasing the
.Va kern.geom.stripe.maxmem
value.
.El
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh EXAMPLES
The following example shows how to set up a striped device from four disks with a
4 KB stripe size for automatic configuration,
@ -204,8 +206,6 @@ umount /mnt
gstripe stop data
gstripe unload
.Ed
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh COMPATIBILITY
The
.Nm

4
sbin/geom/core/geom.8
View File

@ -94,6 +94,8 @@ RAID3
.It
STRIPE
.El
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh EXAMPLES
The following example shows how to set up a stripe on three disks for automatic
configuration:
@ -112,8 +114,6 @@ Unload a kernel module which implements the MD class:
.Bd -literal -offset indent
geom md unload
.Ed
.Sh EXIT STATUS
Exit status is 0 on success, and 1 if the command fails.
.Sh SEE ALSO
.Xr geom 4 ,
.Xr gconcat 8 ,

14
sbin/ggate/ggatec/ggatec.8
View File

@ -150,6 +150,13 @@ Remote host to connect to.
.It Ar path
Path to a regular file or device.
.El
.Sh EXIT STATUS
Exit status is 0 on success, or 1 if the command fails.
To get details about the failure,
.Nm
should be called with the
.Fl v
option.
.Sh EXAMPLES
Made use of CD-ROM device from remote host.
.Bd -literal -offset indent
@ -161,13 +168,6 @@ client# ggatec create -o ro server /dev/acd0
ggate0
client# mount_cd9660 /dev/ggate0 /cdrom
.Ed
.Sh EXIT STATUS
Exit status is 0 on success, or 1 if the command fails.
To get details about the failure,
.Nm
should be called with the
.Fl v
option.
.Sh SEE ALSO
.Xr geom 4 ,
.Xr ggated 8 ,

14
sbin/ggate/ggated/ggated.8
View File

@ -86,13 +86,6 @@ The format of an exports file is as follows:
1.2.3.0/24 RW /tmp/test.img
hostname WO /tmp/image
.Ed
.Sh EXAMPLES
Export CD-ROM device and a file:
.Bd -literal -offset indent
# echo "1.2.3.0/24 RO /dev/acd0" > /etc/gg.exports
# echo "client RW /image" >> /etc/gg.exports
# ggated
.Ed
.Sh EXIT STATUS
Exit status is 0 on success, or 1 if the command fails.
To get details about the failure,
@ -100,6 +93,13 @@ To get details about the failure,
should be called with the
.Fl v
option.
.Sh EXAMPLES
Export CD-ROM device and a file:
.Bd -literal -offset indent
# echo "1.2.3.0/24 RO /dev/acd0" > /etc/gg.exports
# echo "client RW /image" >> /etc/gg.exports
# ggated
.Ed
.Sh SEE ALSO
.Xr geom 4 ,
.Xr ggatec 8 ,

14
sbin/ggate/ggatel/ggatel.8
View File

@ -121,6 +121,13 @@ output.
.It Ar path
Path to a regular file or device.
.El
.Sh EXIT STATUS
Exit status is 0 on success, or 1 if the command fails.
To get details about the failure,
.Nm
should be called with the
.Fl v
option.
.Sh EXAMPLES
.Dq GEOMify
the
@ -139,13 +146,6 @@ umount /secret
gbde detach ggate5
ggatel destroy -u 5
.Ed
.Sh EXIT STATUS
Exit status is 0 on success, or 1 if the command fails.
To get details about the failure,
.Nm
should be called with the
.Fl v
option.
.Sh SEE ALSO
.Xr geom 4 ,
.Xr gbde 8 ,

36
sbin/growfs/growfs.8
View File

@ -116,6 +116,24 @@ will enlarge
.Pa /dev/vinum/testvol
up to 2GB if there is enough space in
.Pa /dev/vinum/testvol .
.Sh SEE ALSO
.Xr bsdlabel 8 ,
.Xr dumpfs 8 ,
.Xr fdisk 8 ,
.Xr ffsinfo 8 ,
.Xr fsck 8 ,
.Xr newfs 8 ,
.Xr tunefs 8 ,
.Xr vinum 8
.Sh HISTORY
The
.Nm
utility first appeared in
.Fx 4.4 .
.Sh AUTHORS
.An Christoph Herrmann Aq chm@FreeBSD.org
.An Thomas-Henning von Kamptz Aq tomsoft@FreeBSD.org
.An The GROWFS team Aq growfs@Tomsoft.COM
.Sh BUGS
The
.Nm
@ -176,21 +194,3 @@ This read operation will provide unexpected data when using
.Fl N .
Therefore, this part cannot really be simulated and will be skipped in test
mode.
.Sh SEE ALSO
.Xr bsdlabel 8 ,
.Xr dumpfs 8 ,
.Xr fdisk 8 ,
.Xr ffsinfo 8 ,
.Xr fsck 8 ,
.Xr newfs 8 ,
.Xr tunefs 8 ,
.Xr vinum 8
.Sh AUTHORS
.An Christoph Herrmann Aq chm@FreeBSD.org
.An Thomas-Henning von Kamptz Aq tomsoft@FreeBSD.org
.An The GROWFS team Aq growfs@Tomsoft.COM
.Sh HISTORY
The
.Nm
utility first appeared in
.Fx 4.4 .

26
sbin/ifconfig/ifconfig.8
View File

@ -934,19 +934,6 @@ it (or have need for it).
Messages indicating the specified interface does not exist, the
requested address is unknown, or the user is not privileged and
tried to alter an interface's configuration.
.Sh BUGS
Basic IPv6 node operation requires a link-local address on each
interface configured for IPv6.
Normally, such an address is automatically configured by the
kernel on each interface added to the system; this behaviour may
be disabled by setting the sysctl MIB variable
.Va net.inet6.ip6.auto_linklocal
to 0.
.Pp
If you delete such an address using
.Nm ,
the kernel may act very oddly.
Do this at your own risk.
.Sh SEE ALSO
.Xr netstat 1 ,
.Xr netintro 4 ,
@ -960,3 +947,16 @@ The
.Nm
utility appeared in
.Bx 4.2 .
.Sh BUGS
Basic IPv6 node operation requires a link-local address on each
interface configured for IPv6.
Normally, such an address is automatically configured by the
kernel on each interface added to the system; this behaviour may
be disabled by setting the sysctl MIB variable
.Va net.inet6.ip6.auto_linklocal
to 0.
.Pp
If you delete such an address using
.Nm ,
the kernel may act very oddly.
Do this at your own risk.

34
sbin/init/init.8
View File

@ -353,23 +353,6 @@ as follows:
.Xr ttys 5
file
.El
.Sh DIAGNOSTICS
.Bl -diag
.It "getty repeating too quickly on port %s, sleeping."
A process being started to service a line is exiting quickly
each time it is started.
This is often caused by a ringing or noisy terminal line.
.Bf -emphasis
Init will sleep for 30 seconds,
then continue trying to start the process.
.Ef
.It "some processes would not die; ps axl advised."
A process
is hung and could not be killed when the system was shutting down.
This condition is usually caused by a process
that is stuck in a device driver because of
a persistent device error condition.
.El
.Sh FILES
.Bl -tag -width /etc/rc.shutdown -compact
.It Pa /dev/console
@ -388,6 +371,23 @@ system startup commands
.It Pa /etc/rc.shutdown
system shutdown commands
.El
.Sh DIAGNOSTICS
.Bl -diag
.It "getty repeating too quickly on port %s, sleeping."
A process being started to service a line is exiting quickly
each time it is started.
This is often caused by a ringing or noisy terminal line.
.Bf -emphasis
Init will sleep for 30 seconds,
then continue trying to start the process.
.Ef
.It "some processes would not die; ps axl advised."
A process
is hung and could not be killed when the system was shutting down.
This condition is usually caused by a process
that is stuck in a device driver because of
a persistent device error condition.
.El
.Sh SEE ALSO
.Xr kill 1 ,
.Xr login 1 ,

30
sbin/ip6fw/ip6fw.8
View File

@ -553,6 +553,21 @@ or in short form without timestamps:
.Xr reboot 8 ,
.Xr sysctl 8 ,
.Xr syslogd 8
.Sh HISTORY
A
.Nm
utility first appeared in
.Fx 4.0 .
.Sh AUTHORS
.An Ugen J. S. Antsilevich ,
.An Poul-Henning Kamp ,
.An Alex Nash ,
.An Archie Cobbs .
.Pp
.An -nosplit
API based upon code written by
.An Daniel Boulet
for BSDI.
.Sh BUGS
.Em WARNING!!WARNING!!WARNING!!WARNING!!WARNING!!WARNING!!WARNING!!
.Pp
@ -565,18 +580,3 @@ do anything you don't understand.
.Pp
When manipulating/adding chain entries, service and protocol names are
not accepted.
.Sh AUTHORS
.An Ugen J. S. Antsilevich ,
.An Poul-Henning Kamp ,
.An Alex Nash ,
.An Archie Cobbs .
.Pp
.An -nosplit
API based upon code written by
.An Daniel Boulet
for BSDI.
.Sh HISTORY
A
.Nm
utility first appeared in
.Fx 4.0 .

54
sbin/ipfw/ipfw.8
View File

@ -2334,6 +2334,33 @@ the sleep terminates thus restoring the previous situation.
.Xr reboot 8 ,
.Xr sysctl 8 ,
.Xr syslogd 8
.Sh HISTORY
The
.Nm
utility first appeared in
.Fx 2.0 .
.Xr dummynet 4
was introduced in
.Fx 2.2.8 .
Stateful extensions were introduced in
.Fx 4.0 .
.Nm ipfw2
was introduced in Summer 2002.
.Sh AUTHORS
.An Ugen J. S. Antsilevich ,
.An Poul-Henning Kamp ,
.An Alex Nash ,
.An Archie Cobbs ,
.An Luigi Rizzo .
.Pp
.An -nosplit
API based upon code written by
.An Daniel Boulet
for BSDI.
.Pp
Work on
.Xr dummynet 4
traffic shaper supported by Akamba Corp.
.Sh BUGS
The syntax has grown over the years and sometimes it might be confusing.
Unfortunately, backward compatibility prevents cleaning up mistakes
@ -2363,30 +2390,3 @@ If a packet is reinserted in this manner, later rules may be incorrectly
applied, making the order of
.Cm divert
rules in the rule sequence very important.
.Sh AUTHORS
.An Ugen J. S. Antsilevich ,
.An Poul-Henning Kamp ,
.An Alex Nash ,
.An Archie Cobbs ,
.An Luigi Rizzo .
.Pp
.An -nosplit
API based upon code written by
.An Daniel Boulet
for BSDI.
.Pp
Work on
.Xr dummynet 4
traffic shaper supported by Akamba Corp.
.Sh HISTORY
The
.Nm
utility first appeared in
.Fx 2.0 .
.Xr dummynet 4
was introduced in
.Fx 2.2.8 .
Stateful extensions were introduced in
.Fx 4.0 .
.Nm ipfw2
was introduced in Summer 2002.

24
sbin/mount/mount.8
View File

@ -412,16 +412,6 @@ Verbose mode.
.It Fl w
The file system object is to be read and write.
.El
.Sh DIAGNOSTICS
Various, most of them are self-explanatory.
.Pp
.Dl XXXXX file system is not available
.Pp
The kernel does not support the respective file system type.
Note that
support for a particular file system might be provided either on a static
(kernel compile-time), or dynamic basis (loaded as a kernel module by
.Xr kldload 8 ) .
.Sh ENVIRONMENT
.Bl -tag -width ".Ev PATH_FSTAB"
.It Ev PATH_FSTAB
@ -441,6 +431,16 @@ for more information.)
.It Pa /etc/fstab
file system table
.El
.Sh DIAGNOSTICS
Various, most of them are self-explanatory.
.Pp
.Dl XXXXX file system is not available
.Pp
The kernel does not support the respective file system type.
Note that
support for a particular file system might be provided either on a static
(kernel compile-time), or dynamic basis (loaded as a kernel module by
.Xr kldload 8 ) .
.Sh SEE ALSO
.Xr getfacl 1 ,
.Xr setfacl 1 ,
@ -468,8 +468,6 @@ file system table
.Xr mount_umapfs 8 ,
.Xr mount_unionfs 8 ,
.Xr umount 8
.Sh BUGS
It is possible for a corrupted file system to cause a crash.
.Sh CAVEATS
After a successful
.Nm ,
@ -484,3 +482,5 @@ A
.Nm
utility appeared in
.At v1 .
.Sh BUGS
It is possible for a corrupted file system to cause a crash.

18
sbin/mount_cd9660/mount_cd9660.8
View File

@ -140,15 +140,6 @@ The following command can be used to mount a Kodak Photo-CD:
.Xr unmount 2 ,
.Xr fstab 5 ,
.Xr mount 8
.Sh BUGS
POSIX device node mapping is currently not supported.
.Pp
Version numbers are not stripped if Rockridge extensions are in use.
In this case, accessing files that don't have Rockridge names without
version numbers gets the one with the lowest version number and not
the one with the highest.
.Pp
There is no ECMA support.
.Sh HISTORY
The
.Nm
@ -158,3 +149,12 @@ utility first appeared in
The Unicode conversion routine was added by
.An Ryuichiro Imura Aq imura@ryu16.org
in 2003.
.Sh BUGS
POSIX device node mapping is currently not supported.
.Pp
Version numbers are not stripped if Rockridge extensions are in use.
In this case, accessing files that don't have Rockridge names without
version numbers gets the one with the lowest version number and not
the one with the highest.
.Pp
There is no ECMA support.

10
sbin/mount_nullfs/mount_nullfs.8
View File

@ -237,6 +237,11 @@ is that vnode arguments must be manually mapped.
.Pp
UCLA Technical Report CSD-910056,
.Em "Stackable Layers: an Architecture for File System Development" .
.Sh HISTORY
The
.Nm
utility first appeared in
.Bx 4.4 .
.Sh BUGS
THIS FILE SYSTEM TYPE IS NOT YET FULLY SUPPORTED (READ: IT DOESN'T WORK)
AND USING IT MAY, IN FACT, DESTROY DATA ON YOUR SYSTEM.
@ -250,8 +255,3 @@ hackers can apply by sending mail to
.Aq hackers@FreeBSD.org
and announcing
their intent to take it over.
.Sh HISTORY
The
.Nm
utility first appeared in
.Bx 4.4 .

10
sbin/mount_umapfs/mount_umapfs.8
View File

@ -126,6 +126,11 @@ sophisticated.
.Sh SEE ALSO
.Xr mount 8 ,
.Xr mount_nullfs 8
.Sh HISTORY
The
.Nm
utility first appeared in
.Bx 4.4 .
.Sh BUGS
THIS FILE SYSTEM TYPE IS NOT YET FULLY SUPPORTED (READ: IT DOESN'T WORK)
AND USING IT MAY, IN FACT, DESTROY DATA ON YOUR SYSTEM.
@ -139,8 +144,3 @@ hackers can apply by sending mail to
.Aq hackers@FreeBSD.org
and announcing
their intent to take it over.
.Sh HISTORY
The
.Nm
utility first appeared in
.Bx 4.4 .

14
sbin/mount_unionfs/mount_unionfs.8
View File

@ -181,6 +181,13 @@ accessible via
.Xr fstab 5 ,
.Xr mount 8 ,
.Xr mount_nullfs 8
.Sh HISTORY
The
.Nm
utility first appeared in
.Bx 4.4 .
It first worked in
.Fx Ns -(fill this in) .
.Sh BUGS
THIS FILE SYSTEM TYPE IS NOT YET FULLY SUPPORTED (READ: IT DOESN'T WORK)
AND USING IT MAY, IN FACT, DESTROY DATA ON YOUR SYSTEM.
@ -207,10 +214,3 @@ Running
.Xr find 1
over a union tree has the side-effect of creating
a tree of shadow directories in the upper layer.
.Sh HISTORY
The
.Nm
utility first appeared in
.Bx 4.4 .
It first worked in
.Fx Ns -(fill this in) .

4
sbin/newfs_msdos/newfs_msdos.8
View File

@ -162,6 +162,8 @@ struct bsxbpb {
u_int16_t bkbs; /* [-k] backup boot sector */
};
.Ed
.Sh EXIT STATUS
Exit status is 0 on success and 1 on error.
.Sh EXAMPLES
.Bd -literal -offset indent
newfs_msdos /dev/ad0s1
@ -182,8 +184,6 @@ on
.Xr disklabel 8 ,
.Xr fdisk 8 ,
.Xr newfs 8
.Sh EXIT STATUS
Exit status is 0 on success and 1 on error.
.Sh HISTORY
The
.Nm

4
sbin/nos-tun/nos-tun.8
View File

@ -79,8 +79,6 @@ tunnel mode nos
tunnel destination 192.168.59.34
tunnel source 192.168.56.45
.Ed
.Sh BUGS
We don't allow for setting our source address for multihomed machines.
.Sh AUTHORS
.An -nosplit
.An Nickolay N. Dudorov Aq nnd@itfs.nsk.su
@ -89,3 +87,5 @@ wrote the program,
wrote the man-page.
.An Isao SEKI Aq iseki@gongon.com
added a new flag, IP protocol number.
.Sh BUGS
We don't allow for setting our source address for multihomed machines.

22
sbin/reboot/boot_i386.8
View File

@ -291,17 +291,6 @@ default kernel
.It Pa /boot/kernel.old/kernel
typical non-default kernel (optional)
.El
.Sh SEE ALSO
.Xr ddb 4 ,
.Xr ttys 5 ,
.Xr boot0cfg 8 ,
.Xr bsdlabel 8 ,
.Xr btxld 8 ,
.Xr config 8 ,
.Xr halt 8 ,
.Xr loader 8 ,
.Xr reboot 8 ,
.Xr shutdown 8
.Sh DIAGNOSTICS
When disk-related errors occur, these are reported by the second-stage
bootstrap using the same error codes returned by the BIOS, for example
@ -341,6 +330,17 @@ When a
.Dq Disk error 0x1
is reported by the second-stage bootstrap, it generally means that this
requirement has not been adhered to.
.Sh SEE ALSO
.Xr ddb 4 ,
.Xr ttys 5 ,
.Xr boot0cfg 8 ,
.Xr bsdlabel 8 ,
.Xr btxld 8 ,
.Xr config 8 ,
.Xr halt 8 ,
.Xr loader 8 ,
.Xr reboot 8 ,
.Xr shutdown 8
.Sh BUGS
The
.Xr bsdlabel 5

46
sbin/restore/restore.8
View File

@ -367,6 +367,24 @@ preceded by its file type.
Do not ask the user whether to abort the restore in the event of an error.
Always try to skip over the bad block(s) and continue.
.El
.Sh ENVIRONMENT
.Bl -tag -width ".Ev TMPDIR"
.It Ev TAPE
Device from which to read backup.
.It Ev TMPDIR
Name of directory where temporary files are to be created.
.El
.Sh FILES
.Bl -tag -width "./restoresymtable" -compact
.It Pa /dev/sa0
the default tape drive
.It Pa /tmp/rstdir*
file containing directories on the tape.
.It Pa /tmp/rstmode*
owner, mode, and time stamps for directories.
.It Pa \&./restoresymtable
information passed between incremental restores.
.El
.Sh DIAGNOSTICS
The
.Nm
@ -438,29 +456,16 @@ After a dump read error,
may have to resynchronize itself.
This message lists the number of blocks that were skipped over.
.El
.Sh FILES
.Bl -tag -width "./restoresymtable" -compact
.It Pa /dev/sa0
the default tape drive
.It Pa /tmp/rstdir*
file containing directories on the tape.
.It Pa /tmp/rstmode*
owner, mode, and time stamps for directories.
.It Pa \&./restoresymtable
information passed between incremental restores.
.El
.Sh ENVIRONMENT
.Bl -tag -width ".Ev TMPDIR"
.It Ev TAPE
Device from which to read backup.
.It Ev TMPDIR
Name of directory where temporary files are to be created.
.El
.Sh SEE ALSO
.Xr dump 8 ,
.Xr mount 8 ,
.Xr newfs 8 ,
.Xr rmt 8
.Sh HISTORY
The
.Nm
utility appeared in
.Bx 4.2 .
.Sh BUGS
The
.Nm
@ -502,8 +507,3 @@ be the same across different processes.
In all other cases, the files are unique because it is possible to
have two different dumps started at the same time, and separate
operations shouldn't conflict with each other.
.Sh HISTORY
The
.Nm
utility appeared in
.Bx 4.2 .

4
sbin/route/route.8
View File

@ -355,6 +355,8 @@ and
.Dv RTM_CHANGE .
As such, only the super-user may modify
the routing tables.
.Sh EXIT STATUS
.Ex -std
.Sh DIAGNOSTICS
.Bl -diag
.It "add [host \&| network ] %s: gateway %s flags %x"
@ -393,8 +395,6 @@ operation resulted in a route whose gateway uses the
same route as the one being changed.
The next-hop gateway should be reachable through a different route.
.El
.Sh EXIT STATUS
.Ex -std
.Sh SEE ALSO
.\".Xr esis 4 ,
.Xr netintro 4 ,

6
sbin/routed/routed.8
View File

@ -720,9 +720,6 @@ for distant gateways
.%R XSIS 028112
.%Q Xerox System Integration Standard
.Re
.Sh BUGS
It does not always detect unidirectional failures in network interfaces,
for example, when the output side fails.
.Sh HISTORY
The
.Nm
@ -730,3 +727,6 @@ utility appeared in
.Bx 4.2 .
.\" LocalWords: loopback ICMP rtquery ifconfig multicasting Solicitations RIPv
.\" LocalWords: netstat rdisc
.Sh BUGS
It does not always detect unidirectional failures in network interfaces,
for example, when the output side fails.

4
sbin/savecore/savecore.8
View File

@ -132,8 +132,6 @@ is meant to be called near the end of the initialization file
.Pa /etc/rc
(see
.Xr rc 8 ) .
.Sh BUGS
The minfree code does not consider the effect of compression or sparse files.
.Sh SEE ALSO
.Xr gzip 1 ,
.Xr getbootfile 3 ,
@ -144,3 +142,5 @@ The
.Nm
utility appeared in
.Bx 4.1 .
.Sh BUGS
The minfree code does not consider the effect of compression or sparse files.

26
sbin/slattach/slattach.8
View File

@ -229,6 +229,19 @@ If you use a hard-wired connection rather than a modem, invoke
with the
.Fl l
option in order to ignore carrier on the slip line.
.Sh FILES
.Bl -tag -width /usr/share/examples/slattach/* -compact
.It Pa /var/run/slattach.<tty>.pid
with
.Ar tty
replaced by the terminal path name component of
.Ar ttyname .
This file contains the numerical process ID of the
.Nm
process and can be examined by scripts in order to send a signal to
.Nm
.It Pa /usr/share/examples/slattach/*
.El
.Sh EXAMPLES
.Bd -literal -offset indent -compact
slattach ttyd8
@ -251,19 +264,6 @@ also logs failure to set the controlling terminal or failure to install
signal handlers.
Upon connection and redial the ttyname and baud rate
are logged and on shutdown the ttyname is logged.
.Sh FILES
.Bl -tag -width /usr/share/examples/slattach/* -compact
.It Pa /var/run/slattach.<tty>.pid
with
.Ar tty
replaced by the terminal path name component of
.Ar ttyname .
This file contains the numerical process ID of the
.Nm
process and can be examined by scripts in order to send a signal to
.Nm
.It Pa /usr/share/examples/slattach/*
.El
.Sh SEE ALSO
.Xr netstat 1 ,
.Xr startslip 1 ,

20
sbin/swapon/swapon.8
View File

@ -146,16 +146,6 @@ environment variable is used if not specifically
overridden.
512 byte blocks are used by default.
.El
.Sh DIAGNOSTICS
These utilities may fail for the reasons described in
.Xr swapon 2 .
.Sh SEE ALSO
.Xr swapon 2 ,
.Xr fstab 5 ,
.Xr init 8 ,
.Xr mdconfig 8 ,
.Xr pstat 8 ,
.Xr rc 8
.Sh FILES
.Bl -tag -width ".Pa /dev/{ad,da}?s?b" -compact
.It Pa /dev/{ad,da}?s?b
@ -166,6 +156,16 @@ memory disk devices
.Tn ASCII
file system description table
.El
.Sh DIAGNOSTICS
These utilities may fail for the reasons described in
.Xr swapon 2 .
.Sh SEE ALSO
.Xr swapon 2 ,
.Xr fstab 5 ,
.Xr init 8 ,
.Xr mdconfig 8 ,
.Xr pstat 8 ,
.Xr rc 8
.Sh HISTORY
The
.Nm swapon

52
sbin/sysctl/sysctl.8
View File

@ -235,6 +235,25 @@ denote
.It "user.stream_max integer no
.It "user.tzname_max integer no
.El
.Sh FILES
.Bl -tag -width ".In netinet/icmp_var.h" -compact
.It In sys/sysctl.h
definitions for top level identifiers, second level kernel and hardware
identifiers, and user level identifiers
.It In sys/socket.h
definitions for second level network identifiers
.It In sys/gmon.h
definitions for third level profiling identifiers
.It In vm/vm_param.h
definitions for second level virtual memory identifiers
.It In netinet/in.h
definitions for third level Internet identifiers and
fourth level IP identifiers
.It In netinet/icmp_var.h
definitions for fourth level ICMP identifiers
.It In netinet/udp_var.h
definitions for fourth level UDP identifiers
.El
.Sh EXAMPLES
For example, to retrieve the maximum number of processes allowed
in the system, one would use the following request:
@ -265,25 +284,6 @@ Information about the load average history may be obtained with:
More variables than these exist, and the best and likely only place
to search for their deeper meaning is undoubtedly the source where
they are defined.
.Sh FILES
.Bl -tag -width ".In netinet/icmp_var.h" -compact
.It In sys/sysctl.h
definitions for top level identifiers, second level kernel and hardware
identifiers, and user level identifiers
.It In sys/socket.h
definitions for second level network identifiers
.It In sys/gmon.h
definitions for third level profiling identifiers
.It In vm/vm_param.h
definitions for second level virtual memory identifiers
.It In netinet/in.h
definitions for third level Internet identifiers and
fourth level IP identifiers
.It In netinet/icmp_var.h
definitions for fourth level ICMP identifiers
.It In netinet/udp_var.h
definitions for fourth level UDP identifiers
.El
.Sh COMPATIBILITY
The
.Fl w
@ -293,13 +293,6 @@ option has been deprecated and is silently ignored.
.Xr loader.conf 5 ,
.Xr sysctl.conf 5 ,
.Xr loader 8
.Sh BUGS
The
.Nm
utility presently exploits an undocumented interface to the kernel
sysctl facility to traverse the sysctl tree and to retrieve format
and name information.
This correct interface is being thought about for the time being.
.Sh HISTORY
A
.Nm
@ -310,3 +303,10 @@ In
.Fx 2.2 ,
.Nm
was significantly remodeled.
.Sh BUGS
The
.Nm
utility presently exploits an undocumented interface to the kernel
sysctl facility to traverse the sysctl tree and to retrieve format
and name information.
This correct interface is being thought about for the time being.

10
sbin/tunefs/tunefs.8
View File

@ -155,14 +155,14 @@ specified mount point.
.%D August 1984
.%O "(reprinted in the BSD System Manager's Manual, SMM:5)"
.Re
.Sh HISTORY
The
.Nm
utility appeared in
.Bx 4.2 .
.Sh BUGS
This utility should work on active file systems.
.\" Take this out and a Unix Daemon will dog your steps from now until
.\" the time_t's wrap around.
.Pp
You can tune a file system, but you can't tune a fish.
.Sh HISTORY
The
.Nm
utility appeared in
.Bx 4.2 .