libcfs/include/libcfs/linux/linux-prim.h

   1 /* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
   2  * vim:expandtab:shiftwidth=8:tabstop=8:
   3  *
   4  * GPL HEADER START
   5  *
   6  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License version 2 only,
  10  * as published by the Free Software Foundation.
  11  *
  12  * This program is distributed in the hope that it will be useful, but
  13  * WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * General Public License version 2 for more details (a copy is included
  16  * in the LICENSE file that accompanied this code).
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * version 2 along with this program; If not, see
  20  * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
  21  *
  22  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
  23  * CA 95054 USA or visit www.sun.com if you need additional information or
  24  * have any questions.
  25  *
  26  * GPL HEADER END
  27  */
  28 /*
  29  * Copyright  2008 Sun Microsystems, Inc. All rights reserved
  30  * Use is subject to license terms.
  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/linux/linux-prim.h
  37  *
  38  * Basic library routines.
  39  */
  40
  41 #ifndef __LIBCFS_LINUX_CFS_PRIM_H__
  42 #define __LIBCFS_LINUX_CFS_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 #ifndef __KERNEL__
  49 #error This include is only for kernel use.
  50 #endif
  51
  52 #ifndef AUTOCONF_INCLUDED
  53 #include <linux/config.h>
  54 #endif
  55 #include <linux/module.h>
  56 #include <linux/init.h>
  57 #include <linux/kernel.h>
  58 #include <linux/version.h>
  59 #include <linux/proc_fs.h>
  60 #include <linux/mm.h>
  61 #include <linux/timer.h>
  62 #include <linux/signal.h>
  63 #include <linux/sched.h>
  64
  65 #include <linux/miscdevice.h>
  66 #include <libcfs/linux/portals_compat25.h>
  67 #include <asm/div64.h>
  68
  69 #include <libcfs/linux/linux-time.h>
  70
  71 /*
  72  * Pseudo device register
  73  */
  74 typedef struct miscdevice               cfs_psdev_t;
  75 #define cfs_psdev_register(dev)         misc_register(dev)
  76 #define cfs_psdev_deregister(dev)       misc_deregister(dev)
  77
  78 /*
  79  * Sysctl register
  80  */
  81 typedef struct ctl_table                cfs_sysctl_table_t;
  82 typedef struct ctl_table_header         cfs_sysctl_table_header_t;
  83
  84 #ifdef HAVE_2ARGS_REGISTER_SYSCTL
  85 #define cfs_register_sysctl_table(t, a) register_sysctl_table(t, a)
  86 #else
  87 #define cfs_register_sysctl_table(t, a) register_sysctl_table(t)
  88 #endif
  89 #define cfs_unregister_sysctl_table(t)  unregister_sysctl_table(t)
  90
  91 /*
  92  * Symbol register
  93  */
  94 #if (LINUX_VERSION_CODE < KERNEL_VERSION(2,5,0))
  95 #define cfs_symbol_register(s, p)       inter_module_register(s, THIS_MODULE, p)
  96 #define cfs_symbol_unregister(s)        inter_module_unregister(s)
  97 #define cfs_symbol_get(s)               inter_module_get(s)
  98 #define cfs_symbol_put(s)               inter_module_put(s)
  99 #define cfs_module_get()                MOD_INC_USE_COUNT
 100 #define cfs_module_put()                MOD_DEC_USE_COUNT
 101 #else
 102 #define cfs_symbol_register(s, p)       do {} while(0)
 103 #define cfs_symbol_unregister(s)        do {} while(0)
 104 #define cfs_symbol_get(s)               symbol_get(s)
 105 #define cfs_symbol_put(s)               symbol_put(s)
 106 #define cfs_module_get()                try_module_get(THIS_MODULE)
 107 #define cfs_module_put()                module_put(THIS_MODULE)
 108 #endif
 109
 110 /*
 111  * Proc file system APIs
 112  */
 113 typedef read_proc_t                     cfs_read_proc_t;
 114 typedef write_proc_t                    cfs_write_proc_t;
 115 typedef struct proc_dir_entry           cfs_proc_dir_entry_t;
 116 #define cfs_create_proc_entry(n, m, p)  create_proc_entry(n, m, p)
 117 #define cfs_free_proc_entry(e)          free_proc_entry(e)
 118 #define cfs_remove_proc_entry(n, e)     remove_proc_entry(n, e)
 119
 120 /*
 121  * Wait Queue
 122  */
 123 #define CFS_TASK_INTERRUPTIBLE          TASK_INTERRUPTIBLE
 124 #define CFS_TASK_UNINT                  TASK_UNINTERRUPTIBLE
 125 #define CFS_TASK_RUNNING                TASK_RUNNING
 126
 127 typedef wait_queue_t                    cfs_waitlink_t;
 128 typedef wait_queue_head_t               cfs_waitq_t;
 129 typedef long                            cfs_task_state_t;
 130
 131 /* Kernel thread */
 132 typedef int (*cfs_thread_t)(void *);
 133
 134 static inline int cfs_kernel_thread(int (*fn)(void *),
 135                                     void *arg, unsigned long flags)
 136 {
 137         void *orig_info = current->journal_info;
 138         int rc;
 139
 140         current->journal_info = NULL;
 141         rc = kernel_thread(fn, arg, flags);
 142         current->journal_info = orig_info;
 143         return rc;
 144 }
 145
 146
 147 /*
 148  * Task struct
 149  */
 150 typedef struct task_struct              cfs_task_t;
 151 #define cfs_current()                   current
 152 #define cfs_task_lock(t)                task_lock(t)
 153 #define cfs_task_unlock(t)              task_unlock(t)
 154 #define CFS_DECL_JOURNAL_DATA           void *journal_info
 155 #define CFS_PUSH_JOURNAL                do {    \
 156         journal_info = current->journal_info;   \
 157         current->journal_info = NULL;           \
 158         } while(0)
 159 #define CFS_POP_JOURNAL                 do {    \
 160         current->journal_info = journal_info;   \
 161         } while(0)
 162
 163 /* Module interfaces */
 164 #define cfs_module(name, version, init, fini) \
 165 module_init(init);                            \
 166 module_exit(fini)
 167
 168 /*
 169  * Signal
 170  */
 171 typedef sigset_t                        cfs_sigset_t;
 172
 173 /*
 174  * Timer
 175  */
 176 typedef struct timer_list cfs_timer_t;
 177
 178
 179 #ifndef wait_event_timeout /* Only for RHEL3 2.4.21 kernel */
 180 #define __wait_event_timeout(wq, condition, timeout, ret)        \
 181 do {                                                             \
 182         int __ret = 0;                                           \
 183         if (!(condition)) {                                      \
 184                 wait_queue_t __wait;                             \
 185                 unsigned long expire;                            \
 186                                                                  \
 187                 init_waitqueue_entry(&__wait, current);          \
 188                 expire = timeout + jiffies;                      \
 189                 add_wait_queue(&wq, &__wait);                    \
 190                 for (;;) {                                       \
 191                         set_current_state(TASK_UNINTERRUPTIBLE); \
 192                         if (condition)                           \
 193                                 break;                           \
 194                         if (jiffies > expire) {                  \
 195                                 ret = jiffies - expire;          \
 196                                 break;                           \
 197                         }                                        \
 198                         schedule_timeout(timeout);               \
 199                 }                                                \
 200                 current->state = TASK_RUNNING;                   \
 201                 remove_wait_queue(&wq, &__wait);                 \
 202         }                                                        \
 203 } while (0)
 204 /*
 205    retval == 0; condition met; we're good.
 206    retval > 0; timed out.
 207 */
 208 #define cfs_waitq_wait_event_timeout(wq, condition, timeout, ret)    \
 209 do {                                                                 \
 210         ret = 0;                                                     \
 211         if (!(condition))                                            \
 212                 __wait_event_timeout(wq, condition, timeout, ret);   \
 213 } while (0)
 214 #else
 215 #define cfs_waitq_wait_event_timeout(wq, condition, timeout, ret)    \
 216         ret = wait_event_timeout(wq, condition, timeout)
 217 #endif
 218
 219 #ifndef wait_event_interruptible_timeout /* Only for RHEL3 2.4.21 kernel */
 220 #define __wait_event_interruptible_timeout(wq, condition, timeout, ret)   \
 221 do {                                                           \
 222         int __ret = 0;                                         \
 223         if (!(condition)) {                                    \
 224                 wait_queue_t __wait;                           \
 225                 unsigned long expire;                          \
 226                                                                \
 227                 init_waitqueue_entry(&__wait, current);        \
 228                 expire = timeout + jiffies;                    \
 229                 add_wait_queue(&wq, &__wait);                  \
 230                 for (;;) {                                     \
 231                         set_current_state(TASK_INTERRUPTIBLE); \
 232                         if (condition)                         \
 233                                 break;                         \
 234                         if (jiffies > expire) {                \
 235                                 ret = jiffies - expire;        \
 236                                 break;                         \
 237                         }                                      \
 238                         if (!signal_pending(current)) {        \
 239                                 schedule_timeout(timeout);     \
 240                                 continue;                      \
 241                         }                                      \
 242                         ret = -ERESTARTSYS;                    \
 243                         break;                                 \
 244                 }                                              \
 245                 current->state = TASK_RUNNING;                 \
 246                 remove_wait_queue(&wq, &__wait);               \
 247         }                                                      \
 248 } while (0)
 249
 250 /*
 251    retval == 0; condition met; we're good.
 252    retval < 0; interrupted by signal.
 253    retval > 0; timed out.
 254 */
 255 #define cfs_waitq_wait_event_interruptible_timeout(wq, condition, timeout, ret)\
 256 do {                                                              \
 257         ret = 0;                                                  \
 258         if (!(condition))                                         \
 259                 __wait_event_interruptible_timeout(wq, condition, \
 260                                                 timeout, ret);     \
 261 } while (0)
 262 #else
 263 #define cfs_waitq_wait_event_interruptible_timeout(wq, c, timeout, ret) \
 264         ret = wait_event_interruptible_timeout(wq, c, timeout)
 265 #endif
 266
 267 #endif