系统用户操作函数

本手册仅供个人学习使用,如有疑问可加我的个人微信询问:kymjs666

 
endgrent(关闭组文件)
相关函数 getgrent,setgrent
表头文件 #include<grp.h> #include<sys/types.h>
定义函数 void endgrent(void);
函数说明 endgrent()用来关闭由getgrent()所打开的密码文件。
返回值
附加说明
使用示例
请参考getgrent()与setgrent()。
 
endpwent(关闭密码文件)
相关函数 getpwent,setpwent
表头文件 #include<pwd.h> #include<sys/types.h>
定义函数 void endpwent(void);
函数说明 endpwent()用来关闭由getpwent()所打开的密码文件。
返回值
附加说明
使用示例
请参考getpwent()与setpwent()。
 
endutent(关闭utmp 文件)
相关函数 getutent,setutent
表头文件 #include<utmp.h>
定义函数 void endutent(void);
函数说明 endutent()用来关闭由getutent所打开的utmp文件。
返回值
附加说明
使用示例
请参考getutent()。
 
fgetgrent(从指定的文件来读取组格式)
相关函数 fgetpwent
表头文件 #include<grp.h> #include<stdio.h> #include<sys/types.h>
定义函数 struct group * getgrent(FILE * stream);
函数说明 fgetgrent()会从参数stream指定的文件读取一行数据,然后以group结构将该数据返回。参数stream所指定的文件必须和、etc/group相同的格式。group结构定义请参考getgrent()。
返回值 返回group结构数据,如果返回NULL则表示已无数据,或有错误发生。
使用示例
#include <grp.h>
#include<sys/types.h>
#include<stdio.h>
main()
{
    struct group *data;
    FILE *stream;
    int i;
    stream = fopen("/etc/group", "r");
    while((data = fgetgrent(stream))!=0){
        i=0;
        printf("%s :%s:%d :", data->gr_name,data->gr_passwd,data->gr_gid);
        while (data->gr_mem[i])
            printf("%s,",data->gr_mem[i++]);
        printf("\n");
    }
    fclose(stream);
}
执行结果 root:x:0:root,
bin:x:1:root,bin,daemon
daemon:x:2:root,bin,daemon
sys:x:3:root,bin,adm
adm:x:4:root,adm,daemon
tty:x:5
disk:x:6:root
lp:x:7:daemon,lp
mem:x:8
kmem:x:9
wheel:x:10:root
mail:x:12:mail
news:x:13:news
uucp:x:14:uucp
man:x:15
games:x:20
gopher:x:30
dip:x:40:
ftp:x:50
nobody:x:99:
 
fgetpwent(从指定的文件来读取密码格式)
相关函数 fgetgrent
表头文件 #include<pwd.h> #include<stdio.h> #include<sys/types.h>
定义函数 struct passwd * fgetpwent(FILE *stream);
函数说明 fgetpwent()会从参数stream指定的文件读取一行数据,然后以passwd结构将该数据返回。参数stream所指定的文件必须和/etc/passwd相同的格式。passwd结构定义请参考getpwent()。
返回值 返回passwd结构数据,如果返回NULL则表示已无数据,或有错误发生。
使用示例
#include<pwd.h>
#include<sys/types.h>
main()
{
    struct passwd *user;
    FILE *stream;
    stream = fopen("/etc/passwd", "r");
    while((user = fgetpwent(stream))!=0){
        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);
    }
}
执行结果 root:0:0:root:/root:/bin/bash
bin:1:1:bin:/bin:
daemon:2:2:daemon:/sbin:
adm:3:4:adm:/var/adm:
lp:4:7:lp:/var/spool/lpd:
sync:5:0:sync:/sbin:/bin/sync
shutdown:6:0:shutdown:/sbin:/sbin/shutdown
halt:7:0:halt:/sbin:/sbin/halt
mail:8:12:mail:/var/spool/mail:
news:9:13:news:var/spool/news
uucp:10:14:uucp:/var/spool/uucp:
operator:11:0:operator :/root:
games:12:100:games:/usr/games:
gopher:13:30:gopher:/usr/lib/gopher-data:
ftp:14:50:FTP User:/home/ftp:
nobody:99:99:Nobody:/:
xfs:100:101:X Font Server: /etc/Xll/fs:/bin/false
gdm:42:42:/home/gdm:/bin/bash
kids:500:500: : /home/kids:/bin/bash
 
