[转]Linux C函数之文件及目录函数（1）

http://hi.baidu.com/ppln/blog/item/1c73671863c6d072dbb4bd68.html

 

 

 

文件及目录函数(37)

chdir, chmod, chown, chroot fchdir, fchmod, fchown, ftruncate lchown, truncate,

get_current_dir_name, getcwd, getwd

opendir, closedir, readir, scandir, seekdir, rewinddir, telldir (mkdir, rmdir)

fstat, lstat, stat

ftw, nftw

link, readlink, symlink, unlink

access, alphasort, realpath, remove, rename, umask

utime, utimes

access: 判断是否有存取文件的权限 头文件: 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()只作权限的核查, 并不理会文件形态或文件内容, 因此, 如果一目录表示为"可写入", 表示可以在该目录中建立新文件等操作, 而非意味此目录可以被当做文件处理. 若所有欲查核的权限都通过了检查则返回0值, 表示成功, 只要有一权限被禁止则返回-1. 错误代码:    EACCESS      参数pathname所指定的文件不符合所要求测试的权限    EROFS        欲测试写入权限的文件存在于只读文件系统内    EFAULT       参数pathname指针超出可存取内存空间    EINVAL       参数mode不正确    ENAMETOOLONG 参数pathname太长    ENOTDIR      参数pathname为一目录    ENOMEM       核心内存不足    ELOOP        参数pathname有过多符号连接问题    EIO          I/O存取错误 附加说明: 使用access()作用户认证方面的判断要特别小心, 例如在access()后再做open()的空文件可能会造成系统安全上的问题. 应用举例: #include <stdio.h> #include <unistd.h> int main(void) { if(access("/etc/passwd", R_OK) == 0) {    printf("/etc/passwd can be read\n"); } return 0; } 运行结果: /etc/passwd can be read

alphasort: 依字母顺序排序目录结构 头文件: dirent.h 定义函数: int alphasort(const struct dirent **a, const struct dirent **b); 说明: alphasort()为scandir()最后调用的函数, 详细说明请参考scandir(). 应用举例: /* 读取/目录下的目录结构, 并依字母顺寻排列 */ #include <stdio.h> #include <dirent.h> int main(void) { 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); } return 0; } 运行结果: . .. .autofsck bin boot ... total = 24

chdir: 改变当前的工作目录 头文件: unistd.h 函数定义: int chdir(const char *path); 说明: chdir()用来将当前的工作目录该变成为参数path所指的目录. 若成功返回0, 失败返回-1, errno为错误代码.

chmod: 改变文件的权限 头文件: sys/types.h 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, 错误原因存于erron. 错误代码:    EPERM    进程的有效用户识别码与欲修改权限的文件拥有者不同, 而且也不具root权限.    EACCESS 参数path所指定的文件无法存取    EROFS    欲写入权限的文件存在于只读文件系统内    EFAULT   参数path指针超出可存取内存空间    EINVAL   参数mode不正确    ENAMETOOLONG 参数path太长    ENOENT   指定的文件不存在    ENOTDIR 参数path路径并非一目录    ENOMEM   核心内存不足    ELOOP    参数path有过多符号连接问题    EIO      I/O存取错误

chown: 改变文件的所有者 头文件: sys/types.h 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().

chroot: 改变根目录 头文件: 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存取错误 应用举例: #include <stdio.h> #include <unistd.h> int main(void) { /* 将根目录改为/tmp ,并将工作目录切换至/tmp */ chroot("/tmp"); chdir("/"); return 0; }

closedir: 关闭目录 头文件: sys/types.h dirent.h 函数定义: int closedir(DIR *dir); 说明: closedir()关闭参数dir所指的目录流. 关闭成功则返回0, 失败返回-1, 错误原因存于errno中. EBADF参数dir为无效的目录流.

fchdir: 改变当前的工作目录 头文件: unistd.h 函数定义: int fchdir(int fd); 说明: fchdir()用来将当前的工作目录改变成以参数fd所指的文件描述词. 执行成功则返回0, 失败返回-1, errno为错误代码.

