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

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

http://hi.baidu.com/51tb1/item/471b7d02d59e6996a2df43f2

link: 建立文件硬连接
头文件: unistd.h
函数定义: int link(const char *oldpath, const char *newpath);
说明: link()以参数newpath指定的名称来建立一个新的连接(硬连接)到参数oldpath所指定的已存在文件. 如果参数newpath指定的名称为一已存在的文件则不会建立连接. 成功则返回0, 失败返回-1, 错误原因存于errno.
错误代码:
   EXDEV   参数oldpath与newpath不是建立在同一文件系统
   EPERM   参数oldpath与newpath所指的文件系统不支持硬连接
   EROFS   文件存在于只读文件系统内
   EFAULT 参数oldpath或newpath指针超出可存取内存空间
   ENAMETOLLONG   参数oldpath或newpath太长
   ENOMEM 核心内存不足
   EEXIST 参数newpath所指的文件名已存在
   EMLINK 参数oldpath所指的文件已达最大连接数目
   ELOOP   参数pathname有过多符号连接问题
   ENOSPC 文件系统的剩余空间不足
   EIO     I/O存取错误
附加说明: link()所建立的硬连接无法跨越不同文件系统, 如果需要请改用symlink().

lstat: 由文件描述词取得文件状态
头文件: sys/stat.h unistd.h
函数定义: int lstat(const char *file_name, struct stat *buf);
说明: lstat()与stat()作用完全相同, 都是取得参数file_name所指的文件状态, 其差别在于, 当文件为符号连接时, lstat()会返回该link本身的状态. 详细内容请参考stat(). 执行成功则返回0, 失败返回-1, 错误代码存于errno.

nftw: 遍历目录树
头文件: ftw.h
函数定义: int nftw(const char *dir, int (*fn)(const char *file, const struct stat *sb, int flag, struct FTW *s), depth, int flags);
说明: nftw()与ftw()很像, 都是从参数dir指定的目录开始, 往下一层层地递归式遍历子目录. 每进入一个目录, 便会调用参数*fn定义的函数来处理. nftw()会传四个参数给fn(), 第一个参数*file指向当时所在的目录路径, 第二个参数是*sb, 为stat结构指针(结构定义请参考stat()), 第三个参数为旗标, 有以下几种可能:
   FTW_F    一般文件
   FTW_D    目录
   FTW_DNR 不可读取的目录. 此目录以下将不被遍历
   FTW_SL   符号连接
   FTW_NS   无法取得stat结构数据, 有可能是权限问题
   FTW_DP   目录, 而且其子目录都已被遍历过了.
   FTW_SLN 符号连接, 但连接不存在文件
fn()的第四个参数是FTW结构, 定义如下:
struct FTW{
int base;
int level;
}
level代表遍历当时的深度, nftw()第三个参数depth代表nftw()在进行遍历目录时可同时打开的文件数. ftw()在遍历时每一层目录至少需要一个文件描述词, 如果遍历时用完了depth所给予的限制数目, 整个遍历将因不断地关闭文件和打开文件操作而显得缓慢. nftw()最后一个参数flags用来指定遍历时的动作, 可以指定下列的操作或用OR组合:
   FTW_CHDIR   在读目录之前用chdir()移到此目录
   FTW_DEPTH   执行深度优先搜索. 在遍历此目录前先将所有子目录遍历完
   FTW_MOUNT   遍历时不要跨越到其他文件系统
   FTW_PHYS    不要遍历符号连接的目录. 预设会遍历符号连接目录
如果要结束ftw()的遍历, fn()只需返回一非零值即可, 此值同时也会是ftw()的返回值, 否则ftw()会试着走完所有的目录, 然后返回0. 遍历中断则返回fn()函数的返回值, 全部遍历完则返回0. 如有错误发生则返回-1.
附加说明: 由于ftw()会动态配置内存使用, 请使用正常方式(fn函数返回非0值)来中断遍历, 不要在fn函数中使用longjmp().

opendir: 打开目录
头文件: sys/types.h dirent.h
函数定义: DIR *opendir(const char *name);
说明: opendir()用来打开参数name指定的目录, 并返回DIR*形态的目录流, 和open()类似, 接下来对目录的读取和搜索都要使用此返回值. 成功则返回DIR*型态的目录流, 打开失败则返回NULL.
错误代码:
   EACCESS 权限不足
   EMFILE   已达到进程可同时打开的文件数上限
   ENFILE   已达到系统可同时打开的文件数上限
   ENOTDIR 参数name非真正的目录
   ENOENT   参数name指定的目录不存在, 或是参数name为一空字符串
   ENOMEM   核心内存不足

