Blame src/unix/linux-inotify.c

Packit Service 7c31a4
/* Copyright Joyent, Inc. and other Node contributors. All rights reserved.
Packit Service 7c31a4
 * Permission is hereby granted, free of charge, to any person obtaining a copy
Packit Service 7c31a4
 * of this software and associated documentation files (the "Software"), to
Packit Service 7c31a4
 * deal in the Software without restriction, including without limitation the
Packit Service 7c31a4
 * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
Packit Service 7c31a4
 * sell copies of the Software, and to permit persons to whom the Software is
Packit Service 7c31a4
 * furnished to do so, subject to the following conditions:
Packit Service 7c31a4
 *
Packit Service 7c31a4
 * The above copyright notice and this permission notice shall be included in
Packit Service 7c31a4
 * all copies or substantial portions of the Software.
Packit Service 7c31a4
 *
Packit Service 7c31a4
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
Packit Service 7c31a4
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
Packit Service 7c31a4
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
Packit Service 7c31a4
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
Packit Service 7c31a4
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
Packit Service 7c31a4
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
Packit Service 7c31a4
 * IN THE SOFTWARE.
Packit Service 7c31a4
 */
Packit Service 7c31a4
Packit Service 7c31a4
#include "uv.h"
Packit Service 7c31a4
#include "uv/tree.h"
Packit Service 7c31a4
#include "internal.h"
Packit Service 7c31a4
Packit Service 7c31a4
#include <stdint.h>
Packit Service 7c31a4
#include <stdio.h>
Packit Service 7c31a4
#include <stdlib.h>
Packit Service 7c31a4
#include <string.h>
Packit Service 7c31a4
#include <assert.h>
Packit Service 7c31a4
#include <errno.h>
Packit Service 7c31a4
Packit Service 7c31a4
#include <sys/inotify.h>
Packit Service 7c31a4
#include <sys/types.h>
Packit Service 7c31a4
#include <unistd.h>
Packit Service 7c31a4
Packit Service 7c31a4
struct watcher_list {
Packit Service 7c31a4
  RB_ENTRY(watcher_list) entry;
Packit Service 7c31a4
  QUEUE watchers;
Packit Service 7c31a4
  int iterating;
Packit Service 7c31a4
  char* path;
Packit Service 7c31a4
  int wd;
Packit Service 7c31a4
};
Packit Service 7c31a4
Packit Service 7c31a4
struct watcher_root {
Packit Service 7c31a4
  struct watcher_list* rbh_root;
Packit Service 7c31a4
};
Packit Service 7c31a4
#define CAST(p) ((struct watcher_root*)(p))
Packit Service 7c31a4
Packit Service 7c31a4
Packit Service 7c31a4
static int compare_watchers(const struct watcher_list* a,
Packit Service 7c31a4
                            const struct watcher_list* b) {
Packit Service 7c31a4
  if (a->wd < b->wd) return -1;
Packit Service 7c31a4
  if (a->wd > b->wd) return 1;
Packit Service 7c31a4
  return 0;
Packit Service 7c31a4
}
Packit Service 7c31a4
Packit Service 7c31a4
Packit Service 7c31a4
RB_GENERATE_STATIC(watcher_root, watcher_list, entry, compare_watchers)
Packit Service 7c31a4
Packit Service 7c31a4
Packit Service 7c31a4
static void uv__inotify_read(uv_loop_t* loop,
Packit Service 7c31a4
                             uv__io_t* w,
Packit Service 7c31a4
                             unsigned int revents);
Packit Service 7c31a4
Packit Service 7c31a4
static void maybe_free_watcher_list(struct watcher_list* w,
Packit Service 7c31a4
                                    uv_loop_t* loop);
