Linux file watcher: poll for missing roots
[idea/community.git] / native / fsNotifier / linux / fsnotifier.h
1 /*
2  * Copyright 2000-2012 JetBrains s.r.o.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16
17 #ifndef __FSNOTIFIER_H
18 #define __FSNOTIFIER_H
19
20 #include <stdbool.h>
21 #include <stdio.h>
22
23
24 // messaging
25 typedef enum {
26   MSG_INSTANCE_LIMIT, MSG_WATCH_LIMIT
27 } MSG;
28
29 void message(MSG id);
30
31
32 // logging
33 void userlog(int priority, const char* format, ...);
34
35 #define CHECK_NULL(p, r) if (p == NULL)  { userlog(LOG_ERR, "out of memory"); return r; }
36
37
38 // variable-length array
39 typedef struct __array array;
40
41 array* array_create(int initial_capacity);
42 int array_size(array* a);
43 void* array_push(array* a, void* element);
44 void* array_pop(array* a);
45 void array_put(array* a, int index, void* element);
46 void* array_get(array* a, int index);
47 void array_delete(array* a);
48 void array_delete_vs_data(array* a);
49 void array_delete_data(array* a);
50
51
52 // poor man's hash table
53 typedef struct __table table;
54
55 table* table_create(int capacity);
56 void* table_put(table* t, int key, void* value);
57 void* table_get(table* t, int key);
58 void table_delete(table* t);
59
60
61 // inotify subsystem
62 enum {
63   ERR_IGNORE = -1,
64   ERR_CONTINUE = -2,
65   ERR_ABORT = -3,
66   ERR_MISSING = -4
67 };
68
69 bool init_inotify();
70 void set_inotify_callback(void (* callback)(char*, int));
71 int get_inotify_fd();
72 int watch(const char* root, array* mounts);
73 void unwatch(int id);
74 bool process_inotify_input();
75 void close_inotify();
76
77
78 // reads one line from stream, trims trailing carriage return if any
79 // returns pointer to the internal buffer (will be overwritten on next call)
80 char* read_line(FILE* stream);
81
82
83 // path comparison
84 bool is_parent_path(const char* parent_path, const char* child_path);
85
86
87 #endif