Whamcloud - gitweb
LU-1346 libcfs: cleanup libcfs primitive (linux-prim.h)
[fs/lustre-release.git] / libcfs / include / libcfs / user-prim.h
1 /*
2  * GPL HEADER START
3  *
4  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License version 2 only,
8  * as published by the Free Software Foundation.
9  *
10  * This program is distributed in the hope that it will be useful, but
11  * WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * General Public License version 2 for more details (a copy is included
14  * in the LICENSE file that accompanied this code).
15  *
16  * You should have received a copy of the GNU General Public License
17  * version 2 along with this program; If not, see
18  * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
19  *
20  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
21  * CA 95054 USA or visit www.sun.com if you need additional information or
22  * have any questions.
23  *
24  * GPL HEADER END
25  */
26 /*
27  * Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
28  * Use is subject to license terms.
29  *
30  * Copyright (c) 2012, Intel Corporation.
31  */
32 /*
33  * This file is part of Lustre, http://www.lustre.org/
34  * Lustre is a trademark of Sun Microsystems, Inc.
35  *
36  * libcfs/include/libcfs/user-prim.h
37  *
38  * Author: Nikita Danilov <nikita@clusterfs.com>
39  */
40
41 #ifndef __LIBCFS_USER_PRIM_H__
42 #define __LIBCFS_USER_PRIM_H__
43
44 #ifndef __LIBCFS_LIBCFS_H__
45 #error Do not #include this file directly. #include <libcfs/libcfs.h> instead
46 #endif
47
48 /* Implementations of portable APIs for liblustre */
49
50 /*
51  * liblustre is single-threaded, so most "synchronization" APIs are trivial.
52  */
53
54 #ifndef EXPORT_SYMBOL
55 # define EXPORT_SYMBOL(s)
56 #endif
57
58 #ifndef __KERNEL__
59
60 typedef struct proc_dir_entry           cfs_proc_dir_entry_t;
61
62 /*
63  * Just present a single processor until will add thread support.
64  */
65 #ifndef smp_processor_id
66 # define smp_processor_id() 0
67 #endif
68 #ifndef num_online_cpus
69 # define num_online_cpus() 1
70 #endif
71 #ifndef num_possible_cpus
72 # define num_possible_cpus() 1
73 #endif
74 /*
75  * Wait Queue.
76  */
77
78 typedef struct cfs_waitlink {
79         cfs_list_t sleeping;
80         void *process;
81 } wait_queue_t;
82
83 typedef struct cfs_waitq {
84         cfs_list_t sleepers;
85 } wait_queue_head_t;
86
87 #define CFS_DECL_WAITQ(wq) wait_queue_head_t wq
88 void init_waitqueue_head(struct cfs_waitq *waitq);
89 void init_waitqueue_entry_current(struct cfs_waitlink *link);
90 void add_wait_queue(struct cfs_waitq *waitq, struct cfs_waitlink *link);
91 void add_wait_queue_exclusive(struct cfs_waitq *waitq, struct cfs_waitlink *link);
92 void add_wait_queue_exclusive_head(struct cfs_waitq *waitq, struct cfs_waitlink *link);
93 void remove_wait_queue(struct cfs_waitq *waitq, struct cfs_waitlink *link);
94 int waitqueue_active(struct cfs_waitq *waitq);
95 void wake_up(struct cfs_waitq *waitq);
96 void wake_up_nr(struct cfs_waitq *waitq, int nr);
97 void wake_up_all(struct cfs_waitq *waitq);
98 void waitq_wait(struct cfs_waitlink *link, long state);
99 int64_t waitq_timedwait(struct cfs_waitlink *link, long state, int64_t timeout);
100 void schedule_timeout_and_set_state(long state, int64_t timeout);
101 void cfs_pause(cfs_duration_t d);
102 int need_resched(void);
103 void cond_resched(void);
104
105 /*
106  * Task states
107  */
108 #define TASK_INTERRUPTIBLE  (0)
109 #define TASK_UNINTERRUPTIBLE          (1)
110 #define TASK_RUNNING        (2)
111
112 static inline void schedule(void)                       {}
113 static inline void schedule_timeout(int64_t t)  {}
114
115 /*
116  * Lproc
117  */
118 typedef int (cfs_read_proc_t)(char *page, char **start, off_t off,
119                           int count, int *eof, void *data);
120
121 struct file; /* forward ref */
122 typedef int (cfs_write_proc_t)(struct file *file, const char *buffer,
123                                unsigned long count, void *data);
124
125 /*
126  * Signal
127  */
128
129 /*
130  * Timer
131  */
132
133 struct timer_list {
134         cfs_list_t tl_list;
135         void (*function)(ulong_ptr_t unused);
136         ulong_ptr_t data;
137         long expires;
138 };
139
140
141 #define in_interrupt()    (0)
142
143 struct miscdevice{
144 };
145
146 static inline int misc_register(struct miscdevice *foo)
147 {
148         return 0;
149 }
150
151 static inline int misc_deregister(struct miscdevice *foo)
152 {
153         return 0;
154 }
155
156 #define cfs_sigfillset(l)               do {} while (0)
157 #define cfs_recalc_sigpending(l)        do {} while (0)
158
159 #define DAEMON_FLAGS                0
160
161 #define L1_CACHE_ALIGN(x)               (x)
162
163 #ifdef HAVE_LIBPTHREAD
164 typedef int (*cfs_thread_t)(void *);
165 void *kthread_run(cfs_thread_t func, void *arg, const char namefmt[], ...);
166 #else
167 /* Fine, crash, but stop giving me compile warnings */
168 #define kthread_run(f, a, n, ...) LBUG()
169 #endif
170
171 uid_t current_uid(void);
172 gid_t current_gid(void);
173 uid_t current_fsuid(void);
174 gid_t current_fsgid(void);
175
176 #ifndef HAVE_STRLCPY /* not in glibc for RHEL 5.x, remove when obsolete */
177 size_t strlcpy(char *tgt, const char *src, size_t tgt_len);
178 #endif
179
180 #ifndef HAVE_STRLCAT /* not in glibc for RHEL 5.x, remove when obsolete */
181 size_t strlcat(char *tgt, const char *src, size_t tgt_len);
182 #endif
183
184 #define LIBCFS_REALLOC(ptr, size) realloc(ptr, size)
185
186 #define cfs_online_cpus() sysconf(_SC_NPROCESSORS_ONLN)
187
188 // static inline void local_irq_save(unsigned long flag) {return;}
189 // static inline void local_irq_restore(unsigned long flag) {return;}
190
191 enum {
192         CFS_STACK_TRACE_DEPTH = 16
193 };
194
195 struct cfs_stack_trace {
196         void *frame[CFS_STACK_TRACE_DEPTH];
197 };
198
199 /*
200  * arithmetic
201  */
202 #ifndef do_div /* gcc only, platform-specific will override */
203 #define do_div(a,b)                     \
204         ({                              \
205                 unsigned long remainder;\
206                 remainder = (a) % (b);  \
207                 (a) = (a) / (b);        \
208                 (remainder);            \
209         })
210 #endif
211
212 /*
213  * Groups
214  */
215 struct group_info{ };
216
217 #ifndef min
218 # define min(x,y) ((x)<(y) ? (x) : (y))
219 #endif
220
221 #ifndef max
222 # define max(x,y) ((x)>(y) ? (x) : (y))
223 #endif
224
225 #define get_random_bytes(val, size)     (*val) = 0
226
227 /* utility libcfs init/fini entries */
228 #ifdef __WINNT__
229 extern int libcfs_arch_init(void);
230 extern void libcfs_arch_cleanup(void);
231 #else /* !__WINNT__ */
232 static inline int libcfs_arch_init(void) {
233         return 0;
234 }
235 static inline void libcfs_arch_cleanup(void) {
236 }
237 /* __WINNT__ */
238 #endif
239
240 /* proc interface wrappers for non-win OS */
241 #ifndef __WINNT__
242 #define cfs_proc_open   open
243 #define cfs_proc_mknod  mknod
244 #define cfs_proc_ioctl  ioctl
245 #define cfs_proc_close  close
246 #define cfs_proc_read   read
247 #define cfs_proc_write  write
248 #define cfs_proc_fopen  fopen
249 #define cfs_proc_fclose fclose
250 #define cfs_proc_fgets  fgets
251 /* !__WINNT__ */
252 #endif
253
254 /* !__KERNEL__ */
255 #endif
256
257 /* __LIBCFS_USER_PRIM_H__ */
258 #endif
259 /*
260  * Local variables:
261  * c-indentation-style: "K&R"
262  * c-basic-offset: 8
263  * tab-width: 8
264  * fill-column: 80
265  * scroll-step: 1
266  * End:
267  */