readdir: 读取目录
头文件: sys/types.h dirent.h
定义函数: struct dirent *readdir(DIR *dir);
说明: readdir()返回参数dir目录流的下个目录进入点. 结构dirent定义如下:
struct dirent{
ino_t d_ino;
ff_t d_off;
signed short int d_reclen;
unsigned char d_type;
char d_name[256];
};
d_ino    此目录进入点的inode
d_off    目录文件开头至此目录进入点的位移
d_reclen _name的长度, 不包含NULL字符
d_type   d_name所指的文件类型
d_name   文件名
成功则返回下个目录进入点, 有错误发生或读取到目录文件尾则返回NULL. EBADF参数dir为无效的目录流.
应用举例:
/* 读取/etc/rc.d目录文件结构, 然后显示目录下的文件 */
#include <stdio.h>
#include <unistd.h>
#include <sys/types.h>
#include <dirent.h>
int main(void)
{
DIR *dir;
struct dirent *ptr;
int i;
dir = opendir("/etc/rc.d");
while((ptr = readdir(dir)) != NULL)
{
   printf("d_name: %s\n", ptr->d_name);
}
return 0;
}
运行结果:
d_name: rc1.d
d_name: rc3.d
d_name: rc
d_name: rc2.d
d_name: rc0.d
d_name: rc.sysinit
d_name: ..
d_name: rc6.d
d_name: rc4.d
d_name: init.d
d_name: rc.local
d_name: rc5.d
d_name: .

readlink: 取得符号连接所指的文件
头文件: unistd.h
函数定义: int readlink(const char *path, char *buf, size_t bufsize);
说明: readlink()会将参数path的符号连接内容存到参数buf所指的内存空间, 返回的内容不是以NULL作字符串结尾, 但会将字符串的字符数返回. 若参数bufsiz小于符号连接的内容长度, 过长的内容会被截断. 执行成功则传符号连接所指的文件路径字符串, 失败则返回-1, 错误代码存于errno.
错误代码: 
   EACCESS 取文件时被拒绝, 权限不够
   EINVAL   参数bufsiz为负数
   EIO      I/O存取错误
   ELOOP    欲打开的文件有过多符号连接问题
   ENAMETOOLONG 参数path的路径名称太长
   ENOENT   参数path所指定的文件不存在
   ENOMEM   核心内存不足
   ENOTDIR 参数path路径中的目录存在但却非真正的目录

realpath: 将相对目录路径转换成绝对路径
头文件: limits.h stdlib.h
函数定义: char *realpath(const char *path, char *resolved_path);
说明: realpath()用来将参数path所指的相对路径转换成绝对路径存于参数resolved_path所指的字符串数组中. 如果转换成功则返回指向resolved_path的指针. 失败返回NULL, 错误代码存于errno.

remove: 删除文件或目录
头文件: stdio.h
函数定义: int remove(const char *pathname);
说明: remove()会删除参数pathname指定的文件. 如果参数pathname为一文件, 则调用unlink()处理, 若参数pathname为一目录, 则调用rmdir()来处理. 请参考unlink()与rmdir(). 成功则返回0, 失败则返回-1, 错误原因存于errno.
错误代码: 
   EROFS    欲写入的文件存在于只读文件系统内
   EFAULT   参数pathname指针超出可存取内存空间
   ENAMETOOLONG   参数pathname太长
   ENOMEM   核心内存不足
   ELOOP    参数pathname有过多符号连接问题
   EIO      I/O存取错误.

rename: 更改文件名或位置
头文件: stdio.h
函数定义: int rename(const char *oldpath, const char *newpath);
说明: rename()会将参数oldpath所指定的文件名称改为参数newpath所指的文件名称. 若newpath所指定的文件已存在, 则会被删除. 执行成功则返回0, 失败返回-1, 错误原因存于errno.

rewinddir: 将读取目录的位置设为开头位置
头文件: sys/types.h dirent.h
函数定义: void rewinddir(DIR *dir);
说明: rewinddir()用来设置参数dir目录流目前的读取位置为原来开头的读取位置. EBADF表示dir为无效的目录流.

scandir: 读取特定的目录数据
头文件: dirent.h
函数定义: int scandir(const char *dir, struct dirent ***namelist, int (*select)(const struct dirent *), int (*compar)(const struct dirent**, const struct dirent**));
说明: scandir()会扫描参数dir指定的目录文件, 经由参数select指定的函数来挑选目录结构至参数namelist数组中, 最后在调用参数compar指定的函数来排序namelist数组中的目录数据. 每次从目录文件中读取一个目录结构后便将此结构传给参数select所指的函数, select函数若不想要将此目录机构复制到namelist数组就返回0, 若select为空指针则代表选择所有的目录结构. scandir()会调用qsort()来排序数据, 参数compar则为qsort()的参数, 若是要排列目录名称字母则可使用alphasort(). 结构dirent定义请参考readdir(). 成功则返回复制到namelist数组中的数据结构数目, 有错误发生则返回-1. ENOMEM表示核心内存不足.
应用举例:
/* 读取/目录下文件名长度大于5的目录结构 */
#include <stdio.h>
#include <string.h>
#include <dirent.h>
int select(const struct dirent *dir)
{
if(strlen(dir->d_name) > 5)
   return 1;
else
   return 0;
}
int main(void)
{
struct dirent **namelist;
int i, total;
total = scandir("/", &namelist, select, 0);
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;
}
运行结果:
selinux
total = 3
.autofsck
total = 3
lost+found
total = 3

