lustre/ldlm/ldlm_internal.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) 2003, 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 extern int ldlm_srv_namespace_nr;
  33 extern int ldlm_cli_namespace_nr;
  34 extern struct mutex ldlm_srv_namespace_lock;
  35 extern struct list_head ldlm_srv_namespace_list;
  36 extern struct mutex ldlm_cli_namespace_lock;
  37 extern struct list_head ldlm_cli_active_namespace_list;
  38 extern struct list_head ldlm_cli_inactive_namespace_list;
  39 extern unsigned int ldlm_cancel_unused_locks_before_replay;
  40 extern struct kmem_cache *ldlm_glimpse_work_kmem;
  41
  42 static inline int ldlm_namespace_nr_read(enum ldlm_side client)
  43 {
  44         return client == LDLM_NAMESPACE_SERVER ?
  45                 ldlm_srv_namespace_nr : ldlm_cli_namespace_nr;
  46 }
  47
  48 static inline void ldlm_namespace_nr_inc(enum ldlm_side client)
  49 {
  50         if (client == LDLM_NAMESPACE_SERVER)
  51                 ldlm_srv_namespace_nr++;
  52         else
  53                 ldlm_cli_namespace_nr++;
  54 }
  55
  56 static inline void ldlm_namespace_nr_dec(enum ldlm_side client)
  57 {
  58         if (client == LDLM_NAMESPACE_SERVER)
  59                 ldlm_srv_namespace_nr--;
  60         else
  61                 ldlm_cli_namespace_nr--;
  62 }
  63
  64 static inline struct list_head *ldlm_namespace_list(enum ldlm_side client)
  65 {
  66         return client == LDLM_NAMESPACE_SERVER ?
  67                 &ldlm_srv_namespace_list : &ldlm_cli_active_namespace_list;
  68 }
  69
  70 static inline
  71 struct list_head *ldlm_namespace_inactive_list(enum ldlm_side client)
  72 {
  73         return client == LDLM_NAMESPACE_SERVER ?
  74                 &ldlm_srv_namespace_list : &ldlm_cli_inactive_namespace_list;
  75 }
  76
  77 static inline struct mutex *ldlm_namespace_lock(enum ldlm_side client)
  78 {
  79         return client == LDLM_NAMESPACE_SERVER ?
  80                 &ldlm_srv_namespace_lock : &ldlm_cli_namespace_lock;
  81 }
  82
  83 /* ns_bref is the number of resources in this namespace */
  84 static inline int ldlm_ns_empty(struct ldlm_namespace *ns)
  85 {
  86         return atomic_read(&ns->ns_bref) == 0;
  87 }
  88
  89 void ldlm_namespace_move_to_active_locked(struct ldlm_namespace *l,
  90                                           enum ldlm_side);
  91 void ldlm_namespace_move_to_inactive_locked(struct ldlm_namespace *l,
  92                                             enum ldlm_side);
  93 struct ldlm_namespace *ldlm_namespace_first_locked(enum ldlm_side);
  94
  95 /* ldlm_request.c */
  96 int ldlm_cancel_lru(struct ldlm_namespace *ns, int min,
  97                     enum ldlm_cancel_flags cancel_flags,
  98                     enum ldlm_lru_flags lru_flags);
  99 int ldlm_cancel_lru_local(struct ldlm_namespace *ns,
 100                           struct list_head *cancels, int min, int max,
 101                           enum ldlm_cancel_flags cancel_flags,
 102                           enum ldlm_lru_flags lru_flags);
 103 extern unsigned int ldlm_enqueue_min;
 104 /* ldlm_resource.c */
 105 extern struct kmem_cache *ldlm_resource_slab;
 106 extern struct kmem_cache *ldlm_lock_slab;
 107 extern struct kmem_cache *ldlm_inodebits_slab;
 108 extern struct kmem_cache *ldlm_interval_tree_slab;
 109
 110 void ldlm_resource_insert_lock_after(struct ldlm_lock *original,
 111                                      struct ldlm_lock *new);
 112 void ldlm_resource_insert_lock_before(struct ldlm_lock *original,
 113                                       struct ldlm_lock *new);
 114
 115 /* ldlm_lock.c */
 116
 117 typedef enum {
 118         LDLM_WORK_BL_AST,
 119         LDLM_WORK_CP_AST,
 120         LDLM_WORK_REVOKE_AST,
 121         LDLM_WORK_GL_AST
 122 } ldlm_desc_ast_t;
 123
 124 void ldlm_grant_lock_with_skiplist(struct ldlm_lock *lock);
 125 void ldlm_grant_lock(struct ldlm_lock *lock, struct list_head *work_list);
 126 int ldlm_fill_lvb(struct ldlm_lock *lock, struct req_capsule *pill,
 127                   enum req_location loc, void *data, int size);
 128 struct ldlm_lock *ldlm_lock_create(struct ldlm_namespace *ns,
 129                                    const struct ldlm_res_id *res,
 130                                    enum ldlm_type type, enum ldlm_mode mode,
 131                                    const struct ldlm_callback_suite *cbs,
 132                                    void *data, __u32 lvb_len,
 133                                    enum lvb_type lvb_type);
 134 enum ldlm_error ldlm_lock_enqueue(const struct lu_env *env,
 135                                   struct ldlm_namespace *l,
 136                                   struct ldlm_lock **lock,
 137                                   void *cookie, __u64 *flags);
 138 void ldlm_lock_addref_internal(struct ldlm_lock *l, enum ldlm_mode mode);
 139 void ldlm_lock_addref_internal_nolock(struct ldlm_lock *l, enum ldlm_mode mode);
 140 void ldlm_lock_decref_internal(struct ldlm_lock *l, enum ldlm_mode mode);
 141 void ldlm_lock_decref_internal_nolock(struct ldlm_lock *l,
 142                                       enum ldlm_mode mode);
 143 void ldlm_add_ast_work_item(struct ldlm_lock *lock, struct ldlm_lock *new,
 144                             struct list_head *work_list);
 145 #ifdef HAVE_SERVER_SUPPORT
 146 int ldlm_reprocess_queue(struct ldlm_resource *res, struct list_head *queue,
 147                          struct list_head *work_list,
 148                          enum ldlm_process_intention intention, __u64 hint);
 149 int ldlm_handle_conflict_lock(struct ldlm_lock *lock, __u64 *flags,
 150                               struct list_head *rpc_list);
 151 void ldlm_discard_bl_list(struct list_head *bl_list);
 152 void ldlm_clear_blocking_lock(struct ldlm_lock *lock);
 153 void ldlm_clear_blocking_data(struct ldlm_lock *lock);
 154 #endif
 155 int ldlm_run_ast_work(struct ldlm_namespace *ns, struct list_head *rpc_list,
 156                       ldlm_desc_ast_t ast_type);
 157 int ldlm_work_gl_ast_lock(struct ptlrpc_request_set *rqset, void *opaq);
 158 int ldlm_lock_remove_from_lru_check(struct ldlm_lock *lock, ktime_t last_use);
 159 #define ldlm_lock_remove_from_lru(lock) \
 160                 ldlm_lock_remove_from_lru_check(lock, ktime_set(0, 0))
 161 int ldlm_lock_remove_from_lru_nolock(struct ldlm_lock *lock);
 162 void ldlm_lock_add_to_lru_nolock(struct ldlm_lock *lock);
 163 void ldlm_lock_touch_in_lru(struct ldlm_lock *lock);
 164 void ldlm_lock_destroy_nolock(struct ldlm_lock *lock);
 165
 166 int ldlm_export_cancel_blocked_locks(struct obd_export *exp);
 167 int ldlm_export_cancel_locks(struct obd_export *exp);
 168 void ldlm_grant_lock_with_skiplist(struct ldlm_lock *lock);
 169
 170 /* ldlm_lockd.c */
 171 int ldlm_bl_to_thread_lock(struct ldlm_namespace *ns, struct ldlm_lock_desc *ld,
 172                            struct ldlm_lock *lock);
 173 int ldlm_bl_to_thread_list(struct ldlm_namespace *ns,
 174                            struct ldlm_lock_desc *ld,
 175                            struct list_head *cancels, int count,
 176                            enum ldlm_cancel_flags cancel_flags);
 177 int ldlm_bl_to_thread_ns(struct ldlm_namespace *ns);
 178 int ldlm_bl_thread_wakeup(void);
 179
 180 void ldlm_handle_bl_callback(struct ldlm_namespace *ns,
 181                              struct ldlm_lock_desc *ld, struct ldlm_lock *lock);
 182 void ldlm_bl_desc2lock(const struct ldlm_lock_desc *ld, struct ldlm_lock *lock);
 183
 184 #ifdef HAVE_SERVER_SUPPORT
 185 /* ldlm_plain.c */
 186 int ldlm_process_plain_lock(struct ldlm_lock *lock, __u64 *flags,
 187                             enum ldlm_process_intention intention,
 188                             enum ldlm_error *err, struct list_head *work_list);
 189
 190 /* ldlm_inodebits.c */
 191 int ldlm_process_inodebits_lock(struct ldlm_lock *lock, __u64 *flags,
 192                                 enum ldlm_process_intention intention,
 193                                 enum ldlm_error *err,
 194                                 struct list_head *work_list);
 195 int ldlm_reprocess_inodebits_queue(struct ldlm_resource *res,
 196                                    struct list_head *queue,
 197                                    struct list_head *work_list,
 198                                    enum ldlm_process_intention intention,
 199                                    __u64 hint);
 200 /* ldlm_extent.c */
 201 int ldlm_process_extent_lock(struct ldlm_lock *lock, __u64 *flags,
 202                              enum ldlm_process_intention intention,
 203                              enum ldlm_error *err, struct list_head *work_list);
 204 #endif
 205 void ldlm_extent_add_lock(struct ldlm_resource *res, struct ldlm_lock *lock);
 206 void ldlm_extent_unlink_lock(struct ldlm_lock *lock);
 207 void ldlm_extent_search(struct interval_tree_root *root,
 208                         u64 start, u64 end,
 209                         bool (*matches)(struct ldlm_lock *lock, void *data),
 210                         void *data);
 211
 212 int ldlm_inodebits_alloc_lock(struct ldlm_lock *lock);
 213 void ldlm_inodebits_add_lock(struct ldlm_resource *res, struct list_head *head,
 214                              struct ldlm_lock *lock, bool tail);
 215 void ldlm_inodebits_unlink_lock(struct ldlm_lock *lock);
 216
 217 /* ldlm_flock.c */
 218 int ldlm_process_flock_lock(struct ldlm_lock *req, __u64 *flags,
 219                             enum ldlm_process_intention intention,
 220                             enum ldlm_error *err, struct list_head *work_list);
 221 int ldlm_init_flock_export(struct obd_export *exp);
 222 void ldlm_destroy_flock_export(struct obd_export *exp);
 223 void ldlm_flock_unlink_lock(struct ldlm_lock *lock);
 224
 225 /* l_lock.c */
 226 void l_check_ns_lock(struct ldlm_namespace *ns);
 227 void l_check_no_ns_lock(struct ldlm_namespace *ns);
 228
 229 extern struct dentry *ldlm_svc_debugfs_dir;
 230
 231 struct ldlm_state {
 232         struct ptlrpc_service *ldlm_cb_service;
 233         struct ptlrpc_service *ldlm_cancel_service;
 234         struct ptlrpc_client *ldlm_client;
 235         struct ldlm_bl_pool *ldlm_bl_pool;
 236 };
 237
 238 int ldlm_init(void);
 239 void ldlm_exit(void);
 240
 241 enum ldlm_policy_res {
 242         LDLM_POLICY_CANCEL_LOCK,
 243         LDLM_POLICY_KEEP_LOCK,
 244         LDLM_POLICY_SKIP_LOCK
 245 };
 246
 247 #define LDLM_POOL_SYSFS_PRINT_int(v) sprintf(buf, "%d\n", v)
 248 #define LDLM_POOL_SYSFS_SET_int(a, b) { a = b; }
 249 #define LDLM_POOL_SYSFS_PRINT_u64(v) sprintf(buf, "%lld\n", v)
 250 #define LDLM_POOL_SYSFS_SET_u64(a, b) { a = b; }
 251 #define LDLM_POOL_SYSFS_PRINT_atomic(v) sprintf(buf, "%d\n", atomic_read(&v))
 252 #define LDLM_POOL_SYSFS_SET_atomic(a, b) atomic_set(&a, b)
 253
 254 #define LDLM_POOL_SYSFS_READER_SHOW(var, type)                             \
 255         static ssize_t var##_show(struct kobject *kobj,                    \
 256                                   struct attribute *attr,                  \
 257                                   char *buf)                               \
 258         {                                                                  \
 259                 struct ldlm_pool *pl = container_of(kobj, struct ldlm_pool,\
 260                                                     pl_kobj);              \
 261                 type tmp;                                                  \
 262                                                                            \
 263                 spin_lock(&pl->pl_lock);                                   \
 264                 tmp = pl->pl_##var;                                        \
 265                 spin_unlock(&pl->pl_lock);                                 \
 266                                                                            \
 267                 return LDLM_POOL_SYSFS_PRINT_##type(tmp);                  \
 268         }                                                                  \
 269         struct __##var##__dummy_read { ; } /* semicolon catcher */
 270
 271 #define LDLM_POOL_SYSFS_WRITER_STORE(var, type)                            \
 272         static ssize_t var##_store(struct kobject *kobj,                   \
 273                                    struct attribute *attr,                 \
 274                                    const char *buffer,                     \
 275                                    size_t count)                           \
 276         {                                                                  \
 277                 struct ldlm_pool *pl = container_of(kobj, struct ldlm_pool,\
 278                                                     pl_kobj);              \
 279                 unsigned long tmp;                                         \
 280                 int rc;                                                    \
 281                                                                            \
 282                 rc = kstrtoul(buffer, 10, &tmp);                           \
 283                 if (rc < 0) {                                              \
 284                         return rc;                                         \
 285                 }                                                          \
 286                                                                            \
 287                 spin_lock(&pl->pl_lock);                                   \
 288                 LDLM_POOL_SYSFS_SET_##type(pl->pl_##var, tmp);             \
 289                 spin_unlock(&pl->pl_lock);                                 \
 290                                                                            \
 291                 return count;                                              \
 292         }                                                                  \
 293         struct __##var##__dummy_write {; } /* semicolon catcher */
 294
 295 #define LDLM_POOL_SYSFS_READER_NOLOCK_SHOW(var, type)                      \
 296         static ssize_t var##_show(struct kobject *kobj,                    \
 297                                   struct attribute *attr,                  \
 298                                   char *buf)                               \
 299         {                                                                  \
 300                 struct ldlm_pool *pl = container_of(kobj, struct ldlm_pool,\
 301                                                     pl_kobj);              \
 302                                                                            \
 303                 return LDLM_POOL_SYSFS_PRINT_##type(pl->pl_##var);         \
 304         }                                                                  \
 305         struct __##var##__dummy_read {; } /* semicolon catcher */
 306
 307 #define LDLM_POOL_SYSFS_WRITER_NOLOCK_STORE(var, type)                     \
 308         static ssize_t var##_store(struct kobject *kobj,                   \
 309                                    struct attribute *attr,                 \
 310                                    const char *buffer,                     \
 311                                    size_t count)                           \
 312         {                                                                  \
 313                 struct ldlm_pool *pl = container_of(kobj, struct ldlm_pool,\
 314                                                     pl_kobj);              \
 315                 unsigned long tmp;                                         \
 316                 int rc;                                                    \
 317                                                                            \
 318                 rc = kstrtoul(buffer, 10, &tmp);                           \
 319                 if (rc < 0) {                                              \
 320                         return rc;                                         \
 321                 }                                                          \
 322                                                                            \
 323                 LDLM_POOL_SYSFS_SET_##type(pl->pl_##var, tmp);             \
 324                                                                            \
 325                 return count;                                              \
 326         }                                                                  \
 327         struct __##var##__dummy_write {; } /* semicolon catcher */
 328
 329 static inline void
 330 ldlm_add_var(struct ldebugfs_vars *vars, struct dentry *debugfs_entry,
 331              const char *name, void *data, const struct file_operations *ops)
 332 {
 333         vars->name = name;
 334         vars->data = data;
 335         vars->fops = ops;
 336         ldebugfs_add_vars(debugfs_entry, vars, NULL);
 337 }
 338
 339 static inline int is_granted_or_cancelled(struct ldlm_lock *lock)
 340 {
 341         int ret = 0;
 342
 343         lock_res_and_lock(lock);
 344         ret = is_granted_or_cancelled_nolock(lock);
 345         unlock_res_and_lock(lock);
 346
 347         return ret;
 348 }
 349
 350 static inline bool is_bl_done(struct ldlm_lock *lock)
 351 {
 352         bool bl_done = true;
 353
 354         if (!ldlm_is_bl_done(lock)) {
 355                 lock_res_and_lock(lock);
 356                 bl_done = ldlm_is_bl_done(lock);
 357                 unlock_res_and_lock(lock);
 358         }
 359
 360         return bl_done;
 361 }
 362
 363 static inline bool is_lock_converted(struct ldlm_lock *lock)
 364 {
 365         bool ret = 0;
 366
 367         lock_res_and_lock(lock);
 368         ret = (lock->l_policy_data.l_inodebits.cancel_bits == 0);
 369         unlock_res_and_lock(lock);
 370
 371         return ret;
 372 }
 373
 374 typedef void (*ldlm_policy_wire_to_local_t)(const union ldlm_wire_policy_data *,
 375                                             union ldlm_policy_data *);
 376 typedef void (*ldlm_policy_local_to_wire_t)(const union ldlm_policy_data *,
 377                                             union ldlm_wire_policy_data *);
 378 void ldlm_plain_policy_wire_to_local(const union ldlm_wire_policy_data *wpolicy,
 379                                      union ldlm_policy_data *lpolicy);
 380 void ldlm_plain_policy_local_to_wire(const union ldlm_policy_data *lpolicy,
 381                                      union ldlm_wire_policy_data *wpolicy);
 382 void ldlm_ibits_policy_wire_to_local(const union ldlm_wire_policy_data *wpolicy,
 383                                      union ldlm_policy_data *lpolicy);
 384 void ldlm_ibits_policy_local_to_wire(const union ldlm_policy_data *lpolicy,
 385                                      union ldlm_wire_policy_data *wpolicy);
 386 void ldlm_extent_policy_wire_to_local(const union ldlm_wire_policy_data *wpol,
 387                                       union ldlm_policy_data *lpolicy);
 388 void ldlm_extent_policy_local_to_wire(const union ldlm_policy_data *lpolicy,
 389                                       union ldlm_wire_policy_data *wpolicy);
 390 void ldlm_flock_policy_wire_to_local(const union ldlm_wire_policy_data *wpolicy,
 391                                      union ldlm_policy_data *lpolicy);
 392 void ldlm_flock_policy_local_to_wire(const union ldlm_policy_data *lpolicy,
 393                                      union ldlm_wire_policy_data *wpolicy);
 394
 395 /* ldlm_reclaim.c */
 396 #ifdef HAVE_SERVER_SUPPORT
 397 extern __u64 ldlm_reclaim_threshold;
 398 extern __u64 ldlm_lock_limit;
 399 extern __u64 ldlm_reclaim_threshold_mb;
 400 extern __u64 ldlm_lock_limit_mb;
 401 extern struct percpu_counter ldlm_granted_total;
 402 #endif
 403 int ldlm_reclaim_setup(void);
 404 void ldlm_reclaim_cleanup(void);
 405 void ldlm_reclaim_add(struct ldlm_lock *lock);
 406 void ldlm_reclaim_del(struct ldlm_lock *lock);
 407 bool ldlm_reclaim_full(void);
 408
 409 static inline bool ldlm_res_eq(const struct ldlm_res_id *res0,
 410                                const struct ldlm_res_id *res1)
 411 {
 412         return memcmp(res0, res1, sizeof(*res0)) == 0;
 413 }
 414
 415 /* exports for testing */
 416 struct ldlm_lock *ldlm_lock_new_testing(struct ldlm_resource *resource);