文件及目录函数(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 beread/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 onexecution)位 S_ISGID 02000 文件的(set group-id onexecution)位 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) { 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.hsys/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, conststruct 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(). 应用举例: #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.hunistd.h 函数定义: int lchown(const char *path, uid_t ownwer, gid_tgroup); 说明: 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存取错误
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, conststruct 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为无效的目录流. 应用举例: #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_tbufsize); 说明: readlink()会将参数path的符号连接内容存到参数buf所指的内存空间, 返回的内容不是以NULL作字符串结尾,但会将字符串的字符数返回. 若参数bufsiz小于符号连接的内容长度, 过长的内容会被截断.执行成功则传符号连接所指的文件路径字符串, 失败则返回-1, 错误代码存于errno. 错误代码: EACCESS 取文件时被拒绝, 权限不够 EINVAL 参数bufsiz为负数 EIO I/O存取错误 ELOOP 欲打开的文件有过多符号连接问题 ENAMETOOLONG参数path的路径名称太长 ENOENT 参数path所指定的文件不存在 ENOMEM 核心内存不足 ENOTDIR参数path路径中的目录存在但却非真正的目录
realpath: 将相对目录路径转换成绝对路径 头文件: limits.hstdlib.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 structdirent**, const struct dirent**)); 说明: scandir()会扫描参数dir指定的目录文件, 经由参数select指定的函数来挑选目录结构至参数namelist数组中,最后在调用参数compar指定的函数来排序namelist数组中的目录数据.每次从目录文件中读取一个目录结构后便将此结构传给参数select所指的函数,select函数若不想要将此目录机构复制到namelist数组就返回0, 若select为空指针则代表选择所有的目录结构.scandir()会调用qsort()来排序数据, 参数compar则为qsort()的参数,若是要排列目录名称字母则可使用alphasort(). 结构dirent定义请参考readdir().成功则返回复制到namelist数组中的数据结构数目, 有错误发生则返回-1. ENOMEM表示核心内存不足. 应用举例: #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所指的结构中. 下面是structstat内各参数的说明: struct stat { dev_t st_dev; ino_t st_ino; mode_tst_mode; nlink_t st_nlink; uid_t st_uid; gid_t st_gid; dev_t st_rdev; off_t st_size; unsigned long st_blksize; unsigned long st_blocks; time_t st_atime; time_t st_mtime; time_t st_ctime; }; 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.hutime.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 指定的文件不存在
