diff options
| -rw-r--r-- | libexec/atrun/atrun.8 | 21 | ||||
| -rw-r--r-- | libexec/comsat/comsat.8 | 20 | ||||
| -rw-r--r-- | libexec/fingerd/fingerd.8 | 31 | ||||
| -rw-r--r-- | libexec/ftpd/ftpd.8 | 97 | ||||
| -rw-r--r-- | libexec/getNAME/getNAME.8 | 14 | ||||
| -rw-r--r-- | libexec/getty/getty.8 | 14 | ||||
| -rw-r--r-- | libexec/getty/ttys.5 | 37 |
7 files changed, 123 insertions, 111 deletions
diff --git a/libexec/atrun/atrun.8 b/libexec/atrun/atrun.8 index 679f8ce1a2a..30c7f373cb1 100644 --- a/libexec/atrun/atrun.8 +++ b/libexec/atrun/atrun.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: atrun.8,v 1.7 1999/07/09 13:35:51 aaron Exp $ +.\" $OpenBSD: atrun.8,v 1.8 2000/09/08 18:03:26 aaron Exp $ .\" $FreeBSD: atrun.man,v 1.3 1997/02/22 14:20:55 peter Exp $ .Dd April 12, 1995 .Dt ATRUN 8 @@ -11,7 +11,7 @@ .Op Fl l Ar load_avg .Op Fl d .Sh DESCRIPTION -.Nm Atrun +.Nm runs jobs queued by .Xr at 1 . Root's @@ -29,9 +29,10 @@ At every invocation, every job in lowercase queues whose starting time has passed is started. A maximum of one batch job (denoted by uppercase queues) is started each time -.Nm atrun +.Nm is invoked. -.Sh OPTIONS +.Pp +The options are as follows: .Bl -tag -width indent .It Fl l Ar load_avg Specifies a limiting load factor, over which batch jobs should @@ -42,16 +43,16 @@ Debug; print error messages to standard error instead of using .El .Sh WARNINGS For -.Nm atrun +.Nm to work, you have to start up a .Xr cron 8 daemon. .Sh FILES .Bl -tag -width /var/at/spool -compact .It Pa /var/at/spool -Directory containing output spool files +directory containing output spool files .It Pa /var/at/jobs -Directory containing job files +directory containing job files .El .Sh SEE ALSO .Xr at 1 , @@ -59,10 +60,10 @@ Directory containing job files .Xr syslog 3 , .Xr crontab 5 , .Xr cron 8 +.Sh AUTHOR +Thomas Koenig <ig25@rz.uni-karlsruhe.de>. .Sh BUGS The functionality of -.Nm atrun +.Nm should be merged into .Xr cron 8 . -.Sh AUTHOR -Thomas Koenig <ig25@rz.uni-karlsruhe.de>. diff --git a/libexec/comsat/comsat.8 b/libexec/comsat/comsat.8 index 7395f0c7717..99bc12fadf8 100644 --- a/libexec/comsat/comsat.8 +++ b/libexec/comsat/comsat.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)comsat.8 8.1 (Berkeley) 6/4/93 -.\" $Id: comsat.8,v 1.2 1999/05/23 14:11:10 aaron Exp $ +.\" $Id: comsat.8,v 1.3 2000/09/08 18:03:26 aaron Exp $ .\" .Dd June 4, 1993 .Dt COMSAT 8 @@ -41,10 +41,10 @@ .Sh SYNOPSIS .Nm comsat .Sh DESCRIPTION -.Nm Comsat +.Nm is the server process which receives reports of incoming mail and notifies users if they have requested this service. -.Nm Comsat +.Nm receives messages on a datagram port associated with the .Dq biff service @@ -65,8 +65,8 @@ the .Em offset is used as a seek offset into the appropriate mailbox file and the first 7 lines or 560 characters of the message are printed -on the user's terminal. Lines which appear to be part of -the message header other than the +on the user's terminal. +Lines which appear to be part of the message header other than the .Dq From , .Dq \&To , .Dq Date , @@ -81,6 +81,11 @@ to find out who's logged on and on what terminals .Sh SEE ALSO .Xr biff 1 , .Xr inetd 8 +.Sh HISTORY +The +.Nm +command appeared in +.Bx 4.2 . .Sh BUGS The message header filtering is prone to error. The density of the information presented is near the theoretical minimum. @@ -90,8 +95,3 @@ machines than the one to which they are currently logged in. .Pp The notification should appear in a separate window so it does not mess up the screen. -.Sh HISTORY -The -.Nm -command appeared in -.Bx 4.2 . diff --git a/libexec/fingerd/fingerd.8 b/libexec/fingerd/fingerd.8 index 96b22740e4a..a10bd3ddc19 100644 --- a/libexec/fingerd/fingerd.8 +++ b/libexec/fingerd/fingerd.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: fingerd.8,v 1.10 2000/08/02 15:58:09 provos Exp $ +.\" $OpenBSD: fingerd.8,v 1.11 2000/09/08 18:03:27 aaron Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -32,7 +32,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)fingerd.8 8.1 (Berkeley) 6/4/93 -.\" $Id: fingerd.8,v 1.10 2000/08/02 15:58:09 provos Exp $ +.\" $Id: fingerd.8,v 1.11 2000/09/08 18:03:27 aaron Exp $ .\" .Dd June 4, 1993 .Dt FINGERD 8 @@ -51,7 +51,7 @@ .Op Fl S .Op Fl P Ar filename .Sh DESCRIPTION -.Nm Fingerd +.Nm is a simple protocol based on .%T RFC1288 that provides an interface to the @@ -63,7 +63,7 @@ There is no required format and the protocol consists mostly of specifying a single .Dq command line . .Pp -.Nm Fingerd +.Nm is started by .Xr inetd 8 , which listens for @@ -74,7 +74,7 @@ terminated by a .Aq Tn CRLF which is passed to .Xr finger 1 . -.Nm Fingerd +.Nm closes its connections as soon as the output is finished. .Pp If the line is null (i.e., just a @@ -100,7 +100,7 @@ and If a name is ambiguous, all possible derivations are returned. .Pp The following options may be passed to -.Nm fingerd +.Nm as server program arguments in .Pa /etc/inetd.conf : .Bl -tag -width Ds @@ -126,10 +126,11 @@ option is supplied. .It Fl M Enables matching of .Ar user -names. This is disabled by default if the system is running YP. +names. +This is disabled by default if the system is running YP. .It Fl p Prevents -.Nm finger +.Nm from displaying the contents of the .Dq Pa .plan and @@ -144,7 +145,7 @@ that may be passed in from the remote client. Use an alternate program as the local information provider. The default local program executed by -.Nm fingerd +.Nm is .Xr finger 1 . By specifying a customized local server, @@ -155,6 +156,11 @@ provided to remote sites. .Sh SEE ALSO .Xr finger 1 , .Xr inetd 8 +.Sh HISTORY +The +.Nm +command appeared in +.Bx 4.3 . .Sh BUGS Connecting directly to the server from a .Tn TIP @@ -163,15 +169,10 @@ or an equally narrow-minded user program can result in meaningless attempts at option negotiation being sent to the server, which will foul up the command line interpretation. -.Nm Fingerd +.Nm should be taught to filter out .Tn IAC Ns \'s and perhaps even respond negatively .Pq Tn IAC WON'T to all option commands received. -.Sh HISTORY -The -.Nm -command appeared in -.Bx 4.3 . diff --git a/libexec/ftpd/ftpd.8 b/libexec/ftpd/ftpd.8 index 71d178de320..fdc599f2c3d 100644 --- a/libexec/ftpd/ftpd.8 +++ b/libexec/ftpd/ftpd.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ftpd.8,v 1.34 2000/08/20 18:42:37 millert Exp $ +.\" $OpenBSD: ftpd.8,v 1.35 2000/09/08 18:03:27 aaron Exp $ .\" $NetBSD: ftpd.8,v 1.8 1996/01/14 20:55:23 thorpej Exp $ .\" .\" Copyright (c) 1985, 1988, 1991, 1993 @@ -48,10 +48,9 @@ Internet File Transfer Protocol server .Op Fl t Ar timeout .Op Fl u Ar mask .Sh DESCRIPTION -.Nm Ftpd -is the -Internet File Transfer Protocol -server process. The server uses the +.Nm +is the Internet File Transfer Protocol server process. +The server uses the .Tn TCP protocol and listens at the port specified in the @@ -59,7 +58,7 @@ and listens at the port specified in the service specification; see .Xr services 5 . .Pp -Available options: +The options are as follows: .Bl -tag -width Ds .It Fl A Permit only anonymous ftp connections, accounts listed in @@ -73,11 +72,11 @@ Other connection attempts are refused. Debugging information is written to the syslog using LOG_FTP. .It Fl D With this option set, -.Nm ftpd +.Nm will detach and become a daemon, accepting connections on the FTP port and -forking child processes to handle them. This has lower overhead than -starting -.Nm ftpd +forking child processes to handle them. +This has lower overhead than starting +.Nm from .Xr inetd 8 and is thus useful on busy servers to reduce load. @@ -87,7 +86,8 @@ This range is defined by the .Ev IPPORT_HIFIRSTAUTO and .Ev IPPORT_HILASTAUTO -defines in <netinet/in.h>. In +defines in <netinet/in.h>. +In .Ox they are set to 49152 and 65535 respectively. .It Fl l @@ -98,7 +98,8 @@ If this option is specified twice, the retrieve (get), store (put), append, delete, make directory, remove directory and rename operations and their filename arguments are also logged. .It Fl M -Enables multihomed mode. Instead of simply using +Enables multihomed mode. +Instead of simply using .Pa ~ftp for anonymous transfers, a directory matching the fully qualified name of the IP number the client connected to, and located inside @@ -114,7 +115,7 @@ This prevents the "FTP bounce attack" against services on both the local machine and other local machines. .It Fl S With this option set, -.Nm ftpd +.Nm logs all anonymous downloads to the file .Pa /var/log/ftpd when this file exists. @@ -152,7 +153,8 @@ seconds (the default is 15 minutes). .It Fl u Ar mask Force the umask to .Ar mask . -instead of the default 027. Also disallows chmod. +instead of the default 027. +Also disallows chmod. .El .Pp The file @@ -172,7 +174,8 @@ If the file .Pa /etc/motd exists, .Nm -prints it after a successful login. If the file +prints it after a successful login. +If the file .Pa .message exists in a directory, .Nm @@ -252,7 +255,7 @@ STAT command is received during a data transfer, preceded by a Telnet IP and Synch, transfer status will be returned. .Pp -.Nm Ftpd +.Nm interprets file names according to the .Dq globbing conventions used by @@ -260,7 +263,7 @@ conventions used by This allows users to utilize the metacharacters .Dq Li \&*?[]{}~ . .Pp -.Nm Ftpd +.Nm authenticates users according to five rules. .Pp .Bl -enum -offset indent @@ -271,13 +274,15 @@ and not have a null password. In this case a password must be provided by the client before any file operations may be performed. If the user has an S/Key key, the response from a successful USER -command will include an S/Key challenge. The client may choose to respond -with a PASS command giving either a standard password or an S/Key -one-time password. The server will automatically determine which type of -password it has been given and attempt to authenticate accordingly. See +command will include an S/Key challenge. +The client may choose to respond with a PASS command giving either a +standard password or an S/Key one-time password. +The server will automatically determine which type of +password it has been given and attempt to authenticate accordingly. +See .Xr skey 1 -for more information on S/Key authentication. S/Key is a Trademark of -Bellcore. +for more information on S/Key authentication. +S/Key is a Trademark of Bellcore. .It The login name must not appear in the file .Pa /etc/ftpusers . @@ -293,10 +298,11 @@ as for an .Dq anonymous or .Dq ftp -account (see next item). However, the user must still supply a password. +account (see next item). +However, the user must still supply a password. This feature is intended as a compromise between a fully anonymous account -and a fully privileged account. The account should also be set up as for an -anonymous account. +and a fully privileged account. +The account should also be set up as for an anonymous account. .It If the user name is .Dq anonymous @@ -312,7 +318,7 @@ the user should be used as the password). .El .Pp In the last case, -.Nm ftpd +.Nm takes special measures to restrict the client's access privileges. The server performs a .Xr chroot 2 @@ -416,9 +422,9 @@ The virtual host that the connection was made to. .El .Pp Although fields exist for logging information on real users, this file is -only used for anonymous downloads. Unused fields exist only for compatility -with other -.Nm ftpd +only used for anonymous downloads. +Unused fields exist only for compatility with other +.Nm implementations. .Sh LOGIN.CONF VARIABLES The @@ -436,21 +442,21 @@ This value overrides the login directory for the users of this class. .Sh FILES .Bl -tag -width /var/run/ftpd.pid -compact .It Pa /etc/ftpusers -List of unwelcome/restricted users. +list of unwelcome/restricted users .It Pa /etc/ftpchroot -List of normal users who should be chroot'd. +list of normal users who should be chroot'd .It Pa /etc/ftpwelcome -Welcome notice. +welcome notice .It Pa /etc/motd -Welcome notice after login. +welcome notice after login .It Pa /etc/nologin -Displayed and access refused. +displayed and access refused .It Pa /var/run/utmp -List of users on the system. +list of users on the system .It Pa /var/run/ftpd.pid -Process id if running in daemon mode. +process ID if running in daemon mode .It Pa /var/log/ftpd -Log file for anonymous downloads. +log file for anonymous downloads .El .Sh SEE ALSO .Xr ftp 1 , @@ -458,15 +464,16 @@ Log file for anonymous downloads. .Xr who 1 , .Xr getusershell 3 , .Xr syslogd 8 -.Sh BUGS -The server must run as the superuser -to create sockets with privileged port numbers. It maintains -an effective user ID of the logged in user, reverting to -the superuser only when binding addresses to sockets. The -possible security holes have been extensively -scrutinized, but are possibly incomplete. .Sh HISTORY The .Nm command appeared in .Bx 4.2 . +.Sh BUGS +The server must run as the superuser to create sockets with +privileged port numbers. +It maintains +an effective user ID of the logged in user, reverting to +the superuser only when binding addresses to sockets. +The possible security holes have been extensively scrutinized, +but are possibly incomplete. diff --git a/libexec/getNAME/getNAME.8 b/libexec/getNAME/getNAME.8 index 33d8478a312..57722147f69 100644 --- a/libexec/getNAME/getNAME.8 +++ b/libexec/getNAME/getNAME.8 @@ -1,3 +1,4 @@ +.\" $OpenBSD: getNAME.8,v 1.10 2000/09/08 18:03:27 aaron Exp $ .\" $NetBSD: getNAME.8,v 1.2.2.1 1997/11/10 19:54:39 thorpej Exp $ .\" .\" Copyright (c) 1997 Matthew R. Green @@ -40,7 +41,8 @@ The .Nm program looks inside manual sources to retrieve the NAME section of -the manual page. It can be used to create a table of contents, report +the manual page. +It can be used to create a table of contents, report the style of manual, or to create an introduction to the manual section. By default, .Nm @@ -72,6 +74,11 @@ or some unknown .Pq Dq UNKNOWN format exists. .El +.Sh SEE ALSO +.Xr apropos 1 , +.Xr man 1 , +.Xr whatis 1 , +.Xr makewhatis 8 .Sh HISTORY The .Nm @@ -81,8 +88,3 @@ command first appeared in It would be nice if .Nm could deal with preformatted manuals. -.Sh SEE ALSO -.Xr apropos 1 , -.Xr man 1 , -.Xr whatis 1 , -.Xr makewhatis 8 diff --git a/libexec/getty/getty.8 b/libexec/getty/getty.8 index 1b2827994b9..88f960d927b 100644 --- a/libexec/getty/getty.8 +++ b/libexec/getty/getty.8 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)getty.8 8.1 (Berkeley) 6/4/93 -.\" $Id: getty.8,v 1.6 2000/08/20 18:42:38 millert Exp $ +.\" $Id: getty.8,v 1.7 2000/09/08 18:03:27 aaron Exp $ .\" .Dd June 4, 1993 .Dt GETTY 8 @@ -46,7 +46,7 @@ .Oc .Sh DESCRIPTION The -.Nm getty +.Nm program is called by .Xr init 8 @@ -65,7 +65,7 @@ the tty line is assumed to be open as file descriptor 0. The .Ar type argument can be used to make -.Nm getty +.Nm treat the terminal line specially. This argument is used as an index into the .Xr gettytab 5 @@ -77,7 +77,7 @@ If there is no .Pa /etc/gettytab a set of system defaults is used. If indicated by the table located, -.Nm getty +.Nm will clear the terminal screen, print a banner heading, and prompt for a login name. @@ -85,13 +85,13 @@ Usually either the banner or the login prompt will include the system hostname. .Pp Most of the default actions of -.Nm getty +.Nm can be circumvented, or modified, by a suitable .Xr gettytab 5 table. .Pp The -.Nm getty +.Nm program can be set to timeout after some interval, which will cause dial up lines to hang up @@ -132,6 +132,6 @@ does not exist. .Xr init 8 .Sh HISTORY A -.Nm getty +.Nm program appeared in .At v6 . diff --git a/libexec/getty/ttys.5 b/libexec/getty/ttys.5 index 77c73dc771f..49a810a71ad 100644 --- a/libexec/getty/ttys.5 +++ b/libexec/getty/ttys.5 @@ -30,7 +30,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)ttys.5 8.1 (Berkeley) 6/4/93 -.\" $Id: ttys.5,v 1.4 1999/07/09 13:35:50 aaron Exp $ +.\" $Id: ttys.5,v 1.5 2000/09/08 18:03:28 aaron Exp $ .\" .Dd June 4, 1993 .Dt TTYS 5 @@ -39,21 +39,23 @@ .Nm ttys .Nd terminal initialization information .Sh DESCRIPTION -The file -.Nm ttys -contains information that is used by various routines to initialize +The +.Nm +file contains information that is used by various routines to initialize and control the use of terminal special files. This information is read with the .Xr getttyent 3 library routines. There is one line in the -.Nm ttys +.Nm file per special device file. Fields are separated by tabs and/or spaces. -Fields comprised of more than one word should be enclosed in double -quotes (``"''). +Fields comprised of more than one word should be enclosed in double quotes +.Pq Ql \&" . Blank lines and comments may appear anywhere in the file; comments -are delimited by hash marks (``#'') and new lines. +are delimited by hash marks +.Pq Ql # +and newlines. Any unspecified fields will default to null. .Pp The first field is the @@ -72,13 +74,12 @@ the start up for a window system terminal emulator or some other daemon process, and can contain multiple words if quoted. .Pp The third field is the type of terminal usually connected to that -tty line, normally the one found in the +TTY line, normally the one found in the .Xr termcap 5 -data base file. +database file. The environment variable .Dv TERM -is initialized with the value by -either +is initialized with the value by either .Xr getty 8 or .Xr login 1 . @@ -90,7 +91,7 @@ entry (see or specify a window system process that .Xr init 8 will maintain for the terminal line. -The following is a list of permitted flags for each tty: +The following is a list of permitted flags for each TTY: .Bl -tag -width xxxxxxx .It Ar on Specify that @@ -99,15 +100,15 @@ should execute the command given in the second field. .It Ar off The opposite of on. .It Ar secure -if +If .Ar on -is also specified, allows users with a uid of 0 to login on -this line. +is also specified, allows users with a UID of 0 to login on this line. .El .Pp Additionally, the following flags modify the default behavior of -the terminal line. Some of these flags may not be supported by a -terminal line driver. The flag fields should not be quoted. +the terminal line. +Some of these flags may not be supported by a terminal line driver. +The flag fields should not be quoted. .Bl -tag -width xxxxxxx .It Ar local Treat the line as if it is locally connected. |