4 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
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.
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).
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
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
27 * Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
28 * Use is subject to license terms.
30 * Copyright (c) 2012, Intel Corporation.
33 * This file is part of Lustre, http://www.lustre.org/
34 * Lustre is a trademark of Sun Microsystems, Inc.
36 * libcfs/include/libcfs/linux/linux-prim.h
38 * Basic library routines.
41 #ifndef __LIBCFS_LINUX_CFS_PRIM_H__
42 #define __LIBCFS_LINUX_CFS_PRIM_H__
44 #ifndef __LIBCFS_LIBCFS_H__
45 #error Do not #include this file directly. #include <libcfs/libcfs.h> instead
49 #error This include is only for kernel use.
52 #include <linux/module.h>
53 #include <linux/init.h>
54 #include <linux/kernel.h>
55 #include <linux/version.h>
56 #include <linux/proc_fs.h>
58 #include <linux/timer.h>
59 #include <linux/signal.h>
60 #include <linux/sched.h>
61 #include <linux/kthread.h>
62 #ifdef HAVE_LINUX_RANDOM_H
63 #include <linux/random.h>
65 #ifdef HAVE_UIDGID_HEADER
66 #include <linux/uidgid.h>
68 #include <linux/user_namespace.h>
69 #include <linux/miscdevice.h>
70 #include <libcfs/linux/portals_compat25.h>
71 #include <asm/div64.h>
73 #include <libcfs/linux/linux-time.h>
79 #ifdef for_each_possible_cpu
80 #define cfs_for_each_possible_cpu(cpu) for_each_possible_cpu(cpu)
81 #elif defined(for_each_cpu)
82 #define cfs_for_each_possible_cpu(cpu) for_each_cpu(cpu)
89 #define DECLARE_PROC_HANDLER(name) \
93 return proc_call_handler(table->data, write, \
99 * Proc file system APIs
101 typedef struct proc_dir_entry cfs_proc_dir_entry_t;
102 #define cfs_create_proc_entry(n, m, p) create_proc_entry(n, m, p)
103 #define cfs_free_proc_entry(e) free_proc_entry(e)
104 #define cfs_remove_proc_entry(n, e) remove_proc_entry(n, e)
111 #define CFS_DECL_WAITQ(wq) DECLARE_WAIT_QUEUE_HEAD(wq)
113 #define LIBCFS_WQITQ_MACROS 1
114 #define init_waitqueue_entry_current(w) init_waitqueue_entry(w, current)
115 #define waitq_wait(w, s) schedule()
116 #define waitq_timedwait(w, s, t) schedule_timeout(t)
118 #ifndef HAVE___ADD_WAIT_QUEUE_EXCLUSIVE
119 static inline void __add_wait_queue_exclusive(wait_queue_head_t *q,
122 wait->flags |= WQ_FLAG_EXCLUSIVE;
123 __add_wait_queue(q, wait);
125 #endif /* HAVE___ADD_WAIT_QUEUE_EXCLUSIVE */
128 * wait_queue_t of Linux (version < 2.6.34) is a FIFO list for exclusively
129 * waiting threads, which is not always desirable because all threads will
130 * be waken up again and again, even user only needs a few of them to be
131 * active most time. This is not good for performance because cache can
132 * be polluted by different threads.
134 * LIFO list can resolve this problem because we always wakeup the most
135 * recent active thread by default.
137 * NB: please don't call non-exclusive & exclusive wait on the same
138 * waitq if add_wait_queue_exclusive_head is used.
140 #define add_wait_queue_exclusive_head(waitq, link) \
142 unsigned long flags; \
144 spin_lock_irqsave(&((waitq)->lock), flags); \
145 __add_wait_queue_exclusive(waitq, link); \
146 spin_unlock_irqrestore(&((waitq)->lock), flags); \
149 #define schedule_timeout_and_set_state(state, timeout) \
151 set_current_state(state); \
152 schedule_timeout(timeout); \
155 /* deschedule for a bit... */
156 #define cfs_pause(ticks) \
158 set_current_state(TASK_UNINTERRUPTIBLE); \
159 schedule_timeout(ticks); \
162 #define DECL_JOURNAL_DATA void *journal_info
163 #define PUSH_JOURNAL do { \
164 journal_info = current->journal_info; \
165 current->journal_info = NULL; \
167 #define POP_JOURNAL do { \
168 current->journal_info = journal_info; \
171 /* Module interfaces */
172 #define cfs_module(name, version, init, fini) \