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) 2003, 2010, Oracle and/or its affiliates. All rights reserved.
28 * Use is subject to license terms.
30 * Copyright (c) 2011, 2012, Whamcloud, Inc.
33 * This file is part of Lustre, http://www.lustre.org/
34 * Lustre is a trademark of Sun Microsystems, Inc.
37 #define MAX_STRING_SIZE 128
39 extern cfs_atomic_t ldlm_srv_namespace_nr;
40 extern cfs_atomic_t ldlm_cli_namespace_nr;
41 extern cfs_mutex_t ldlm_srv_namespace_lock;
42 extern cfs_list_t ldlm_srv_namespace_list;
43 extern cfs_mutex_t ldlm_cli_namespace_lock;
44 extern cfs_list_t ldlm_cli_namespace_list;
46 static inline cfs_atomic_t *ldlm_namespace_nr(ldlm_side_t client)
48 return client == LDLM_NAMESPACE_SERVER ?
49 &ldlm_srv_namespace_nr : &ldlm_cli_namespace_nr;
52 static inline cfs_list_t *ldlm_namespace_list(ldlm_side_t client)
54 return client == LDLM_NAMESPACE_SERVER ?
55 &ldlm_srv_namespace_list : &ldlm_cli_namespace_list;
58 static inline cfs_mutex_t *ldlm_namespace_lock(ldlm_side_t client)
60 return client == LDLM_NAMESPACE_SERVER ?
61 &ldlm_srv_namespace_lock : &ldlm_cli_namespace_lock;
70 /* Cancel lru flag, it indicates we cancel aged locks. */
72 LDLM_CANCEL_AGED = 1 << 0, /* Cancel aged locks (non lru resize). */
73 LDLM_CANCEL_PASSED = 1 << 1, /* Cancel passed number of locks. */
74 LDLM_CANCEL_SHRINK = 1 << 2, /* Cancel locks from shrinker. */
75 LDLM_CANCEL_LRUR = 1 << 3, /* Cancel locks from lru resize. */
76 LDLM_CANCEL_NO_WAIT = 1 << 4 /* Cancel locks w/o blocking (neither
77 * sending nor waiting for any rpcs) */
80 int ldlm_cancel_lru(struct ldlm_namespace *ns, int nr, ldlm_sync_t sync,
82 int ldlm_cancel_lru_local(struct ldlm_namespace *ns,
83 cfs_list_t *cancels, int count, int max,
84 ldlm_cancel_flags_t cancel_flags, int flags);
85 extern int ldlm_enqueue_min;
86 int ldlm_get_enq_timeout(struct ldlm_lock *lock);
89 int ldlm_resource_putref_locked(struct ldlm_resource *res);
90 void ldlm_resource_insert_lock_after(struct ldlm_lock *original,
91 struct ldlm_lock *new);
92 void ldlm_namespace_free_prior(struct ldlm_namespace *ns,
93 struct obd_import *imp, int force);
94 void ldlm_namespace_free_post(struct ldlm_namespace *ns);
97 struct ldlm_cb_set_arg {
98 struct ptlrpc_request_set *set;
99 int type; /* LDLM_{CP,BL,GL}_CALLBACK */
100 cfs_atomic_t restart;
102 union ldlm_gl_desc *gl_desc; /* glimpse AST descriptor */
108 LDLM_WORK_REVOKE_AST,
112 void ldlm_grant_lock(struct ldlm_lock *lock, cfs_list_t *work_list);
114 ldlm_lock_create(struct ldlm_namespace *ns, const struct ldlm_res_id *,
115 ldlm_type_t type, ldlm_mode_t,
116 const struct ldlm_callback_suite *cbs,
117 void *data, __u32 lvb_len);
118 ldlm_error_t ldlm_lock_enqueue(struct ldlm_namespace *, struct ldlm_lock **,
119 void *cookie, __u64 *flags);
120 void ldlm_lock_addref_internal(struct ldlm_lock *, __u32 mode);
121 void ldlm_lock_addref_internal_nolock(struct ldlm_lock *, __u32 mode);
122 void ldlm_lock_decref_internal(struct ldlm_lock *, __u32 mode);
123 void ldlm_lock_decref_internal_nolock(struct ldlm_lock *, __u32 mode);
124 void ldlm_add_ast_work_item(struct ldlm_lock *lock, struct ldlm_lock *new,
125 cfs_list_t *work_list);
126 #ifdef HAVE_SERVER_SUPPORT
127 int ldlm_reprocess_queue(struct ldlm_resource *res, cfs_list_t *queue,
128 cfs_list_t *work_list);
130 int ldlm_run_ast_work(struct ldlm_namespace *ns, cfs_list_t *rpc_list,
131 ldlm_desc_ast_t ast_type);
132 int ldlm_work_gl_ast_lock(struct ptlrpc_request_set *rqset, void *opaq);
133 int ldlm_lock_remove_from_lru(struct ldlm_lock *lock);
134 int ldlm_lock_remove_from_lru_nolock(struct ldlm_lock *lock);
135 void ldlm_lock_add_to_lru_nolock(struct ldlm_lock *lock);
136 void ldlm_lock_add_to_lru(struct ldlm_lock *lock);
137 void ldlm_lock_touch_in_lru(struct ldlm_lock *lock);
138 void ldlm_lock_destroy_nolock(struct ldlm_lock *lock);
140 void ldlm_cancel_locks_for_export(struct obd_export *export);
143 int ldlm_bl_to_thread_lock(struct ldlm_namespace *ns, struct ldlm_lock_desc *ld,
144 struct ldlm_lock *lock);
145 int ldlm_bl_to_thread_list(struct ldlm_namespace *ns, struct ldlm_lock_desc *ld,
146 cfs_list_t *cancels, int count, int mode);
148 void ldlm_handle_bl_callback(struct ldlm_namespace *ns,
149 struct ldlm_lock_desc *ld, struct ldlm_lock *lock);
151 #ifdef HAVE_SERVER_SUPPORT
153 int ldlm_process_plain_lock(struct ldlm_lock *lock, __u64 *flags,
154 int first_enq, ldlm_error_t *err,
155 cfs_list_t *work_list);
157 /* ldlm_inodebits.c */
158 int ldlm_process_inodebits_lock(struct ldlm_lock *lock, __u64 *flags,
159 int first_enq, ldlm_error_t *err,
160 cfs_list_t *work_list);
164 #ifdef HAVE_SERVER_SUPPORT
165 int ldlm_process_extent_lock(struct ldlm_lock *lock, __u64 *flags,
166 int first_enq, ldlm_error_t *err,
167 cfs_list_t *work_list);
169 void ldlm_extent_add_lock(struct ldlm_resource *res, struct ldlm_lock *lock);
170 void ldlm_extent_unlink_lock(struct ldlm_lock *lock);
173 int ldlm_process_flock_lock(struct ldlm_lock *req, __u64 *flags,
174 int first_enq, ldlm_error_t *err,
175 cfs_list_t *work_list);
176 int ldlm_init_flock_export(struct obd_export *exp);
177 void ldlm_destroy_flock_export(struct obd_export *exp);
180 void l_check_ns_lock(struct ldlm_namespace *ns);
181 void l_check_no_ns_lock(struct ldlm_namespace *ns);
183 extern cfs_proc_dir_entry_t *ldlm_svc_proc_dir;
184 extern cfs_proc_dir_entry_t *ldlm_type_proc_dir;
187 struct ptlrpc_service *ldlm_cb_service;
188 struct ptlrpc_service *ldlm_cancel_service;
189 struct ptlrpc_client *ldlm_client;
190 struct ptlrpc_connection *ldlm_server_conn;
191 struct ldlm_bl_pool *ldlm_bl_pool;
194 /* interval tree, for LDLM_EXTENT. */
195 extern cfs_mem_cache_t *ldlm_interval_slab; /* slab cache for ldlm_interval */
196 extern void ldlm_interval_attach(struct ldlm_interval *n, struct ldlm_lock *l);
197 extern struct ldlm_interval *ldlm_interval_detach(struct ldlm_lock *l);
198 extern struct ldlm_interval *ldlm_interval_alloc(struct ldlm_lock *lock);
199 extern void ldlm_interval_free(struct ldlm_interval *node);
200 /* this function must be called with res lock held */
201 static inline struct ldlm_extent *
202 ldlm_interval_extent(struct ldlm_interval *node)
204 struct ldlm_lock *lock;
205 LASSERT(!cfs_list_empty(&node->li_group));
207 lock = cfs_list_entry(node->li_group.next, struct ldlm_lock,
209 return &lock->l_policy_data.l_extent;
213 void ldlm_exit(void);
215 enum ldlm_policy_res {
216 LDLM_POLICY_CANCEL_LOCK,
217 LDLM_POLICY_KEEP_LOCK,
218 LDLM_POLICY_SKIP_LOCK
221 typedef enum ldlm_policy_res ldlm_policy_res_t;
223 #define LDLM_POOL_PROC_READER(var, type) \
224 static int lprocfs_rd_##var(char *page, char **start, off_t off, \
225 int count, int *eof, void *data) \
227 struct ldlm_pool *pl = data; \
230 cfs_spin_lock(&pl->pl_lock); \
231 tmp = pl->pl_##var; \
232 cfs_spin_unlock(&pl->pl_lock); \
234 return lprocfs_rd_uint(page, start, off, count, eof, &tmp); \
236 struct __##var##__dummy_read {;} /* semicolon catcher */
238 #define LDLM_POOL_PROC_WRITER(var, type) \
239 int lprocfs_wr_##var(struct file *file, const char *buffer, \
240 unsigned long count, void *data) \
242 struct ldlm_pool *pl = data; \
246 rc = lprocfs_wr_uint(file, buffer, count, &tmp); \
248 CERROR("Can't parse user input, rc = %d\n", rc); \
252 cfs_spin_lock(&pl->pl_lock); \
253 pl->pl_##var = tmp; \
254 cfs_spin_unlock(&pl->pl_lock); \
258 struct __##var##__dummy_write {;} /* semicolon catcher */
260 static inline int is_granted_or_cancelled(struct ldlm_lock *lock)
264 lock_res_and_lock(lock);
265 if (((lock->l_req_mode == lock->l_granted_mode) &&
266 !(lock->l_flags & LDLM_FL_CP_REQD)) ||
267 (lock->l_flags & (LDLM_FL_FAILED | LDLM_FL_CANCEL)))
269 unlock_res_and_lock(lock);
274 typedef void (*ldlm_policy_wire_to_local_t)(const ldlm_wire_policy_data_t *,
275 ldlm_policy_data_t *);
277 typedef void (*ldlm_policy_local_to_wire_t)(const ldlm_policy_data_t *,
278 ldlm_wire_policy_data_t *);
280 void ldlm_plain_policy_wire_to_local(const ldlm_wire_policy_data_t *wpolicy,
281 ldlm_policy_data_t *lpolicy);
282 void ldlm_plain_policy_local_to_wire(const ldlm_policy_data_t *lpolicy,
283 ldlm_wire_policy_data_t *wpolicy);
284 void ldlm_ibits_policy_wire_to_local(const ldlm_wire_policy_data_t *wpolicy,
285 ldlm_policy_data_t *lpolicy);
286 void ldlm_ibits_policy_local_to_wire(const ldlm_policy_data_t *lpolicy,
287 ldlm_wire_policy_data_t *wpolicy);
288 void ldlm_extent_policy_wire_to_local(const ldlm_wire_policy_data_t *wpolicy,
289 ldlm_policy_data_t *lpolicy);
290 void ldlm_extent_policy_local_to_wire(const ldlm_policy_data_t *lpolicy,
291 ldlm_wire_policy_data_t *wpolicy);
292 void ldlm_flock_policy_wire18_to_local(const ldlm_wire_policy_data_t *wpolicy,
293 ldlm_policy_data_t *lpolicy);
294 void ldlm_flock_policy_wire21_to_local(const ldlm_wire_policy_data_t *wpolicy,
295 ldlm_policy_data_t *lpolicy);
297 void ldlm_flock_policy_local_to_wire(const ldlm_policy_data_t *lpolicy,
298 ldlm_wire_policy_data_t *wpolicy);