/usr/include/nih/watch.h is in libnih-dev 1.0.3-4ubuntu25.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 | /* libnih
*
* Copyright © 2009 Scott James Remnant <scott@netsplit.com>.
* Copyright © 2009 Canonical Ltd.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2, as
* published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
#ifndef NIH_WATCH_H
#define NIH_WATCH_H
#include <sys/inotify.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <nih/macros.h>
#include <nih/list.h>
#include <nih/hash.h>
#include <nih/file.h>
#include <nih/io.h>
/* Predefine the typedefs as we use them in the callbacks */
typedef struct nih_watch NihWatch;
/**
* NihCreateHandler:
* @data: data pointer given when registered,
* @watch: NihWatch for directory tree,
* @path: full path to file,
* @statbuf: stat of @path.
*
* A create handler is a function that is called whenever a file or other
* object is created under or moved into a directory tree being watched.
* @path contains the path to the file, including the directory prefix
* which can be found in @watch.
*
* It is safe to remove the watch with nih_free() from this function.
**/
typedef void (*NihCreateHandler) (void *data, NihWatch *watch,
const char *path, struct stat *statbuf);
/**
* NihModifyHandler:
* @data: data pointer given when registered,
* @watch: NihWatch for directory tree,
* @path: full path to file,
* @statbuf: stat of @path.
*
* A modify handler is a function that is called whenever a file or other
* object is changed within a directory tree being watched. @path contains
* the path to the file, including the directory prefix which can be
* found in @watch.
*
* It is safe to remove the watch with nih_free() from this function.
**/
typedef void (*NihModifyHandler) (void *data, NihWatch *watch,
const char *path, struct stat *statbuf);
/**
* NihDeleteHandler:
* @data: data pointer given when registered,
* @watch: NihWatch for directory tree,
* @path: full path to file.
*
* A delete handler is a function that is called whenever a file or other
* object is deleted from or moved out of a directory tree being watched.
* @path contains the path to the file, including the directory prefix
* which can be found in @watch.
*
* If the directory being watched itself is deleted, or an error occurs
* with the inotify socket (including closure), this function is called
* with the top-level path as an argument (check watch->path). It is
* normal and safe to free the watch at this point.
*
* It is safe to remove the watch with nih_free() from this function.
**/
typedef void (*NihDeleteHandler) (void *data, NihWatch *watch,
const char *path);
/**
* NihWatch:
* @fd: inotify instance,
* @io: NihIo structure to watch @fd,
* @path: full path to be watched,
* @watches: list of watch descriptors,
* @subdirs: include sub-directories of @path,
* @create: call @create_handler for existing files,
* @filter: function to filter paths watched,
* @create_handler: function called when a path is created,
* @modify_handler: function called when a path is modified,
* @delete_handler: function called when a path is deleted,
* @created: hash table of created files,
* @data: pointer to pass to functions,
* @free: allows free to be called within a handler.
*
* This structure represents an inotify instance that is watching @path,
* and optionally sub-directories underneath it. It can also be used to
* just watch multiple different files calling the same functions for each.
**/
struct nih_watch {
int fd;
NihIo *io;
char *path;
NihList watches;
int subdirs;
int create;
NihFileFilter filter;
NihCreateHandler create_handler;
NihModifyHandler modify_handler;
NihDeleteHandler delete_handler;
NihHash *created;
void *data;
int *free;
};
/**
* NihWatchHandle:
* @entry: entry in list,
* @wd: inotify watch handle,
* @path: path being watched.
*
* This structure represents an inotify watch on an individual @path with
* a unique watch descriptor @wd. They are stored in the watches list of
* an NihWatch structure.
**/
typedef struct nih_watch_handle {
NihList entry;
int wd;
char *path;
} NihWatchHandle;
NIH_BEGIN_EXTERN
NihWatch *nih_watch_new (const void *parent, const char *path, int subdirs,
int create, NihFileFilter filter,
NihCreateHandler create_handler,
NihModifyHandler modify_handler,
NihDeleteHandler delete_handler, void *data)
__attribute__ ((warn_unused_result));
int nih_watch_add (NihWatch *watch, const char *path, int subdirs)
__attribute__ ((warn_unused_result));
int nih_watch_destroy (NihWatch *watch);
NIH_END_EXTERN
#endif /* NIH_WATCH_H */
|