第 15 章 文件属性 (File Attributes)

// 摘自《The Linux Programming Interface》第 15 章
#include <sys/stat.h>

int stat(const char *pathname, struct stat *statbuf);
// 查 pathname；跟随符号链接

int lstat(const char *pathname, struct stat *statbuf);
// 查 pathname；不跟随符号链接（用于查看链接本身）

int fstat(int fd, struct stat *statbuf);
// 查已打开的 fd

// 全部成功返回 0；失败返回 -1

// 摘自《The Linux Programming Interface》第 15 章 files/t_stat.c
struct stat sb;
if (stat(argv[1], &sb) == -1) errExit("stat");
printf("File type: ");
if (S_ISREG(sb.st_mode))      printf("regular\n");
else if (S_ISDIR(sb.st_mode)) printf("directory\n");
else if (S_ISLNK(sb.st_mode)) printf("symlink\n");
// ...
printf("Size: %lld bytes\n", (long long) sb.st_size);
printf("Inode: %ld\n", (long) sb.st_ino);

struct stat {
    dev_t     st_dev;         // 文件所在设备
    ino_t     st_ino;         // i-node 号
    mode_t    st_mode;        // 文件类型 + 权限
    nlink_t   st_nlink;       // 硬链接数
    uid_t     st_uid;         // owner UID
    gid_t     st_gid;         // owner GID
    dev_t     st_rdev;        // 设备文件专用：设备 major/minor
    off_t     st_size;        // 文件大小（字节）
    blksize_t st_blksize;     // 最优 I/O 块大小（字节）
    blkcnt_t  st_blocks;      // 分配的 512 字节块数
    time_t    st_atime;       // 最后访问时间
    time_t    st_mtime;       // 最后数据修改时间
    time_t    st_ctime;       // 最后 i-node 状态变更时间
};

#define _BSD_SOURCE
#include <sys/types.h>
#include <sys/sysmacros.h>

unsigned int major(dev_t dev);
unsigned int minor(dev_t dev);
// 返回值类型随实现变化；打印时强转 unsigned int

// 摘自《The Linux Programming Interface》第 15 章
struct stat sb;
stat(path, &sb);
printf("Device: %d:%d\n", major(sb.st_dev), minor(sb.st_dev));
printf("Inode: %ld\n", (long) sb.st_ino);
printf("Size: %lld, Allocated: %lld*512\n",
       (long long) sb.st_size, (long long) sb.st_blocks);

// 摘自《The Linux Programming Interface》第 15 章
// 类型掩码和常量
if ((sb.st_mode & S_IFMT) == S_IFREG)   /* 普通文件 */
if (S_ISREG(sb.st_mode))                 /* 同上，宏更易读 */

// 摘自《The Linux Programming Interface》第 15 章
struct stat sb;
if (lstat(path, &sb) == -1) errExit("lstat");

switch (sb.st_mode & S_IFMT) {
    case S_IFREG:  printf("regular file\n"); break;
    case S_IFDIR:  printf("directory\n"); break;
    case S_IFLNK:  printf("symbolic link\n"); break;
    case S_IFCHR:  printf("character device\n"); break;
    case S_IFBLK:  printf("block device\n"); break;
    case S_IFIFO:  printf("FIFO\n"); break;
    case S_IFSOCK: printf("socket\n"); break;
    default:       printf("unknown?\n");
}

#include <sys/stat.h>
int chmod(const char *pathname, mode_t mode);
int fchmod(int fd, mode_t mode);
// 成功返回 0；进程需是 file owner 或有 CAP_FOWNER

// 摘自《The Linux Programming Interface》第 15 章
if (chmod("file", S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH) == -1)
    errExit("chmod");
// 等价于 chmod 644 file

// 打开 set-UID
if (chmod("prog", S_ISUID | S_IXUSR) == -1)
    errExit("chmod");
// 等价于 chmod u+s prog

#include <utime.h>
int utime(const char *filename, const struct utimbuf *times);
// 精度 1 秒；times == NULL → 设为当前时间

#include <sys/time.h>
int utimes(const char *filename, const struct timeval times[2]);
// 精度微秒；times[0] = atime, times[1] = mtime

// Linux 特有
#include <fcntl.h>
int utimensat(int fd, const char *path, const struct timespec times[2], int flags);
// 精度纳秒；可与 AT_SYMLINK_NOFOLLOW 一起用
// times[0] = atime, times[1] = mtime

// 摘自《The Linux Programming Interface》第 4 章
int fd = open("file", O_RDONLY | O_NOATIME);
// read 不更新 atime；减少磁盘写
// 需要 file owner 或 CAP_FOWNER

// 摘自《The Linux Programming Interface》第 15 章
// 设置 atime 和 mtime 为特定时间（纳秒精度）
struct timespec times[2];
times[0].tv_sec = 1234567890; times[0].tv_nsec = 0;  // atime
times[1].tv_sec = 1234567891; times[1].tv_nsec = 0;  // mtime

if (utimensat(AT_FDCWD, "file", times, 0) == -1)
    errExit("utimensat");

# 摘自《The Linux Programming Interface》第 15 章
# 设置 append-only
$ chattr +a /var/log/important.log

# 设置 immutable（root 自己也改不了）
$ chattr +i /etc/passwd

# 查看
$ lsattr /etc/passwd
----i-------e- /etc/passwd