getegid(取得有效的组识别码)
相关函数 getgid,setgid,setregid
表头文件 #include<unistd.h> #include<sys/types.h>
定义函数 gid_t getegid(void);
函数说明 getegid()用来取得执行结果目前进程有效组识别码。有效的组识别码用来决定进程执行结果时组的权限。返回值返回有效的组识别码。
使用示例
main()
{
    printf("egid is %d\n",getegid());
}
执行结果 egid is 0 /*当使用root身份执行结果使用示例程序时*/
 
geteuid(取得有效的用户识别码)
相关函数 getuid,setreuid,setuid
表头文件 #include<unistd.h> #include<sys/types.h>
定义函数 uid_t geteuid(void)
函数说明 geteuid()用来取得执行结果目前进程有效的用户识别码。有效的用户识别码用来决定进程执行结果的权限,借由此改变此值,进程可以获得额外的权限。倘若执行结果文件的setID位已被设置,该文件执行结果时,其进程的euid值便会设成该文件所有者的uid。例如,执行结果文件/usr/bin/passwd的权限为-r-s--x--x,其s 位即为setID(SUID)位,而当任何用户在执行结果passwd 时其有效的用户识别码会被设成passwd 所有者的uid 值,即root的uid 值(0)。
返回值 返回有效的用户识别码。
使用示例
main()
{
    printf("euid is %d \n",geteuid());
    printf("C函数手册 - 开源实验室");
}
执行结果 euid is 0 /*当使用root身份执行结果使用示例程序时*/
C函数手册 - 开源实验室
 
getgid(取得真实的组识别码)
相关函数 getegid,setregid,setgid
表头文件 #include<unistd.h> #include<sys/types.h>
定义函数 gid_t getgid(void);
函数说明 getgid()用来取得执行结果目前进程的组识别码。
返回值 返回组识别码
使用示例
main()
{
    printf(“gid is %d\n”,getgid());
}
执行结果 gid is 0 /*当使用root身份执行结果使用示例程序时*/
 
getgrent(从组文件中取得账号的数据)
相关函数 setgrent,endgrent
表头文件 #include<grp.h> #include <sys/types.h>
定义函数 struct group *getgrent(void);
函数说明 getgrent()用来从组文件(/etc/group)中读取一项组数据,该数据以group 结构返回。第一次调用时会取得第一项组数据,之后每调用一次就会返回下一项数据,直到已无任何数据时返回NULL。 struct group{ char *gr_name; /*组名称*/ char *gr_passwd; /* 组密码*/ gid_t gr_gid; /*组识别码*/ char **gr_mem; /*组成员账号*/ }
返回值 返回group结构数据,如果返回NULL则表示已无数据,或有错误发生。
附加说明 getgrent()在第一次调用时会打开组文件,读取数据完毕后可使用endgrent()来关闭该组文件。
错误代码 ENOMEM 内存不足,无法配置group结构。
使用示例
#include<grp.h>
#include<sys/types.h>
main()
{
    struct group *data;
    int i;
    while((data= getgrent())!=0){
        i=0;
        printf(“%s:%s:%d:”,data->gr_name,data->gr_passwd,data->gr_gid);
        while(data->gr_mem[i])printf(“%s,”,data->gr_mem[i++]);
            printf(“\n”);
    }
    endgrent();
}
执行结果 root:x:0:root,
bin:x:1:root,bin,daemon,
daemon:x:2:root,bin,daemon,
sys:x:3:root,bin,adm,
adm:x:4:root,adm,daemon
tty:x:5
disk:x:6:root
lp:x:7:daemon,lp
mem:x:8
kmem:x:9:
wheel:x:10:root
mail:x:12:mail
news:x:13:news
uucp:x:14:uucp
man:x:15:
games:x:20
gopher:x:30
dip:x:40
ftp:x:50
nobody:x:99
 
