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.gnu.org/licenses/gpl-2.0.html
23 * Copyright (c) 2002, 2010, Oracle and/or its affiliates. All rights reserved.
24 * Use is subject to license terms.
26 * Copyright (c) 2010, 2016, Intel Corporation.
29 * This file is part of Lustre, http://www.lustre.org/
30 * Lustre is a trademark of Sun Microsystems, Inc.
32 * lustre/ldlm/ldlm_resource.c
34 * Author: Phil Schwan <phil@clusterfs.com>
35 * Author: Peter Braam <braam@clusterfs.com>
38 #define DEBUG_SUBSYSTEM S_LDLM
39 #include <lustre_dlm.h>
40 #include <lustre_fid.h>
41 #include <obd_class.h>
42 #include "ldlm_internal.h"
44 struct kmem_cache *ldlm_resource_slab, *ldlm_lock_slab;
45 struct kmem_cache *ldlm_interval_tree_slab;
47 int ldlm_srv_namespace_nr = 0;
48 int ldlm_cli_namespace_nr = 0;
50 struct mutex ldlm_srv_namespace_lock;
51 struct list_head ldlm_srv_namespace_list;
53 struct mutex ldlm_cli_namespace_lock;
54 /* Client Namespaces that have active resources in them.
55 * Once all resources go away, ldlm_poold moves such namespaces to the
57 struct list_head ldlm_cli_active_namespace_list;
58 /* Client namespaces that don't have any locks in them */
59 struct list_head ldlm_cli_inactive_namespace_list;
61 static struct proc_dir_entry *ldlm_type_proc_dir;
62 static struct proc_dir_entry *ldlm_ns_proc_dir;
63 struct proc_dir_entry *ldlm_svc_proc_dir;
65 /* during debug dump certain amount of granted locks for one resource to avoid
67 static unsigned int ldlm_dump_granted_max = 256;
71 lprocfs_dump_ns_seq_write(struct file *file, const char __user *buffer,
72 size_t count, loff_t *off)
74 ldlm_dump_all_namespaces(LDLM_NAMESPACE_SERVER, D_DLMTRACE);
75 ldlm_dump_all_namespaces(LDLM_NAMESPACE_CLIENT, D_DLMTRACE);
78 LPROC_SEQ_FOPS_WO_TYPE(ldlm, dump_ns);
80 LPROC_SEQ_FOPS_RW_TYPE(ldlm_rw, uint);
81 LPROC_SEQ_FOPS_RO_TYPE(ldlm, uint);
83 #ifdef HAVE_SERVER_SUPPORT
85 static int seq_watermark_show(struct seq_file *m, void *data)
87 seq_printf(m, "%llu\n", *(__u64 *)m->private);
91 static ssize_t seq_watermark_write(struct file *file,
92 const char __user *buffer, size_t count,
97 __u64 *data = ((struct seq_file *)file->private_data)->private;
98 bool wm_low = (data == &ldlm_reclaim_threshold_mb) ? true : false;
101 rc = lprocfs_str_with_units_to_s64(buffer, count, &value, 'M');
103 CERROR("Failed to set %s, rc = %d.\n",
104 wm_low ? "lock_reclaim_threshold_mb" : "lock_limit_mb",
107 } else if (value != 0 && value < (1 << 20)) {
108 CERROR("%s should be greater than 1MB.\n",
109 wm_low ? "lock_reclaim_threshold_mb" : "lock_limit_mb");
112 watermark = value >> 20;
115 if (ldlm_lock_limit_mb != 0 && watermark > ldlm_lock_limit_mb) {
116 CERROR("lock_reclaim_threshold_mb must be smaller than "
122 if (watermark != 0) {
124 do_div(watermark, sizeof(struct ldlm_lock));
126 ldlm_reclaim_threshold = watermark;
128 if (ldlm_reclaim_threshold_mb != 0 &&
129 watermark < ldlm_reclaim_threshold_mb) {
130 CERROR("lock_limit_mb must be greater than "
131 "lock_reclaim_threshold_mb.\n");
136 if (watermark != 0) {
138 do_div(watermark, sizeof(struct ldlm_lock));
140 ldlm_lock_limit = watermark;
146 static int seq_watermark_open(struct inode *inode, struct file *file)
148 return single_open(file, seq_watermark_show, PDE_DATA(inode));
151 static const struct file_operations ldlm_watermark_fops = {
152 .owner = THIS_MODULE,
153 .open = seq_watermark_open,
155 .write = seq_watermark_write,
157 .release = lprocfs_single_release,
160 static int seq_granted_show(struct seq_file *m, void *data)
162 seq_printf(m, "%llu\n", percpu_counter_sum_positive(
163 (struct percpu_counter *)m->private));
167 static int seq_granted_open(struct inode *inode, struct file *file)
169 return single_open(file, seq_granted_show, PDE_DATA(inode));
172 static const struct file_operations ldlm_granted_fops = {
173 .owner = THIS_MODULE,
174 .open = seq_granted_open,
177 .release = seq_release,
180 #endif /* HAVE_SERVER_SUPPORT */
182 int ldlm_proc_setup(void)
185 struct lprocfs_vars list[] = {
186 { .name = "dump_namespaces",
187 .fops = &ldlm_dump_ns_fops,
189 { .name = "dump_granted_max",
190 .fops = &ldlm_rw_uint_fops,
191 .data = &ldlm_dump_granted_max },
192 { .name = "cancel_unused_locks_before_replay",
193 .fops = &ldlm_rw_uint_fops,
194 .data = &ldlm_cancel_unused_locks_before_replay },
195 #ifdef HAVE_SERVER_SUPPORT
196 { .name = "lock_reclaim_threshold_mb",
197 .fops = &ldlm_watermark_fops,
198 .data = &ldlm_reclaim_threshold_mb },
199 { .name = "lock_limit_mb",
200 .fops = &ldlm_watermark_fops,
201 .data = &ldlm_lock_limit_mb },
202 { .name = "lock_granted_count",
203 .fops = &ldlm_granted_fops,
204 .data = &ldlm_granted_total },
208 LASSERT(ldlm_ns_proc_dir == NULL);
210 ldlm_type_proc_dir = lprocfs_register(OBD_LDLM_DEVICENAME,
213 if (IS_ERR(ldlm_type_proc_dir)) {
214 CERROR("LProcFS failed in ldlm-init\n");
215 rc = PTR_ERR(ldlm_type_proc_dir);
219 ldlm_ns_proc_dir = lprocfs_register("namespaces",
222 if (IS_ERR(ldlm_ns_proc_dir)) {
223 CERROR("LProcFS failed in ldlm-init\n");
224 rc = PTR_ERR(ldlm_ns_proc_dir);
228 ldlm_svc_proc_dir = lprocfs_register("services",
231 if (IS_ERR(ldlm_svc_proc_dir)) {
232 CERROR("LProcFS failed in ldlm-init\n");
233 rc = PTR_ERR(ldlm_svc_proc_dir);
237 rc = lprocfs_add_vars(ldlm_type_proc_dir, list, NULL);
239 CERROR("LProcFS failed in ldlm-init\n");
246 lprocfs_remove(&ldlm_svc_proc_dir);
248 lprocfs_remove(&ldlm_ns_proc_dir);
250 lprocfs_remove(&ldlm_type_proc_dir);
252 ldlm_svc_proc_dir = NULL;
256 void ldlm_proc_cleanup(void)
258 if (ldlm_svc_proc_dir)
259 lprocfs_remove(&ldlm_svc_proc_dir);
261 if (ldlm_ns_proc_dir)
262 lprocfs_remove(&ldlm_ns_proc_dir);
264 if (ldlm_type_proc_dir)
265 lprocfs_remove(&ldlm_type_proc_dir);
268 static int lprocfs_ns_resources_seq_show(struct seq_file *m, void *v)
270 struct ldlm_namespace *ns = m->private;
272 struct cfs_hash_bd bd;
275 /* result is not strictly consistant */
276 cfs_hash_for_each_bucket(ns->ns_rs_hash, &bd, i)
277 res += cfs_hash_bd_count_get(&bd);
278 return lprocfs_u64_seq_show(m, &res);
280 LPROC_SEQ_FOPS_RO(lprocfs_ns_resources);
282 static int lprocfs_ns_locks_seq_show(struct seq_file *m, void *v)
284 struct ldlm_namespace *ns = m->private;
287 locks = lprocfs_stats_collector(ns->ns_stats, LDLM_NSS_LOCKS,
288 LPROCFS_FIELDS_FLAGS_SUM);
289 return lprocfs_u64_seq_show(m, &locks);
291 LPROC_SEQ_FOPS_RO(lprocfs_ns_locks);
293 static int lprocfs_lru_size_seq_show(struct seq_file *m, void *v)
295 struct ldlm_namespace *ns = m->private;
296 __u32 *nr = &ns->ns_max_unused;
298 if (ns_connect_lru_resize(ns))
299 nr = &ns->ns_nr_unused;
300 return lprocfs_uint_seq_show(m, nr);
303 static ssize_t lprocfs_lru_size_seq_write(struct file *file,
304 const char __user *buffer,
305 size_t count, loff_t *off)
307 struct ldlm_namespace *ns = ((struct seq_file *)file->private_data)->private;
308 char dummy[MAX_STRING_SIZE + 1];
313 if (count >= sizeof(dummy))
319 if (copy_from_user(dummy, buffer, count))
324 if (strncmp(dummy, "clear", 5) == 0) {
326 "dropping all unused locks from namespace %s\n",
328 if (ns_connect_lru_resize(ns)) {
329 int canceled, unused = ns->ns_nr_unused;
331 /* Try to cancel all @ns_nr_unused locks. */
332 canceled = ldlm_cancel_lru(ns, unused, 0,
333 LDLM_LRU_FLAG_PASSED);
334 if (canceled < unused) {
336 "not all requested locks are canceled, "
337 "requested: %d, canceled: %d\n", unused,
342 tmp = ns->ns_max_unused;
343 ns->ns_max_unused = 0;
344 ldlm_cancel_lru(ns, 0, 0, LDLM_LRU_FLAG_PASSED);
345 ns->ns_max_unused = tmp;
350 tmp = simple_strtoul(dummy, &end, 0);
352 CERROR("invalid value written\n");
355 lru_resize = (tmp == 0);
357 if (ns_connect_lru_resize(ns)) {
359 ns->ns_max_unused = tmp;
361 if (tmp > ns->ns_nr_unused)
362 tmp = ns->ns_nr_unused;
363 tmp = ns->ns_nr_unused - tmp;
366 "changing namespace %s unused locks from %u to %u\n",
367 ldlm_ns_name(ns), ns->ns_nr_unused,
369 ldlm_cancel_lru(ns, tmp, LCF_ASYNC, LDLM_LRU_FLAG_PASSED);
373 "disable lru_resize for namespace %s\n",
375 ns->ns_connect_flags &= ~OBD_CONNECT_LRU_RESIZE;
379 "changing namespace %s max_unused from %u to %u\n",
380 ldlm_ns_name(ns), ns->ns_max_unused,
382 ns->ns_max_unused = (unsigned int)tmp;
383 ldlm_cancel_lru(ns, 0, LCF_ASYNC, LDLM_LRU_FLAG_PASSED);
385 /* Make sure that LRU resize was originally supported before
386 * turning it on here. */
388 (ns->ns_orig_connect_flags & OBD_CONNECT_LRU_RESIZE)) {
390 "enable lru_resize for namespace %s\n",
392 ns->ns_connect_flags |= OBD_CONNECT_LRU_RESIZE;
398 LPROC_SEQ_FOPS(lprocfs_lru_size);
400 static int lprocfs_elc_seq_show(struct seq_file *m, void *v)
402 struct ldlm_namespace *ns = m->private;
403 unsigned int supp = ns_connect_cancelset(ns);
405 return lprocfs_uint_seq_show(m, &supp);
408 static ssize_t lprocfs_elc_seq_write(struct file *file,
409 const char __user *buffer,
410 size_t count, loff_t *off)
412 struct ldlm_namespace *ns = ((struct seq_file *)file->private_data)->private;
413 unsigned int supp = -1;
416 rc = lprocfs_wr_uint(file, buffer, count, &supp);
421 ns->ns_connect_flags &= ~OBD_CONNECT_CANCELSET;
422 else if (ns->ns_orig_connect_flags & OBD_CONNECT_CANCELSET)
423 ns->ns_connect_flags |= OBD_CONNECT_CANCELSET;
426 LPROC_SEQ_FOPS(lprocfs_elc);
428 static void ldlm_namespace_proc_unregister(struct ldlm_namespace *ns)
430 if (ns->ns_proc_dir_entry == NULL)
431 CERROR("dlm namespace %s has no procfs dir?\n",
434 lprocfs_remove(&ns->ns_proc_dir_entry);
436 if (ns->ns_stats != NULL)
437 lprocfs_free_stats(&ns->ns_stats);
440 static int ldlm_namespace_proc_register(struct ldlm_namespace *ns)
442 struct lprocfs_vars lock_vars[2];
443 char lock_name[MAX_STRING_SIZE + 1];
444 struct proc_dir_entry *ns_pde;
447 LASSERT(ns->ns_rs_hash != NULL);
449 if (ns->ns_proc_dir_entry != NULL) {
450 ns_pde = ns->ns_proc_dir_entry;
452 ns_pde = proc_mkdir(ldlm_ns_name(ns), ldlm_ns_proc_dir);
455 ns->ns_proc_dir_entry = ns_pde;
458 ns->ns_stats = lprocfs_alloc_stats(LDLM_NSS_LAST, 0);
459 if (ns->ns_stats == NULL)
462 lprocfs_counter_init(ns->ns_stats, LDLM_NSS_LOCKS,
463 LPROCFS_CNTR_AVGMINMAX, "locks", "locks");
465 lock_name[MAX_STRING_SIZE] = '\0';
467 memset(lock_vars, 0, sizeof(lock_vars));
468 lock_vars[0].name = lock_name;
470 ldlm_add_var(&lock_vars[0], ns_pde, "resource_count", ns,
471 &lprocfs_ns_resources_fops);
472 ldlm_add_var(&lock_vars[0], ns_pde, "lock_count", ns,
473 &lprocfs_ns_locks_fops);
475 if (ns_is_client(ns)) {
476 ldlm_add_var(&lock_vars[0], ns_pde, "lock_unused_count",
477 &ns->ns_nr_unused, &ldlm_uint_fops);
478 ldlm_add_var(&lock_vars[0], ns_pde, "lru_size", ns,
479 &lprocfs_lru_size_fops);
480 ldlm_add_var(&lock_vars[0], ns_pde, "lru_max_age",
481 &ns->ns_max_age, &ldlm_rw_uint_fops);
482 ldlm_add_var(&lock_vars[0], ns_pde, "early_lock_cancel",
483 ns, &lprocfs_elc_fops);
485 ldlm_add_var(&lock_vars[0], ns_pde, "ctime_age_limit",
486 &ns->ns_ctime_age_limit, &ldlm_rw_uint_fops);
487 ldlm_add_var(&lock_vars[0], ns_pde, "lock_timeouts",
488 &ns->ns_timeouts, &ldlm_uint_fops);
489 ldlm_add_var(&lock_vars[0], ns_pde, "max_nolock_bytes",
490 &ns->ns_max_nolock_size, &ldlm_rw_uint_fops);
491 ldlm_add_var(&lock_vars[0], ns_pde, "contention_seconds",
492 &ns->ns_contention_time, &ldlm_rw_uint_fops);
493 ldlm_add_var(&lock_vars[0], ns_pde, "contended_locks",
494 &ns->ns_contended_locks, &ldlm_rw_uint_fops);
495 ldlm_add_var(&lock_vars[0], ns_pde, "max_parallel_ast",
496 &ns->ns_max_parallel_ast, &ldlm_rw_uint_fops);
500 #undef MAX_STRING_SIZE
501 #else /* CONFIG_PROC_FS */
503 #define ldlm_namespace_proc_unregister(ns) ({;})
504 #define ldlm_namespace_proc_register(ns) ({0;})
506 #endif /* CONFIG_PROC_FS */
508 static unsigned ldlm_res_hop_hash(struct cfs_hash *hs,
509 const void *key, unsigned mask)
511 const struct ldlm_res_id *id = key;
515 for (i = 0; i < RES_NAME_SIZE; i++)
520 static unsigned ldlm_res_hop_fid_hash(struct cfs_hash *hs,
521 const void *key, unsigned mask)
523 const struct ldlm_res_id *id = key;
528 fid.f_seq = id->name[LUSTRE_RES_ID_SEQ_OFF];
529 fid.f_oid = (__u32)id->name[LUSTRE_RES_ID_VER_OID_OFF];
530 fid.f_ver = (__u32)(id->name[LUSTRE_RES_ID_VER_OID_OFF] >> 32);
532 hash = fid_flatten32(&fid);
533 hash += (hash >> 4) + (hash << 12); /* mixing oid and seq */
534 if (id->name[LUSTRE_RES_ID_HSH_OFF] != 0) {
535 val = id->name[LUSTRE_RES_ID_HSH_OFF];
536 hash += (val >> 5) + (val << 11);
540 hash = hash_long(hash, hs->hs_bkt_bits);
541 /* give me another random factor */
542 hash -= hash_long((unsigned long)hs, val % 11 + 3);
544 hash <<= hs->hs_cur_bits - hs->hs_bkt_bits;
545 hash |= ldlm_res_hop_hash(hs, key, CFS_HASH_NBKT(hs) - 1);
550 static void *ldlm_res_hop_key(struct hlist_node *hnode)
552 struct ldlm_resource *res;
554 res = hlist_entry(hnode, struct ldlm_resource, lr_hash);
555 return &res->lr_name;
558 static int ldlm_res_hop_keycmp(const void *key, struct hlist_node *hnode)
560 struct ldlm_resource *res;
562 res = hlist_entry(hnode, struct ldlm_resource, lr_hash);
563 return ldlm_res_eq((const struct ldlm_res_id *)key,
564 (const struct ldlm_res_id *)&res->lr_name);
567 static void *ldlm_res_hop_object(struct hlist_node *hnode)
569 return hlist_entry(hnode, struct ldlm_resource, lr_hash);
573 ldlm_res_hop_get_locked(struct cfs_hash *hs, struct hlist_node *hnode)
575 struct ldlm_resource *res;
577 res = hlist_entry(hnode, struct ldlm_resource, lr_hash);
578 ldlm_resource_getref(res);
581 static void ldlm_res_hop_put(struct cfs_hash *hs, struct hlist_node *hnode)
583 struct ldlm_resource *res;
585 res = hlist_entry(hnode, struct ldlm_resource, lr_hash);
586 ldlm_resource_putref(res);
589 static struct cfs_hash_ops ldlm_ns_hash_ops = {
590 .hs_hash = ldlm_res_hop_hash,
591 .hs_key = ldlm_res_hop_key,
592 .hs_keycmp = ldlm_res_hop_keycmp,
594 .hs_object = ldlm_res_hop_object,
595 .hs_get = ldlm_res_hop_get_locked,
596 .hs_put = ldlm_res_hop_put
599 static struct cfs_hash_ops ldlm_ns_fid_hash_ops = {
600 .hs_hash = ldlm_res_hop_fid_hash,
601 .hs_key = ldlm_res_hop_key,
602 .hs_keycmp = ldlm_res_hop_keycmp,
604 .hs_object = ldlm_res_hop_object,
605 .hs_get = ldlm_res_hop_get_locked,
606 .hs_put = ldlm_res_hop_put
609 typedef struct ldlm_ns_hash_def {
610 enum ldlm_ns_type nsd_type;
611 /** hash bucket bits */
612 unsigned nsd_bkt_bits;
614 unsigned nsd_all_bits;
615 /** hash operations */
616 struct cfs_hash_ops *nsd_hops;
617 } ldlm_ns_hash_def_t;
619 static struct ldlm_ns_hash_def ldlm_ns_hash_defs[] =
622 .nsd_type = LDLM_NS_TYPE_MDC,
625 .nsd_hops = &ldlm_ns_fid_hash_ops,
628 .nsd_type = LDLM_NS_TYPE_MDT,
631 .nsd_hops = &ldlm_ns_fid_hash_ops,
634 .nsd_type = LDLM_NS_TYPE_OSC,
637 .nsd_hops = &ldlm_ns_hash_ops,
640 .nsd_type = LDLM_NS_TYPE_OST,
643 .nsd_hops = &ldlm_ns_hash_ops,
646 .nsd_type = LDLM_NS_TYPE_MGC,
649 .nsd_hops = &ldlm_ns_hash_ops,
652 .nsd_type = LDLM_NS_TYPE_MGT,
655 .nsd_hops = &ldlm_ns_hash_ops,
658 .nsd_type = LDLM_NS_TYPE_UNKNOWN,
663 * Create and initialize new empty namespace.
665 struct ldlm_namespace *ldlm_namespace_new(struct obd_device *obd, char *name,
666 enum ldlm_side client,
667 enum ldlm_appetite apt,
668 enum ldlm_ns_type ns_type)
670 struct ldlm_namespace *ns = NULL;
671 struct ldlm_ns_bucket *nsb;
672 struct ldlm_ns_hash_def *nsd;
673 struct cfs_hash_bd bd;
678 LASSERT(obd != NULL);
682 CERROR("ldlm_get_ref failed: %d\n", rc);
686 for (idx = 0;;idx++) {
687 nsd = &ldlm_ns_hash_defs[idx];
688 if (nsd->nsd_type == LDLM_NS_TYPE_UNKNOWN) {
689 CERROR("Unknown type %d for ns %s\n", ns_type, name);
693 if (nsd->nsd_type == ns_type)
701 ns->ns_rs_hash = cfs_hash_create(name,
702 nsd->nsd_all_bits, nsd->nsd_all_bits,
703 nsd->nsd_bkt_bits, sizeof(*nsb),
709 CFS_HASH_SPIN_BKTLOCK |
710 CFS_HASH_NO_ITEMREF);
711 if (ns->ns_rs_hash == NULL)
714 cfs_hash_for_each_bucket(ns->ns_rs_hash, &bd, idx) {
715 nsb = cfs_hash_bd_extra_get(ns->ns_rs_hash, &bd);
716 at_init(&nsb->nsb_at_estimate, ldlm_enqueue_min, 0);
717 nsb->nsb_namespace = ns;
718 nsb->nsb_reclaim_start = 0;
722 ns->ns_appetite = apt;
723 ns->ns_client = client;
725 INIT_LIST_HEAD(&ns->ns_list_chain);
726 INIT_LIST_HEAD(&ns->ns_unused_list);
727 spin_lock_init(&ns->ns_lock);
728 atomic_set(&ns->ns_bref, 0);
729 init_waitqueue_head(&ns->ns_waitq);
731 ns->ns_max_nolock_size = NS_DEFAULT_MAX_NOLOCK_BYTES;
732 ns->ns_contention_time = NS_DEFAULT_CONTENTION_SECONDS;
733 ns->ns_contended_locks = NS_DEFAULT_CONTENDED_LOCKS;
735 ns->ns_max_parallel_ast = LDLM_DEFAULT_PARALLEL_AST_LIMIT;
736 ns->ns_nr_unused = 0;
737 ns->ns_max_unused = LDLM_DEFAULT_LRU_SIZE;
738 ns->ns_max_age = LDLM_DEFAULT_MAX_ALIVE;
739 ns->ns_ctime_age_limit = LDLM_CTIME_AGE_LIMIT;
741 ns->ns_orig_connect_flags = 0;
742 ns->ns_connect_flags = 0;
744 ns->ns_reclaim_start = 0;
745 rc = ldlm_namespace_proc_register(ns);
747 CERROR("Can't initialize ns proc, rc %d\n", rc);
751 idx = ldlm_namespace_nr_read(client);
752 rc = ldlm_pool_init(&ns->ns_pool, ns, idx, client);
754 CERROR("Can't initialize lock pool, rc %d\n", rc);
758 ldlm_namespace_register(ns, client);
761 ldlm_namespace_proc_unregister(ns);
762 ldlm_namespace_cleanup(ns, 0);
764 cfs_hash_putref(ns->ns_rs_hash);
771 EXPORT_SYMBOL(ldlm_namespace_new);
773 extern struct ldlm_lock *ldlm_lock_get(struct ldlm_lock *lock);
776 * Cancel and destroy all locks on a resource.
778 * If flags contains FL_LOCAL_ONLY, don't try to tell the server, just
779 * clean up. This is currently only used for recovery, and we make
780 * certain assumptions as a result--notably, that we shouldn't cancel
783 static void cleanup_resource(struct ldlm_resource *res, struct list_head *q,
786 struct list_head *tmp;
787 int rc = 0, client = ns_is_client(ldlm_res_to_ns(res));
788 bool local_only = !!(flags & LDLM_FL_LOCAL_ONLY);
791 struct ldlm_lock *lock = NULL;
793 /* First, we look for non-cleaned-yet lock
794 * all cleaned locks are marked by CLEANED flag. */
796 list_for_each(tmp, q) {
797 lock = list_entry(tmp, struct ldlm_lock,
799 if (ldlm_is_cleaned(lock)) {
804 ldlm_set_cleaned(lock);
813 /* Set CBPENDING so nothing in the cancellation path
814 * can match this lock. */
815 ldlm_set_cbpending(lock);
816 ldlm_set_failed(lock);
817 lock->l_flags |= flags;
819 /* ... without sending a CANCEL message for local_only. */
821 ldlm_set_local_only(lock);
823 if (local_only && (lock->l_readers || lock->l_writers)) {
824 /* This is a little bit gross, but much better than the
825 * alternative: pretend that we got a blocking AST from
826 * the server, so that when the lock is decref'd, it
827 * will go away ... */
829 LDLM_DEBUG(lock, "setting FL_LOCAL_ONLY");
830 if (lock->l_flags & LDLM_FL_FAIL_LOC) {
831 set_current_state(TASK_UNINTERRUPTIBLE);
832 schedule_timeout(cfs_time_seconds(4));
833 set_current_state(TASK_RUNNING);
835 if (lock->l_completion_ast)
836 lock->l_completion_ast(lock,
837 LDLM_FL_FAILED, NULL);
838 LDLM_LOCK_RELEASE(lock);
843 struct lustre_handle lockh;
846 ldlm_lock2handle(lock, &lockh);
847 rc = ldlm_cli_cancel(&lockh, LCF_LOCAL);
849 CERROR("ldlm_cli_cancel: %d\n", rc);
852 LDLM_DEBUG(lock, "Freeing a lock still held by a "
854 ldlm_lock_cancel(lock);
856 LDLM_LOCK_RELEASE(lock);
860 static int ldlm_resource_clean(struct cfs_hash *hs, struct cfs_hash_bd *bd,
861 struct hlist_node *hnode, void *arg)
863 struct ldlm_resource *res = cfs_hash_object(hs, hnode);
864 __u64 flags = *(__u64 *)arg;
866 cleanup_resource(res, &res->lr_granted, flags);
867 cleanup_resource(res, &res->lr_converting, flags);
868 cleanup_resource(res, &res->lr_waiting, flags);
873 static int ldlm_resource_complain(struct cfs_hash *hs, struct cfs_hash_bd *bd,
874 struct hlist_node *hnode, void *arg)
876 struct ldlm_resource *res = cfs_hash_object(hs, hnode);
879 CERROR("%s: namespace resource "DLDLMRES" (%p) refcount nonzero "
880 "(%d) after lock cleanup; forcing cleanup.\n",
881 ldlm_ns_name(ldlm_res_to_ns(res)), PLDLMRES(res), res,
882 atomic_read(&res->lr_refcount) - 1);
884 ldlm_resource_dump(D_ERROR, res);
890 * Cancel and destroy all locks in the namespace.
892 * Typically used during evictions when server notified client that it was
893 * evicted and all of its state needs to be destroyed.
894 * Also used during shutdown.
896 int ldlm_namespace_cleanup(struct ldlm_namespace *ns, __u64 flags)
899 CDEBUG(D_INFO, "NULL ns, skipping cleanup\n");
903 cfs_hash_for_each_nolock(ns->ns_rs_hash, ldlm_resource_clean,
905 cfs_hash_for_each_nolock(ns->ns_rs_hash, ldlm_resource_complain,
909 EXPORT_SYMBOL(ldlm_namespace_cleanup);
912 * Attempts to free namespace.
914 * Only used when namespace goes away, like during an unmount.
916 static int __ldlm_namespace_free(struct ldlm_namespace *ns, int force)
920 /* At shutdown time, don't call the cancellation callback */
921 ldlm_namespace_cleanup(ns, force ? LDLM_FL_LOCAL_ONLY : 0);
923 if (atomic_read(&ns->ns_bref) > 0) {
924 struct l_wait_info lwi = LWI_INTR(LWI_ON_SIGNAL_NOOP, NULL);
927 "dlm namespace %s free waiting on refcount %d\n",
928 ldlm_ns_name(ns), atomic_read(&ns->ns_bref));
931 lwi = LWI_TIMEOUT(msecs_to_jiffies(obd_timeout *
932 MSEC_PER_SEC) / 4, NULL, NULL);
934 rc = l_wait_event(ns->ns_waitq,
935 atomic_read(&ns->ns_bref) == 0, &lwi);
937 /* Forced cleanups should be able to reclaim all references,
938 * so it's safe to wait forever... we can't leak locks... */
939 if (force && rc == -ETIMEDOUT) {
940 LCONSOLE_ERROR("Forced cleanup waiting for %s "
941 "namespace with %d resources in use, "
942 "(rc=%d)\n", ldlm_ns_name(ns),
943 atomic_read(&ns->ns_bref), rc);
944 GOTO(force_wait, rc);
947 if (atomic_read(&ns->ns_bref)) {
948 LCONSOLE_ERROR("Cleanup waiting for %s namespace "
949 "with %d resources in use, (rc=%d)\n",
951 atomic_read(&ns->ns_bref), rc);
952 RETURN(ELDLM_NAMESPACE_EXISTS);
954 CDEBUG(D_DLMTRACE, "dlm namespace %s free done waiting\n",
962 * Performs various cleanups for passed \a ns to make it drop refc and be
963 * ready for freeing. Waits for refc == 0.
965 * The following is done:
966 * (0) Unregister \a ns from its list to make inaccessible for potential
967 * users like pools thread and others;
968 * (1) Clear all locks in \a ns.
970 void ldlm_namespace_free_prior(struct ldlm_namespace *ns,
971 struct obd_import *imp,
981 spin_lock(&ns->ns_lock);
983 spin_unlock(&ns->ns_lock);
986 * Can fail with -EINTR when force == 0 in which case try harder.
988 rc = __ldlm_namespace_free(ns, force);
989 if (rc != ELDLM_OK) {
991 ptlrpc_disconnect_import(imp, 0);
992 ptlrpc_invalidate_import(imp);
996 * With all requests dropped and the import inactive
997 * we are gaurenteed all reference will be dropped.
999 rc = __ldlm_namespace_free(ns, 1);
1004 EXPORT_SYMBOL(ldlm_namespace_free_prior);
1007 * Performs freeing memory structures related to \a ns. This is only done
1008 * when ldlm_namespce_free_prior() successfully removed all resources
1009 * referencing \a ns and its refc == 0.
1011 void ldlm_namespace_free_post(struct ldlm_namespace *ns)
1019 /* Make sure that nobody can find this ns in its list. */
1020 ldlm_namespace_unregister(ns, ns->ns_client);
1021 /* Fini pool _before_ parent proc dir is removed. This is important as
1022 * ldlm_pool_fini() removes own proc dir which is child to @dir.
1023 * Removing it after @dir may cause oops. */
1024 ldlm_pool_fini(&ns->ns_pool);
1026 ldlm_namespace_proc_unregister(ns);
1027 cfs_hash_putref(ns->ns_rs_hash);
1028 /* Namespace \a ns should be not on list at this time, otherwise
1029 * this will cause issues related to using freed \a ns in poold
1031 LASSERT(list_empty(&ns->ns_list_chain));
1036 EXPORT_SYMBOL(ldlm_namespace_free_post);
1039 * Cleanup the resource, and free namespace.
1042 * proc1: destroy import
1043 * class_disconnect_export(grab cl_sem) ->
1044 * -> ldlm_namespace_free ->
1045 * -> lprocfs_remove(grab _lprocfs_lock).
1046 * proc2: read proc info
1047 * lprocfs_fops_read(grab _lprocfs_lock) ->
1048 * -> osc_rd_active, etc(grab cl_sem).
1050 * So that I have to split the ldlm_namespace_free into two parts - the first
1051 * part ldlm_namespace_free_prior is used to cleanup the resource which is
1052 * being used; the 2nd part ldlm_namespace_free_post is used to unregister the
1053 * lprocfs entries, and then free memory. It will be called w/o cli->cl_sem
1056 void ldlm_namespace_free(struct ldlm_namespace *ns,
1057 struct obd_import *imp,
1060 ldlm_namespace_free_prior(ns, imp, force);
1061 ldlm_namespace_free_post(ns);
1063 EXPORT_SYMBOL(ldlm_namespace_free);
1065 void ldlm_namespace_get(struct ldlm_namespace *ns)
1067 atomic_inc(&ns->ns_bref);
1070 /* This is only for callers that care about refcount */
1071 static int ldlm_namespace_get_return(struct ldlm_namespace *ns)
1073 return atomic_inc_return(&ns->ns_bref);
1076 void ldlm_namespace_put(struct ldlm_namespace *ns)
1078 if (atomic_dec_and_lock(&ns->ns_bref, &ns->ns_lock)) {
1079 wake_up(&ns->ns_waitq);
1080 spin_unlock(&ns->ns_lock);
1084 /** Register \a ns in the list of namespaces */
1085 void ldlm_namespace_register(struct ldlm_namespace *ns, enum ldlm_side client)
1087 mutex_lock(ldlm_namespace_lock(client));
1088 LASSERT(list_empty(&ns->ns_list_chain));
1089 list_add(&ns->ns_list_chain, ldlm_namespace_inactive_list(client));
1090 ldlm_namespace_nr_inc(client);
1091 mutex_unlock(ldlm_namespace_lock(client));
1094 /** Unregister \a ns from the list of namespaces. */
1095 void ldlm_namespace_unregister(struct ldlm_namespace *ns, enum ldlm_side client)
1097 mutex_lock(ldlm_namespace_lock(client));
1098 LASSERT(!list_empty(&ns->ns_list_chain));
1099 /* Some asserts and possibly other parts of the code are still
1100 * using list_empty(&ns->ns_list_chain). This is why it is
1101 * important to use list_del_init() here. */
1102 list_del_init(&ns->ns_list_chain);
1103 ldlm_namespace_nr_dec(client);
1104 mutex_unlock(ldlm_namespace_lock(client));
1107 /** Should be called with ldlm_namespace_lock(client) taken. */
1108 void ldlm_namespace_move_to_active_locked(struct ldlm_namespace *ns,
1109 enum ldlm_side client)
1111 LASSERT(!list_empty(&ns->ns_list_chain));
1112 LASSERT(mutex_is_locked(ldlm_namespace_lock(client)));
1113 list_move_tail(&ns->ns_list_chain, ldlm_namespace_list(client));
1116 /** Should be called with ldlm_namespace_lock(client) taken. */
1117 void ldlm_namespace_move_to_inactive_locked(struct ldlm_namespace *ns,
1118 enum ldlm_side client)
1120 LASSERT(!list_empty(&ns->ns_list_chain));
1121 LASSERT(mutex_is_locked(ldlm_namespace_lock(client)));
1122 list_move_tail(&ns->ns_list_chain,
1123 ldlm_namespace_inactive_list(client));
1126 /** Should be called with ldlm_namespace_lock(client) taken. */
1127 struct ldlm_namespace *ldlm_namespace_first_locked(enum ldlm_side client)
1129 LASSERT(mutex_is_locked(ldlm_namespace_lock(client)));
1130 LASSERT(!list_empty(ldlm_namespace_list(client)));
1131 return container_of(ldlm_namespace_list(client)->next,
1132 struct ldlm_namespace, ns_list_chain);
1135 /** Create and initialize new resource. */
1136 static struct ldlm_resource *ldlm_resource_new(enum ldlm_type ldlm_type)
1138 struct ldlm_resource *res;
1141 OBD_SLAB_ALLOC_PTR_GFP(res, ldlm_resource_slab, GFP_NOFS);
1145 if (ldlm_type == LDLM_EXTENT) {
1146 OBD_SLAB_ALLOC(res->lr_itree, ldlm_interval_tree_slab,
1147 sizeof(*res->lr_itree) * LCK_MODE_NUM);
1148 if (res->lr_itree == NULL) {
1149 OBD_SLAB_FREE_PTR(res, ldlm_resource_slab);
1152 /* Initialize interval trees for each lock mode. */
1153 for (idx = 0; idx < LCK_MODE_NUM; idx++) {
1154 res->lr_itree[idx].lit_size = 0;
1155 res->lr_itree[idx].lit_mode = 1 << idx;
1156 res->lr_itree[idx].lit_root = NULL;
1160 INIT_LIST_HEAD(&res->lr_granted);
1161 INIT_LIST_HEAD(&res->lr_converting);
1162 INIT_LIST_HEAD(&res->lr_waiting);
1164 atomic_set(&res->lr_refcount, 1);
1165 spin_lock_init(&res->lr_lock);
1166 lu_ref_init(&res->lr_reference);
1168 /* Since LVB init can be delayed now, there is no longer need to
1169 * immediatelly acquire mutex here. */
1170 mutex_init(&res->lr_lvb_mutex);
1171 res->lr_lvb_initialized = false;
1177 * Return a reference to resource with given name, creating it if necessary.
1178 * Args: namespace with ns_lock unlocked
1179 * Locks: takes and releases NS hash-lock and res->lr_lock
1180 * Returns: referenced, unlocked ldlm_resource or NULL
1182 struct ldlm_resource *
1183 ldlm_resource_get(struct ldlm_namespace *ns, struct ldlm_resource *parent,
1184 const struct ldlm_res_id *name, enum ldlm_type type,
1187 struct hlist_node *hnode;
1188 struct ldlm_resource *res = NULL;
1189 struct cfs_hash_bd bd;
1191 int ns_refcount = 0;
1193 LASSERT(ns != NULL);
1194 LASSERT(parent == NULL);
1195 LASSERT(ns->ns_rs_hash != NULL);
1196 LASSERT(name->name[0] != 0);
1198 cfs_hash_bd_get_and_lock(ns->ns_rs_hash, (void *)name, &bd, 0);
1199 hnode = cfs_hash_bd_lookup_locked(ns->ns_rs_hash, &bd, (void *)name);
1200 if (hnode != NULL) {
1201 cfs_hash_bd_unlock(ns->ns_rs_hash, &bd, 0);
1205 version = cfs_hash_bd_version_get(&bd);
1206 cfs_hash_bd_unlock(ns->ns_rs_hash, &bd, 0);
1209 return ERR_PTR(-ENOENT);
1211 LASSERTF(type >= LDLM_MIN_TYPE && type < LDLM_MAX_TYPE,
1212 "type: %d\n", type);
1213 res = ldlm_resource_new(type);
1215 return ERR_PTR(-ENOMEM);
1217 res->lr_ns_bucket = cfs_hash_bd_extra_get(ns->ns_rs_hash, &bd);
1218 res->lr_name = *name;
1219 res->lr_type = type;
1221 cfs_hash_bd_lock(ns->ns_rs_hash, &bd, 1);
1222 hnode = (version == cfs_hash_bd_version_get(&bd)) ? NULL :
1223 cfs_hash_bd_lookup_locked(ns->ns_rs_hash, &bd, (void *)name);
1225 if (hnode != NULL) {
1226 /* Someone won the race and already added the resource. */
1227 cfs_hash_bd_unlock(ns->ns_rs_hash, &bd, 1);
1228 /* Clean lu_ref for failed resource. */
1229 lu_ref_fini(&res->lr_reference);
1230 if (res->lr_itree != NULL)
1231 OBD_SLAB_FREE(res->lr_itree, ldlm_interval_tree_slab,
1232 sizeof(*res->lr_itree) * LCK_MODE_NUM);
1233 OBD_SLAB_FREE(res, ldlm_resource_slab, sizeof *res);
1235 res = hlist_entry(hnode, struct ldlm_resource, lr_hash);
1238 /* We won! Let's add the resource. */
1239 cfs_hash_bd_add_locked(ns->ns_rs_hash, &bd, &res->lr_hash);
1240 if (cfs_hash_bd_count_get(&bd) == 1)
1241 ns_refcount = ldlm_namespace_get_return(ns);
1243 cfs_hash_bd_unlock(ns->ns_rs_hash, &bd, 1);
1245 OBD_FAIL_TIMEOUT(OBD_FAIL_LDLM_CREATE_RESOURCE, 2);
1247 /* Let's see if we happened to be the very first resource in this
1248 * namespace. If so, and this is a client namespace, we need to move
1249 * the namespace into the active namespaces list to be patrolled by
1250 * the ldlm_poold. */
1251 if (ns_is_client(ns) && ns_refcount == 1) {
1252 mutex_lock(ldlm_namespace_lock(LDLM_NAMESPACE_CLIENT));
1253 ldlm_namespace_move_to_active_locked(ns, LDLM_NAMESPACE_CLIENT);
1254 mutex_unlock(ldlm_namespace_lock(LDLM_NAMESPACE_CLIENT));
1259 EXPORT_SYMBOL(ldlm_resource_get);
1261 struct ldlm_resource *ldlm_resource_getref(struct ldlm_resource *res)
1263 LASSERT(res != NULL);
1264 LASSERT(res != LP_POISON);
1265 atomic_inc(&res->lr_refcount);
1266 CDEBUG(D_INFO, "getref res: %p count: %d\n", res,
1267 atomic_read(&res->lr_refcount));
1271 static void __ldlm_resource_putref_final(struct cfs_hash_bd *bd,
1272 struct ldlm_resource *res)
1274 struct ldlm_ns_bucket *nsb = res->lr_ns_bucket;
1276 if (!list_empty(&res->lr_granted)) {
1277 ldlm_resource_dump(D_ERROR, res);
1281 if (!list_empty(&res->lr_converting)) {
1282 ldlm_resource_dump(D_ERROR, res);
1286 if (!list_empty(&res->lr_waiting)) {
1287 ldlm_resource_dump(D_ERROR, res);
1291 cfs_hash_bd_del_locked(nsb->nsb_namespace->ns_rs_hash,
1293 lu_ref_fini(&res->lr_reference);
1294 if (cfs_hash_bd_count_get(bd) == 0)
1295 ldlm_namespace_put(nsb->nsb_namespace);
1298 /* Returns 1 if the resource was freed, 0 if it remains. */
1299 int ldlm_resource_putref(struct ldlm_resource *res)
1301 struct ldlm_namespace *ns = ldlm_res_to_ns(res);
1302 struct cfs_hash_bd bd;
1304 LASSERT_ATOMIC_GT_LT(&res->lr_refcount, 0, LI_POISON);
1305 CDEBUG(D_INFO, "putref res: %p count: %d\n",
1306 res, atomic_read(&res->lr_refcount) - 1);
1308 cfs_hash_bd_get(ns->ns_rs_hash, &res->lr_name, &bd);
1309 if (cfs_hash_bd_dec_and_lock(ns->ns_rs_hash, &bd, &res->lr_refcount)) {
1310 __ldlm_resource_putref_final(&bd, res);
1311 cfs_hash_bd_unlock(ns->ns_rs_hash, &bd, 1);
1312 if (ns->ns_lvbo && ns->ns_lvbo->lvbo_free)
1313 ns->ns_lvbo->lvbo_free(res);
1314 if (res->lr_itree != NULL)
1315 OBD_SLAB_FREE(res->lr_itree, ldlm_interval_tree_slab,
1316 sizeof(*res->lr_itree) * LCK_MODE_NUM);
1317 OBD_SLAB_FREE(res, ldlm_resource_slab, sizeof *res);
1322 EXPORT_SYMBOL(ldlm_resource_putref);
1325 * Add a lock into a given resource into specified lock list.
1327 void ldlm_resource_add_lock(struct ldlm_resource *res, struct list_head *head,
1328 struct ldlm_lock *lock)
1330 check_res_locked(res);
1332 LDLM_DEBUG(lock, "About to add this lock");
1334 if (ldlm_is_destroyed(lock)) {
1335 CDEBUG(D_OTHER, "Lock destroyed, not adding to resource\n");
1339 LASSERT(list_empty(&lock->l_res_link));
1341 list_add_tail(&lock->l_res_link, head);
1345 * Insert a lock into resource after specified lock.
1347 * Obtain resource description from the lock we are inserting after.
1349 void ldlm_resource_insert_lock_after(struct ldlm_lock *original,
1350 struct ldlm_lock *new)
1352 struct ldlm_resource *res = original->l_resource;
1354 check_res_locked(res);
1356 ldlm_resource_dump(D_INFO, res);
1357 LDLM_DEBUG(new, "About to insert this lock after %p: ", original);
1359 if (ldlm_is_destroyed(new)) {
1360 CDEBUG(D_OTHER, "Lock destroyed, not adding to resource\n");
1364 LASSERT(list_empty(&new->l_res_link));
1366 list_add(&new->l_res_link, &original->l_res_link);
1370 void ldlm_resource_unlink_lock(struct ldlm_lock *lock)
1372 int type = lock->l_resource->lr_type;
1374 check_res_locked(lock->l_resource);
1375 if (type == LDLM_IBITS || type == LDLM_PLAIN)
1376 ldlm_unlink_lock_skiplist(lock);
1377 else if (type == LDLM_EXTENT)
1378 ldlm_extent_unlink_lock(lock);
1379 list_del_init(&lock->l_res_link);
1381 EXPORT_SYMBOL(ldlm_resource_unlink_lock);
1383 void ldlm_res2desc(struct ldlm_resource *res, struct ldlm_resource_desc *desc)
1385 desc->lr_type = res->lr_type;
1386 desc->lr_name = res->lr_name;
1390 * Print information about all locks in all namespaces on this node to debug
1393 void ldlm_dump_all_namespaces(enum ldlm_side client, int level)
1395 struct list_head *tmp;
1397 if (!((libcfs_debug | D_ERROR) & level))
1400 mutex_lock(ldlm_namespace_lock(client));
1402 list_for_each(tmp, ldlm_namespace_list(client)) {
1403 struct ldlm_namespace *ns;
1405 ns = list_entry(tmp, struct ldlm_namespace, ns_list_chain);
1406 ldlm_namespace_dump(level, ns);
1409 mutex_unlock(ldlm_namespace_lock(client));
1412 static int ldlm_res_hash_dump(struct cfs_hash *hs, struct cfs_hash_bd *bd,
1413 struct hlist_node *hnode, void *arg)
1415 struct ldlm_resource *res = cfs_hash_object(hs, hnode);
1416 int level = (int)(unsigned long)arg;
1419 ldlm_resource_dump(level, res);
1426 * Print information about all locks in this namespace on this node to debug
1429 void ldlm_namespace_dump(int level, struct ldlm_namespace *ns)
1431 if (!((libcfs_debug | D_ERROR) & level))
1434 CDEBUG(level, "--- Namespace: %s (rc: %d, side: %s)\n",
1435 ldlm_ns_name(ns), atomic_read(&ns->ns_bref),
1436 ns_is_client(ns) ? "client" : "server");
1438 if (cfs_time_before(cfs_time_current(), ns->ns_next_dump))
1441 cfs_hash_for_each_nolock(ns->ns_rs_hash,
1443 (void *)(unsigned long)level, 0);
1444 spin_lock(&ns->ns_lock);
1445 ns->ns_next_dump = cfs_time_shift(10);
1446 spin_unlock(&ns->ns_lock);
1450 * Print information about all locks in this resource to debug log.
1452 void ldlm_resource_dump(int level, struct ldlm_resource *res)
1454 struct ldlm_lock *lock;
1455 unsigned int granted = 0;
1457 CLASSERT(RES_NAME_SIZE == 4);
1459 if (!((libcfs_debug | D_ERROR) & level))
1462 CDEBUG(level, "--- Resource: "DLDLMRES" (%p) refcount = %d\n",
1463 PLDLMRES(res), res, atomic_read(&res->lr_refcount));
1465 if (!list_empty(&res->lr_granted)) {
1466 CDEBUG(level, "Granted locks (in reverse order):\n");
1467 list_for_each_entry_reverse(lock, &res->lr_granted,
1469 LDLM_DEBUG_LIMIT(level, lock, "###");
1470 if (!(level & D_CANTMASK) &&
1471 ++granted > ldlm_dump_granted_max) {
1472 CDEBUG(level, "only dump %d granted locks to "
1473 "avoid DDOS.\n", granted);
1478 if (!list_empty(&res->lr_converting)) {
1479 CDEBUG(level, "Converting locks:\n");
1480 list_for_each_entry(lock, &res->lr_converting, l_res_link)
1481 LDLM_DEBUG_LIMIT(level, lock, "###");
1483 if (!list_empty(&res->lr_waiting)) {
1484 CDEBUG(level, "Waiting locks:\n");
1485 list_for_each_entry(lock, &res->lr_waiting, l_res_link)
1486 LDLM_DEBUG_LIMIT(level, lock, "###");
1489 EXPORT_SYMBOL(ldlm_resource_dump);