用户组篇.txt

最经典的C函数库,共分17篇,分别为进程操作篇,内存控制篇,信号处理篇,环境变量等17篇

#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
 
　 

 

 
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。
 
返回值