getgrgid(从组文件中取得指定gid 的数据)
相关函数 fgetgrent,getgrent,getgrnam
表头文件 #include<grp.h> #include<sys/types.h>
定义函数 strcut group * getgrgid(gid_t gid);
函数说明 getgrgid()用来依参数gid指定的组识别码逐一搜索组文件,找到时便将该组的数据以group结构返回。group结构请参考getgrent()。
返回值 返回group结构数据,如果返回NULL则表示已无数据,或有错误发生。
使用示例
/* 取得gid=3的组数据*/
        #include<grp.h>
        #include<sys/types.h>
        main()
        {
        strcut group *data;
        int i=0;
        data = getgrgid(3);
        printf(“%s:%s:%d:”,data->gr_name,data->gr_passwd,data->gr_gid);
        while(data->gr_mem[i])printf(“%s ,”,data->mem[i++]);
        printf(“\n”);
        }
执行结果 sys:x:3:root,bin,adm
 
getgrnam(从组文件中取得指定组的数据)
相关函数 fgetgrent,getrent,getgruid
表头文件 #include<grp.h> #include<sys/types.h>
定义函数 strcut group * getgrnam(const char * name);
函数说明 getgrnam()用来逐一搜索参数那么指定的组名称,找到时便将该组的数据以group结构返回。group 结构请参考getgrent()。
返回值 返回group结构数据,如果返回NULL则表示已无数据,或有错误发生。
使用示例
/* 取得adm的组数据*/
#include<grp.h>
#include<sys/types.h>
main()
{
    strcut group * data;
    int i=0;
    data = getgrnam(“adm”);
    printf(“%s:%s:%d:”,data->gr_name,data->gr_passwd,data->gr_gid);
    while(data->gr_mem[i])printf(“%s,”,data->gr_mem[i++]);
        printf(“\n”);
}
执行结果 adm:x:4:root,adm,daemon
 
getgroups(取得组代码)
相关函数 initgroups,setgroup,getgid,setgid
表头文件 #include<unistd.h> #include<sys/types.h>
定义函数 int getgroups(int size,gid_t list[]);
函数说明 getgroup()用来取得目前用户所属的组代码。参数size为list〔〕所能容纳的gid_t 数目。如果参数size 值为零,此函数仅会返回用户所属的组数。
返回值 返回组识别码,如有错误则返回-1。
错误代码 EFAULT 参数list数组地址不合法。EINVAL 参数size值不足以容纳所有的组。
使用示例
#include<unistd.h>
#include<sys/types.h>
main()
{
    gid_t list[500];
    int x,i;
    x = getgroups(0.list);
    getgroups(x,list);
    for(i=0;i<x;i++)
        printf(“%d:%d\n”,i,list[i]);
}
执行结果 0:00
1:01
2:02
3:03
4:04
5:06
6:10
 
getpw(取得指定用户的密码文件数据)
相关函数 getpwent
表头文件 #include<pwd.h> #include<sys/types.h>
定义函数 int getpw(uid_t uid,char *buf);
函数说明 getpw()会从/etc/passwd中查找符合参数uid所指定的用户账号数据,找不到相关数据就返回-1。所返回的buf字符串格式如下:账号:密码:用户识别码(uid):组识别码(gid):全名:根目录:shell
返回值 返回0表示成功,有错误发生时返回-1。
附加说明 1. getpw()会有潜在的安全性问题,请尽量使用别的函数取代。 2. 使用shadow的系统已把用户密码抽出/etc/passwd,因此使用getpw()取得的密码将为“x”。
使用示例
#include<pwd.h>
#include<sys/types.h>
main()
{
    char buffer[80];
    getpw(0,buffer);
    printf(“%s\n”,buffer);
}
执行结果 root:x:0:0:root:/root:/bin/bash
 