Packit Service 7c31a4
Packit Service 7c31a4
static int init_inotify(uv_loop_t* loop) {
Packit Service 7c31a4
  int fd;
Packit Service 7c31a4
Packit Service 7c31a4
  if (loop->inotify_fd != -1)
Packit Service 7c31a4
    return 0;
Packit Service 7c31a4
Packit Service 7c31a4
  fd = inotify_init1(IN_NONBLOCK | IN_CLOEXEC);
Packit Service 7c31a4
  if (fd < 0)
Packit Service 7c31a4
    return UV__ERR(errno);
Packit Service 7c31a4
Packit Service 7c31a4
  loop->inotify_fd = fd;
Packit Service 7c31a4
  uv__io_init(&loop->inotify_read_watcher, uv__inotify_read, loop->inotify_fd);
Packit Service 7c31a4
  uv__io_start(loop, &loop->inotify_read_watcher, POLLIN);
Packit Service 7c31a4
Packit Service 7c31a4
  return 0;
Packit Service 7c31a4
}
Packit Service 7c31a4
Packit Service 7c31a4
Packit Service 7c31a4
int uv__inotify_fork(uv_loop_t* loop, void* old_watchers) {
Packit Service 7c31a4
  /* Open the inotify_fd, and re-arm all the inotify watchers. */
Packit Service 7c31a4
  int err;
Packit Service 7c31a4
  struct watcher_list* tmp_watcher_list_iter;
Packit Service 7c31a4
  struct watcher_list* watcher_list;
Packit Service 7c31a4
  struct watcher_list tmp_watcher_list;
Packit Service 7c31a4
  QUEUE queue;
Packit Service 7c31a4
  QUEUE* q;
Packit Service 7c31a4
  uv_fs_event_t* handle;
Packit Service 7c31a4
  char* tmp_path;
Packit Service 7c31a4
Packit Service 7c31a4
  if (old_watchers != NULL) {
Packit Service 7c31a4
    /* We must restore the old watcher list to be able to close items
Packit Service 7c31a4
     * out of it.
Packit Service 7c31a4
     */
Packit Service 7c31a4
    loop->inotify_watchers = old_watchers;
Packit Service 7c31a4
Packit Service 7c31a4
    QUEUE_INIT(&tmp_watcher_list.watchers);
Packit Service 7c31a4
    /* Note that the queue we use is shared with the start and stop()
Packit Service 7c31a4
     * functions, making QUEUE_FOREACH unsafe to use. So we use the
Packit Service 7c31a4
     * QUEUE_MOVE trick to safely iterate. Also don't free the watcher
Packit Service 7c31a4
     * list until we're done iterating. c.f. uv__inotify_read.
Packit Service 7c31a4
     */
Packit Service 7c31a4
    RB_FOREACH_SAFE(watcher_list, watcher_root,
Packit Service 7c31a4
                    CAST(&old_watchers), tmp_watcher_list_iter) {
Packit Service 7c31a4
      watcher_list->iterating = 1;
Packit Service 7c31a4
      QUEUE_MOVE(&watcher_list->watchers, &queue);
Packit Service 7c31a4
      while (!QUEUE_EMPTY(&queue)) {
Packit Service 7c31a4
        q = QUEUE_HEAD(&queue);
Packit Service 7c31a4
        handle = QUEUE_DATA(q, uv_fs_event_t, watchers);
Packit Service 7c31a4
        /* It's critical to keep a copy of path here, because it
Packit Service 7c31a4
         * will be set to NULL by stop() and then deallocated by
Packit Service 7c31a4
         * maybe_free_watcher_list
Packit Service 7c31a4
         */
Packit Service 7c31a4
        tmp_path = uv__strdup(handle->path);
Packit Service 7c31a4
        assert(tmp_path != NULL);
Packit Service 7c31a4
        QUEUE_REMOVE(q);
Packit Service 7c31a4
        QUEUE_INSERT_TAIL(&watcher_list->watchers, q);
Packit Service 7c31a4
        uv_fs_event_stop(handle);
Packit Service 7c31a4
Packit Service 7c31a4
        QUEUE_INSERT_TAIL(&tmp_watcher_list.watchers, &handle->watchers);
Packit Service 7c31a4
        handle->path = tmp_path;
Packit Service 7c31a4
      }
Packit Service 7c31a4
      watcher_list->iterating = 0;
Packit Service 7c31a4
      maybe_free_watcher_list(watcher_list, loop);
Packit Service 7c31a4
    }
Packit Service 7c31a4
Packit Service 7c31a4
    QUEUE_MOVE(&tmp_watcher_list.watchers, &queue);
Packit Service 7c31a4
    while (!QUEUE_EMPTY(&queue)) {
Packit Service 7c31a4
        q = QUEUE_HEAD(&queue);
Packit Service 7c31a4
        QUEUE_REMOVE(q);
Packit Service 7c31a4
        handle = QUEUE_DATA(q, uv_fs_event_t, watchers);
Packit Service 7c31a4
        tmp_path = handle->path;
Packit Service 7c31a4
        handle->path = NULL;
Packit Service 7c31a4
        err = uv_fs_event_start(handle, handle->cb, tmp_path, 0);
Packit Service 7c31a4
        uv__free(tmp_path);
Packit Service 7c31a4
        if (err)
Packit Service 7c31a4
          return err;
Packit Service 7c31a4
    }
Packit Service 7c31a4
  }
Packit Service 7c31a4
Packit Service 7c31a4
  return 0;
Packit Service 7c31a4
}
Packit Service 7c31a4
Packit Service 7c31a4
Packit Service 7c31a4
static struct watcher_list* find_watcher(uv_loop_t* loop, int wd) {
Packit Service 7c31a4
  struct watcher_list w;
Packit Service 7c31a4
  w.wd = wd;
Packit Service 7c31a4
  return RB_FIND(watcher_root, CAST(&loop->inotify_watchers), &w);
Packit Service 7c31a4
}
Packit Service 7c31a4
Packit Service 7c31a4
static void maybe_free_watcher_list(struct watcher_list* w, uv_loop_t* loop) {
Packit Service 7c31a4
  /* if the watcher_list->watchers is being iterated over, we can't free it. */
Packit Service 7c31a4
  if ((!w->iterating) && QUEUE_EMPTY(&w->watchers)) {
Packit Service 7c31a4
    /* No watchers left for this path. Clean up. */
Packit Service 7c31a4
    RB_REMOVE(watcher_root, CAST(&loop->inotify_watchers), w);
Packit Service 7c31a4
    inotify_rm_watch(loop->inotify_fd, w->wd);
Packit Service 7c31a4
    uv__free(w);
Packit Service 7c31a4
  }
Packit Service 7c31a4
}
Packit Service 7c31a4
Packit Service 7c31a4
static void uv__inotify_read(uv_loop_t* loop,
Packit Service 7c31a4
                             uv__io_t* dummy,
Packit Service 7c31a4
                             unsigned int events) {
Packit Service 7c31a4
  const struct inotify_event* e;
Packit Service 7c31a4
  struct watcher_list* w;
Packit Service 7c31a4
  uv_fs_event_t* h;
Packit Service 7c31a4
  QUEUE queue;
Packit Service 7c31a4
  QUEUE* q;
Packit Service 7c31a4
  const char* path;
Packit Service 7c31a4
  ssize_t size;
Packit Service 7c31a4
  const char *p;
Packit Service 7c31a4
  /* needs to be large enough for sizeof(inotify_event) + strlen(path) */
Packit Service 7c31a4
  char buf[4096];
Packit Service 7c31a4
Packit Service 7c31a4
  while (1) {
Packit Service 7c31a4
    do
Packit Service 7c31a4
      size = read(loop->inotify_fd, buf, sizeof(buf));
Packit Service 7c31a4
    while (size == -1 && errno == EINTR);
Packit Service 7c31a4
Packit Service 7c31a4
    if (size == -1) {
Packit Service 7c31a4
      assert(errno == EAGAIN || errno == EWOULDBLOCK);
Packit Service 7c31a4
      break;
Packit Service 7c31a4
    }
Packit Service 7c31a4
Packit Service 7c31a4
    assert(size > 0); /* pre-2.6.21 thing, size=0 == read buffer too small */
Packit Service 7c31a4
Packit Service 7c31a4
    /* Now we have one or more inotify_event structs. */
Packit Service 7c31a4
    for (p = buf; p < buf + size; p += sizeof(*e) + e->len) {
Packit Service 7c31a4
      e = (const struct inotify_event*) p;
Packit Service 7c31a4
Packit Service 7c31a4
      events = 0;
Packit Service 7c31a4
      if (e->mask & (IN_ATTRIB|IN_MODIFY))
Packit Service 7c31a4
        events |= UV_CHANGE;
Packit Service 7c31a4
      if (e->mask & ~(IN_ATTRIB|IN_MODIFY))
Packit Service 7c31a4
        events |= UV_RENAME;
Packit Service 7c31a4
Packit Service 7c31a4
      w = find_watcher(loop, e->wd);
Packit Service 7c31a4
      if (w == NULL)
Packit Service 7c31a4
        continue; /* Stale event, no watchers left. */
Packit Service 7c31a4
Packit Service 7c31a4
      /* inotify does not return the filename when monitoring a single file
Packit Service 7c31a4
       * for modifications. Repurpose the filename for API compatibility.
Packit Service 7c31a4
       * I'm not convinced this is a good thing, maybe it should go.
Packit Service 7c31a4
       */
Packit Service 7c31a4
      path = e->len ? (const char*) (e + 1) : uv__basename_r(w->path);
Packit Service 7c31a4
Packit Service 7c31a4
      /* We're about to iterate over the queue and call user's callbacks.
Packit Service 7c31a4
       * What can go wrong?
Packit Service 7c31a4
       * A callback could call uv_fs_event_stop()
Packit Service 7c31a4
       * and the queue can change under our feet.
Packit Service 7c31a4
       * So, we use QUEUE_MOVE() trick to safely iterate over the queue.
Packit Service 7c31a4
       * And we don't free the watcher_list until we're done iterating.
Packit Service 7c31a4
       *
Packit Service 7c31a4
       * First,
Packit Service 7c31a4
       * tell uv_fs_event_stop() (that could be called from a user's callback)
Packit Service 7c31a4
       * not to free watcher_list.
Packit Service 7c31a4
       */
Packit Service 7c31a4
      w->iterating = 1;
Packit Service 7c31a4
      QUEUE_MOVE(&w->watchers, &queue);
Packit Service 7c31a4
      while (!QUEUE_EMPTY(&queue)) {
Packit Service 7c31a4
        q = QUEUE_HEAD(&queue);
Packit Service 7c31a4
        h = QUEUE_DATA(q, uv_fs_event_t, watchers);
Packit Service 7c31a4
Packit Service 7c31a4
        QUEUE_REMOVE(q);
Packit Service 7c31a4
        QUEUE_INSERT_TAIL(&w->watchers, q);
Packit Service 7c31a4
Packit Service 7c31a4
        h->cb(h, path, events, 0);
Packit Service 7c31a4
      }
Packit Service 7c31a4
      /* done iterating, time to (maybe) free empty watcher_list */
Packit Service 7c31a4
      w->iterating = 0;
Packit Service 7c31a4
      maybe_free_watcher_list(w, loop);
Packit Service 7c31a4
    }
Packit Service 7c31a4
  }
Packit Service 7c31a4
}
Packit Service 7c31a4
Packit Service 7c31a4
Packit Service 7c31a4
int uv_fs_event_init(uv_loop_t* loop, uv_fs_event_t* handle) {
Packit Service 7c31a4
  uv__handle_init(loop, (uv_handle_t*)handle, UV_FS_EVENT);
Packit Service 7c31a4
  return 0;
Packit Service 7c31a4
}
Packit Service 7c31a4
Packit Service 7c31a4
Packit Service 7c31a4
int uv_fs_event_start(uv_fs_event_t* handle,
Packit Service 7c31a4
                      uv_fs_event_cb cb,
Packit Service 7c31a4
                      const char* path,
Packit Service 7c31a4
                      unsigned int flags) {
Packit Service 7c31a4
  struct watcher_list* w;
Packit Service 7c31a4
  size_t len;
Packit Service 7c31a4
  int events;
Packit Service 7c31a4
  int err;
Packit Service 7c31a4
  int wd;
Packit Service 7c31a4
Packit Service 7c31a4
  if (uv__is_active(handle))
Packit Service 7c31a4
    return UV_EINVAL;
Packit Service 7c31a4
Packit Service 7c31a4
  err = init_inotify(handle->loop);
Packit Service 7c31a4
  if (err)
Packit Service 7c31a4
    return err;
Packit Service 7c31a4
Packit Service 7c31a4
  events = IN_ATTRIB
Packit Service 7c31a4
         | IN_CREATE
Packit Service 7c31a4
         | IN_MODIFY
Packit Service 7c31a4
         | IN_DELETE
Packit Service 7c31a4
         | IN_DELETE_SELF
Packit Service 7c31a4
         | IN_MOVE_SELF
Packit Service 7c31a4
         | IN_MOVED_FROM
Packit Service 7c31a4
         | IN_MOVED_TO;
Packit Service 7c31a4
Packit Service 7c31a4
  wd = inotify_add_watch(handle->loop->inotify_fd, path, events);
Packit Service 7c31a4
  if (wd == -1)
Packit Service 7c31a4
    return UV__ERR(errno);
Packit Service 7c31a4
Packit Service 7c31a4
  w = find_watcher(handle->loop, wd);
Packit Service 7c31a4
  if (w)
Packit Service 7c31a4
    goto no_insert;
Packit Service 7c31a4
Packit Service 7c31a4
  len = strlen(path) + 1;
Packit Service 7c31a4
  w = uv__malloc(sizeof(*w) + len);
Packit Service 7c31a4
  if (w == NULL)
Packit Service 7c31a4
    return UV_ENOMEM;
Packit Service 7c31a4
Packit Service 7c31a4
  w->wd = wd;
Packit Service 7c31a4
  w->path = memcpy(w + 1, path, len);
Packit Service 7c31a4
  QUEUE_INIT(&w->watchers);
Packit Service 7c31a4
  w->iterating = 0;
Packit Service 7c31a4
  RB_INSERT(watcher_root, CAST(&handle->loop->inotify_watchers), w);
Packit Service 7c31a4
Packit Service 7c31a4
no_insert:
Packit Service 7c31a4
  uv__handle_start(handle);
Packit Service 7c31a4
  QUEUE_INSERT_TAIL(&w->watchers, &handle->watchers);
Packit Service 7c31a4
  handle->path = w->path;
Packit Service 7c31a4
  handle->cb = cb;
Packit Service 7c31a4
  handle->wd = wd;
Packit Service 7c31a4
Packit Service 7c31a4
  return 0;
Packit Service 7c31a4
}
Packit Service 7c31a4
Packit Service 7c31a4
Packit Service 7c31a4
int uv_fs_event_stop(uv_fs_event_t* handle) {
Packit Service 7c31a4
  struct watcher_list* w;
Packit Service 7c31a4
Packit Service 7c31a4
  if (!uv__is_active(handle))
Packit Service 7c31a4
    return 0;
Packit Service 7c31a4
Packit Service 7c31a4
  w = find_watcher(handle->loop, handle->wd);
Packit Service 7c31a4
  assert(w != NULL);
Packit Service 7c31a4
Packit Service 7c31a4
  handle->wd = -1;
Packit Service 7c31a4
  handle->path = NULL;
Packit Service 7c31a4
  uv__handle_stop(handle);
Packit Service 7c31a4
  QUEUE_REMOVE(&handle->watchers);
Packit Service 7c31a4
Packit Service 7c31a4
  maybe_free_watcher_list(w, handle->loop);
Packit Service 7c31a4
Packit Service 7c31a4
  return 0;
Packit Service 7c31a4
}
Packit Service 7c31a4
Packit Service 7c31a4
Packit Service 7c31a4
void uv__fs_event_close(uv_fs_event_t* handle) {
Packit Service 7c31a4
  uv_fs_event_stop(handle);
Packit Service 7c31a4
}