summaryrefslogtreecommitdiff
path: root/sbin/rcorder/rcorder.8
diff options
context:
space:
mode:
Diffstat (limited to 'sbin/rcorder/rcorder.8')
-rw-r--r--sbin/rcorder/rcorder.8158
1 files changed, 0 insertions, 158 deletions
diff --git a/sbin/rcorder/rcorder.8 b/sbin/rcorder/rcorder.8
deleted file mode 100644
index 2ba623b69b17..000000000000
--- a/sbin/rcorder/rcorder.8
+++ /dev/null
@@ -1,158 +0,0 @@
-.\" $NetBSD: rcorder.8,v 1.2 2000/07/05 15:45:30 msaitoh Exp $
-.\"
-.\" Copyright (c) 1998
-.\" Perry E. Metzger. 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.
-.\" 3. All advertising materials mentioning features or use of this software
-.\" must display the following acknowledgment:
-.\" This product includes software developed for the NetBSD Project
-.\" by Perry E. Metzger.
-.\" 4. The name of the author may not be used to endorse or promote products
-.\" derived from this software without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 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.
-.\"
-.\"
-.Dd July 17, 2000
-.Dt RCORDER 8
-.Os
-.Sh NAME
-.Nm rcorder
-.Nd print a dependency ordering of interdependent files
-.Sh SYNOPSIS
-.Nm
-.Op Fl k Ar keep
-.Op Fl s Ar skip
-.Ar
-.Sh DESCRIPTION
-.Nm
-is designed to print out a dependency ordering of a set of
-interdependent files. Typically it is used to find an execution
-sequence for a set of shell scripts in which certain files must be
-executed before others.
-.Pp
-Each file passed to
-.Nm
-must be annotated with special lines (which look like comments to the
-shell) which indicate the dependencies the files have upon certain
-points in the sequence, known as
-.Dq conditions ,
-and which indicate, for each file, which
-.Dq conditions
-may be expected to be filled by that file.
-.Pp
-Within each file, a block containing a series of
-.Dq REQUIRE ,
-.Dq PROVIDE ,
-.Dq BEFORE
-and
-.Dq KEYWORD
-lines must appear.
-The format of the lines is rigid. Each line must begin with a single
-.Dq # ,
-followed by a single space, followed by
-.Dq PROVIDE: ,
-.Dq REQUIRE: ,
-.Dq BEFORE: ,
-or
-.Dq KEYWORD: .
-No deviation is permitted.
-Each dependency line is then followed by a series of conditions,
-separated by whitespace. Multiple
-.Dq PROVIDE ,
-.Dq REQUIRE ,
-.Dq BEFORE
-and
-.Dq KEYWORD
-lines may appear, but all such lines must appear in a sequence without
-any intervening lines, as once a line that does not follow the format
-is reached, parsing stops.
-.Pp
-The options are as follows:
-.Bl -tag -width Ds
-.It Fl k
-Add the specified keyword to the
-.Dq keep list .
-If any
-.Fl k
-option is given, only those files containing the matching keyword are listed.
-.It Fl s
-Add the specified keyword to the
-.Dq skip list .
-If any
-.Fl s
-option is given, files containing the matching keyword are not listed.
-.El
-.Pp
- An example block follows:
-.Bd -literal -offset indent
-# REQUIRE: networking syslog
-# REQUIRE: usr
-# PROVIDE: dns nscd
-.Ed
-.Pp
-This block states that the file in which it appears depends upon the
-.Dq networking ,
-.Dq syslog ,
-and
-.Dq usr
-conditions, and provides the
-.Dq dns
-and
-.Dq nscd
-conditions.
-.Pp
-A file may contain zero
-.Dq PROVIDE
-lines, in which case it provides no conditions, and may contain zero
-.Dq REQUIRE
-lines, in which case it has no dependencies.
-There must be at least one file with no dependencies in the set of
-arguments passed to
-.Nm
-in order for it to find a starting place in the dependency ordering.
-.Sh DIAGNOSTICS
-.Nm
-may print one of the following error messages and exit with a non-zero
-status if it encounters an error while processing the file list.
-.Bl -diag
-.It "Requirement %s has no providers, aborting."
-No file has a
-.Dq PROVIDE
-line corresponding to a condition present in a
-.Dq REQUIRE
-line in another file.
-.It "Circular dependency on provision %s, aborting."
-A set of files has a circular dependency which was detected while
-processing the stated condition.
-.It "Circular dependency on file %s, aborting."
-A set of files has a circular dependency which was detected while
-processing the stated file.
-.El
-.Sh SEE ALSO
-.Xr rc 8
-.Sh HISTORY
-The
-.Nm
-program first appeared in
-.Nx 1.5 .
-.Sh AUTHORS
-Written by Perry E. Metzger (perry@piermont.com) and Matthew R.
-Green (mrg@eterna.com.au).