getutent

getutent

从utmp 文件中取得账号登录数据

相关函数

getutent，getutid，getutline，setutent，endutent，pututline，utmpname

表头文件

#include<utmp.h>

定义函数

struct utmp *getutent(void);

函数说明

getutent()用来从utmp 文件(/var/run/utmp)中读取一项登录数据，该数据以utmp 结构返回。第一次调用时会取得第一位用户数据，之后每调用一次就会返回下一项数据，直到已无任何数据时返回NULL。

utmp结构定义如下

struct utmp
{
short int ut_type; /*登录类型*/
pid_t ut_pid; /*login进程的pid*/
char ut_line[UT_LINESIZE];/*登录装置名，省略了“/dev/”*/
char ut_id[4]; /* Inittab ID*/
char ut_user[UT_NAMESIZE];/*登录账号*/
char ut_host[UT_HOSTSIZE];/*登录账号的远程主机名称*/
struxt exit_status ut_exit;/* 当类型为DEAD_PROCESS时进程的结
束状态*/
long int ut_session; /*Sessioc ID*/
struct timeval ut_tv; /*时间记录*/
int32_t ut_addr_v6[4]; /*远程主机的网络地址*/
char __unused[20]; /* 保留未使用*/
};

ut_type有以下几种类型: EMPTY 此为空的记录。 RUN_LVL 记录系统run－level的改变 BOOT_TIME 记录系统开机时间 NEW_TIME 记录系统时间改变后的时间 OLD_TINE 记录当改变系统时间时的时间。 INIT_PROCESS 记录一个由init衍生出来的进程。 LOGIN_PROCESS 记录login进程。 USER_PROCESS 记录一般进程。 DEAD_PROCESS 记录一结束的进程。 ACCOUNTING 目前尚未使用。

exit_status结构定义

struct exit_status
{
short int e_termination; /*进程结束状态*/
short int e_exit; /*进程退出状态*/
};

timeval的结构定义请参考gettimeofday（）。

相关常数定义如下: UT_LINESIZE 32 UT_NAMESIZE 32 UT_HOSTSIZE 256

返回值

返回utmp 结构数据，如果返回NULL 则表示已无数据，或有错误发生。

附加说明

getutent()在第一次调用时会打开utmp 文件，读取数据完毕后可使用endutent()来关闭该utmp文件。

范例

#include<utmp.h>
main()
{
struct utmp *u;
while((u=getutent())){
if(u->ut_type = = USER_PROCESS)
printf(“%d %s %s %s \n”,u->ut_type,u->ut_user,u->ut_line,u->ut_host);
}
endutent();
}

执行

/* 表示有三个root账号分别登录/dev/pts/0，/dev/pts/1，/dev/pts/2 */
7 root pts/0
7 root pts/1
7 root pts/2