1 /* Copyright (C) 2005, 2006 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, write to the Free 16 Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 17 02111-1307 USA. */ 18 19 #ifndef _SYS_INOTIFY_H 20 #define _SYS_INOTIFY_H 1 21 22 #include <stdint.h> 23 24 25 /* Structure describing an inotify event. */ 26 struct inotify_event 27 { 28 int wd; /* Watch descriptor. */ 29 uint32_t mask; /* Watch mask. */ 30 uint32_t cookie; /* Cookie to synchronize two events. */ 31 uint32_t len; /* Length (including NULs) of name. */ 32 char name __flexarr; /* Name. */ 33 }; 34 35 36 /* Supported events suitable for MASK parameter of INOTIFY_ADD_WATCH. */ 37 #define IN_ACCESS 0x00000001 /* File was accessed. */ 38 #define IN_MODIFY 0x00000002 /* File was modified. */ 39 #define IN_ATTRIB 0x00000004 /* Metadata changed. */ 40 #define IN_CLOSE_WRITE 0x00000008 /* Writtable file was closed. */ 41 #define IN_CLOSE_NOWRITE 0x00000010 /* Unwrittable file closed. */ 42 #define IN_CLOSE (IN_CLOSE_WRITE | IN_CLOSE_NOWRITE) /* Close. */ 43 #define IN_OPEN 0x00000020 /* File was opened. */ 44 #define IN_MOVED_FROM 0x00000040 /* File was moved from X. */ 45 #define IN_MOVED_TO 0x00000080 /* File was moved to Y. */ 46 #define IN_MOVE (IN_MOVED_FROM | IN_MOVED_TO) /* Moves. */ 47 #define IN_CREATE 0x00000100 /* Subfile was created. */ 48 #define IN_DELETE 0x00000200 /* Subfile was deleted. */ 49 #define IN_DELETE_SELF 0x00000400 /* Self was deleted. */ 50 #define IN_MOVE_SELF 0x00000800 /* Self was moved. */ 51 52 /* Events sent by the kernel. */ 53 #define IN_UNMOUNT 0x00002000 /* Backing fs was unmounted. */ 54 #define IN_Q_OVERFLOW 0x00004000 /* Event queued overflowed. */ 55 #define IN_IGNORED 0x00008000 /* File was ignored. */ 56 57 /* Helper events. */ 58 #define IN_CLOSE (IN_CLOSE_WRITE | IN_CLOSE_NOWRITE) /* Close. */ 59 #define IN_MOVE (IN_MOVED_FROM | IN_MOVED_TO) /* Moves. */ 60 61 /* Special flags. */ 62 #define IN_ONLYDIR 0x01000000 /* Only watch the path if it is a 63 directory. */ 64 #define IN_DONT_FOLLOW 0x02000000 /* Do not follow a sym link. */ 65 #define IN_MASK_ADD 0x20000000 /* Add to the mask of an already 66 existing watch. */ 67 #define IN_ISDIR 0x40000000 /* Event occurred against dir. */ 68 #define IN_ONESHOT 0x80000000 /* Only send event once. */ 69 70 /* All events which a program can wait on. */ 71 #define IN_ALL_EVENTS (IN_ACCESS | IN_MODIFY | IN_ATTRIB | IN_CLOSE_WRITE \ 72 | IN_CLOSE_NOWRITE | IN_OPEN | IN_MOVED_FROM \ 73 | IN_MOVED_TO | IN_CREATE | IN_DELETE \ 74 | IN_DELETE_SELF | IN_MOVE_SELF) 75 76 77 __BEGIN_DECLS 78 79 /* Create and initialize inotify instance. */ 80 extern int inotify_init (void) __THROW; 81 82 /* Add watch of object NAME to inotify instance FD. Notify about 83 events specified by MASK. */ 84 extern int inotify_add_watch (int __fd, const char *__name, uint32_t __mask) 85 __THROW; 86 87 /* Remove the watch specified by WD from the inotify instance FD. */ 88 extern int inotify_rm_watch (int __fd, uint32_t __wd) __THROW; 89 90 __END_DECLS 91 92 #endif /* sys/inotify.h */ 93