2 * FAM file notification support.
4 * Copyright (c) James Peach 2005
5 * Copyright (c) Volker Lendecke 2007
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 3 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
26 #if !defined(HAVE_FAM_H_FAMCODES_TYPEDEF)
27 /* Gamin provides this typedef which means we can't use 'enum FAMCodes' as per
28 * every other FAM implementation. Phooey.
30 typedef enum FAMCodes FAMCodes;
33 /* NOTE: There are multiple versions of FAM floating around the net, each with
34 * slight differences from the original SGI FAM implementation. In this file,
35 * we rely only on the SGI features and do not assume any extensions. For
36 * example, we do not look at FAMErrno, because it is not set by the original
40 * http://oss.sgi.com/projects/fam/
41 * http://savannah.nongnu.org/projects/fam/
42 * http://sourceforge.net/projects/bsdfam/
45 /* ------------------------------------------------------------------------- */
47 struct fam_watch_context {
48 struct fam_watch_context *prev, *next;
49 FAMConnection *fam_connection;
51 struct sys_notify_context *sys_ctx;
52 void (*callback)(struct sys_notify_context *ctx,
54 struct notify_event *ev);
56 uint32_t mask; /* the inotify mask */
57 uint32_t filter; /* the windows completion filter */
63 * We want one FAM connection per smbd, not one per tcon.
65 static FAMConnection fam_connection;
66 static BOOL fam_connection_initialized = False;
68 static struct fam_watch_context *fam_notify_list;
69 static void fam_handler(struct event_context *event_ctx,
70 struct fd_event *fd_event,
74 static NTSTATUS fam_open_connection(FAMConnection *fam_conn,
75 struct event_context *event_ctx)
80 ZERO_STRUCTP(fam_conn);
81 FAMCONNECTION_GETFD(fam_conn) = -1;
83 if (asprintf(&name, "smbd (%lu)", (unsigned long)sys_getpid()) == -1) {
84 DEBUG(0, ("No memory\n"));
85 return NT_STATUS_NO_MEMORY;
88 res = FAMOpen2(fam_conn, name);
92 DEBUG(10, ("FAM file change notifications not available\n"));
94 * No idea how to get NT_STATUS from a FAM result
96 FAMCONNECTION_GETFD(fam_conn) = -1;
97 return NT_STATUS_UNEXPECTED_IO_ERROR;
100 if (event_add_fd(event_ctx, event_ctx,
101 FAMCONNECTION_GETFD(fam_conn),
102 EVENT_FD_READ, fam_handler,
103 (void *)fam_conn) == NULL) {
104 DEBUG(0, ("event_add_fd failed\n"));
106 FAMCONNECTION_GETFD(fam_conn) = -1;
107 return NT_STATUS_NO_MEMORY;
113 static void fam_reopen(FAMConnection *fam_conn,
114 struct event_context *event_ctx,
115 struct fam_watch_context *notify_list)
117 struct fam_watch_context *ctx;
119 DEBUG(5, ("Re-opening FAM connection\n"));
123 if (!NT_STATUS_IS_OK(fam_open_connection(fam_conn, event_ctx))) {
124 DEBUG(5, ("Re-opening fam connection failed\n"));
128 for (ctx = notify_list; ctx; ctx = ctx->next) {
129 FAMMonitorDirectory(fam_conn, ctx->path, &ctx->fr, NULL);
133 static void fam_handler(struct event_context *event_ctx,
134 struct fd_event *fd_event,
138 FAMConnection *fam_conn = (FAMConnection *)private_data;
140 struct fam_watch_context *ctx;
141 struct notify_event ne;
143 if (FAMPending(fam_conn) == 0) {
144 DEBUG(10, ("fam_handler called but nothing pending\n"));
148 if (FAMNextEvent(fam_conn, &fam_event) != 1) {
149 DEBUG(5, ("FAMNextEvent returned an error\n"));
150 TALLOC_FREE(fd_event);
151 fam_reopen(fam_conn, event_ctx, fam_notify_list);
155 DEBUG(10, ("Got FAMCode %d for %s\n", fam_event.code,
156 fam_event.filename));
158 switch (fam_event.code) {
160 ne.action = NOTIFY_ACTION_ADDED;
163 ne.action = NOTIFY_ACTION_REMOVED;
166 DEBUG(10, ("Ignoring code FAMCode %d for file %s\n",
167 (int)fam_event.code, fam_event.filename));
171 for (ctx = fam_notify_list; ctx; ctx = ctx->next) {
172 if (memcmp(&fam_event.fr, &ctx->fr, sizeof(FAMRequest)) == 0) {
178 DEBUG(5, ("Discarding event for file %s\n",
179 fam_event.filename));
183 if ((ne.path = strrchr_m(fam_event.filename, '\\')) == NULL) {
184 ne.path = fam_event.filename;
187 ctx->callback(ctx->sys_ctx, ctx->private_data, &ne);
190 static int fam_watch_context_destructor(struct fam_watch_context *ctx)
192 if (FAMCONNECTION_GETFD(ctx->fam_connection) != -1) {
193 FAMCancelMonitor(&fam_connection, &ctx->fr);
195 DLIST_REMOVE(fam_notify_list, ctx);
200 add a watch. The watch is removed when the caller calls
201 talloc_free() on *handle
203 static NTSTATUS fam_watch(vfs_handle_struct *vfs_handle,
204 struct sys_notify_context *ctx,
205 struct notify_entry *e,
206 void (*callback)(struct sys_notify_context *ctx,
208 struct notify_event *ev),
212 const uint32 fam_mask = (FILE_NOTIFY_CHANGE_FILE_NAME|
213 FILE_NOTIFY_CHANGE_DIR_NAME);
214 struct fam_watch_context *watch;
215 void **handle = (void **)handle_p;
217 if ((e->filter & fam_mask) == 0) {
218 DEBUG(10, ("filter = %u, ignoring in FAM\n", e->filter));
222 if (!fam_connection_initialized) {
223 if (!NT_STATUS_IS_OK(fam_open_connection(&fam_connection,
226 * Just let smbd do all the work itself
230 fam_connection_initialized = True;
233 if (!(watch = TALLOC_P(ctx, struct fam_watch_context))) {
234 return NT_STATUS_NO_MEMORY;
237 watch->fam_connection = &fam_connection;
239 watch->callback = callback;
240 watch->private_data = private_data;
241 watch->sys_ctx = ctx;
243 if (!(watch->path = talloc_strdup(watch, e->path))) {
244 DEBUG(0, ("talloc_asprintf failed\n"));
246 return NT_STATUS_NO_MEMORY;
250 * The FAM module in this early state will only take care of
251 * FAMCreated and FAMDeleted events, Leave the rest to
255 watch->filter = fam_mask;
256 e->filter &= ~fam_mask;
258 DLIST_ADD(fam_notify_list, watch);
259 talloc_set_destructor(watch, fam_watch_context_destructor);
262 * Only directories monitored so far
265 if (FAMCONNECTION_GETFD(watch->fam_connection) != -1) {
266 FAMMonitorDirectory(watch->fam_connection, watch->path,
271 * If the re-open is successful, this will establish the
272 * FAMMonitor from the list
274 fam_reopen(watch->fam_connection, ctx->ev, fam_notify_list);
277 *handle = (void *)watch;
282 /* VFS operations structure */
284 static vfs_op_tuple notify_fam_op_tuples[] = {
286 {SMB_VFS_OP(fam_watch),
287 SMB_VFS_OP_NOTIFY_WATCH,
288 SMB_VFS_LAYER_OPAQUE},
297 NTSTATUS vfs_notify_fam_init(void);
298 NTSTATUS vfs_notify_fam_init(void)
300 return smb_register_vfs(SMB_VFS_INTERFACE_VERSION, "notify_fam",
301 notify_fam_op_tuples);