相关函数 | 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身份执行范例程序时*/ |
| 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身份执行范例程序时*/ |
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 |
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 权限不够,无法完成设置。 |
| 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)。 |
setregid(设置真实及有效的组识别码) | |
相关函数 | setgid,setegid,setfsgid |
表头文件 | #include<unistd.h> |
定义函数 | int setregid(gid_t rgid,gid_t egid); |
函数说明 | setregid()用来将参数rgid设为目前进程的真实组识别码,将参数egid设置为目前进程的有效组识别码。如果参数rgid或egid值为-1,则对应的识别码不会改变。 |
返回值 | 执行成功则返回0,失败则返回-1,错误代码存于errno。 |
utmpname(设置utmp 文件路径) | |
相关函数 | getutent,getutid,getutline,setutent,endutent,pututline |
表头文件 | #include<utmp.h> |
定义函数 | void utmpname(const char * file); |
函数说明 | utmpname()用来设置utmp文件的路径,以提供utmp相关函数的存取路径。如果没有使用utmpname()则默认utmp文件路径为/var/run/utmp。 |
返回值 | |
| | | | | |