fchmod: 改变文件的权限 头文件: sys/types.h sys/stat.h 函数定义: int fdmod(int fildes, mode_t mode); 说明: fchmod()会依参数mode权限来更改参数fildes所指文件的权限. 参数fildes为已打开文件的文件描述词. 参数mode请参考chmod(). 权限改变成功则返回0, 失败返回-1, 错误原因存于errno. 错误代码:    EBADF 参数fildes为无效的文件描述词    EPERM 进程的有效用户识别码与欲修改权限的文件所有者不同, 而且也不具root权限    EROFS 欲写入权限的文件存在于只读文件系统内    EIO    I/O存取错误

fchown: 改变文件的所有者 头文件: sys/types.h 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权限, 则会清除此权限位. 成功则返回0, 失败则返回-1, 错误原因存于errno. 错误代码:    EBADF   参数fd文件描述词为无效的或该文件已关闭    EPERM   进程的有效用户识别码与欲修改权限的文件所有者不同, 而且也不具root权限, 或是参数owner, group不正确    EROFS   欲写入的文件存在于只读文件系统内    ENOENT 指定的文件不存在    EIO     I/O存取错误

fstat: 由文件描述词取得文件状态 头文件: sys/stat.h unistd.h 函数定义: int fstat(int fildes, struct stat *buf); 说明: fstat()用来将参数fildes所指的文件状态, 复制到参数buf所指的结构中(struct stat). fstat()与stat()作用完全相同, 不同处在于传入的参数为已打开的文件描述词. 详细内容请参考stat(). 执行成功则返回0, 失败返回-1, 错误代码存于errno.

ftruncate: 改变文件大小 头文件: unistd.h 函数定义: int ftruncate(int fd, off_t length); 说明: ftruncate()会将参数fd指定的文件大小改为参数length指定的大小. 参数fd为已打开的文件描述词, 而且必须是以写入模式打开的文件. 如果原来的文件大小比参数length大, 则超过的部分会被删去. 执行成功则返回0, 失败返回-1, 错误原因存于errno. 错误代码:    EBADF    参数fd文件描述词为无效的或该文件已关闭    EINVAL 参数fd为一socket并非文件, 或是该文件并非以写入模式打开

ftw: 遍历目录树 头文件: ftw.h 函数定义: int ftw(const char *dir, int (*fn)(const char *file, const struct stat *sb, int flag), int depth); 说明: ftw()会从参数dir指定的目录开始, 往下一层层地递归式遍历子目录. 每进入一个目录, 便会调用参数*fn定义的函数来处理. ftw()会传三个参数给fn(), 第一个参数*file指向当时所在的目录路径, 第二个参数是*sb, 为stat结构指针(该结构的定义请参考stat()), 第三个参数为旗标, 有下面几种可能值:    FTW_F    一般文件    FTW_D    目录    FTW_DNR 不可读取的目录. 此目录以下将不被遍历    FTW_SL   符号连接    FTW_NS   无法取得stat结构数据, 有可能是权限问题 最后一个参数depth代表ftw()在进行遍历目录时可同时打开的文件数. ftw()在遍历时每一层目录至少需要一个文件描述词, 如果遍历时用完了depth所给予的限制数目, 整个遍历将因不断地关闭文件和打开文件操作而显得缓慢. 如果要结束ftw()的遍历, fn()只需返回一非零值即可, 此值同时也会是ftw()的返回值, 否则ftw()会试着走完所有的目录, 然后返回0. 遍历中断则返回fn()函数的返回值, 全部遍历完则返回0. 如有错误发生则返回-1. 附加说明: 由于ftw()会动态配置内存使用, 请使用正常方式(fn函数返回非0值)来中断遍历, 不要在fn函数中使用longjmp(). 应用举例: /* 列出/etc/X11目录下的子目录 */ #include <stdio.h> #include <sys/stat.h> #include <unistd.h> #include <ftw.h> int fn(const char *file, const struct stat* sb, int flag) { if(flag == FTW_D) {    printf("%s -- directory\n", file); } return 0; } int main(void) { ftw("/etc/X11", fn, 500); return 0; } 运行结果: /etc/X11 -- directory /etc/X11/xinit -- directory /etc/X11/xinit/xinitrc.d -- directory /etc/X11/xinit/Xclients.d -- directory /etc/X11/xinit/xinput.d -- directory /etc/X11/xdm -- directory /etc/X11/applnk -- directory /etc/X11/twm -- directory

