c - 为什么 fanotify_fid Linux 手册页示例代码失败（在 open_by_handle_at() 上）？

Question

我正在 Linux 5.4 上测试 fanotify（也在 5.8 上测试过）；对于测试，我使用的是手册页fanotify_fid.c中的示例。fanotify(7)

现在，代码似乎很糟糕——我认为至少有几个错误——但我还是设法让它在一定程度上发挥作用。

有一个我无法解决的问题 -open_by_handle_at()失败Invalid argument。

以下是我使用的示例代码，带有注释；它是原始代码的简化和更正版本；它适用于 gcc 和 clang。
为了测试它，执行它，然后在另一个终端中执行mktemp（或只是在 下创建一个文件/目录/tmp）。

#define _GNU_SOURCE
#include <errno.h>
#include <fcntl.h>
#include <limits.h>
#include <stdio.h>
#include <stdlib.h>
#include <sys/fanotify.h>
#include <sys/stat.h>
#include <sys/types.h>
#include <unistd.h>

#define BUF_SIZE 512

int main(int argc, char **argv) {
  char *filename = "/tmp";

  int fd = fanotify_init(FAN_CLASS_NOTIF | FAN_REPORT_FID, 0);
  if (fd == -1)
    exit(EXIT_FAILURE);

  int ret = fanotify_mark(fd, FAN_MARK_ADD | FAN_MARK_ONLYDIR, FAN_CREATE | FAN_ONDIR, AT_FDCWD, filename);
  if (ret == -1)
    exit(EXIT_FAILURE);

  char events_buf[BUF_SIZE];
  char path[PATH_MAX], procfd_path[PATH_MAX];

  ssize_t len = read(fd, (void *)&events_buf, sizeof(events_buf));
  if (len == -1 && errno != EAGAIN)
    exit(EXIT_FAILURE);

  for (
    struct fanotify_event_metadata *metadata = (struct fanotify_event_metadata *)events_buf;
    FAN_EVENT_OK(metadata, len);
    metadata = FAN_EVENT_NEXT(metadata, len)
  ) {
    struct fanotify_event_info_fid *fid = (struct fanotify_event_info_fid *)(metadata + 1);

    // The mangpage `BUF_SIZE` is 256; this causes `info_type` to be 64 instead of 0
    // (when running `mktemp`), which causes an error.
    if (fid->hdr.info_type != FAN_EVENT_INFO_TYPE_FID) {
      fprintf(stderr, "Received unexpected event info type: %i.\n", fid->hdr.info_type);
      exit(EXIT_FAILURE);
    }

    if (metadata->mask == FAN_CREATE)
      printf("FAN_CREATE (file/directory created)\n");

    struct file_handle *file_handle = (struct file_handle *)fid->handle;

    // The manpage condition is `(ret == -1)`, which seems to be a bug.
    int event_fd = open_by_handle_at(AT_FDCWD, file_handle, O_RDONLY);
    if (event_fd == -1) {
      printf("File handle hex: ");
      for (int i = 0; i < sizeof(struct file_handle); i++)
        printf("%02x ", ((unsigned char *)file_handle)[i]);
      printf("\n");

      perror("open_by_handle_at");
      exit(EXIT_FAILURE);
    }

    snprintf(procfd_path, sizeof(procfd_path), "/proc/self/fd/%d", event_fd);

    ssize_t path_len = readlink(procfd_path, path, sizeof(path) - 1);
    if (path_len == -1) {
        perror("readlink");
        exit(EXIT_FAILURE);
    }

    close(event_fd);
  }
}

标签： clinuxfilesystemsfile-watcherfanotify

Answer 1

The 5.4 fanotify(7) man page example has many bugs, one of whom is that the first argument of open_by_handle_at() should be the mount/directory fd, not AT_FDCWD.

Corrected snippets, from the 5.10 man page:

mount_fd = open(argv[1], O_DIRECTORY | O_RDONLY);
if (mount_fd == -1) { /* error handling */ }

// ...

event_fd = open_by_handle_at(mount_fd, file_handle, O_RDONLY);
if (event_fd == -1) { /* error handling */ }