1. 组管理相关函数介绍



相关函数



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。



返回值











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


Unix/Linux环境C编程入门教程(35)  编程管理系统中的组_编程


Unix/Linux环境C编程入门教程(35)  编程管理系统中的组_编程_02


在RHEL6上


Unix/Linux环境C编程入门教程(35)  编程管理系统中的组_用户和组_03


在Solaris11上


Unix/Linux环境C编程入门教程(35)  编程管理系统中的组_getgid_04