get_current_dir_name: 取得当前的工作目录 头文件: unistd.h 函数定义: char *get_current_dir_name(void); 说明: 此函数会返回一字符串指针, 指向目前的工作目录绝对路径字符串. 执行成功返回字符串指针, 失败返回NULL, 错误代码存于errno. getcwd: 取得当前的工作目录 头文件: unistd.h 函数定义: char *getcwd(char *buf, size_t size); 说明: getcwd()会将当前的工作目录绝对路径复制到参数buf所指的内存空间, 参数size为buf的空间大小. 在调用此函数时, buf所指的内存空间要足够大, 若工作目录绝对路径的字符串长度超过参数size大小, 则回值NULL, errno的值则为ERANGE. 倘若参数buf为NULL, getcwd()会依参数size的大小自动配置内存(使用malloc()), 如果参数size也为0, 则getcwd()会依工作目录绝对路径的字符串程度来决定所配置的内存大小, 进程可以在使用完此字符串后利用free()来释放此空间. 执行成功则将结果复制到参数buf所指的内存空间, 或是返回自动配置的字符串指针. 失败返回NULL, 错误代码存于errno. getwd: 取得当前的工作目录 头文件: unistd.h 函数定义: char *getwd(char *buf); 说明: getwd()会将当前的工作目录绝对路径复制到参数buf所指的内存空间, 然后将此路径字符串指针返回. 执行成功则将结果复制到参数buf所指的内存空间, 失败返回NULL, 错误代码存于errno. 应用举例: #include <stdio.h> #include <unistd.h> int main(void) { char *ptr1, *ptr2; char buf[80]; ptr1 = get_current_dir_name(); printf("%s\n", ptr1); getcwd(buf, sizeof(buf)); printf("%s\n", buf); ptr2 = getcwd(NULL, 0); printf("%s\n", ptr2); free(ptr2); getwd(buf); printf("%s\n", buf); return 0; } 运行结果: /root/c-function /root/c-function /root/c-function /root/c-function

lchown: 改变文件的所有者 头文件: sys/types.h unistd.h 函数定义: int lchown(const char *path, uid_t ownwer, gid_t group); 说明: lchown()会将参数path指定文件的所有者变更为参数owner代表的用户, 而将该文件的组变更为参数group组. 如果参数owner或group为-1, 对应的所有者活组不会有所改变. 当root用lchown()改变文件所有者或组时, 该文件若具S_ISUID或S_ISGID权限, 则会清除此权限位. lchown()与chown不同之处在于, 如果参数path指定的文件为一符号连接(symbolic link), lchown()是改变连接本身的所有者或组, chown()则是改变连接所指向的文件所有者或组. 成功则返回0, 失败返回-1, 错误原因在于errno. 错误代码:    EPERM     进程的有效用户识别码与欲修改权限的文件拥有者不同, 而且也不具root权限, 或是参数owner/group不正确    EACCESS   参数path所指定的文件无法存取    EROFS     欲写入的文件存在于只读文件系统内    EFAULT    参数path指针超出可存取内存空间    ENAMETOOLONG 参数path太长    ENOENT    参数path指定的文件不存在    ENOTDIR   参数path路径并非一目录    ENOMEM    核心内存不足    ELOOP     参数path有过多符号连接问题    EIO       I/O存取错误