converted man page
authorCynthia A. E. Livingston <cael@ucbvax.Berkeley.EDU>
Mon, 25 Jun 1990 10:09:26 +0000 (02:09 -0800)
committerCynthia A. E. Livingston <cael@ucbvax.Berkeley.EDU>
Mon, 25 Jun 1990 10:09:26 +0000 (02:09 -0800)
SCCS-vsn: usr.bin/logger/logger.1 6.5
SCCS-vsn: usr.bin/rlogin/rlogin.1 6.14
SCCS-vsn: usr.bin/login/login.1 6.7

usr/src/usr.bin/logger/logger.1
usr/src/usr.bin/login/login.1
usr/src/usr.bin/rlogin/rlogin.1

index d14d4c8..3af969a 100644 (file)
@@ -1,75 +1,78 @@
-.\" Copyright (c) 1983 Regents of the University of California.
+.\" Copyright (c) 1983, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"
 .\" All rights reserved.
 .\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" %sccs.include.redist.man%
 .\"
 .\"
-.\"    @(#)logger.1    6.4 (Berkeley) %G%
+.\"     @(#)logger.1   6.5 (Berkeley) %G%
 .\"
 .\"
-.TH LOGGER 1 ""
-.UC 6
-.SH NAME
-logger \- make entries in the system log
-.SH SYNOPSIS
-.B logger
-[
-.B \-is
-] [
-.B \-f
-file
-] [
-.B \-p
-pri
-] [
-.B \-t
-tag ] [ message ... ]
-.SH ARGUMENTS
-.TP 12n
-.B \-i
+.Dd 
+.Dt LOGGER 1
+.Os BSD 4.3
+.Sh NAME
+.Nm logger
+.Nd make entries in the system log
+.Sh SYNOPSIS
+.Nm logger
+.Op Fl is
+.Op Fl f Ar file
+.Op Fl p Ar pri
+.Op Fl t Ar tag
+.Op Ar message ...
+.Sh DESCRIPTION
+.Nm Logger
+provides a shell command interface to the
+.Xr syslog  3
+system log module.
+.Pp
+Options:
+.Pp
+.Tw Fl
+.Tp Fl i
 Log the process id of the logger process
 with each line.
 Log the process id of the logger process
 with each line.
-.TP
-.B \-s
+.Tp Fl s
 Log the message to standard error, as well as the system log.
 Log the message to standard error, as well as the system log.
-.TP
-.BI \-f \ file
+.Tc Fl f
+.Ws
+.Ar file
+.Cx
 Log the specified file.
 Log the specified file.
-.TP
-.BI \-p \ pri
+.Tc Fl p
+.Ws
+.Ar pri
+.Cx
 Enter the message with the specified priority.
 The priority may be specified numerically or as a ``facility.level''
 pair.
 For example, ``\-p local3.info'' logs the message(s) as
 Enter the message with the specified priority.
 The priority may be specified numerically or as a ``facility.level''
 pair.
 For example, ``\-p local3.info'' logs the message(s) as
-.IR info rmational
+.Sf Ar info rmational
 level in the
 level in the
-.I local3
+.Ar local3
 facility.
 The default is ``user.notice.''
 facility.
 The default is ``user.notice.''
-.TP
-.BI \-t \ tag
+.Tc Fl t
+.Ws
+.Ar tag
+.Cx
 Mark every line in the log with the specified
 Mark every line in the log with the specified
-.IR tag .
-.TP
-message
-The message to log; if not specified, and the \fB-f\fP flag is not
+.Ar tag  .
+.Tp Ar message
+Write the message to log; if not specified, and the
+.Fl f
+flag is not
 provided, standard input is logged.
 provided, standard input is logged.
-.SH DESCRIPTION
-.I Logger
-provides a shell command interface to the
-.IR syslog (3)
-system log module.
-.SH EXAMPLES
-logger System rebooted
-.PP
-logger \-p local0.notice \-t HOSTIDM \-f /dev/idmc
-.SH SEE ALSO
-syslog(3), syslogd(8)
+.Tp
+.Pp
+The
+.Nm logger
+utility exits 0 on success, and >0 if an error occurs.
+.Sh EXAMPLES
+.Pp
+.Dl logger System rebooted
+.Pp
+.Dl logger \-p local0.notice \-t HOSTIDM \-f /dev/idmc
+.Sh SEE ALSO
+.Xr syslog 3 ,
+.Xr syslogd 8
+.Sh STANDARDS
+The logger function is expected to be POSIX 1003.2 compatible.
index 2b82d03..3bc4f48 100644 (file)
-.\" Copyright (c) 1980 Regents of the University of California.
+.\" Copyright (c) 1980, 1990 Regents of the University of California.
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
-.\"    @(#)login.1     6.6 (Berkeley) %G%
+.\"     @(#)login.1    6.7 (Berkeley) %G%
 .\"
 .\"