getpwent(从密码文件中取得账号的数据)
相关函数 getpw,fgetpwent,getpwnam,getpwuid,setpwent,endpwent
表头文件 #include<pwd.h> #include<sys/types.h>
定义函数 strcut passwd * getpwent(void);
函数说明 getpwent()用来从密码文件(/etc/passwd)中读取一项用户数据,该用户的数据以passwd 结构返回。第一次调用时会取得第一位用户数据,之后每调用一次就会返回下一项数据,直到已无任何数据时返回NULL。 passwd 结构定义如下 struct passwd{ char * pw_name; /*用户账号*/ char * pw_passwd; /*用户密码*/ uid_t pw_uid; /*用户识别码*/ gid_t pw_gid; /*组识别码*/ char * pw_gecos; /*用户全名*/ char * pw_dir; /*家目录*/ char * pw_shell; /* 所使用的shell路径*/ };
返回值 返回passwd 结构数据,如果返回NULL 则表示已无数据,或有错误发生。
附加说明 getpwent()在第一次调用时会打开密码文件,读取数据完毕后可使用endpwent()来关闭该密码文件。错误代码ENOMEM 内存不足,无法配置passwd结构。
使用示例
#include<pwd.h>
#include<sys/types.h>
main()
{
    struct passwd *user;
    while((user = getpwent())!=0){
        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:
lp:4:7:lp:/var/spool/lpd:
sync:5:0:sync:/sbin:/bin/sync
shutdown:6:0:shutdown:/sbin:/sbin/shutdown
halt:7:0:halt:/sbin:/sbin/halt
mail:8:12:mail:/var/spool/mail:
news:9:13:news:var/spool/news
uucp:10:14:uucp:/var/spool/uucp:
operator:11:0:operator :/root:
games:12:100:games:/usr/games:
gopher:13:30:gopher:/usr/lib/gopher-data:
ftp:14:50:FTP User:/home/ftp:
nobody:99:99:Nobody:/:
xfs:100:101:X Font Server: /etc/Xll/fs:/bin/false
gdm:42:42:/home/gdm:/bin/bash
kids:500:500: : /home/kids:/bin/bash
 
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.kymjs.com”);
    pututline(&ut);
}
执行结果 /*执行结果使用示例后用指令who -l 观察*/
root pts/0 dec9 19:20
kids pts/1 dec12 10:31(www.kymjs.com)
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
 
setregid(设置真实及有效的组识别码)
相关函数 setgid,setegid,setfsgid
表头文件 #include<unistd.h>
定义函数 int setregid(gid_t rgid,gid_t egid);
函数说明 setregid()用来将参数rgid设为目前进程的真实组识别码,将参数egid设置为目前进程的有效组识别码。如果参数rgid或egid值为-1,则对应的识别码不会改变。
返回值 执行结果成功则返回0,失败则返回-1,错误代码存于errno。
 
setreuid(设置真实及有效的用户识别码)
相关函数 setuid,seteuid,setfsuid
表头文件 #include<unistd.h>
定义函数 int setreuid(uid_t ruid,uid_t euid);
函数说明 setreuid()用来将参数ruid 设为目前进程的真实用户识别码,将参数euid 设置为目前进程的有效用户识别码。如果参数ruid 或euid值为-1,则对应的识别码不会改变。
返回值 执行结果成功则返回0,失败则返回-1,错误代码存于errno。
附加说明 请参考setuid()。
 
setuid(设置真实的用户识别码)
相关函数 getuid,setreuid,seteuid,setfsuid
表头文件 #include<unistd.h>
定义函数 int setuid(uid_t uid)
函数说明 setuid()用来重新设置执行结果目前进程的用户识别码。不过,要让此函数有作用,其有效的用户识别码必须为0(root)。在Linux下,当root使用setuid()来变换成其他用户识别码时,root权限会被抛弃,完全转换成该用户身份,也就是说,该进程往后将不再具有可setuid()的权利,如果只是向暂时抛弃root 权限,稍后想重新取回权限,则必须使用seteuid()。
返回值 执行结果成功则返回0,失败则返回-1,错误代码存于errno。
附加说明 一般在编写具setuid root的程序时,为减少此类程序带来的系统安全风险,在使用完root权限后建议马上执行结果setuid(getuid());来抛弃root权限。此外,进程uid和euid不一致时Linux系统将不会产生core dump。
 
setutent(从头读取utmp 文件中的登录数据)
相关函数 getutent,endutent
表头文件 #include<utmp.h>
定义函数 void setutent(void);
函数说明 setutent()用来将getutent()的读写地址指回utmp文件开头。
附加说明 请参考setpwent()或setgrent()。
 
utmpname(设置utmp 文件路径)
相关函数 getutent,getutid,getutline,setutent,endutent,pututline
表头文件 #include<utmp.h>
定义函数 void utmpname(const char * file);
函数说明 utmpname()用来设置utmp文件的路径,以提供utmp相关函数的存取路径。如果没有使用utmpname()则默认utmp文件路径为/var/run/utmp。
返回值