]> git.ipfire.org Git - thirdparty/man-pages.git/blame - man5/utmp.5
fread.3: Swap size and nmemb params
[thirdparty/man-pages.git] / man5 / utmp.5
CommitLineData
3d54a910
MK
1.\" Copyright (c) 1993 Michael Haardt (michael@cantor.informatik.rwth-aachen.de),
2.\" Fri Apr 2 11:32:09 MET DST 1993
fea681da 3.\"
1dd72f9c 4.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
fea681da
MK
5.\" This is free documentation; you can redistribute it and/or
6.\" modify it under the terms of the GNU General Public License as
7.\" published by the Free Software Foundation; either version 2 of
8.\" the License, or (at your option) any later version.
9.\"
10.\" The GNU General Public License's references to "object code"
11.\" and "executables" are to be interpreted as the output of any
12.\" document formatting or typesetting system, including
13.\" intermediate and printed output.
14.\"
15.\" This manual is distributed in the hope that it will be useful,
16.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
17.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18.\" GNU General Public License for more details.
19.\"
20.\" You should have received a copy of the GNU General Public
c715f741
MK
21.\" License along with this manual; if not, see
22.\" <http://www.gnu.org/licenses/>.
6a8d8745 23.\" %%%LICENSE_END
c13182ef 24.\"
fea681da
MK
25.\" Modified 1993-07-25 by Rik Faith (faith@cs.unc.edu)
26.\" Modified 1995-02-26 by Michael Haardt
27.\" Modified 1996-07-20 by Michael Haardt
e00c3a07 28.\" Modified 1997-07-02 by Nicolás Lichtmaier <nick@debian.org>
fea681da 29.\" Modified 2004-10-31 by aeb, following Gwenole Beauchesne
9f43659f 30.TH UTMP 5 2020-12-21 "Linux" "Linux Programmer's Manual"
fea681da
MK
31.SH NAME
32utmp, wtmp \- login records
33.SH SYNOPSIS
c7db92b9 34.nf
62218dc0 35.B #include <utmp.h>
c7db92b9 36.fi
fea681da
MK
37.SH DESCRIPTION
38The
39.I utmp
40file allows one to discover information about who is currently using the
c13182ef
MK
41system.
42There may be more users currently using the system, because not
fea681da
MK
43all programs use utmp logging.
44.PP
45.B Warning:
46.I utmp
01f59bf3
PC
47must not be writable by the user class "other",
48because many system programs (foolishly)
c13182ef
MK
49depend on its integrity.
50You risk faked system logfiles and
fea681da
MK
51modifications of system files if you leave
52.I utmp
01f59bf3 53writable to any user other than the owner and group owner of the file.
fea681da 54.PP
c5571b61 55The file is a sequence of
897ea723
MK
56.I utmp
57structures,
58declared as follows in
59.IR <utmp.h>
60(note that this is only one of several definitions
fea681da 61around; details depend on the version of libc):
78bffc45 62.PP
088a639b 63.in +4n
bdd915e2 64.EX
f6f269ab
MK
65/* Values for ut_type field, below */
66
377dda59
MK
67#define EMPTY 0 /* Record does not contain valid info
68 (formerly known as UT_UNKNOWN on Linux) */
69#define RUN_LVL 1 /* Change in system run-level (see
4a95bc02 70 \fBinit\fP(1)) */