http://apps.hi.baidu.com/share/detail/51225486
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 指定的文件不存在