Linux file watcher: do not dive into flat 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 // logging
25 void userlog(int priority, const char* format, ...);
26
27 #define CHECK_NULL(p, r) if (p == NULL)  { userlog(LOG_ERR, "out of memory"); return r; }
28
29
30 // variable-length array
31 typedef struct __array array;
32
33 array* array_create(int initial_capacity);
34 int array_size(array* a);
35 void* array_push(array* a, void* element);
36 void* array_pop(array* a);
37 void array_put(array* a, int index, void* element);
38 void* array_get(array* a, int index);
39 void array_delete(array* a);
40 void array_delete_vs_data(array* a);
41
42
43 // poor man's hash table
44 typedef struct __table table;
45
46 table* table_create(int capacity);
47 void* table_put(table* t, int key, void* value);
48 void* table_get(table* t, int key);
49 void table_delete(table* t);
50
51
52 // inotify subsystem
53 enum {
54   ERR_IGNORE = -1,
55   ERR_CONTINUE = -2,
56   ERR_ABORT = -3
57 };
58
59 bool init_inotify();
60 void set_inotify_callback(void (* callback)(char*, int));
61 int get_inotify_fd();
62 int get_watch_count();
63 bool watch_limit_reached();
64 int watch(const char* root, array* ignores);
65 void unwatch(int id);
66 bool process_inotify_input();
67 void close_inotify();
68
69
70 // reads one line from stream, trims trailing carriage return if any
71 // returns pointer to the internal buffer (will be overwriten on next call)
72 char* read_line(FILE* stream);
73
74 #endif