|
getpwnam(从密码文件中取得指定账号的数据)
|
相关函数
|
getpw,fgetpwent,getpwent,getpwuid
|
表头文件
|
#include<pwd.h> #include<sys/types.h>
|
定义函数
|
struct passwd * getpwnam(const char * name);
|
函数说明
|
getpwnam()用来逐一搜索参数name 指定的账号名称,找到时便将该用户的数据以passwd结构返回。passwd结构请参考getpwent()。
|
返回值
|
返回passwd 结构数据,如果返回NULL 则表示已无数据,或有错误发生。
|
范例
|
/*取得root账号的识别码和根目录*/ #include<pwd.h> #include<sys/types.h> main() { struct passwd *user; user = getpwnam(“root”); printf(“name:%s/n”,user->pw_name); printf(“uid:%d/n”,user->pw_uid); printf(“home:%s/n”,user->pw_dir); }
|
执行
|
name:root uid:0 home:/root
|
|
|
getpwuid(从密码文件中取得指定uid 的数据)
|
相关函数
|
getpw,fgetpwent,getpwent,getpwnam
|
表头文件
|
#include<pwd.h> #include<sys/types.h>
|
定义函数
|
struct passwd * getpwuid(uid_t uid);
|
函数说明
|
getpwuid()用来逐一搜索参数uid 指定的用户识别码,找到时便将该用户的数据以结构返回结构请参考将该用户的数据以passwd 结构返回。passwd 结构请参考getpwent()。
|
返回值
|
返回passwd 结构数据,如果返回NULL 则表示已无数据,或者有错误发生。
|
范例
|
#include<pwd.h> #include<sys/types.h> main() { struct passwd *user; user= getpwuid(6); printf(“name:%s/n”,user->pw_name); printf(“uid:%d/n”,user->pw_uid); printf(“home:%s/n”,user->pw_dir); }
|
执行
|
name:shutdown uid:6 home:/sbin
|
|
|
getuid(取得真实的用户识别码)
|
相关函数
|
geteuid,setreuid,setuid
|
表头文件
|
#include<unistd.h> #include<sys/types.h>
|
定义函数
|
uid_t getuid(void);
|
函数说明
|
getuid()用来取得执行目前进程的用户识别码。
|
返回值
|
用户识别码
|
范例
|
main() { printf(“uid is %d/n”,getuid()); }
|
执行
|
uid is 0 /*当使用root身份执行范例程序时*/
|
|
|
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
|
|
|
getutid(从utmp 文件中查找特定的记录)
|
相关函数
|
getutent,getutline
|
表头文件
|
#include<utmp.h>
|
定义函数
|
strcut utmp *getutid(strcut utmp *ut);
|
函数说明
|
getutid()用来从目前utmp 文件的读写位置逐一往后搜索参数ut指定的记录,如果ut->ut_type 为RUN_LVL,BOOT_TIME,NEW_TIME,OLD_TIME 其中之一则查找与ut->ut_type 相符的记录;若ut->ut_type 为INIT_PROCESS,LOGIN_PROCESS,USER_PROCESS或DEAD_PROCESS其中之一,则查找与ut->ut_id相符的记录。找到相符的记录便将该数据以utmp 结构返回。utmp结构请参考getutent()。
|
返回值
|
返回utmp 结构数据,如果返回NULL 则表示已无数据,或有错误发生。
|
范例
|
#include<utmp.h> main() { struct utmp ut,*u; ut.ut_type=RUN_LVL; while((u= getutid(&ut))){ printf(“%d %s %s %s/n”,u->ut_type,u->ut_user,u->ut_line,u->ut_host); } }
|
执行
|
1 runlevel -
|
|
|
getutline(从utmp 文件中查找特定的记录)
|
相关函数
|
getutent,getutid,pututline
|
表头文件
|
#include<utmp.h>
|
定义函数
|
struct utmp * getutline (struct utmp *ut);
|
函数说明
|
getutline()用来从目前utmp文件的读写位置逐一往后搜索ut_type为USER_PROCESS 或LOGIN_PROCESS 的记录,而且ut_line 和ut->ut_line 相符。找到相符的记录便将该数据以utmp 结构返回,utmp结构请参考getutent()。
|
返回值
|
返回utmp 结构数据,如果返回NULL 则表示已无数据,或有错误发生。
|
范例
|
#include<utmp.h> main() { struct utmp ut,*u; strcpy (ut.ut_line,”pts/1”); while ((u=getutline(&ut))){ printf(“%d %s %s %s /n”,u->ut_type,u->ut_user,u->ut_line,u->ut_host); } }
|
执行
|
7 root pts/1
|
|
|
initgroups(初始化组清单)
|
相关函数
|
setgrent,endgrent
|
表头文件
|
#include<grp.h> #include<sys/types.h>
|
定义函数
|
int initgroups(const char *user,gid_t group);
|
函数说明
|
initgroups()用来从组文件(/etc/group)中读取一项组数据,若该组数据的成员中有参数user时,便将参数group组识别码加入到此数据中。
|
返回值
|
执行成功则返回0,失败则返回-1,错误码存于errno。
|
|
|
pututline(将utmp 记录写入文件)
|
相关函数
|
getutent,getutid,getutline
|
表头文件
|
#include<utmp.h>
|
定义函数
|
void pututline(struct utmp *ut);
|
函数说明
|
pututline()用来将参数ut的utmp结构记录到utmp文件中。此函数会先用getutid()来取得正确的写入位置,如果没有找到相符的记录则会加入到utmp文件尾,utmp结构请参考getutent()。
|
返回值
|
|
附加说明
|
需要有写入/var/run/utmp 的权限
|
范例
|
#include<utmp.h> main() { struct utmp ut; ut.ut_type =USER_PROCESS; ut.ut_pid=getpid(); strcpy(ut.ut_user,”kids”); strcpy(ut.ut_line,”pts/1”); strcpy(ut.ut_host,”www.gnu.org”); pututline(&ut); }
|
执行
|
/*执行范例后用指令who -l 观察*/ root pts/0 dec9 19:20 kids pts/1 dec12 10:31(www.gnu.org) root pts/2 dec12 13:33
|
|
|
seteuid(设置有效的用户识别码)
|
相关函数
|
setuid,setreuid,setfsuid
|
表头文件
|
#include<unistd.h>
|
定义函数
|
int seteuid(uid_t euid);
|
函数说明
|
seteuid()用来重新设置执行目前进程的有效用户识别码。在Linux下,seteuid(euid)相当于setreuid(-1,euid)。
|
返回值
|
执行成功则返回0,失败则返回-1,错误代码存于errno
|
附加说明
|
请参考setuid
|
|
|
setfsgid(设置文件系统的组识别码)
|
相关函数
|
setuid,setreuid,seteuid,setfsuid
|
表头文件
|
#include<unistd.h>
|
定义函数
|
int setfsgid(uid_t fsgid);
|
函数说明
|
setfsgid()用来重新设置目前进程的文件系统的组识别码。一般情况下,文件系统的组识别码(fsgid)与有效的组识别码(egid)是相同的。如果是超级用户调用此函数,参数fsgid 可以为任何值,否则参数fsgid必须为real/effective/saved的组识别码之一。
|
返回值
|
执行成功则返回0,失败则返回-1,错误代码存于errno。
|
附加说明
|
此函数为Linux特有。
|
错误代码
|
EPERM 权限不够,无法完成设置。
|
|
|
setfsuid(设置文件系统的用户识别码)
|
相关函数
|
setuid,setreuid,seteuid,setfsgid
|
表头文件
|
#include<unistd.h>
|
定义函数
|
int setfsuid(uid_t fsuid);
|
函数说明
|
setfsuid()用来重新设置目前进程的文件系统的用户识别码。一般情况下,文件系统的用户识别码(fsuid)与有效的用户识别码(euid)是相同的。如果是超级用户调用此函数,参数fsuid可以为任何值,否则参数fsuid必须为real/effective/saved的用户识别码之一。
|
返回值
|
执行成功则返回0,失败则返回-1,错误代码存于errno
|
附加说明
|
此函数为Linux特有
|
错误代码
|
EPERM 权限不够,无法完成设置。
|
|
|
setgid(设置真实的组识别码)
|
相关函数
|
getgid,setregid,getegid,setegid
|
表头文件
|
#include<unistd.h>
|
定义函数
|
int setgid(gid_t gid);
|
函数说明
|
setgid()用来将目前进程的真实组识别码(real gid)设成参数gid值。如果是以超级用户身份执行此调用,则real、effective与savedgid都会设成参数gid。
|
返回值
|
设置成功则返回0,失败则返回-1,错误代码存于errno中。
|
错误代码
|
EPERM 并非以超级用户身份调用,而且参数gid 并非进程的effective gid或saved gid值之一。
|
|
|
setgrent(从头读取组文件中的组数据)
|
相关函数
|
getgrent,endgrent
|
表头文件
|
#include<grp.h> #include<sys/types.h>
|
定义函数
|
void setgrent(void);
|
函数说明
|
setgrent()用来将getgrent()的读写地址指回组文件开头。
|
返回值
|
|
附加说明
|
请参考setpwent()。
|
|
|
setgroups(设置组代码)
|
相关函数
|
initgroups,getgroup,getgid,setgid
|
表头文件
|
#include<grp.h>
|
定义函数
|
int setgroups(size_t size,const gid_t * list);
|
函数说明
|
setgroups()用来将list 数组中所标明的组加入到目前进程的组设置中。参数size为list()的gid_t数目,最大值为NGROUP(32)。
|
返回值
|
设置成功则返回0,如有错误则返回-1。
|
错误代码
|
EFAULT 参数list数组地址不合法。 EPERM 权限不足,必须是root权限 EINVAL 参数size值大于NGROUP(32)。
|
|
|
setpwent(从头读取密码文件中的账号数据)
|
相关函数
|
getpwent,endpwent
|
表头文件
|
#include<pwd.h> #include<sys/types.h>
|
定义函数
|
void setpwent(void);
|
函数说明
|
setpwent()用来将getpwent()的读写地址指回密码文件开头。
|
返回值
|
|
范例
|
#include<pwd.h> #include<sys/types.h> main() { struct passwd *user; int i; for(i=0;i<4;i++){ user=getpwent(); printf(“%s :%d :%d :%s:%s:%s/n”,user->pw_name,user->pw_uid,user->pw_gid, user->pw_gecos,user->pw_dir,user->pw_shell); } setpwent(); user=getpwent(); printf(“%s :%d :%d :%s:%s:%s/n”,user->pw_name,user->pw_uid,user->pw_gid, user->pw_gecos,user->pw_dir,user->pw_shell); endpwent(); }
|
执行
|
root:0:0:root:/root:/bin/bash bin:1:1:bin:/bin daemon:2:2:daemon:/sbin adm:3:4:adm:/var/adm root:0:0:root:/root:/bin/bash
|