diff options
author | ed <ed@FreeBSD.org> | 2010-01-13 19:03:48 +0000 |
---|---|---|
committer | ed <ed@FreeBSD.org> | 2010-01-13 19:03:48 +0000 |
commit | a40e5b0c4872f0c1eb774b675e6e714e73d63d8c (patch) | |
tree | 541fa34254d7ab29c00912b4f2b280b8e1b94b26 /share | |
parent | fc12a579a0a06596dc1b73d257d1b9751d747ce9 (diff) | |
download | FreeBSD-src-a40e5b0c4872f0c1eb774b675e6e714e73d63d8c.zip FreeBSD-src-a40e5b0c4872f0c1eb774b675e6e714e73d63d8c.tar.gz |
Remove <utmp.h> and its corresponding manual page.
Diffstat (limited to 'share')
-rw-r--r-- | share/man/man5/Makefile | 2 | ||||
-rw-r--r-- | share/man/man5/utmp.5 | 267 |
2 files changed, 0 insertions, 269 deletions
diff --git a/share/man/man5/Makefile b/share/man/man5/Makefile index 615ebf1..1216fc4 100644 --- a/share/man/man5/Makefile +++ b/share/man/man5/Makefile @@ -68,7 +68,6 @@ MAN= acct.5 \ style.Makefile.5 \ sysctl.conf.5 \ tmpfs.5 \ - utmp.5 \ xfs.5 MLINKS= dir.5 dirent.5 @@ -79,7 +78,6 @@ MLINKS+=passwd.5 master.passwd.5 MLINKS+=quota.user.5 quota.group.5 MLINKS+=rc.conf.5 rc.conf.local.5 MLINKS+=resolver.5 resolv.conf.5 -MLINKS+=utmp.5 lastlog.5 utmp.5 wtmp.5 .if ${MK_HESIOD} != "no" MAN+= hesiod.conf.5 diff --git a/share/man/man5/utmp.5 b/share/man/man5/utmp.5 deleted file mode 100644 index c342041..0000000 --- a/share/man/man5/utmp.5 +++ /dev/null @@ -1,267 +0,0 @@ -.\" Copyright (c) 1980, 1991, 1993 -.\" The Regents of the University of California. 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 acknowledgement: -.\" This product includes software developed by the University of -.\" California, Berkeley and its contributors. -.\" 4. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS 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 REGENTS 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. -.\" -.\" @(#)utmp.5 8.2 (Berkeley) 3/17/94 -.\" $FreeBSD$ -.\" -.Dd November 14, 2001 -.Dt UTMP 5 -.Os -.Sh NAME -.Nm utmp , -.Nm wtmp , -.Nm lastlog -.Nd login records -.Sh SYNOPSIS -.In sys/types.h -.In utmp.h -.Sh DESCRIPTION -The file -.In utmp.h -declares the structures used to record information about current -users in the file -.Nm , -logins and logouts in the file -.Nm wtmp , -and last logins in the file -.Nm lastlog . -The time stamps of date changes, shutdowns and reboots are also logged in -the -.Nm wtmp -file. -.Bd -literal -offset indent -#define _PATH_UTMP "/var/run/utmp" -#define _PATH_WTMP "/var/log/wtmp" -#define _PATH_LASTLOG "/var/log/lastlog" - -#define UT_NAMESIZE 16 -#define UT_LINESIZE 8 -#define UT_HOSTSIZE 16 - -struct lastlog { - int32_t ll_time; /* When user logged in */ - char ll_line[UT_LINESIZE]; /* Terminal line name */ - char ll_host[UT_HOSTSIZE]; /* Host user came from */ -}; - -struct utmp { - char ut_line[UT_LINESIZE]; /* Terminal line name */ - char ut_name[UT_NAMESIZE]; /* User's login name */ - char ut_host[UT_HOSTSIZE]; /* Host user came from */ - int32_t ut_time; /* When user logged in */ -}; -.Ed -.Pp -The -.Nm lastlog -file is a linear array of -.Vt lastlog -structures indexed by a user's -.Tn UID . -The -.Nm -file is a linear array of -.Vt utmp -structures indexed by a terminal line number -(see -.Xr ttyslot 3 ) . -The -.Nm wtmp -file consists of -.Vt utmp -structures and is a binary log file, -that is, grows linearly at its end. -.Pp -By default, each time a user logs in, the -.Xr pam_lastlog 8 -program looks up the user's -.Tn UID -in the file -.Nm lastlog . -If it is found, the timestamp of the last time the user logged -in, the terminal line and the hostname -are written to the standard output. -The -.Xr pam_lastlog 8 -program then records the new login time in the file -.Nm lastlog . -.Pp -After the new -.Vt lastlog -record is written, -.\" the -.\" .Xr libutil 3 -.\" routine -the file -.Nm -is opened and the -.Vt utmp -record for the user is inserted. -This record remains there until -the user logs out at which time it is deleted. -The -.Nm -file is used by the programs -.Xr rwho 1 , -.Xr users 1 , -.Xr w 1 , -and -.Xr who 1 . -.Pp -Next, the -.Xr pam_lastlog 8 -program opens the file -.Nm wtmp , -and appends the user's -.Vt utmp -record. -The user's subsequent logout from the terminal -line is marked by a special -.Vt utmp -record with -.Va ut_line -set accordingly, -.Va ut_time -updated, but -.Va ut_name -and -.Va ut_host -both empty -(see -.Xr init 8 ) . -The -.Nm wtmp -file is used by the programs -.Xr last 1 -and -.Xr ac 8 . -.Pp -In the event of a date change, a shutdown or reboot, the -following items are logged in the -.Nm wtmp -file. -.Pp -.Bl -tag -width ".Li shutdown" -compact -.It Li reboot -.It Li shutdown -A system reboot or shutdown has been initiated. -The character -.Ql \&~ -is placed in the field -.Va ut_line , -and -.Li reboot -or -.Li shutdown -in the field -.Va ut_name -(see -.Xr shutdown 8 -and -.Xr reboot 8 ) . -.Pp -.It Li date -The system time has been manually or automatically updated -(see -.Xr date 1 ) . -The command name -.Li date -is recorded in the field -.Va ut_name . -In the field -.Va ut_line , -the character -.Ql \&| -indicates the time prior to the change, and the character -.Ql \&{ -indicates the new time. -.El -.Sh NOTES -The -.Nm wtmp -file can grow rapidly on busy systems, so daily or weekly rotation -is recommended. -It is maintained by -.Xr newsyslog 8 . -.Pp -If any one of these files does not exist, it is not created by -.Xr pam_lastlog 8 . -The files must be created manually. -.Pp -The supplied -.Xr login 3 , -.Xr logout 3 , -and -.Xr logwtmp 3 -utility functions should be used to perform -the standard actions on the -.Nm -and -.Nm wtmp -files in order to maintain the portability across -systems with different formats of those files. -.Sh FILES -.Bl -tag -width ".Pa /var/log/lastlog" -compact -.It Pa /var/run/utmp -The -.Nm -file. -.It Pa /var/log/wtmp -The -.Nm wtmp -file. -.It Pa /var/log/lastlog -The -.Nm lastlog -file. -.El -.Sh SEE ALSO -.Xr last 1 , -.Xr w 1 , -.Xr who 1 , -.Xr login 3 , -.Xr logout 3 , -.Xr logwtmp 3 , -.Xr ttyslot 3 , -.Xr ac 8 , -.Xr init 8 , -.Xr pam_lastlog 8 -.Sh HISTORY -A -.Nm -and -.Nm wtmp -file format appeared in -.At v6 . -The -.Nm lastlog -file format appeared in -.Bx 3.0 . |