Whamcloud - gitweb
b9963e48c77c69691550486d38ae35144e1aaa21
[fs/lustre-release.git] / libcfs / include / libcfs / linux / linux-misc.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.gnu.org/licenses/gpl-2.0.html
19  *
20  * GPL HEADER END
21  */
22 /*
23  * Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
24  * Use is subject to license terms.
25  *
26  * Copyright (c) 2011, 2017, Intel Corporation.
27  */
28 /*
29  * This file is part of Lustre, http://www.lustre.org/
30  */
31
32 #ifndef __LIBCFS_LINUX_MISC_H__
33 #define __LIBCFS_LINUX_MISC_H__
34
35 #include <linux/fs.h>
36 /* Since Commit 2f8b544477e6 ("block,fs: untangle fs.h and blk_types.h")
37  * fs.h doesn't include blk_types.h, but we need it.
38  */
39 #include <linux/blk_types.h>
40 #include <linux/mutex.h>
41 #include <linux/user_namespace.h>
42 #include <linux/uio.h>
43 #include <linux/kallsyms.h>
44
45 #ifndef HAVE_IOV_ITER_TYPE
46 #ifdef HAVE_IOV_ITER_HAS_TYPE_MEMBER
47 #define iter_is_iovec(iter)             ((iter)->type & ITER_IOVEC)
48 #define iov_iter_is_kvec(iter)          ((iter)->type & ITER_KVEC)
49 #define iov_iter_is_bvec(iter)          ((iter)->type & ITER_BVEC)
50 #define iov_iter_is_pipe(iter)          ((iter)->type & ITER_PIPE)
51 #define iov_iter_is_discard(iter)       ((iter)->type & ITER_DISCARD)
52 #else
53 #define iter_is_iovec(iter)             1
54 #define iov_iter_is_kvec(iter)          0
55 #define iov_iter_is_bvec(iter)          0
56 #define iov_iter_is_pipe(iter)          0
57 #define iov_iter_is_discard(iter)       0
58 #endif
59 #endif /* HAVE_IOV_ITER_TYPE */
60
61 int cfs_kernel_write(struct file *filp, const void *buf, size_t count,
62                      loff_t *pos);
63 ssize_t cfs_kernel_read(struct file *file, void *buf, size_t count,
64                         loff_t *pos);
65
66 /*
67  * For RHEL6 struct kernel_parm_ops doesn't exist. Also
68  * the arguments for .set and .get take different
69  * parameters which is handled below
70  */
71 #ifdef HAVE_KERNEL_PARAM_OPS
72 #define cfs_kernel_param_arg_t const struct kernel_param
73 #else
74 #define cfs_kernel_param_arg_t struct kernel_param_ops
75 #define kernel_param_ops kernel_param
76 #endif /* ! HAVE_KERNEL_PARAM_OPS */
77
78 #ifndef HAVE_KERNEL_PARAM_LOCK
79 static inline void kernel_param_unlock(struct module *mod)
80 {
81         __kernel_param_unlock();
82 }
83
84 static inline void kernel_param_lock(struct module *mod)
85 {
86         __kernel_param_lock();
87 }
88 #endif /* ! HAVE_KERNEL_PARAM_LOCK */
89
90 int cfs_apply_workqueue_attrs(struct workqueue_struct *wq,
91                               const struct workqueue_attrs *attrs);
92
93 #ifndef HAVE_KSTRTOBOOL_FROM_USER
94
95 #define kstrtobool strtobool
96
97 int kstrtobool_from_user(const char __user *s, size_t count, bool *res);
98 #endif /* HAVE_KSTRTOBOOL_FROM_USER */
99
100 #ifndef HAVE_MATCH_WILDCARD
101 bool match_wildcard(const char *pattern, const char *str);
102 #endif /* !HAVE_MATCH_WILDCARD */
103
104 #ifndef HAVE_KREF_READ
105 static inline int kref_read(const struct kref *kref)
106 {
107         return atomic_read(&kref->refcount);
108 }
109 #endif /* HAVE_KREF_READ */
110
111 #ifdef HAVE_FORCE_SIG_WITH_TASK
112 #define cfs_force_sig(sig, task)        force_sig((sig), (task))
113 #else
114 #define cfs_force_sig(sig, task)                                        \
115 do {                                                                    \
116         unsigned long flags;                                            \
117                                                                         \
118         spin_lock_irqsave(&task->sighand->siglock, flags);              \
119         task->sighand->action[sig - 1].sa.sa_handler = SIG_DFL;         \
120         send_sig(sig, task, 1);                                         \
121         spin_unlock_irqrestore(&task->sighand->siglock, flags);         \
122 } while (0)
123 #endif
124
125 void cfs_arch_init(void);
126
127 #ifndef container_of_safe
128 /**
129  * container_of_safe - cast a member of a structure out to the containing structure
130  * @ptr:        the pointer to the member.
131  * @type:       the type of the container struct this is embedded in.
132  * @member:     the name of the member within the struct.
133  *
134  * If IS_ERR_OR_NULL(ptr), ptr is returned unchanged.
135  *
136  * Note: Copied from Linux 5.6, with BUILD_BUG_ON_MSG section removed.
137  */
138 #define container_of_safe(ptr, type, member) ({                         \
139         void *__mptr = (void *)(ptr);                                   \
140         IS_ERR_OR_NULL(__mptr) ? ERR_CAST(__mptr) :                     \
141                 ((type *)(__mptr - offsetof(type, member))); })
142 #endif
143
144 /*
145  * Linux v4.15-rc2-5-g4229a470175b added sizeof_field()
146  * Linux v5.5-rc4-1-g1f07dcc459d5 removed FIELD_SIZEOF()
147  * Proved a sizeof_field in terms of FIELD_SIZEOF() when one is not provided
148  */
149 #ifndef sizeof_field
150 #define sizeof_field(type, member)      FIELD_SIZEOF(type, member)
151 #endif
152
153 #ifdef HAVE_KALLSYMS_LOOKUP_NAME
154 static inline void *cfs_kallsyms_lookup_name(const char *name)
155 {
156         return (void *)kallsyms_lookup_name(name);
157 }
158 #else
159 static inline void *cfs_kallsyms_lookup_name(const char *name)
160 {
161         return NULL;
162 }
163 #endif
164
165 #endif /* __LIBCFS_LINUX_MISC_H__ */