Manpages

*

Linux で は 、 フ ァ イ ル シ ス テ ム オ ブ ジ ェ ク ト は 複 数 の パ ス で ア ク セ ス 可 能 で あ る 。 例 え ば 、 フ ァ イ ル シ ス テ ム の 一 部 は mount(8) の −−bind オ プ シ ョ ン を 使 っ て 再 マ ウ ン ト さ れ る こ と が あ る 。 マ ー ク さ れ た マ ウ ン ト の 監 視 者 は 、 同 じ マ ウ ン ト を 使 っ た フ ァ イ ル オ ブ ジ ェ ク ト に つ い て の み イ ベ ン ト 通 知 を 受 け る 。 そ れ 以 外 の イ ベ ン ト は 通 知 さ れ な い 。

*

fallocate(2) の 呼 び 出 し で は fanotify イ ベ ン ト が 作 成 さ れ な い 。

イ ベ ン ト が 生 成 さ れ た 際 に 、 そ の フ ァ イ ル の フ ァ イ ル デ ィ ス ク リ プ タ ー を 渡 す 前 に 、 イ ベ ン ト を 受 信 す る プ ロ セ ス の ユ ー ザ ー ID が そ の フ ァ イ ル に 対 す る 読 み 出 し ／ 書 き 込 み 許 可 が あ る か の 確 認 は 行 わ れ な い 。 非 特 権 ユ ー ザ ー に よ っ て 実 行 さ れ た プ ロ グ ラ ム に CAP_SYS_ADMIN ケ ー パ ビ リ テ ィ ー が セ ッ ト さ れ て い る 場 合 に は 、 こ の こ と は セ キ ュ リ テ ィ ー リ ス ク と な る 。
*

read(2) の 呼 び 出 し が fanotify キ ュ ー か ら 複 数 の イ ベ ン ト を 処 理 し て い る 際 に 、 エ ラ ー が 発 生 し た 場 合 、 返 り 値 は エ ラ ー が 発 生 す る 前 ま で に ユ ー ザ ー 空 間 バ ッ フ ァ ー に 正 常 に コ ピ ー さ れ た イ ベ ン ト の 合 計 長 と な る 。 返 り 値 は −1 に な ら ず 、 errno も セ ッ ト さ れ な い 。 し た が っ て 、 読 み 出 し を 行 う ア プ リ ケ ー シ ョ ン で は エ ラ ー を 検 出 す る 方 法 は な い 。

例

以 下 の プ ロ グ ラ ム は fanotify API の 使 用 法 を 示 す も の で あ る 。 コ マ ン ド ラ イ ン 引 き 数 で 渡 さ れ た マ ウ ン ト ポ イ ン ト を 監 視 し 、 種 別 が FAN_PERM_OPEN と FAN_CLOSE_WRITE の イ ベ ン ト を 待 つ 。 ア ク セ ス 許 可 イ ベ ン ト が 発 生 に は 、 FAN_ALLOW 応 答 を 返 す 。 以 下 の 出 力 例 は フ ァ イ ル /home/user/temp/notes を 編 集 し た 際 に 記 録 さ れ た も の で あ る 。 フ ァ イ ル を オ ー プ ン す る 前 に FAN_OPEN_PERM イ ベ ン ト が 発 生 し て い る 。 フ ァ イ ル を ク ロ ー ズ し た 後 に FAN_CLOSE_WRITE イ ベ ン ト が 発 生 し て い る 。 エ ン タ ー キ ー を ユ ー ザ ー が 押 す と 、 こ の プ ロ グ ラ ム の 実 行 は 終 了 す る 。 出 力 例

# ./fanotify_example /home
Press enter key to terminate.
Listening for events.
FAN_OPEN_PERM: File /home/user/temp/notes
FAN_CLOSE_WRITE: File /home/user/temp/notes

Listening for events stopped. プ ロ グ ラ ム ソ ー ス

#define _GNU_SOURCE /* O_LARGEFILE の 定 義 を 得 る た め に 必 要 */
#include <errno.h>
#include <fcntl.h>
#include <limits.h>
#include <poll.h>
#include <stdio.h>
#include <stdlib.h>
#include <sys/fanotify.h>
#include <unistd.h>

/* フ ァ イ ル デ ィ ス ク リ プ タ ー ’fd’ か ら 読 み 出 し で き る 全 fanotify イ ベ ン ト を 読 み 出 す */

