1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
|
.\" Copyright 1995 Mark D. Roth (roth@uiuc.edu)
.\"
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, write to the Free
.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
.\" USA.
.\"
.\" References consulted:
.\" Linux libc source code
.\" Solaris manpages
.\"
.\" Modified Thu Jul 25 14:43:46 MET DST 1996 by Michael Haardt <michael@cantor.informatik.rwth-aachen.de>
.\"
.\" Japanese Version Copyright (c) 1998 NAKANO Takeo all rights reserved.
.\" Translated Fri Mar 15 1998 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
,\" Updated Tue Oct 16 2001 by Kentaro Shirakata <argrath@ub32.org>
.\" Updated Thu Jan 3 2002 by Kentaro Shirakata <argrath@ub32.org>
.\"
.TH GETUTENT 3 "July 25, 1996" "" "Library functions"
.SH ̾
getutent, getutid, getutline, pututline, setutent, endutent, utmpname \- utmp եΥȥ˥
.SH
.B #include <utmp.h>
.sp
.B struct utmp *getutent(void);
.br
.BI "struct utmp *getutid(struct utmp *" ut );
.br
.BI "struct utmp *getutline(struct utmp *" ut );
.sp
.BI "struct utmp *pututline(struct utmp *" ut );
.sp
.B void setutent(void);
.br
.B void endutent(void);
.sp
.BI "void utmpname(const char *" file );
.SH
\fButmpname\fP() ϡ¾ utmp ؿ (utmp եޥåȤ)
ե̾ꤹ롣\fButmpname\fP() ¾δؿΩä
ե̾λѤʤϡ \fI<path.h>\fP
Ƥ \fB_PATH_UTMP\fP ե̾Ȥ롣
.PP
\fBsetutent\fP() ϥեݥ utmp եƬ˰ư롣
̾¾δؿΩäƤδؿƤӽФƤɤ
.PP
\fBendutent\fP() utmp ե롣桼ɤ¾
ؿˤ륢λ顢Ǹˤδؿ
ƤӽФʤФʤʤ
.PP
\fBgetutent\fP() utmp եθߤΥե֤ɤ߹ߡ
ԤγƥեɤƤ¤ΤؤΥݥ֤
.PP
\fBgetutid\fP() utmp եθߤΰ֤˸äơ
\fIut\fP ǻꤵ븡Ԥ \fIut\fP\fB->ut_type\fP
\fBRUN_LVL\fP, \fBBOOT_TIME\fP, \fBNEW_TIME\fP, \fBOLD_TIME\fP
줫ʤ顢 \fBgetutid\fP() \fBut_type\fP եɤ
\fIut\fP\fB->ut_type\fP ˰פǽΥȥõ
\fIut\fP\fB->ut_type\fP \fBINIT_PROCESS\fP, \fBLOGIN_PROCESS\fP,
\fBUSER_PROCESS\fP, \fBDEAD_PROCESS\fP Τ줫ʤ顢
\fBgetutid\fP() \fBut_id\fP եɤ \fIut\fP\fB->ut_id\fP
פǽΥȥõ
.PP
\fBgetutline\fP() utmp եθߤΰ֤顢Ƭ˸ä
Ԥ ut_type \fBUSER_PROCESS\fP ޤ \fBLOGIN_PROCESS\fP ǡ
\fBut_line\fP եɤ \fIut\fP\fB->ut_line\fP ˥ޥåǽ
Ԥ֤롣
.PP
\fBpututline\fP() utmp ¤ \fIut\fP Ƥ utmp ե
Ф \fBpututline\fP() \fBgetutid\fP() Ѥơʥȥ
Τˤդ路õ \fIut\fP դ路꤬
ĤʤϡʥȥϥեκǸɲä롣
.SH ֤
\fBgetutent\fP(), \fBgetutid\fP(), \fBgetutline\fP(), \fBpututline\fP()
\fBstatic struct utmp\fP ؤΥݥ֤
顼λˤ NULL ֤롣
.SH
ʲ utmp Υ쥳ɤɲáƤ롣ü (pseudo
terminal) ¹Ԥ뤳ȤꤷƤ롣ºݤΥץꥱǤϡ
getpwuid() ttyname() ͤ٤Ǥ롣
.PP
.nf
#include <string.h>
#include <stdlib.h>
#include <pwd.h>
#include <unistd.h>
#include <utmp.h>
int main(int argc, char *argv[])
{
struct utmp entry;
system("echo before adding entry:;who");
entry.ut_type=USER_PROCESS;
entry.ut_pid=getpid();
strcpy(entry.ut_line,ttyname(0)+strlen("/dev/"));
/* only correct for ptys named /dev/tty[pqr][0-9a-z] */
strcpy(entry.ut_id,ttyname(0)+strlen("/dev/tty"));
time(&entry.ut_time);
strcpy(entry.ut_user,getpwuid(getuid())->pw_name);
memset(entry.ut_host,0,UT_HOSTSIZE);
entry.ut_addr=0;
setutent();
pututline(&entry);
system("echo after adding entry:;who");
entry.ut_type=DEAD_PROCESS;
memset(entry.ut_line,0,UT_LINESIZE);
entry.ut_time=0;
memset(entry.ut_user,0,UT_NAMESIZE);
setutent();
pututline(&entry);
system("echo after removing entry:;who");
endutent();
return 0;
}
.fi
.SH ե
/var/run/utmp ߥƤ桼Υǡ١
.br
/var/log/wtmp Υ桼Υǡ١
.SH
XPG 2, SVID 2, Linux FSSTND 1.2
.LP
XPG2 SVID2 Ǥϡ\fIpututline()\fP ؿ֤ͤʤȤƤꡢ
¿Υƥ (AIX, HPUX, Linux libc5) ǤϤʤäƤ롣
HPUX ǤϾҤ \fIpututline()\fP Ʊץȥפ
ؿǤ \fI_pututline()\fP ƳƤ
(δؿ Linux libc5 ˤ⤢)
.LP
Ƥδؿ Linux ʳΥƥǤϸŤΤǤ롣
XPG4.2 ³ POSIX 1003.1-2001 ǤϤϤ䤳δؿϤʤ
˰ʲΤΤȤ
.sp
.B #include <utmpx.h>
.sp
.B struct utmpx *getutxent(void);
.br
.B struct utmpx *getutxid(const struct utmpx *);
.br
.B struct utmpx *getutxline(const struct utmpx *);
.br
.B struct utmpx *pututxline(const struct utmpx *);
.br
.B void setutxent(void);
.br
.B void endutxent(void);
.sp
\fIutmpx\fP ¤Τ \fIutmp\fP ¤ΤΥѡåȤǡ
եɤɲä줿ꡢ
Ǥ¸ߤեɤΥ礭ʤäꤷƤ롣
бե
.I /var/*/utmpx
.I /var/*/wtmpx
Ǥ롣
.LP
Linux glibc \fIutmpx\fP ȤäƤʤ
\fIutmp\fP ¤Τʬ礭Ǥ롣
\fIgetutxent\fP ʤɤδؿ \fIgetutent\fP ʤɤؤ̾ȤʤäƤ롣
.SH Ϣ
.BR utmp (5)
|
