summaryrefslogtreecommitdiffstats
path: root/usr.sbin/diskcheckd/diskcheckd.8
diff options
context:
space:
mode:
authorobrien <obrien@FreeBSD.org>2001-08-28 23:00:28 +0000
committerobrien <obrien@FreeBSD.org>2001-08-28 23:00:28 +0000
commitd350edf744aae32de95d06c856373a03f2f92bc3 (patch)
tree103f791e64fb81349e7ee4e6b59e795979e73266 /usr.sbin/diskcheckd/diskcheckd.8
parentf3aeba4a67b48dad63fa772a8288bcc60631a1b7 (diff)
downloadFreeBSD-src-d350edf744aae32de95d06c856373a03f2f92bc3.zip
FreeBSD-src-d350edf744aae32de95d06c856373a03f2f92bc3.tar.gz
Remove `diskcheckd'. It is now in ports/sysutils.
Consensus on: freebsd-current.
Diffstat (limited to 'usr.sbin/diskcheckd/diskcheckd.8')
-rw-r--r--usr.sbin/diskcheckd/diskcheckd.8190
1 files changed, 0 insertions, 190 deletions
diff --git a/usr.sbin/diskcheckd/diskcheckd.8 b/usr.sbin/diskcheckd/diskcheckd.8
deleted file mode 100644
index 83d7878..0000000
--- a/usr.sbin/diskcheckd/diskcheckd.8
+++ /dev/null
@@ -1,190 +0,0 @@
-.\" Copyright (c) 2000, 2001 Ben Smithurst <ben@FreeBSD.org>
-.\" All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\" notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\" notice, this list of conditions and the following disclaimer in the
-.\" documentation and/or other materials provided with the distribution.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
-.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
-.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
-.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\" $FreeBSD$
-.\"
-.Dd July 4, 2001
-.Dt DISKCHECKD 8
-.Os
-.Sh NAME
-.Nm diskcheckd
-.Nd daemon to check for disk read errors
-.Sh SYNOPSIS
-.Nm
-.Op Fl d
-.Op Fl f Ar conf_file
-.Op Fl o Ar save_file
-.Sh DESCRIPTION
-.Nm
-is a daemon which runs in the background,
-reading entire disks to find any read errors on those disks.
-The disks which should be scanned,
-and the rates at which they should be scanned,
-must be specified in the configuration file,
-which is
-.Pa /etc/diskcheckd.conf
-by default.
-.Pp
-Any blank lines or lines starting with a
-.Ql #
-character in this file are ignored.
-Each non-comment line of this file must be in one of two formats.
-The first format is
-.Ql !xx ,
-and specifies that device names matching
-.Pa /dev/xx*
-should not be included in expansion of wildcards (see below).
-The second format consists of four white space separated
-fields,
-which are the full pathname of the disk device,
-the size of that disk,
-the frequency in days at which to check that disk,
-and the rate in kilobytes per second at which to check this disk.
-Naturally,
-it would be contradictory to specify both the frequency and the rate,
-so only one of these should be specified.
-Additionally,
-the size of the disk should not be specified if the rate is specified,
-as this information is unnecessary.
-.Pp
-If the disk is specified as
-.Dq * ,
-then
-.Nm
-will apply the given settings to all disks in the system,
-obtained using the
-.Va kern.disks
-sysctl variable.
-If the size is specified as
-.Dq *
-(recommended),
-then the size of the disk will be automatically determined from the
-disklabel,
-if possible.
-Fields which are not specified should contain a single
-.Dq *
-character.
-.Pp
-Note that
-.Nm
-always reads data from the disk in 64KB blocks,
-so the rate your specify may not be the exact rate at which the disk is
-actually checked.
-Similarly,
-if you specify the third field (days for complete scan) it is unlikely
-that a complete scan will actually take exactly this many days.
-.Pp
-To run
-.Nm
-automatically at boot time,
-the
-.Va diskcheckd_enable
-variable in
-.Xr rc.conf 5
-should be set to
-.Dq YES .
-.Pp
-When
-.Nm
-receives a
-.Dv SIGTERM
-or
-.Dv SIGINT
-signal,
-it saves its current state information to a file,
-so that after a reboot
-.Nm
-can resume reading from where it left off,
-rather than starting from the beginning of the disk again.
-The information saved to this file consists of the device filename and the
-current offset into that device.
-.Pp
-.Nm
-can be instructed to reload the configuration file by sending it a
-.Dv SIGHUP
-signal.
-.Pp
-.Nm
-accepts the following command line options:
-.Bl -tag -width Fl
-.It Fl d
-If this flag is specified,
-.Nm
-will not fork into the background and detach from its controlling terminal
-to become a daemon.
-This flag is primarily used for debugging.
-.It Fl f
-Specify the configuration file to use,
-instead of the default
-.Pa /etc/diskcheckd.conf .
-.It Fl o
-Specify the file to save disk offsets to,
-instead of the default
-.Pa /var/db/diskcheckd.offsets .
-.El
-.Sh FILES
-.Bl -tag -width /var/db/diskcheckd.offsets -compact
-.It Pa /etc/diskcheckd.conf
-Default configuration file.
-.It Pa /var/db/diskcheckd.offsets
-Default location of saved offsets.
-.El
-.Sh EXAMPLES
-To check all of
-.Pa /dev/ad0
-for errors once every two weeks,
-use this entry in
-.Pa diskcheckd.conf :
-.Bd -literal -offset indent
-/dev/ad0 * 14 *
-.Ed
-.Pp
-To check the first SCSI disk for errors at approximately 64KB/s,
-use the following entry:
-.Bd -literal -offset indent
-/dev/da0 * * 64
-.Ed
-.Pp
-To check all disks once every four weeks:
-.Bd -literal -offset indent
-* * 28 *
-.Ed
-.Sh DIAGNOSTICS
-If any errors occur,
-they will be written to
-.Xr syslogd 8 .
-.Sh HISTORY
-.Nm
-first appeared in
-.Fx 5.0 .
-.Sh AUTHORS
-.An -nosplit
-.Nm
-and this manual page were written by
-.An Ben Smithurst Aq ben@FreeBSD.org ,
-with input from
-.An Poul-Henning Kamp Aq phk@FreeBSD.org .
-.Sh BUGS
-.Nm
-assumes all disks have 512 byte sectors.
OpenPOWER on IntegriCloud