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)
|