2 Unix SMB/CIFS implementation.
4 Copyright (C) Andrew Tridgell 2000
5 Copyright (C) Jeremy Allison 1994-1998
6 Copyright (C) Volker Lendecke 2007
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>.
23 #include "smbd/smbd.h"
24 #include "smbd/globals.h"
25 #include "../librpc/gen_ndr/ndr_notify.h"
27 struct notify_change_event {
33 struct notify_change_buf {
35 * If no requests are pending, changes are queued here. Simple array,
40 * num_changes == -1 means that we have got a catch-all change, when
41 * asked we just return NT_STATUS_OK without specific changes.
44 struct notify_change_event *changes;
47 * If no changes are around requests are queued here. Using a linked
48 * list, because we have to append at the end and delete from the top.
50 struct notify_change_request *requests;
53 struct notify_change_request {
54 struct notify_change_request *prev, *next;
55 struct files_struct *fsp; /* backpointer for cancel by mid */
56 struct smb_request *req;
59 void (*reply_fn)(struct smb_request *req,
61 uint8_t *buf, size_t len);
62 struct notify_mid_map *mid_map;
66 static void notify_fsp(files_struct *fsp, struct timespec when,
67 uint32 action, const char *name);
69 bool change_notify_fsp_has_changes(struct files_struct *fsp)
75 if (fsp->notify == NULL) {
79 if (fsp->notify->num_changes == 0) {
87 * For NTCancel, we need to find the notify_change_request indexed by
88 * mid. Separate list here.
91 struct notify_mid_map {
92 struct notify_mid_map *prev, *next;
93 struct notify_change_request *req;
97 static bool notify_change_record_identical(struct notify_change_event *c1,
98 struct notify_change_event *c2)
100 /* Note this is deliberately case sensitive. */
101 if (c1->action == c2->action &&
102 strcmp(c1->name, c2->name) == 0) {
108 static bool notify_marshall_changes(int num_changes,
110 struct notify_change_event *changes,
111 DATA_BLOB *final_blob)
115 if (num_changes == -1) {
119 for (i=0; i<num_changes; i++) {
120 enum ndr_err_code ndr_err;
121 struct notify_change_event *c;
122 struct FILE_NOTIFY_INFORMATION m;
125 /* Coalesce any identical records. */
126 while (i+1 < num_changes &&
127 notify_change_record_identical(&changes[i],
134 m.FileName1 = c->name;
135 m.FileNameLength = strlen_m(c->name)*2;
136 m.Action = c->action;
137 m.NextEntryOffset = (i == num_changes-1) ? 0 : ndr_size_FILE_NOTIFY_INFORMATION(&m, 0);
140 * Offset to next entry, only if there is one
143 ndr_err = ndr_push_struct_blob(&blob, talloc_tos(), &m,
144 (ndr_push_flags_fn_t)ndr_push_FILE_NOTIFY_INFORMATION);
145 if (!NDR_ERR_CODE_IS_SUCCESS(ndr_err)) {
149 if (DEBUGLEVEL >= 10) {
150 NDR_PRINT_DEBUG(FILE_NOTIFY_INFORMATION, &m);
153 if (!data_blob_append(talloc_tos(), final_blob,
154 blob.data, blob.length)) {
155 data_blob_free(&blob);
159 data_blob_free(&blob);
161 if (final_blob->length > max_offset) {
162 /* Too much data for client. */
163 DEBUG(10, ("Client only wanted %d bytes, trying to "
164 "marshall %d bytes\n", (int)max_offset,
165 (int)final_blob->length));
173 /****************************************************************************
174 Setup the common parts of the return packet and send it.
175 *****************************************************************************/
177 void change_notify_reply(struct smb_request *req,
180 struct notify_change_buf *notify_buf,
181 void (*reply_fn)(struct smb_request *req,
183 uint8_t *buf, size_t len))
185 DATA_BLOB blob = data_blob_null;
187 if (!NT_STATUS_IS_OK(error_code)) {
188 reply_fn(req, error_code, NULL, 0);
192 if (max_param == 0 || notify_buf == NULL) {
193 reply_fn(req, NT_STATUS_OK, NULL, 0);
197 if (!notify_marshall_changes(notify_buf->num_changes, max_param,
198 notify_buf->changes, &blob)) {
200 * We exceed what the client is willing to accept. Send
203 data_blob_free(&blob);
206 reply_fn(req, NT_STATUS_OK, blob.data, blob.length);
208 data_blob_free(&blob);
210 TALLOC_FREE(notify_buf->changes);
211 notify_buf->num_changes = 0;
214 static void notify_callback(void *private_data, const struct notify_event *e)
216 files_struct *fsp = (files_struct *)private_data;
217 DEBUG(10, ("notify_callback called for %s\n", fsp_str_dbg(fsp)));
218 notify_fsp(fsp, timespec_current(), e->action, e->path);
221 static void sys_notify_callback(struct sys_notify_context *ctx,
223 struct notify_event *e)
225 files_struct *fsp = (files_struct *)private_data;
226 DEBUG(10, ("sys_notify_callback called for %s\n", fsp_str_dbg(fsp)));
227 notify_fsp(fsp, timespec_current(), e->action, e->path);
230 NTSTATUS change_notify_create(struct files_struct *fsp, uint32 filter,
235 uint32_t subdir_filter;
236 NTSTATUS status = NT_STATUS_NOT_IMPLEMENTED;
238 if (fsp->notify != NULL) {
239 DEBUG(1, ("change_notify_create: fsp->notify != NULL, "
240 "fname = %s\n", fsp->fsp_name->base_name));
241 return NT_STATUS_INVALID_PARAMETER;
244 if (!(fsp->notify = talloc_zero(NULL, struct notify_change_buf))) {
245 DEBUG(0, ("talloc failed\n"));
246 return NT_STATUS_NO_MEMORY;
249 /* Do notify operations on the base_name. */
250 fullpath = talloc_asprintf(
251 talloc_tos(), "%s/%s", fsp->conn->connectpath,
252 fsp->fsp_name->base_name);
253 if (fullpath == NULL) {
254 DEBUG(0, ("talloc_asprintf failed\n"));
255 TALLOC_FREE(fsp->notify);
256 return NT_STATUS_NO_MEMORY;
260 * Avoid /. at the end of the path name. notify can't deal with it.
262 len = strlen(fullpath);
263 if (len > 1 && fullpath[len-1] == '.' && fullpath[len-2] == '/') {
264 fullpath[len-2] = '\0';
267 subdir_filter = recursive ? filter : 0;
269 if (fsp->conn->sconn->sys_notify_ctx != NULL) {
270 void *sys_notify_handle = NULL;
272 status = SMB_VFS_NOTIFY_WATCH(
273 fsp->conn, fsp->conn->sconn->sys_notify_ctx,
274 fullpath, &filter, &subdir_filter,
275 sys_notify_callback, fsp, &sys_notify_handle);
277 if (NT_STATUS_IS_OK(status)) {
278 talloc_steal(fsp->notify, sys_notify_handle);
282 if ((filter != 0) || (subdir_filter != 0)) {
283 status = notify_add(fsp->conn->sconn->notify_ctx,
284 fullpath, filter, subdir_filter,
285 notify_callback, fsp);
287 TALLOC_FREE(fullpath);
291 NTSTATUS change_notify_add_request(struct smb_request *req,
293 uint32 filter, bool recursive,
294 struct files_struct *fsp,
295 void (*reply_fn)(struct smb_request *req,
297 uint8_t *buf, size_t len))
299 struct notify_change_request *request = NULL;
300 struct notify_mid_map *map = NULL;
301 struct smbd_server_connection *sconn = req->sconn;
303 DEBUG(10, ("change_notify_add_request: Adding request for %s: "
304 "max_param = %d\n", fsp_str_dbg(fsp), (int)max_param));
306 if (!(request = talloc(NULL, struct notify_change_request))
307 || !(map = talloc(request, struct notify_mid_map))) {
308 TALLOC_FREE(request);
309 return NT_STATUS_NO_MEMORY;
312 request->mid_map = map;
315 request->req = talloc_move(request, &req);
316 request->max_param = max_param;
317 request->filter = filter;
319 request->reply_fn = reply_fn;
320 request->backend_data = NULL;
322 DLIST_ADD_END(fsp->notify->requests, request,
323 struct notify_change_request *);
325 map->mid = request->req->mid;
326 DLIST_ADD(sconn->smb1.notify_mid_maps, map);
331 static void change_notify_remove_request(struct smbd_server_connection *sconn,
332 struct notify_change_request *remove_req)
335 struct notify_change_request *req;
338 * Paranoia checks, the fsp referenced must must have the request in
339 * its list of pending requests
342 fsp = remove_req->fsp;
343 SMB_ASSERT(fsp->notify != NULL);
345 for (req = fsp->notify->requests; req; req = req->next) {
346 if (req == remove_req) {
352 smb_panic("notify_req not found in fsp's requests");
355 DLIST_REMOVE(fsp->notify->requests, req);
356 DLIST_REMOVE(sconn->smb1.notify_mid_maps, req->mid_map);
360 /****************************************************************************
361 Delete entries by mid from the change notify pending queue. Always send reply.
362 *****************************************************************************/
364 void remove_pending_change_notify_requests_by_mid(
365 struct smbd_server_connection *sconn, uint64_t mid)
367 struct notify_mid_map *map;
369 for (map = sconn->smb1.notify_mid_maps; map; map = map->next) {
370 if (map->mid == mid) {
379 change_notify_reply(map->req->req,
380 NT_STATUS_CANCELLED, 0, NULL, map->req->reply_fn);
381 change_notify_remove_request(sconn, map->req);
384 void smbd_notify_cancel_by_smbreq(const struct smb_request *smbreq)
386 struct smbd_server_connection *sconn = smbreq->sconn;
387 struct notify_mid_map *map;
389 for (map = sconn->smb1.notify_mid_maps; map; map = map->next) {
390 if (map->req->req == smbreq) {
399 change_notify_reply(map->req->req,
400 NT_STATUS_CANCELLED, 0, NULL, map->req->reply_fn);
401 change_notify_remove_request(sconn, map->req);
404 /****************************************************************************
405 Delete entries by fnum from the change notify pending queue.
406 *****************************************************************************/
408 void remove_pending_change_notify_requests_by_fid(files_struct *fsp,
411 if (fsp->notify == NULL) {
415 while (fsp->notify->requests != NULL) {
416 change_notify_reply(fsp->notify->requests->req,
418 fsp->notify->requests->reply_fn);
419 change_notify_remove_request(fsp->conn->sconn,
420 fsp->notify->requests);
424 void notify_fname(connection_struct *conn, uint32 action, uint32 filter,
427 struct notify_context *notify_ctx = conn->sconn->notify_ctx;
428 char *fullpath, *to_free;
429 char tmpbuf[PATH_MAX];
432 if (path[0] == '.' && path[1] == '/') {
435 len = full_path_tos(conn->connectpath, path, tmpbuf, sizeof(tmpbuf),
436 &fullpath, &to_free);
438 DEBUG(0, ("full_path_tos failed\n"));
441 notify_trigger(notify_ctx, action, filter, fullpath);
442 TALLOC_FREE(to_free);
445 static void notify_fsp(files_struct *fsp, struct timespec when,
446 uint32 action, const char *name)
448 struct notify_change_event *change, *changes;
451 if (fsp->notify == NULL) {
453 * Nobody is waiting, don't queue
459 * Someone has triggered a notify previously, queue the change for
463 if ((fsp->notify->num_changes > 1000) || (name == NULL)) {
465 * The real number depends on the client buf, just provide a
466 * guard against a DoS here. If name == NULL the CN backend is
467 * alerting us to a problem. Possibly dropped events. Clear
468 * queued changes and send the catch-all response to the client
469 * if a request is pending.
471 TALLOC_FREE(fsp->notify->changes);
472 fsp->notify->num_changes = -1;
473 if (fsp->notify->requests != NULL) {
474 change_notify_reply(fsp->notify->requests->req,
476 fsp->notify->requests->max_param,
478 fsp->notify->requests->reply_fn);
479 change_notify_remove_request(fsp->conn->sconn,
480 fsp->notify->requests);
485 /* If we've exceeded the server side queue or received a NULL name
486 * from the underlying CN implementation, don't queue up any more
487 * requests until we can send a catch-all response to the client */
488 if (fsp->notify->num_changes == -1) {
492 if (!(changes = talloc_realloc(
493 fsp->notify, fsp->notify->changes,
494 struct notify_change_event,
495 fsp->notify->num_changes+1))) {
496 DEBUG(0, ("talloc_realloc failed\n"));
500 fsp->notify->changes = changes;
502 change = &(fsp->notify->changes[fsp->notify->num_changes]);
504 if (!(tmp = talloc_strdup(changes, name))) {
505 DEBUG(0, ("talloc_strdup failed\n"));
509 string_replace(tmp, '/', '\\');
513 change->action = action;
514 fsp->notify->num_changes += 1;
516 if (fsp->notify->requests == NULL) {
518 * Nobody is waiting, so don't send anything. The ot
523 if (action == NOTIFY_ACTION_OLD_NAME) {
525 * We have to send the two rename events in one reply. So hold
526 * the first part back.
532 * Someone is waiting for the change, trigger the reply immediately.
534 * TODO: do we have to walk the lists of requests pending?
537 change_notify_reply(fsp->notify->requests->req,
539 fsp->notify->requests->max_param,
541 fsp->notify->requests->reply_fn);
543 change_notify_remove_request(fsp->conn->sconn, fsp->notify->requests);
546 char *notify_filter_string(TALLOC_CTX *mem_ctx, uint32 filter)
550 result = talloc_strdup(mem_ctx, "");
552 if (filter & FILE_NOTIFY_CHANGE_FILE_NAME)
553 result = talloc_asprintf_append(result, "FILE_NAME|");
554 if (filter & FILE_NOTIFY_CHANGE_DIR_NAME)
555 result = talloc_asprintf_append(result, "DIR_NAME|");
556 if (filter & FILE_NOTIFY_CHANGE_ATTRIBUTES)
557 result = talloc_asprintf_append(result, "ATTRIBUTES|");
558 if (filter & FILE_NOTIFY_CHANGE_SIZE)
559 result = talloc_asprintf_append(result, "SIZE|");
560 if (filter & FILE_NOTIFY_CHANGE_LAST_WRITE)
561 result = talloc_asprintf_append(result, "LAST_WRITE|");
562 if (filter & FILE_NOTIFY_CHANGE_LAST_ACCESS)
563 result = talloc_asprintf_append(result, "LAST_ACCESS|");
564 if (filter & FILE_NOTIFY_CHANGE_CREATION)
565 result = talloc_asprintf_append(result, "CREATION|");
566 if (filter & FILE_NOTIFY_CHANGE_EA)
567 result = talloc_asprintf_append(result, "EA|");
568 if (filter & FILE_NOTIFY_CHANGE_SECURITY)
569 result = talloc_asprintf_append(result, "SECURITY|");
570 if (filter & FILE_NOTIFY_CHANGE_STREAM_NAME)
571 result = talloc_asprintf_append(result, "STREAM_NAME|");
572 if (filter & FILE_NOTIFY_CHANGE_STREAM_SIZE)
573 result = talloc_asprintf_append(result, "STREAM_SIZE|");
574 if (filter & FILE_NOTIFY_CHANGE_STREAM_WRITE)
575 result = talloc_asprintf_append(result, "STREAM_WRITE|");
577 if (result == NULL) return NULL;
578 if (*result == '\0') return result;
580 result[strlen(result)-1] = '\0';
584 struct sys_notify_context *sys_notify_context_create(TALLOC_CTX *mem_ctx,
585 struct tevent_context *ev)
587 struct sys_notify_context *ctx;
589 if (!(ctx = talloc(mem_ctx, struct sys_notify_context))) {
590 DEBUG(0, ("talloc failed\n"));
595 ctx->private_data = NULL;