static void
handle_events(int fd)
{
const struct fanotify_event_metadata *metadata;
struct fanotify_event_metadata buf[200];
ssize_t len;
char path[PATH_MAX];
ssize_t path_len;
char procfd_path[PATH_MAX];
struct fanotify_response response;

/* fanotify フ ァ イ ル デ ィ ス ク リ プ タ ー か ら イ ベ ン ト が 読 み 出 せ る 間 は ル ー プ す る */

for(;;) {

/* イ ベ ン ト を 読 み 出 す */

len = read(fd, (void *) &buf, sizeof(buf));
if (len == −1 && errno != EAGAIN) {
perror("read");
exit(EXIT_FAILURE); }

/* 読 み 出 せ る デ ー タ の 最 後 に 達 し て い る か チ ェ ッ ク す る */

if (len <= 0)
break;

/* バ ッ フ ァ ー の 最 初 の イ ベ ン ト を 参 照 す る */

metadata = buf;

/* バ ッ フ ァ ー 内 の 全 イ ベ ン ト を 処 理 す る */

while (FAN_EVENT_OK(metadata, len)) {

/* 実 行 時 と コ ン パ イ ル 時 の 構 造 体 が 一 致 す る か 確 認 す る */

if (metadata−>vers != FANOTIFY_METADATA_VERSION) {
fprintf(stderr,
"Mismatch of fanotify metadata version.\n");
exit(EXIT_FAILURE); }

/* metadata−>fd に は 、 キ ュ ー の オ ー バ ー フ ロ ー を 示 す FAN_NOFD か 、 フ ァ イ ル デ ィ ス ク リ プ タ ー
(負 で な い 整 数 ) の い ず れ か が 入 っ て い る 。 こ こ で は キ ュ ー の オ ー バ ー フ ロ ー は 無 視 し て い る 。
*/

if (metadata−>fd >= 0) {

/* オ ー プ ン 許 可 イ ベ ン ト を 処 理 す る */

if (metadata−>mask & FAN_OPEN_PERM) {
printf("FAN_OPEN_PERM: ");

/* フ ァ イ ル の オ ー プ ン を 許 可 す る */

response.fd = metadata−>fd;
response.response = FAN_ALLOW;
write(fd, &response,
sizeof(struct fanotify_response)); }

/* 書 き 込 み 可 能 フ ァ イ ル の ク ロ ー ズ イ ベ ン ト を 処 理 す る */

if (metadata−>mask & FAN_CLOSE_WRITE)
printf("FAN_CLOSE_WRITE: ");

/* ア ク セ ス さ れ た フ ァ イ ル の パ ス 名 を 取 得 し 表 示 す る */

snprintf(procfd_path, sizeof(procfd_path),
"/proc/self/fd/%d", metadata−>fd);
path_len = readlink(procfd_path, path,
sizeof(path) − 1);
if (path_len == −1) {
perror("readlink");
exit(EXIT_FAILURE); }

path[path_len] = ’\0’;
printf("File %s\n", path);

/* イ ベ ン ト の フ ァ イ ル デ ィ ス ク リ プ タ ー を ク ロ ー ズ す る */

close(metadata−>fd); }

/* 次 の イ ベ ン ト に 進 む */

metadata = FAN_EVENT_NEXT(metadata, len); } } }

int
main(int argc, char *argv[])
{
char buf;
int fd, poll_num;
nfds_t nfds;
struct pollfd fds[2];

/* マ ウ ン ト ポ イ ン ト が 指 定 さ れ た か 確 認 す る */

if (argc != 2) {
fprintf(stderr, "Usage: %s MOUNT\n", argv[0]);
exit(EXIT_FAILURE); }

printf("Press enter key to terminate.\n");

/* fanotify API に ア ク セ ス す る た め の フ ァ イ ル デ ィ ス ク リ プ タ ー を 作 成 す る */

fd = fanotify_init(FAN_CLOEXEC | FAN_CLASS_CONTENT | FAN_NONBLOCK,
O_RDONLY | O_LARGEFILE);
if (fd == −1) {
perror("fanotify_init");
exit(EXIT_FAILURE); }

/* 指 定 さ れ た マ ウ ン ト に 対 し て 以 下 を 監 視 す る よ う に マ ー ク を 付 け る :
− フ ァ イ ル の オ ー プ ン 前 の ア ク セ ス 許 可 イ ベ ン ト
− 書 き 込 み 可 能 な フ ァ イ ル デ ィ ス ク リ プ タ ー の ク ロ ー ズ 後 の 通 知 イ ベ ン ト
*/

if (fanotify_mark(fd, FAN_MARK_ADD | FAN_MARK_MOUNT,
FAN_OPEN_PERM | FAN_CLOSE_WRITE, AT_FDCWD,
argv[1]) == −1) {
perror("fanotify_mark");
exit(EXIT_FAILURE); }

/* ポ ー リ ン グ の 準 備 */

nfds = 2;

/* コ ン ソ ー ル の 入 力 */

fds[0].fd = STDIN_FILENO;
fds[0].events = POLLIN;

/* fanotify の 入 力 */

fds[1].fd = fd;
fds[1].events = POLLIN;

/* イ ベ ン ト の 発 生 を 待 つ ル ー プ */

printf("Listening for events.\n");

while (1) {
poll_num = poll(fds, nfds, −1);
if (poll_num == −1) {
if (errno == EINTR) /* シ グ ナ ル に 割 り 込 ま れ た 場 合 */
continue; /* poll() を 再 開 す る */

perror("poll"); /* 予 期 し な い エ ラ ー */
exit(EXIT_FAILURE); }

if (poll_num > 0) {
if (fds[0].revents & POLLIN) {

/* コ ン ソ ー ル か ら の 入 力 が あ る 場 合 : 空 の 標 準 入 力 で あ れ ば 終 了 */

while (read(STDIN_FILENO, &buf, 1) > 0 && buf != ’\n’)
continue;
break; }

if (fds[1].revents & POLLIN) {

/* fanotify イ ベ ン ト が あ る 場 合 */

handle_events(fd); } } }

printf("Listening for events stopped.\n");
exit(EXIT_SUCCESS); }

関 連 項 目

fanotify_init(2), fanotify_mark(2), inotify(7)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。