seekdir: 设置下回读取目录的位置
头文件: dirent.h
函数定义: void seekdir(DIR *dir, off_t offset);
说明: seekdir()用来设置参数dir目录流目前的读取位置, 在调用readdir()时便从此新位置开始读取. 参数offset代表距离目录文件开头的偏移量. EBADF表示参数dir为无效路径.

stat: 取得文件状态
头文件: sys/stat.h unistd.h
函数定义: int stat(const char *file_name, struct stat *buf);
说明: stat()用来将参数file_name所指的文件状态, 复制到参数buf所指的结构中. 下面是struct stat内各参数的说明:
struct stat
{
dev_t   st_dev;      /* device */
ino_t   st_ino;      /* inode */
mode_t st_mode;     /* protection */
nlink_t   st_nlink; /* number of hard links */
uid_t    st_uid;     /* user ID of owner */
gid_t    st_gid;     /* group ID of owner */
dev_t    st_rdev;    /* device type */
off_t     st_size;   /* total size, in bytes */
unsigned long st_blksize; /* blocksize for filesystem I/O */
unsigned long st_blocks; /* number of blocks allocated */
time_t   st_atime;   /* time of lastaccess */
time_t   st_mtime;   /* time of last modification */
time_t   st_ctime;   /* time of last change */
};
st_dev    文件的设备编号
st_ino    文件的i-node
st_mode   文件的类型和存取的权限
st_nlink 连到该文件的硬连接数目, 刚建立的文件值为1
st_uid    文件所有者的用户识别码
st_gid    文件所有者的组识别码
st_rdev   若此文件为装置设备文件, 则为其设备编号
st_size   文件大小, 以字节计算
st_blksize 文件系统的I/O缓冲区大小
st_blcoks 占用文件区块的个数, 每一区块大小为512个字节
st_atime 文件最近一次被存取或被执行的时间, 一般只有在用mknod, utime, read, write与tructate时改变
st_mtime 文件最后一次被修改的时间, 一般只有在用mknod, utime和write时才会改变
st_ctime i-node最近一次被更改的时间, 此参数会在文件所有者, 组, 权限被更改时更新
先前所描述的st_mode则定义了下列数种情况:
   S_IFMT    0170000 文件类型的位遮罩
   S_IFSOCK 0140000 scoket
   S_IFLNK   0120000 符号连接
   S_IFREG   0100000 一般文件
   S_IFBLK   0060000 区块装置
   S_IFDIR   0040000 目录
   S_IFCHR   0020000 字符装置
   S_IFIFO   0010000 先进先出
   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 其他用户具可执行权限
上述的文件类型在POSIX中定义了检查这些类型的宏定义:
   S_ISLNK (st_mode) 判断是否为符号连接
   S_ISREG   (st_mode) 是否为一般文件
   S_ISDIR    (st_mode)是否为目录
   S_ISCHR   (st_mode)是否为字符装置文件
   S_ISBLK    (s3e)   是否为先进先出
   S_ISSOCK (st_mode) 是否为socket
若一目录具有sticky位(S_ISVTX), 则表示在此目录下的文件只能被该文件所有者, 此目录所有者或root来删除或改名. 执行成功则返回0, 失败返回-1, 错误代码存于errno.
错误代码: 
   ENOENT   参数file_name指定的文件不存在
   ENOTDIR 路径中的目录存在但却非真正的目录
   ELOOP    欲打开的文件有过多符号连接问题, 上限为16符号连接
   EFAULT   参数buf为无效指针, 指向无法存在的内存空间
   EACCESS 存取文件时被拒绝
   ENOMEM   核心内存不足
   ENAMETOOLONG 参数file_name的路径名称太长
应用举例:
#include <stdio.h>
#include <sys/stat.h>
#include <unistd.h>
int main(void)
{
struct stat buf;
stat("/etc/passwd", &buf);
printf("etc/passwd file size = %d\n", buf.st_size);
return 0;
}
运行结果:
etc/passwd file size = 2529

