Linux C函数之文件及目录函数（一）

转载：http://blog.csdn.net/wangwenxc/article/details/17393657

http://hi.baidu.com/51tb1/item/70fd8d1aca4c10dabe9042f2

文件及目录函数(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存取错误