diff options
author | 1999-03-11 21:07:58 +0000 | |
---|---|---|
committer | 1999-03-11 21:07:58 +0000 | |
commit | 885abdb24d35eaff7327fcbe3b5e27541983d3a5 (patch) | |
tree | 5013af6608780fdac71a2314c787509a4aca5fe3 | |
parent | ncurses-4.2-990307 (diff) | |
download | wireguard-openbsd-885abdb24d35eaff7327fcbe3b5e27541983d3a5.tar.xz wireguard-openbsd-885abdb24d35eaff7327fcbe3b5e27541983d3a5.zip |
cleanup
-rw-r--r-- | usr.sbin/rwhod/rwhod.8 | 17 | ||||
-rw-r--r-- | usr.sbin/sa/sa.8 | 86 | ||||
-rw-r--r-- | usr.sbin/screenblank/screenblank.1 | 41 | ||||
-rw-r--r-- | usr.sbin/sliplogin/sliplogin.8 | 19 | ||||
-rw-r--r-- | usr.sbin/spray/spray.8 | 9 | ||||
-rw-r--r-- | usr.sbin/syslogd/syslogd.8 | 50 | ||||
-rw-r--r-- | usr.sbin/timed/timed/timed.8 | 25 | ||||
-rw-r--r-- | usr.sbin/timed/timedc/timedc.8 | 16 |
8 files changed, 144 insertions, 119 deletions
diff --git a/usr.sbin/rwhod/rwhod.8 b/usr.sbin/rwhod/rwhod.8 index 0dfe732b758..243269067fd 100644 --- a/usr.sbin/rwhod/rwhod.8 +++ b/usr.sbin/rwhod/rwhod.8 @@ -1,3 +1,4 @@ +.\" $OpenBSD: rwhod.8,v 1.7 1999/03/11 21:07:58 aaron Exp $ .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" @@ -30,7 +31,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)rwhod.8 8.2 (Berkeley) 12/11/93 -.\" $OpenBSD: rwhod.8,v 1.6 1998/04/25 01:14:41 deraadt Exp $ +.\" $OpenBSD: rwhod.8,v 1.7 1999/03/11 21:07:58 aaron Exp $ .\" .Dd December 11, 1993 .Dt RWHOD 8 @@ -39,9 +40,9 @@ .Nm rwhod .Nd system status server .Sh SYNOPSIS -.Nm rwhod +.Nm .Sh DESCRIPTION -.Nm Rwhod +.Nm is the server which maintains the database used by the .Xr rwho 1 and @@ -50,13 +51,13 @@ programs. Its operation is predicated on the ability to .Em broadcast messages on a network. .Pp -.Nm Rwhod +.Nm operates as both a producer and consumer of status information. As a producer of information it periodically queries the state of the system and constructs status messages which are broadcast on a network. As a consumer of information, it listens for other -.Nm rwhod +.Nm servers' status messages, validating them, then recording them in a collection of files located in the directory .Pa /var/rwho . @@ -113,7 +114,7 @@ in the message, contains any unprintable .Tn ASCII characters, the message is discarded. Valid messages received by -.Nm rwhod +.Nm are placed in files named .Pa whod.hostname in the directory @@ -124,8 +125,8 @@ format described above. Status messages are generated approximately once every 3 minutes. .Sh SEE ALSO -.Xr rwho 1 , -.Xr ruptime 1 +.Xr ruptime 1 , +.Xr rwho 1 .Sh BUGS There should be a way to relay status information between networks. Status information should be sent only upon request rather than continuously. diff --git a/usr.sbin/sa/sa.8 b/usr.sbin/sa/sa.8 index 685ae3e829d..af06bc313c0 100644 --- a/usr.sbin/sa/sa.8 +++ b/usr.sbin/sa/sa.8 @@ -1,3 +1,4 @@ +.\" $OpenBSD: sa.8,v 1.4 1999/03/11 21:07:59 aaron Exp $ .\" .\" Copyright (c) 1994 Christopher G. Demetriou .\" All rights reserved. @@ -27,7 +28,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" $Id: sa.8,v 1.3 1997/08/30 08:16:42 deraadt Exp $ +.\" $Id: sa.8,v 1.4 1999/03/11 21:07:59 aaron Exp $ .\" .Dd February 25, 1994 .Dt SA 8 @@ -36,18 +37,18 @@ .Nm sa .Nd print system accounting statistics .Sh SYNOPSIS -.Nm sa +.Nm .Op Fl abcdDfijkKlmnqrstu .Op Fl v Ar cutoff .Op Ar .Sh DESCRIPTION The -.Nm sa +.Nm utility reports on, cleans up, and generally maintains system accounting files. .Pp -.Nm Sa +.Nm is able to condense the information in .Pa /var/account/acct into the summary files @@ -55,7 +56,7 @@ into the summary files and .Pa /var/account/usracct , which contain system statistics according -to command name and login id, respectively. +to command name and login ID, respectively. This condensation is desirable because on a large system, .Pa /var/account/acct @@ -73,38 +74,40 @@ after the last file is processed. .Pp The labels used in the output indicate the following, except where otherwise specified by individual options: -.Bl -tag -width k*sec +.Pp +.Bl -tag -width k*sec -compact .It Dv avio -Average number of I/O operations per execution +Average number of I/O operations per execution. .It Dv cp -Sum of user and system time, in minutes +Sum of user and system time, in minutes. .It Dv cpu Same as -.Dv cp +.Dv cp . .It Dv k -CPU-time averaged core usage, in 1k units +CPU time averaged core usage, in 1k units. .It Dv k*sec -CPU storage integral, in 1k-core seconds +CPU storage integral, in 1k-core seconds. .It Dv re -Real time, in minutes +Real time, in minutes. .It Dv s -System time, in minutes +System time, in minutes. .It Dv tio -Total number of I/O operations +Total number of I/O operations. .It Dv u -User time, in minutes +User time, in minutes. .El .Pp The options to -.Nm sa -are: +.Nm +are as follows: .Bl -tag -width Ds .It Fl a List all command names, including those containing unprintable characters and those used only once. By default, -.Nm sa +.Nm places all names containing unprintable characters and -those used only once under the name ``***other''. +those used only once under the name +.Dq ***other . .It Fl b If printing command statistics, sort output by the sum of user and system time divided by number of calls. @@ -127,11 +130,11 @@ Do not read in the summary files. .It Fl j Instead of the total minutes per category, give seconds per call. .It Fl k -If printing command statistics, sort by the cpu-time average memory -usage. If printing user statistics, print the cpu-time average +If printing command statistics, sort by the CPU time average memory +usage. If printing user statistics, print the CPU time average memory usage. .It Fl K -If printing command statistics, print and sort by the cpu-storage integral. +If printing command statistics, print and sort by the CPU-storage integral. .It Fl l Separate system and user time; normally they are combined. .It Fl m @@ -147,30 +150,33 @@ Truncate the accounting files when done and merge their data into the summary files. .It Fl t For each command, report the ratio of real time to the sum -of user and system cpu times. -If the cpu time is too small to report, ``*ignore*'' appears in -this field. +of user and system CPU times. +If the CPU time is too small to report, +.Dq *ignore* +appears in this field. .It Fl u Superseding all other flags, for each entry -in the accounting file, print the user ID, total seconds of cpu usage, +in the accounting file, print the user ID, total seconds of CPU usage, total memory usage, number of I/O operations performed, and command name. .It Fl v Ar cutoff For each command used .Ar cutoff times or fewer, print the command name and await a reply -from the terminal. If the reply begins with ``y'', add -the command to the category ``**junk**''. This flag is -used to strip garbage from the report. +from the terminal. If the reply begins with +.Dq y , +add the command to the category +.Dq **junk** . +This flag is used to strip garbage from the report. .El .Pp By default, per-command statistics will be printed. The number of -calls, the total elapsed time in minutes, total cpu and user time -in minutes, average number of I/O operations, and CPU-time +calls, the total elapsed time in minutes, total CPU and user time +in minutes, average number of I/O operations, and CPU time averaged core usage will be printed. If the .Fl m option is specified, per-user statistics will be printed, including -the user name, the number of commands invoked, total cpu time used +the user name, the number of commands invoked, total CPU time used (in minutes), total number of I/O operations, and CPU storage integral for each user. If the .Fl u @@ -195,8 +201,8 @@ and flags are honored. .Pp The -.Nm sa -utility exits 0 on success, and >0 if an error occurs. +.Nm +utility exits 0 on success or >0 if an error occurred. .Sh FILES .Bl -tag -width /var/account/usracct -compact .It Pa /var/account/acct @@ -207,10 +213,10 @@ per-command accounting summary database per-user accounting summary database .El .Sh SEE ALSO -.Xr ac 8 , +.Xr lastcomm 1 , .Xr acct 5 , -.Xr accton 8 , -.Xr lastcomm 1 +.Xr ac 8 , +.Xr accton 8 .Sh BUGS The number of options to this program is absurd, especially considering that there's not much logic behind their lettering. @@ -220,7 +226,7 @@ The field labels should be more consistent. NetBSD's VM system does not record the CPU storage integral. .Sh CAVEATS While the behavior of the options in this version of -.Nm sa +.Nm was modeled after the original version, there are some intentional differences and undoubtedly some unintentional ones as well. In particular, the @@ -230,12 +236,12 @@ option has been added, and the option now understands more options than it used to. .Pp The formats of the summary files created by this version of -.Nm sa +.Nm are very different than the those used by the original version. This is not considered a problem, however, because the accounting record format has changed as well (since user ids are now 32 bits). .Sh HISTORY -.Nm Sa +.Nm was written for .Nx 0.9a from the specification provided by various systems' manual pages. diff --git a/usr.sbin/screenblank/screenblank.1 b/usr.sbin/screenblank/screenblank.1 index 1dcf40124a9..341eabc037d 100644 --- a/usr.sbin/screenblank/screenblank.1 +++ b/usr.sbin/screenblank/screenblank.1 @@ -1,4 +1,4 @@ -.\" $OpenBSD: screenblank.1,v 1.2 1996/03/25 15:56:13 niklas Exp $ +.\" $OpenBSD: screenblank.1,v 1.3 1999/03/11 21:07:59 aaron Exp $ .\" $NetBSD: screenblank.1,v 1.2 1996/02/28 01:18:32 thorpej Exp $ .\" .\" Copyright (c) 1996 The NetBSD Foundation, Inc. @@ -42,20 +42,24 @@ .Nm screenblank .Nd screen saver daemon for the Sun 3 and SPARC .Sh SYNOPSIS -.Nm screenblank +.Nm .Op Fl k | Fl m .Op Fl d Ar timeout .Op Fl e Ar timeout .Op Fl f Ar framebuffer .Sh DESCRIPTION -.Nm Screenblank +.Nm disables the framebuffer if the keyboard and mouse are idle for a period of time, and re-enables the framebuffer when keyboard or mouse activity resumes. .Pp -When killed with a SIGINT, SIGHUP, or SIGTERM, -.Nm screenblank -will re-enable the framebuffer. The pid can be found in the file +When killed with a +.Dv SIGINT , +.Dv SIGHUP , +or +.Dv SIGTERM , +.Nm +will re-enable the framebuffer. The PID can be found in the file .Pa /var/run/screenblank.pid . .Pp The options are as follows: @@ -87,16 +91,17 @@ and .Fl m flags are mutually exclusive. .Sh FILES -.Bl -tag -width "/var/run/screenblank.pid " -.It /dev/kbd -The keyboard device. -.It /dev/mouse -The mouse device. -.It /dev/console -The console device. -.It /dev/fb -The default framebuffer. -.It /var/run/screenblank.pid -File containing the pid of -.Nm screenblank . +.Bl -tag -width "/var/run/screenblank.pid " -compact +.It Pa /dev/kbd +keyboard device +.It Pa /dev/mouse +mouse device +.It Pa /dev/console +console device +.It Pa /dev/fb +default framebuffer +.It Pa /var/run/screenblank.pid +contains the PID of +.Nm screenblank .El + diff --git a/usr.sbin/sliplogin/sliplogin.8 b/usr.sbin/sliplogin/sliplogin.8 index 79c2ab526b5..009c65de9f5 100644 --- a/usr.sbin/sliplogin/sliplogin.8 +++ b/usr.sbin/sliplogin/sliplogin.8 @@ -1,3 +1,4 @@ +.\" $OpenBSD: sliplogin.8,v 1.2 1999/03/11 21:08:02 aaron Exp $ .\" Copyright (c) 1990, 1991 The Regents of the University of California. .\" All rights reserved. .\" @@ -30,7 +31,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)sliplogin.8 5.4 (Berkeley) 8/5/91 -.\" $Id: sliplogin.8,v 1.1.1.1 1995/10/18 08:48:21 deraadt Exp $ +.\" $Id: sliplogin.8,v 1.2 1999/03/11 21:08:02 aaron Exp $ .\" .Dd August 5, 1991 .Dt SLIPLOGIN 8 @@ -39,10 +40,10 @@ .Nm sliplogin .Nd attach a serial line network interface .Sh SYNOPSIS -.Nm sliplogin +.Nm .Op Ar loginname .Sh DESCRIPTION -.Nm Sliplogin +.Nm is used to turn the terminal line on standard input into a Serial Line IP .Pq Tn SLIP @@ -53,7 +54,7 @@ for an entry matching .Ar loginname (which defaults to the current login name if omitted). If a matching entry is found, the line is configured appropriately -for slip (8-bit transparent i/o) and converted to +for slip (8-bit transparent I/O) and converted to .Tn SLIP line discipline. Then a shell script is invoked to initialize the slip @@ -85,7 +86,7 @@ entry, in order starting with .Pp Only the super-user may attach a network interface. The interface is automatically detached when the other end hangs up or the -.Nm sliplogin +.Nm process dies. If the kernel slip module has been configured for it, all routes through that interface will also disappear at the same time. If there is other processing a site @@ -125,11 +126,11 @@ directly to are optional arguments used to configure the line. .Sh EXAMPLE The normal use of -.Nm sliplogin +.Nm is to create a .Pa /etc/passwd entry for each legal, remote slip site with -.Nm sliplogin +.Nm as the shell for that entry. E.g., .Bd -literal Sfoo:ikhuy6:2010:1:slip line to foo:/tmp:/usr/sbin/sliplogin @@ -156,7 +157,7 @@ to the local host name and is the local host IP netmask. .Pp Note that -.Nm sliplogin +.Nm must be setuid to root and, while not a security hole, moral defectives can use it to place terminal lines in an unusable state and/or deny access to legitimate users of a remote slip line. To prevent this, @@ -170,7 +171,7 @@ and mode 4550 (setuid root, only group .Em slip can execute binary). .Sh DIAGNOSTICS -.Nm Sliplogin +.Nm logs various information to the system log daemon, .Xr syslogd 8 , with a facility code of diff --git a/usr.sbin/spray/spray.8 b/usr.sbin/spray/spray.8 index 6388f504122..15b61b93892 100644 --- a/usr.sbin/spray/spray.8 +++ b/usr.sbin/spray/spray.8 @@ -1,3 +1,4 @@ +.\" $OpenBSD: spray.8,v 1.3 1999/03/11 21:08:03 aaron Exp $ .\" .\" Copyright (c) 1994 James A. Jegers .\" All rights reserved. @@ -28,7 +29,7 @@ .Nm spray .Nd send many packets to host .Sh SYNOPSIS -.Nm spray +.Nm .Op Fl c Ar count .Op Fl d Ar delay .Op Fl l Ar length @@ -36,7 +37,7 @@ \&... .Ek .Sh DESCRIPTION -.Nm Spray +.Nm sends multiple RPC packets to .Ar host and records how many of them were correctly received and how long it took. @@ -58,11 +59,11 @@ bytes. Not all values of .Ar length are possible because RPC data is encoded using XDR. -.Nm Spray +.Nm rounds up to the nearest possible value. .El .Pp -.Nm Spray +.Nm is intended for use in network testing, measurement, and management. This command .Bf -emphasis diff --git a/usr.sbin/syslogd/syslogd.8 b/usr.sbin/syslogd/syslogd.8 index 8a54ba1f491..23518ce9388 100644 --- a/usr.sbin/syslogd/syslogd.8 +++ b/usr.sbin/syslogd/syslogd.8 @@ -1,3 +1,4 @@ +.\" $OpenBSD: syslogd.8,v 1.8 1999/03/11 21:08:03 aaron Exp $ .\" Copyright (c) 1983, 1986, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" @@ -39,16 +40,17 @@ .Nm syslogd .Nd log systems messages .Sh SYNOPSIS -.Nm syslogd +.Nm .Op Fl du .Op Fl f Ar config_file .Op Fl m Ar mark_interval .Op Fl a Ar path .Op Fl p Ar log_socket .Sh DESCRIPTION -.Nm Syslogd +.Nm reads and logs messages to the system console, log files, other machines and/or users as specified by its configuration file. +.Pp The options are as follows: .Bl -tag -width Ds .It Fl d @@ -59,10 +61,13 @@ Specify the pathname of an alternate configuration file; the default is .Pa /etc/syslog.conf . .It Fl m Ar mark_interval -Select the number of minutes between ``mark'' messages; -the default is 20 minutes. +Select the number of minutes between +.Dq mark +messages; the default is 20 minutes. .It Fl u -Select the historical ``insecure'' mode, in which syslogd will +Select the historical +.Dq insecure +mode, in which syslogd will accept input from the UDP port. Some software wants this, but you can be subjected to a variety of attacks over the network, including attackers remotely filling logs. @@ -72,7 +77,7 @@ the default is .Pa /dev/log . .It Fl a Pa path Specify a location where -.Nm syslogd +.Nm should place an additional log socket. Up to about 20 additional logging sockets can be specified. The primary use for this is to place additional log sockets in @@ -80,22 +85,23 @@ The primary use for this is to place additional log sockets in of various chroot filespaces. .El .Pp -.Nm Syslogd +.Nm reads its configuration file when it starts up and whenever it receives a hangup signal. For information on the format of the configuration file, see .Xr syslog.conf 5 . .Pp -.Nm Syslogd +.Nm opens an Internet domain socket as specified in .Pa /etc/services . Normally -.Nm syslogd +.Nm will only use this socket to send messages outwards, but in -`insecure'' mode it will also read messages from this socket. -.Nm Syslogd +.Dq insecure +mode it will also read messages from this socket. +.Nm also opens and reads messages from the .Tn UNIX domain socket @@ -104,36 +110,35 @@ and from the special device .Pa /dev/klog (to read kernel messages). .Pp -.Nm Syslogd +.Nm creates the file .Pa /var/run/syslog.pid , -and stores its process -id there. +and stores its process ID there. This can be used to kill or reconfigure .Nm syslogd . .Pp The message sent to -.Nm syslogd +.Nm should consist of a single line. The message can contain a priority code, which should be a preceding decimal number in angle braces, for example, -.Sq Aq 5. +.Dq Aq 5. . This priority code should map into the priorities defined in the include file .Aq Pa sys/syslog.h . .Sh FILES .Bl -tag -width /var/run/syslog.pid -compact .It Pa /etc/syslog.conf -The configuration file. +configuration file .It Pa /var/run/syslog.pid -The process id of current -.Nm syslogd . +process ID of current +.Nm syslogd .It Pa /dev/log -Name of the +name of the .Tn UNIX -domain datagram log socket. +domain datagram log socket .It Pa /dev/klog -The kernel log device. +kernel log device .El .Sh SEE ALSO .Xr logger 1 , @@ -145,3 +150,4 @@ The .Nm command appeared in .Bx 4.3 . + diff --git a/usr.sbin/timed/timed/timed.8 b/usr.sbin/timed/timed/timed.8 index 70fc7036627..a73e4f9d87d 100644 --- a/usr.sbin/timed/timed/timed.8 +++ b/usr.sbin/timed/timed/timed.8 @@ -1,3 +1,4 @@ +.\" $OpenBSD: timed.8,v 1.2 1999/03/11 21:08:04 aaron Exp $ .\" Copyright (c) 1980, 1991 Regents of the University of California. .\" All rights reserved. .\" @@ -38,7 +39,7 @@ .Nm timed .Nd time server daemon .Sh SYNOPSIS -.Nm timed +.Nm .Op Fl M .Op Fl t .Op Fl d @@ -62,11 +63,11 @@ using the timestamp request message. .Pp The service provided by -.Nm timed -is based on a master-slave +.Nm +is based on a master-slave scheme. When -.Nm timed +.Nm is started on a machine, it asks the master for the network time and sets the host's clock to that time. After that, it accepts synchronization messages periodically sent by @@ -85,7 +86,7 @@ a new master from among slaves running with the .Fl M flag. A -.Nm timed +.Nm running without the .Fl M or @@ -94,7 +95,7 @@ flags will remain a slave. The .Fl t flag enables -.Nm timed +.Nm to trace the messages it receives in the file .Pa /var/log/timed.log . @@ -105,7 +106,7 @@ The flag is for debugging the daemon. It causes the program to not put itself into the background. Normally -.Nm timed +.Nm checks for a master time server on each network to which it is connected, except as modified by the options described below. It will request synchronization service from the first master server @@ -142,7 +143,7 @@ and .Fl i flags are meaningless if used together. .Pp -.Nm Timed +.Nm checks for a master time server on each network to which it is connected, except as modified by the .Fl n @@ -185,7 +186,7 @@ and another time daemon are run on the same machine, ensure that the .Fl F flag is used, so that -.Nm timed +.Nm never attempts to adjust the local clock. .Pp The protocol is based on UDP/IP broadcasts. All machines within @@ -199,9 +200,11 @@ machines in the system log. .Sh FILES .Bl -tag -width /var/log/timed.masterlog -compact .It Pa /var/log/timed.log -tracing file for timed +tracing file for +.Nm .It Pa /var/log/timed.masterlog -log file for master timed +log file for master +.Nm .El .Sh SEE ALSO .Xr date 1 , diff --git a/usr.sbin/timed/timedc/timedc.8 b/usr.sbin/timed/timedc/timedc.8 index c89a6f925f1..7076bfcc98b 100644 --- a/usr.sbin/timed/timedc/timedc.8 +++ b/usr.sbin/timed/timedc/timedc.8 @@ -1,3 +1,4 @@ +.\" $OpenBSD: timedc.8,v 1.2 1999/03/11 21:08:04 aaron Exp $ .\" Copyright (c) 1980, 1991 Regents of the University of California. .\" All rights reserved. .\" @@ -39,17 +40,18 @@ .Nm timedc .Nd timed control program .Sh SYNOPSIS -.Nm timedc +.Nm .Oo Ar command\ \& .Op Ar argument ... .Oc .Sh DESCRIPTION -.Nm Timedc +.Nm is used to control the operation of the .Xr timed 8 program. It may be used to: -.Bl -bullet +.Pp +.Bl -bullet -compact .It Measure the differences between machines' clocks, .It @@ -63,14 +65,14 @@ Perform various debugging actions. .El .Pp Without any arguments, -.Nm timedc +.Nm will prompt for commands from the standard input. If arguments are supplied, -.Nm timedc +.Nm interprets the first argument as a command and the remaining arguments as parameters to the command. The standard input may be redirected causing -.Nm timedc +.Nm to read commands from a file. Commands may be abbreviated; recognized commands are: @@ -82,7 +84,7 @@ recognized commands are: Print a short description of each command specified in the argument list, or, if no arguments are given, a list of the recognized commands. .Pp -.It Ic clockdiff Ar host ... +.It Ic clockdiff Ar host Op Ar ... Compute the differences between the clock of the host machine and the clocks of the machines given as arguments. .Pp |