- 组管理相关函数介绍
相关函数 | getgid,setgid,setregid | ||||
表头文件 | #include<unistd.h> | ||||
定义函数 | gid_t getegid(void); | ||||
函数说明 | getegid()用来取得执行目前进程有效组识别码。有效的组识别码用来决定进程执行时组的权限。返回值返回有效的组识别码。 | ||||
范例 | main() | ||||
执行 | egid is 0 /*当使用root身份执行范例程序时*/ | ||||
getgid(取得真实的组识别码) | |||||
相关函数 | getegid,setregid,setgid | ||||
表头文件 | #include<unistd.h> | ||||
定义函数 | gid_t getgid(void); | ||||
函数说明 | getgid()用来取得执行目前进程的组识别码。 | ||||
返回值 | 返回组识别码 | ||||
范例 | main() | ||||
执行 | gid is 0 /*当使用root身份执行范例程序时*/ | ||||
getgrgid(从组文件中取得指定gid 的数据) | |||||
相关函数 | fgetgrent,getgrent,getgrnam | ||||
表头文件 | #include<grp.h> | ||||
定义函数 | strcut group * getgrgid(gid_t gid); | ||||
函数说明 | getgrgid()用来依参数gid指定的组识别码逐一搜索组文件,找到时便将该组的数据以group结构返回。group结构请参考getgrent()。 | ||||
返回值 | 返回group结构数据,如果返回NULL则表示已无数据,或有错误发生。 | ||||
范例 | /* 取得gid=3的组数据*/ | ||||
执行 | sys:x:3:root,bin,adm | ||||
getgrnam(从组文件中取得指定组的数据) | |||||
相关函数 | fgetgrent,getrent,getgruid | ||||
表头文件 | #include<grp.h> | ||||
定义函数 | strcut group * getgrnam(const char * name); | ||||
函数说明 | getgrnam()用来逐一搜索参数那么指定的组名称,找到时便将该组的数据以group结构返回。group 结构请参考getgrent()。 | ||||
返回值 | 返回group结构数据,如果返回NULL则表示已无数据,或有错误发生。 | ||||
范例 | /* 取得adm的组数据*/ | ||||
执行 | adm:x:4:root,adm,daemon | ||||
getgroups(取得组代码) | |||||
相关函数 | initgroups,setgroup,getgid,setgid | ||||
表头文件 | #include<unistd.h> | ||||
定义函数 | int getgroups(int size,gid_t list[]); | ||||
函数说明 | getgroup()用来取得目前用户所属的组代码。参数size为list〔〕所能容纳的gid_t 数目。如果参数size 值为零,此函数仅会返回用户所属的组数。 | ||||
返回值 | 返回组识别码,如有错误则返回-1。 | ||||
错误代码 | EFAULT 参数list数组地址不合法。EINVAL 参数size值不足以容纳所有的组。 | ||||
范例 | #include<unistd.h> | ||||
执行 | 0:00 | ||||
getpw(取得指定用户的密码文件数据) | |||||
相关函数 | getpwent | ||||
表头文件 | #include<pwd.h> | ||||
定义函数 | int getpw(uid_t uid,char *buf); | ||||
函数说明 | getpw()会从/etc/passwd中查找符合参数uid所指定的用户账号数据,找不到相关数据就返回-1。所返回的buf字符串格式如下:账号:密码:用户识别码(uid):组识别码(gid):全名:根目录:shell | ||||
返回值 | 返回0表示成功,有错误发生时返回-1。 | ||||
附加说明 | 1. getpw()会有潜在的安全性问题,请尽量使用别的函数取代。 | ||||
范例 | #include<pwd.h> | ||||
执行 | 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> | ||||
定义函数 | 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数组地址不合法。 | ||||
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。 | ||||
返回值 | |||||
2.小试牛刀
实际编程中上述的函数我们也不大可能使用那么多函数。
常用的大家可以参考组管理命令实现的功能。
#include <stdio.h>
#include <sys/types.h>
#include <unistd.h>
int main(void)
{
printf("gid = %d\n",getgid());
printf("egid = %d\n",getegid());
setgid(1001);
printf("gid = %d\n",getgid());
printf("egid = %d\n",getegid());
return 0;
}
3.各个平台的运行情况
RHEL7
在RHEL6上
在Solaris11上