Linux C 常用库函数说明和实例

access（判断是否具有存取文件的权限） 相关函数 stat，open，chmod，chown，setuid，setgid 表头文件 #include<unistd.h> 定义函数 int access(const char * pathname,int mode); 函数说明 access()会检查是否可以读/写某一已存在的文件。参数mode有几种情况组合，R_OK，W_OK，X_OK 和F_OK。R_OK，W_OK与X_OK用来检查文件是否具有读取、写入和执行的权限。F_OK则是用来判断该文件是否存在。由于access()只作权限的核查，并不理会文件形态或文件内容，因此，如果一目录表示为“可写入”，表示可以在该目录中建立新文件等操作，而非意味此目录可以被当做文件处理。例如，你会发现DOS的文件都具有“可执行”权限，但用execve()执行时则会失败。 返回值 若所有欲查核的权限都通过了检查则返回0值，表示成功，只要有一权限被禁止则返回-1。 错误代码 EACCESS 参数pathname 所指定的文件不符合所要求测试的权限。 EROFS 欲测试写入权限的文件存在于只读文件系统内。 EFAULT 参数pathname指针超出可存取内存空间。 EINVAL 参数mode 不正确。 ENAMETOOLONG 参数pathname太长。 ENOTDIR 参数pathname为一目录。 ENOMEM 核心内存不足 ELOOP 参数pathname有过多符号连接问题。 EIO I/O 存取错误。 附加说明 使用access()作用户认证方面的判断要特别小心，例如在access()后再做open()的空文件可能会造成系统安全上的问题。 范例 /* 判断是否允许读取/etc/passwd */ #include<unistd.h> int main() { if (access(“/etc/passwd”,R_OK) = =0) printf(“/etc/passwd can be read\n”); } 执行 /etc/passwd can be read 　 alphasort（依字母顺序排序目录结构） 相关函数 scandir，qsort 表头文件 #include<dirent.h> 定义函数 int alphasort(const struct dirent **a,const struct dirent **b); 函数说明 alphasort()为scandir()最后调用qsort()函数时传给qsort()作为判断的函数，详细说明请参考scandir()及qsort()。 返回值 参考qsort()。 范例 /* 读取/目录下所有的目录结构，并依字母顺序排列*/ main() { struct dirent **namelist; int i,total; total = scandir(“/”,&namelist ,0,alphasort); if(total <0) perror(“scandir”); else{ for(i=0;i<total;i++) printf(“%s\n”,namelist[i]->d_name); printf(“total = %d\n”,total); } } 执行 .. .gnome .gnome_private ErrorLog Weblog bin boot dev dosc dosd etc home lib lost+found misc mnt opt proc root sbin tmp usr var total = 24 　 chdir（改变当前的工作（目录） 相关函数 getcwd，chroot 表头文件 #include<unistd.h> 定义函数 int chdir(const char * path); 函数说明 chdir()用来将当前的工作目录改变成以参数path所指的目录。 返回值 执行成功则返回0，失败返回-1，errno为错误代码。 范例 #include<unistd.h> main() { chdir(“/tmp”); printf(“current working directory: %s\n”,getcwd(NULL,NULL)); } 执行 current working directory :/tmp 　 chmod（改变文件的权限） 相关函数 fchmod，stat，open，chown 表头文件 #include<sys/types.h> #include<sys/stat.h> 定义函数 int chmod(const char * path,mode_t mode); 函数说明 chmod()会依参数mode 权限来更改参数path 指定文件的权限。 参数 mode 有下列数种组合 S_ISUID 04000 文件的（set user-id on execution）位 S_ISGID 02000 文件的（set group-id on execution）位 S_ISVTX 01000 文件的sticky位 S_IRUSR（S_IREAD） 00400 文件所有者具可读取权限 S_IWUSR（S_IWRITE）00200 文件所有者具可写入权限 S_IXUSR（S_IEXEC） 00100 文件所有者具可执行权限 S_IRGRP 00040 用户组具可读取权限 S_IWGRP 00020 用户组具可写入权限 S_IXGRP 00010 用户组具可执行权限 S_IROTH 00004 其他用户具可读取权限 S_IWOTH 00002 其他用户具可写入权限 S_IXOTH 00001 其他用户具可执行权限 只有该文件的所有者或有效用户识别码为0，才可以修改该文件权限。基于系统安全，如果欲将数据写入一执行文件，而该执行文件具有S_ISUID 或S_ISGID 权限，则这两个位会被清除。如果一目录具有S_ISUID 位权限，表示在此目录下只有该文件的所有者或root可以删除该文件。 返回值 权限改变成功返回0，失败返回-1，错误原因存于errno。 错误代码 EPERM 进程的有效用户识别码与欲修改权限的文件拥有者不同，而且也不具root权限。 EACCESS 参数path所指定的文件无法存取。 EROFS 欲写入权限的文件存在于只读文件系统内。 EFAULT 参数path指针超出可存取内存空间。 EINVAL 参数mode不正确 ENAMETOOLONG 参数path太长 ENOENT 指定的文件不存在 ENOTDIR 参数path路径并非一目录 ENOMEM 核心内存不足 ELOOP 参数path有过多符号连接问题。 EIO I/O 存取错误 范例 /* 将/etc/passwd 文件权限设成S_IRUSR|S_IWUSR|S_IRGRP|S_IROTH */ #include<sys/types.h> #include<sys/stat.h> main() { chmod(“/etc/passwd”,S_IRUSR|S_IWUSR|S_IRGRP|S_IROTH); } 　 chown（改变文件的所有者） 相关函数 fchown，lchown，chmod 表头文件 #include<sys/types.h> #include<unistd.h> 定义函数 int chown(const char * path, uid_t owner,gid_t group); 函数说明 chown()会将参数path指定文件的所有者变更为参数owner代表的用户，而将该文件的组变更为参数group组。如果参数owner或group为-1，对应的所有者或组不会有所改变。root与文件所有者皆可改变文件组，但所有者必须是参数group组的成员。当root用chown()改变文件所有者或组时，该文件若具有S_ISUID或S_ISGID权限，则会清除此权限位，此外如果具有S_ISGID权限但不具S_IXGRP位，则该文件会被强制锁定，文件模式会保留。 返回值 成功则返回0，失败返回-1，错误原因存于errno。 错误代码 参考chmod（）。 范例 /* 将/etc/passwd 的所有者和组都设为root */ #include<sys/types.h> #include<unistd.h> main() { chown(“/etc/passwd”,0,0); } 　 chroot（改变根目录） 相关函数 chdir 表头文件 #include<unistd.h> 定义函数 int chroot(const char * path); 函数说明 chroot()用来改变根目录为参数path 所指定的目录。只有超级用户才允许改变根目录，子进程将继承新的根目录。 返回值 调用成功则返回0，失败则返-1，错误代码存于errno。 错误代码 EPERM 权限不足，无法改变根目录。 EFAULT 参数path指针超出可存取内存空间。 ENAMETOOLONG 参数path太长。 ENOTDIR 路径中的目录存在但却非真正的目录。 EACCESS 存取目录时被拒绝 ENOMEM 核心内存不足。 ELOOP 参数path有过多符号连接问题。 EIO I/O 存取错误。 范例 /* 将根目录改为/tmp ,并将工作目录切换至/tmp */ #include<unistd.h> main() { chroot(“/tmp”); chdir(“/”); } 　 closedir（关闭目录） 相关函数 opendir 表头文件 #include<sys/types.h> #include<dirent.h> 定义函数 int closedir(DIR *dir); 函数说明 closedir()关闭参数dir所指的目录流。 返回值 关闭成功则返回0，失败返回-1，错误原因存于errno 中。 错误代码 EBADF 参数dir为无效的目录流 范例 参考readir()。 　 fchdir（改变当前的工作目录） 相关函数 getcwd，chroot 表头文件 #include<unistd.h> 定义函数 int fchdir(int fd); 函数说明 fchdir()用来将当前的工作目录改变成以参数fd 所指的文件描述词。 返回值执 行成功则返回0，失败返回-1，errno为错误代码。 附加说明 范例 #include<sys/types.h> #include<sys/stat.h> #include<fcntl.h> #include<unistd.h> main() { int fd; fd = open(“/tmp”,O_RDONLY); fchdir(fd); printf(“current working directory : %s \n”,getcwd(NULL,NULL)); close(fd); } 执行 current working directory : /tmp 　 fchmod（改变文件的权限） 相关函数 chmod，stat，open，chown 表头文件 #include<sys/types.h> #include<sys/stat.h> 定义函数 int fchmod(int fildes,mode_t mode); 函数说明 fchmod()会依参数mode权限来更改参数fildes所指文件的权限。参数fildes为已打开文件的文件描述词。参数mode请参考chmod（）。 返回值 权限改变成功则返回0，失败返回-1，错误原因存于errno。 错误原因 EBADF 参数fildes为无效的文件描述词。 EPERM 进程的有效用户识别码与欲修改权限的文件所有者不同，而且也不具root权限。 EROFS 欲写入权限的文件存在于只读文件系统内。 EIO I/O 存取错误。 范例 #include<sys/stat.h> #include<fcntl.h> main() { int fd; fd = open (“/etc/passwd”,O_RDONLY); fchmod(fd,S_IRUSR|S_IWUSR|S_IRGRP|S_IROTH); close(fd); } 　 fchown（改变文件的所有者） 相关函数 chown，lchown，chmod 表头文件 #include<sys/types.h> #include<unistd.h> 定义函数 int fchown(int fd,uid_t owner,gid_t group); 函数说明 fchown()会将参数fd指定文件的所有者变更为参数owner代表的用户，而将该文件的组变更为参数group组。如果参数owner或group为-1，对映的所有者或组有所改变。参数fd 为已打开的文件描述词。当root用fchown()改变文件所有者或组时，该文件若具S_ISUID或S_ISGID权限，则会清除此权限位。 返回值 成功