[04]APUE：文件与目录

时间：2022-11-15 19:20:26

[a] stat / lstat / fstat

#include <sys/stat.h>

int stat(const char *restrict pathname, struct stat *restrict buf)
int lstat(const char *restrict pathname, struct stat *restrict buf)

int fstat(int fd, struct stat *buf)
struct stat {
 mode_t    st_mode;

    ino_t    st_ino;

    dev_t    st_dev;

    dev_t    st_rdev;

    nlink_t    st_nlink;

    uid_t    st_uid;

    gid_t    st_gid;

    off_t    st_size;

    struct timespec    st_atime;

    struct timespec    st_mtime;

    struct timesepc    st_ctime;
blksize_t    st_blksize;

    blkcnt_t    st_blocks;

}
/* st_mode 二进制位对应关系, 显示的数字为 8 进制*/

     #define S_IFMT   0170000  /* type of file mask */

     #define S_IFIFO  0010000  /* named pipe (fifo) */

     #define S_IFCHR  0020000  /* character special */

     #define S_IFDIR  0040000  /* directory */

     #define S_IFBLK  0060000  /* block special */

     #define S_IFREG  0100000  /* regular */

     #define S_IFLNK  0120000  /* symbolic link */

     #define S_IFSOCK 0140000  /* socket */

     #define S_IFWHT  0160000  /* whiteout */

     #define S_ISUID  0004000  /* set user id on execution */

     #define S_ISGID  0002000  /* set group id on execution */

     #define S_ISVTX  0001000  /* save swapped text even after use */

     #define S_IRWXU  0000700  /* RWX mask for owner */

     #define S_IRUSR  0000400  /* read permission, owner */

     #define S_IWUSR  0000200  /* write permission, owner */

     #define S_IXUSR  0000100  /* execute/search permission, owner */

     #define S_IRWXG  0000070  /* RWX mask for group */

     #define S_IRGRP  0000040  /* read permission, group */

     #define S_IWGRP  0000020  /* write permission, group */

     #define S_IXGRP  0000010  /* execute/search permission, group */

     #define S_IRWXO  0000007  /* RWX mask for other */

     #define S_IROTH  0000004  /* read permission, other */

     #define S_IWOTH  0000002  /* write permission, other */

     #define S_IXOTH  0000001  /* execute/search permission, other */
struct timespec {

    time_t    tv_sec;

    long    tv_nsec;

}
/* 判断文件类型的預定义宏, 类型匹配返回非 0, 否则返回 0 */

    S_ISREG(buf.st_mode)

    S_ISDIR(buf.st_mode)

    S_ISCHR(buf.st_mode)

    S_ISBLK(buf.st_mode)

    S_ISFIFO(buf.st_mode)

    S_ISLNK(buf.st_mode)

    S_ISSOCK(buf.st_mode)
  • 成功返回 0, 出錯返回 -1
  • lstat 不追踪软链接目标文件, 可获得软链接本身的状态信息, 软链接的文件大小等于其所指向的目标文件名称的字符数量
  • 文件的状态信息将写入事先定义的 stat 結构体中
  • 文件类型的判断, 由于每种文件类型并不独占相应的二进制位, 故需使用預定义的 S_ISREG ... 等宏, 或者取 buf.st_mode & S_IFMT 的結果与对应的文件类型(S_IFDIR ...)进行相等性测试
  • 文件的每类权限均独占相应的二进制位, 故可直接使用 buf.st_mode 与各权限宏逐一按位 '&'

[b] umask

#include <sys/stat.h>

mode_t    umask(mode_t cmask)
  • 总是成功, 返回之前的屏蔽字, 没有出錯返回值
  • 仅作用于当前进程环境, 不更改 shell 的 umask 值

[c] chmod / lchmod / fchmod

#include <sys/stat.h>

int chmod(const char *path, mode_t mode)

int lchmod(const char *path, mode_t mode)

int fchmod(int fd, mode_t mode)
  • 成功返回 0, 出錯返回 -1
  • lchmod 不追踪软链接
  • mode 可使用八进制数字表示, 如 0644 等

[d] chown / lchown / fchown

#include <unistd.h>

int chown(const char *path, uid_t owner, gid_t group)

int lchown(const char *path, uid_t owner, gid_t group)

int fchown(int fd, uid_t owner, gid_t group)
  • 成功返回 0, 出錯返回 -1

[e] truncate / ftruncate

#include <unistd.h>

int truncate(const char *path, off_t length)

int ftruncate(int fd, off_t length)
  • 成功返回 0, 出錯返回 -1
  • 将指定文件截断为 length 字节, 其值若大于原文件大小, 将在文件末尾创建空洞

[f] link / unlink / mkdir / rmdir / remove

#include <unistd.h>

int link(const char *path, const char *path2)

int unlink(const char *path)

int mkdir(const char *path, mode_t mode)

int rmdir(const char *path)

#include <stdio.h>

int remove(const char *path)
  • 成功返回 0, 出錯返回 -1
  • link 创建硬链接, unlink 删除硬链接, mkdir 创建目录, rmdir 删除空目录
  • 标准库函数 remove 可对文件或目录执行 "删除"

[g] rename

#include <stdio.h>

int rename(const char *path, const char *path2)
  • 成功返回 0, 出錯返回 -1

[h] symlink

#include <unistd.h>

int symlink(const char *path, const char *path2)
  • 成功返回 0, 出錯返回 -1

[i] readlink

#include <unistd.h>

ssize_t readlink(const char *restrict path, char *restrict buf, size_t bufsize)
  • 成功返回读取到的字节数, 出錯返回 -1
  • 用于读取软链接指向的目标文件或目录名称

[j] futimens

#include <sys/stat.h>

int futimens(int fd, const struct timespec times[])
  • 成功返回 0, 出錯返回 -1
  • 用于更改文件或目录的 atime 或 mtime, 不能更改 ctime, 結构体数組的第一个元素指 atime
  • 若 times 参数指定为 NULL, 则更改为当前时间
  • 任意数組元素的 tv_nsec 字段为 UTIME_NOW, 则对应时间设置为当前时间; 若为 UTIME_OMIT, 则对应时间保持不变

[k] opendir / fdopendir / readdir / rewinddir / closedir / telldir / seekdir

#include <dirent.h>

DIR *opendir(const char *path)

DIR *fdopendir(int fd)

struct dirent *readdir(DIR *dp)

void rewinddir(DIR *dp)

int closedir(DIR *dp)

long telldir(DIR *dp)

void seekdir(DIR *dp, long loc) 
struct dirent {

    ino_t d_ino;

    char d_name[];

} 

[l] chdir / fchdir / getcwd

#include <unistd.h>

int chdir(const char *path)

int fchdir(int fd)
char *getcwd(char *buf, size_t size) 

...

相关文章