1/* Copyright (C) 2005-2026 Free Software Foundation, Inc.
2 This file is part of the GNU C Library.
3
4 The GNU C Library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Lesser General Public
6 License as published by the Free Software Foundation; either
7 version 2.1 of the License, or (at your option) any later version.
8
9 The GNU C Library is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 Lesser General Public License for more details.
13
14 You should have received a copy of the GNU Lesser General Public
15 License along with the GNU C Library; if not, see
16 <https://www.gnu.org/licenses/>. */
17
18#ifndef _SYS_INOTIFY_H
19#define _SYS_INOTIFY_H 1
20
21#include <stdint.h>
22
23/* Get the platform-dependent flags. */
24#include <bits/inotify.h>
25
26
27/* Structure describing an inotify event. */
28struct inotify_event
29{
30 int wd; /* Watch descriptor. */
31 uint32_t mask; /* Watch mask. */
32 uint32_t cookie; /* Cookie to synchronize two events. */
33 uint32_t len; /* Length (including NULs) of name. */
34 char name __flexarr; /* Name. */
35};
36
37
38/* Supported events suitable for MASK parameter of INOTIFY_ADD_WATCH. */
39#define IN_ACCESS 0x00000001 /* File was accessed. */
40#define IN_MODIFY 0x00000002 /* File was modified. */
41#define IN_ATTRIB 0x00000004 /* Metadata changed. */
42#define IN_CLOSE_WRITE 0x00000008 /* Writtable file was closed. */
43#define IN_CLOSE_NOWRITE 0x00000010 /* Unwrittable file closed. */
44#define IN_CLOSE (IN_CLOSE_WRITE | IN_CLOSE_NOWRITE) /* Close. */
45#define IN_OPEN 0x00000020 /* File was opened. */
46#define IN_MOVED_FROM 0x00000040 /* File was moved from X. */
47#define IN_MOVED_TO 0x00000080 /* File was moved to Y. */
48#define IN_MOVE (IN_MOVED_FROM | IN_MOVED_TO) /* Moves. */
49#define IN_CREATE 0x00000100 /* Subfile was created. */
50#define IN_DELETE 0x00000200 /* Subfile was deleted. */
51#define IN_DELETE_SELF 0x00000400 /* Self was deleted. */
52#define IN_MOVE_SELF 0x00000800 /* Self was moved. */
53
54/* Events sent by the kernel. */
55#define IN_UNMOUNT 0x00002000 /* Backing fs was unmounted. */
56#define IN_Q_OVERFLOW 0x00004000 /* Event queued overflowed. */
57#define IN_IGNORED 0x00008000 /* File was ignored. */
58
59/* Helper events. */
60#define IN_CLOSE (IN_CLOSE_WRITE | IN_CLOSE_NOWRITE) /* Close. */
61#define IN_MOVE (IN_MOVED_FROM | IN_MOVED_TO) /* Moves. */
62
63/* Special flags. */
64#define IN_ONLYDIR 0x01000000 /* Only watch the path if it is a
65 directory. */
66#define IN_DONT_FOLLOW 0x02000000 /* Do not follow a sym link. */
67#define IN_EXCL_UNLINK 0x04000000 /* Exclude events on unlinked
68 objects. */
69#define IN_MASK_CREATE 0x10000000 /* Only create watches. */
70#define IN_MASK_ADD 0x20000000 /* Add to the mask of an already
71 existing watch. */
72#define IN_ISDIR 0x40000000 /* Event occurred against dir. */
73#define IN_ONESHOT 0x80000000 /* Only send event once. */
74
75/* All events which a program can wait on. */
76#define IN_ALL_EVENTS (IN_ACCESS | IN_MODIFY | IN_ATTRIB | IN_CLOSE_WRITE \
77 | IN_CLOSE_NOWRITE | IN_OPEN | IN_MOVED_FROM \
78 | IN_MOVED_TO | IN_CREATE | IN_DELETE \
79 | IN_DELETE_SELF | IN_MOVE_SELF)
80
81
82__BEGIN_DECLS
83
84/* Create and initialize inotify instance. */
85extern int inotify_init (void) __THROW;
86
87/* Create and initialize inotify instance. */
88extern int inotify_init1 (int __flags) __THROW;
89
90/* Add watch of object NAME to inotify instance FD. Notify about
91 events specified by MASK. */
92extern int inotify_add_watch (int __fd, const char *__name, uint32_t __mask)
93 __THROW;
94
95/* Remove the watch specified by WD from the inotify instance FD. */
96extern int inotify_rm_watch (int __fd, int __wd) __THROW;
97
98__END_DECLS
99
100#endif /* sys/inotify.h */