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