symlink: 建立文件符号连接
头文件: unistd.h
函数定义: int symlink(const char *oldpath, const char *newpath);
说明: symlink()以参数newpath指定的名称来建立一个新的连接(符号连接)到参数oldpath所指定的已存在文件. 参数oldpath指定的文件不一定要存在, 如果参数newpath指定的名称为一已存在的文件则不会建立连接. 成功则返回0, 失败返回-1, 错误原因存于errno.
错误代码:
   EPERM   参数oldpath与newpath所指的文件系统不支持符号连接
   EROFS   欲测试写入权限的文件存在于只读文件系统内
   EFAULT 参数oldpath或newpath指针超出可存取内存空间
   ENAMETOOLONG 参数oldpath或newpath太长
   ENOMEM 核心内存不足
   EEXIST 参数newpath所指的文件名已存在
   EMLINK 参数oldpath所指的文件已达到最大连接数目
   ELOOP   参数pathname有过多符号连接问题
   ENOSPC 文件系统的剩余空间不足
   EIO     I/O存取错误

telldir: 取得目录流的读取位置
头文件: dirent.h
函数定义: off_t telldir(DIR *dir);
说明: telldir()返回参数dir目录流目前的读取位置. 此返回值代表距离目录文件开头的偏移量, 有错误发生时返回-1. EBADF表示参数dir为无效的目录流.

truncate: 改变文件大小
头文件: unistd.h
函数定义: int truncate(const char *path, off_t length);
说明: truncate()会将参数path指定的文件大小改为参数length指定的大小. 如果原来的文件大小比参数length大, 则超过的部分会被删去. 执行成功则返回0, 失败返回-1, 错误原因存于errno. 
错误代码: 
   EACCESS   参数path所指定的文件无法存取。
   EROFS     欲写入的文件存在于只读文件系统内
   EFAULT    参数path指针超出可存取内存空间
   EINVAL    参数path包含不合法字符
   ENAMETOOLONG 参数path太长
   ENOTDIR   参数path路径并非一目录
   EISDIR    参数path指向一目录
   ETXTBUSY 参数path所指的文件为共享程序, 而且正被执行中
   ELOOP     参数path’有过多符号连接问题
   EIO       I/O存取错误

umask: 设置建立新文件时的权限遮罩
头文件: sys/types.h sys/stat.h
函数定义: mode_t umask(mode_t mask);
说明: umask()会将系统umask值设成参数mask&0777后的值, 然后将先前的umask值返回. 在使用open()建立新文件时, 该参数mode并非真正建立文件的权限, 而是(mode&~umask)的权限值. 例如, 在建立文件时指定文件权限为0666, 通常umask值默认为022, 则该文件的真正权限则为0666&～022＝0644, 也就是rw-r--r--. 此调用不会有错误值返回, 返回值为原先系统的umask值.

unlink: 删除文件
头文件: unistd.h
函数定义: int unlink(const char *pathname);
说明: unlink()会删除参数pathname指定的文件. 如果该文件名为最后连接点, 但有其他进程打开了此文件, 则在所有关于此文件的文件描述词皆关闭后才会删除. 如果参数pathname为一符号连接, 则此连接会被删除. 成功则返回0, 失败返回-1, 错误原因存于errno.
错误代码: 
   EROFS   文件存在于只读文件系统内
   EFAULT 参数pathname指针超出可存取内存空间
   ENAMETOOLONG 参数pathname太长
   ENOMEM 核心内存不足
   ELOOP   参数pathname有过多符号连接问题
   EIO     I/O存取错误

utime: 修改文件的存取时间和更改时间
头文件: sys/types.h utime.h
函数定义: int utime(const char *filename, struct utimebuf *buf);
说明: utime()用来修改参数filename文件所属的inode存取时间. 结构utimbuf定义如下:
struct utimbuf{
time_t actime;
time_t modtime;
};
如果参数buf为空指针(NULL), 则该文件的存取时间和更改时间全部会设为目前时间. 执行成功则返回0, 失败返回-1, 错误代码存于errno.
错误代码: 
   EACCESS 存取文件时被拒绝, 权限不足
   ENOENT   指定的文件不存在

utimes: 修改文件的存取时间和更改时间
头文件: sys/types.h utime.h
函数定义: int utimes(char *filename, struct timeval *tvp);
说明: utimes()用来修改参数filename文件所属的inode存取时间和修改时间, 结构timeval定义如下:
struct timeval{
long tv_sec;
long tv_usec; /* 微妙 */
};
参数tvp指向两个timeval结构空间, 和utime()使用的utimebuf结构比较, tvp.tc_sec则为utimbuf.actime, tvp.tv_sec为utimbuf.modtime. 执行成功则返回0. 失败返回-1, 错误代码存于errno. 
错误代码: 
   EACCESS 存取文件时被拒绝, 权限不足
   ENOENT   指定的文件不存在