-.TH LOGIN 1 ""
-.UC 4
-.SH NAME
-login \- sign on
-.SH SYNOPSIS
-.B login
-[
-.B \-p
-] [ username ]
-.br
-.B login
-[
-.B \-p
-] [
-.B \-h
-hostname
-] [
-.B \-f
-] [
-username
-]
-.SH DESCRIPTION
+.Dd 
+.Dt LOGIN 1
+.Os BSD 4
+.Sh NAME
+.Nm login
+.Nd sign on
+.Sh SYNOPSIS
+.Nm login
+.Op Fl p
+.Op Ar username
+.Nm login
+.Op Fl p
+.Op Fl h Ar hostname
+.Op Fl f
+.Op Ar username
+.Sh DESCRIPTION
 The
 The
-.I login
+.Nm login
 command
 is used when a user initially
 signs on.
 It may also be used at any time to change
 from one user to another.
 This case is the one summarized first above and described here.
 command
 is used when a user initially
 signs on.
 It may also be used at any time to change
 from one user to another.
 This case is the one summarized first above and described here.
-See \*(lqHow to Get Started\*(rq for how to connect initially.
+See
+.Em How to Get Started
+for how to connect initially.
 The invocation of
 The invocation of
-.I login
+.Nm login
 for initial sign-on
 is made by a system program or server using the latter form of the command
 and is described below.
 for initial sign-on
 is made by a system program or server using the latter form of the command
 and is described below.
-.PP
+.Pp
 If
 If
-.I login
+.Nm login
 is invoked without an argument,
 it asks for a user name, and, if
 appropriate, a password.
 Echoing is turned off (if possible) during the typing of the password,
 so it will not appear on the written record of the
 session.
 is invoked without an argument,
 it asks for a user name, and, if
 appropriate, a password.
 Echoing is turned off (if possible) during the typing of the password,
 so it will not appear on the written record of the
 session.
-.PP
+.Pp
 After a successful login,
 accounting files are updated and
 the user is informed of the
 existence of mail.
 The message of the day is printed,
 as is the time of his last login.
 After a successful login,
 accounting files are updated and
 the user is informed of the
 existence of mail.
 The message of the day is printed,
 as is the time of his last login.
-Both are suppressed if he has a \*(lq.hushlogin\*(rq
+Both are suppressed if he has a
+.Dq Pa .hushlogin
 file in his home directory; this
 is mostly used to make life easier for non-human users, such as
 file in his home directory; this
 is mostly used to make life easier for non-human users, such as
-.IR uucp .
-.PP
-.I Login
+.Xr uucp 1 .
+.Pp
+.Nm Login
 initializes the user and group IDs and the working directory,
 then executes a command interpreter (usually
 initializes the user and group IDs and the working directory,
 then executes a command interpreter (usually
-.IR  csh (1))
+.Xr csh  1  )
 according to specifications found in a password file.
 Argument 0 of the command interpreter is
 the name of the command interpreter with
 according to specifications found in a password file.
 Argument 0 of the command interpreter is
 the name of the command interpreter with
-a leading dash (\*(lq\-\*(rq).
-.PP
+a leading dash
+.Sq Fl .
+.Pp
 Login also modifies the
 environment
 Login also modifies the
 environment
-.IR environ (7)
+.Xr environ  7
 with information specifying home directory, command interpreter, terminal
 type (if available) and user name.
 with information specifying home directory, command interpreter, terminal
 type (if available) and user name.
-The `\-p' argument causes the remainder of the environment to be preserved,
+.Pp
+Options:
+.Pp
+.Tw Fl
+.Tp Fl p
+Causes the remainder of the environment to be preserved,
 otherwise any previous environment is discarded.
 otherwise any previous environment is discarded.
-.PP
-If the file /etc/nologin exists,
-.I login
-prints its contents on the user's terminal and exits. This is
-used by
-.IR shutdown (8)
-to stop users logging in when the system is about to go down.
-.PP
-Login is recognized by
-.IR sh (1)
-and
-.IR csh (1)
-and executed directly (without forking).
-.PP
-There are several additional options to
-.I login
-for use at initial login.
-With one exception, these options are available only to the superuser.
-The
-.B \-h
+.Tp Fl h
 option is used by
 option is used by
-.IR telnetd (8)
+.Ar telnetd  8
+(at initial login)
 and other servers to list the host from which
 the connection was received.
 and other servers to list the host from which
 the connection was received.
-The
-.B \-f
-option is used with a username on the command line
+.Tp Fl f
+Used with a username on the command line, at initial login,
 to indicate that proper authentication has already been done
 and that no password need be requested.
 This option may be used by the superuser
 or by the user specified on the command line.
 to indicate that proper authentication has already been done
 and that no password need be requested.
 This option may be used by the superuser
 or by the user specified on the command line.
-.SH FILES
-.ta \w'/usr/spool/mail/*\ \ 'u
-/etc/utmp      accounting
-.br
-/usr/adm/wtmp  accounting
-.br
-/usr/spool/mail/*      mail
-.br
-/etc/motd      message-of-the-day
-.br
-/etc/passwd    password file
-.br
-/etc/nologin   stops logins
-.br
-\&.hushlogin   makes login quieter
-.SH "SEE ALSO"
-mail(1), passwd(1), rlogin(1), getpass(3), passwd(5), utmp(5), environ(7),
-init(8), getty(8), shutdown(8),
-.SH DIAGNOSTICS
-\*(lqLogin incorrect,\*(rq
+.Tp
+.Pp
+If the file
+.Pa /etc/nologin
+exists,
+.Nm login
+prints its contents on the user's terminal and exits. This is
+used by
+.Xr shutdown  8
+to stop users logging in when the system is about to go down.
+.Pp
+Login is recognized by
+.Xr sh  1
+and
+.Xr csh  1
+and executed directly (without forking).
+.Sh FILES
+.Dw /var/log/wtmp
+.Di L
+.Dp Pa /var/run/utmp
+accounting
+.Dp Pa /var/log/wtmp
+accounting
+.Dp Pa /var/mail/*
+mail
+.Dp Pa /etc/motd
+message-of-the-day
+.Dp Pa /etc/passwd
+password file
+.Dp Pa /etc/nologin
+stops logins
+.Dp Pa \&.hushlogin
+makes login quieter
+.Dp
+.Sh SEE ALSO
+.Xr mail 1 ,
+.Xr passwd 1 ,
+.Xr rlogin 1 ,
+.Xr getpass 3 ,
+.Xr passwd 5 ,
+.Xr utmp 5 ,
+.Xr environ 7 ,
+.Xr init 8 ,
+.Xr getty 8 ,
+.Xr shutdown 8 ,
+.Sh HISTORY
+.Nm login
+appeared in Version 6 AT&T Unix.
+.Sh DIAGNOSTICS
+.Dw Fl
+.Di L
+.Dp Li Login incorrect
 if the name or the password is bad.
 if the name or the password is bad.
-.br
-\*(lqNo Shell\*(rq, \*(lqcannot open password file\*(rq,
-\*(lqno directory\*(rq:
+.Dp Li No Shell
+.Dp Li cannot open password file
+.Dp Li no directory
 consult a programming counselor.
 consult a programming counselor.
+.Dp
index 1b58e3f..628da07 100644 (file)
@@ -1,14 +1,11 @@
 .\" Copyright (c) 1983, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"
 .\" Copyright (c) 1983, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"
-%sccs.include.redist.man%
+.\" %sccs.include.redist.man%
 .\"
 .\"
-.\"    @(#)rlogin.1    6.13 (Berkeley) %G%
+.\"     @(#)rlogin.1   6.14 (Berkeley) %G%
 .\"
 .\"
-.\" $Source: /mit/kerberos/src/man/RCS/rlogin.1,v $
-.\" $Author: jtkohl $
-.\" $Header: rlogin.1,v 4.1 89/01/23 11:39:19 jtkohl Exp $
-.TH RLOGIN 1 ""
+.TH RLOGIN 1 "%Q"
 .UC 5
 .SH NAME
 rlogin \- remote login
 .UC 5
 .SH NAME
 rlogin \- remote login