lustre/ldlm/ldlm_lock.c

   1 /* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
   2  * vim:expandtab:shiftwidth=8:tabstop=8:
   3  *
   4  *  Copyright (c) 2002, 2003 Cluster File Systems, Inc.
   5  *   Author: Peter Braam <braam@clusterfs.com>
   6  *   Author: Phil Schwan <phil@clusterfs.com>
   7  *
   8  *   This file is part of the Lustre file system, http://www.lustre.org
   9  *   Lustre is a trademark of Cluster File Systems, Inc.
  10  *
  11  *   You may have signed or agreed to another license before downloading
  12  *   this software.  If so, you are bound by the terms and conditions
  13  *   of that agreement, and the following does not apply to you.  See the
  14  *   LICENSE file included with this distribution for more information.
  15  *
  16  *   If you did not agree to a different license, then this copy of Lustre
  17  *   is open source software; you can redistribute it and/or modify it
  18  *   under the terms of version 2 of the GNU General Public License as
  19  *   published by the Free Software Foundation.
  20  *
  21  *   In either case, Lustre is distributed in the hope that it will be
  22  *   useful, but WITHOUT ANY WARRANTY; without even the implied warranty
  23  *   of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  24  *   license text for more details.
  25  */
  26
  27 #define DEBUG_SUBSYSTEM S_LDLM
  28
  29 #ifdef __KERNEL__
  30 # include <libcfs/libcfs.h>
  31 # include <linux/lustre_intent.h>
  32 #else
  33 # include <liblustre.h>
  34 # include <libcfs/kp30.h>
  35 #endif
  36
  37 #include <obd_class.h>
  38 #include "ldlm_internal.h"
  39
  40 //struct lustre_lock ldlm_everything_lock;
  41
  42 /* lock's skip list pointers fix mode */
  43 #define LDLM_JOIN_NONE          0
  44 #define LDLM_MODE_JOIN_RIGHT    1
  45 #define LDLM_MODE_JOIN_LEFT     (1 << 1)
  46 #define LDLM_POLICY_JOIN_RIGHT  (1 << 2)
  47 #define LDLM_POLICY_JOIN_LEFT   (1 << 3)
  48
  49 /* lock types */
  50 char *ldlm_lockname[] = {
  51         [0] "--",
  52         [LCK_EX] "EX",
  53         [LCK_PW] "PW",
  54         [LCK_PR] "PR",
  55         [LCK_CW] "CW",
  56         [LCK_CR] "CR",
  57         [LCK_NL] "NL",
  58         [LCK_GROUP] "GROUP"
  59 };
  60
  61 char *ldlm_typename[] = {
  62         [LDLM_PLAIN] "PLN",
  63         [LDLM_EXTENT] "EXT",
  64         [LDLM_FLOCK] "FLK",
  65         [LDLM_IBITS] "IBT",
  66 };
  67
  68 char *ldlm_it2str(int it)
  69 {
  70         switch (it) {
  71         case IT_OPEN:
  72                 return "open";
  73         case IT_CREAT:
  74                 return "creat";
  75         case (IT_OPEN | IT_CREAT):
  76                 return "open|creat";
  77         case IT_READDIR:
  78                 return "readdir";
  79         case IT_GETATTR:
  80                 return "getattr";
  81         case IT_LOOKUP:
  82                 return "lookup";
  83         case IT_UNLINK:
  84                 return "unlink";
  85         case IT_GETXATTR:
  86                 return "getxattr";
  87         default:
  88                 CERROR("Unknown intent %d\n", it);
  89                 return "UNKNOWN";
  90         }
  91 }
  92
  93 extern cfs_mem_cache_t *ldlm_lock_slab;
  94
  95 static ldlm_processing_policy ldlm_processing_policy_table[] = {
  96         [LDLM_PLAIN] ldlm_process_plain_lock,
  97         [LDLM_EXTENT] ldlm_process_extent_lock,
  98 #ifdef __KERNEL__
  99         [LDLM_FLOCK] ldlm_process_flock_lock,
 100 #endif
 101         [LDLM_IBITS] ldlm_process_inodebits_lock,
 102 };
 103
 104 ldlm_processing_policy ldlm_get_processing_policy(struct ldlm_resource *res)
 105 {
 106         return ldlm_processing_policy_table[res->lr_type];
 107 }
 108
 109 void ldlm_register_intent(struct ldlm_namespace *ns, ldlm_res_policy arg)
 110 {
 111         ns->ns_policy = arg;
 112 }
 113
 114 /*
 115  * REFCOUNTED LOCK OBJECTS
 116  */
 117
 118
 119 /*
 120  * Lock refcounts, during creation:
 121  *   - one special one for allocation, dec'd only once in destroy
 122  *   - one for being a lock that's in-use
 123  *   - one for the addref associated with a new lock
 124  */
 125 struct ldlm_lock *ldlm_lock_get(struct ldlm_lock *lock)
 126 {
 127         atomic_inc(&lock->l_refc);
 128         return lock;
 129 }
 130
 131 void ldlm_lock_put(struct ldlm_lock *lock)
 132 {
 133         ENTRY;
 134
 135         LASSERT(lock->l_resource != LP_POISON);
 136         LASSERT(atomic_read(&lock->l_refc) > 0);
 137         if (atomic_dec_and_test(&lock->l_refc)) {
 138                 struct ldlm_resource *res;
 139
 140                 LDLM_DEBUG(lock, "final lock_put on destroyed lock, freeing it.");
 141
 142                 res = lock->l_resource;
 143                 LASSERT(lock->l_destroyed);
 144                 LASSERT(list_empty(&lock->l_res_link));
 145                 LASSERT(list_empty(&lock->l_pending_chain));
 146
 147                 if (lock->l_parent)
 148                         LDLM_LOCK_PUT(lock->l_parent);
 149
 150                 atomic_dec(&res->lr_namespace->ns_locks);
 151                 ldlm_resource_putref(res);
 152                 lock->l_resource = NULL;
 153                 if (lock->l_export)
 154                         class_export_put(lock->l_export);
 155
 156                 if (lock->l_lvb_data != NULL)
 157                         OBD_FREE(lock->l_lvb_data, lock->l_lvb_len);
 158
 159                 OBD_SLAB_FREE(lock, ldlm_lock_slab, sizeof(*lock));
 160         }
 161
 162         EXIT;
 163 }
 164
 165 int ldlm_lock_remove_from_lru_nolock(struct ldlm_lock *lock)
 166 {
 167         int rc = 0;
 168         if (!list_empty(&lock->l_lru)) {
 169                 LASSERT(lock->l_resource->lr_type != LDLM_FLOCK);
 170                 list_del_init(&lock->l_lru);
 171                 lock->l_resource->lr_namespace->ns_nr_unused--;
 172                 LASSERT(lock->l_resource->lr_namespace->ns_nr_unused >= 0);
 173                 rc = 1;
 174         }
 175         return rc;
 176 }
 177
 178 int ldlm_lock_remove_from_lru(struct ldlm_lock *lock)
 179 {
 180         int rc;
 181         ENTRY;
 182         spin_lock(&lock->l_resource->lr_namespace->ns_unused_lock);
 183         rc = ldlm_lock_remove_from_lru_nolock(lock);
 184         spin_unlock(&lock->l_resource->lr_namespace->ns_unused_lock);
 185         EXIT;
 186         return rc;
 187 }
 188
 189 /* This used to have a 'strict' flag, which recovery would use to mark an
 190  * in-use lock as needing-to-die.  Lest I am ever tempted to put it back, I
 191  * shall explain why it's gone: with the new hash table scheme, once you call
 192  * ldlm_lock_destroy, you can never drop your final references on this lock.
 193  * Because it's not in the hash table anymore.  -phil */
 194 int ldlm_lock_destroy_internal(struct ldlm_lock *lock)
 195 {
 196         ENTRY;
 197
 198         if (!list_empty(&lock->l_children)) {
 199                 LDLM_ERROR(lock, "still has children (%p)!",
 200                            lock->l_children.next);
 201                 ldlm_lock_dump(D_ERROR, lock, 0);
 202                 LBUG();
 203         }
 204         if (lock->l_readers || lock->l_writers) {
 205                 LDLM_ERROR(lock, "lock still has references");
 206                 ldlm_lock_dump(D_ERROR, lock, 0);
 207                 LBUG();
 208         }
 209
 210         if (!list_empty(&lock->l_res_link)) {
 211                 LDLM_ERROR(lock, "lock still on resource");
 212                 ldlm_lock_dump(D_ERROR, lock, 0);
 213                 LBUG();
 214         }
 215
 216         if (lock->l_destroyed) {
 217                 LASSERT(list_empty(&lock->l_lru));
 218                 EXIT;
 219                 return 0;
 220         }
 221         lock->l_destroyed = 1;
 222
 223         if (lock->l_export)
 224                 spin_lock(&lock->l_export->exp_ldlm_data.led_lock);
 225         list_del_init(&lock->l_export_chain);
 226         if (lock->l_export)
 227                 spin_unlock(&lock->l_export->exp_ldlm_data.led_lock);
 228
 229         ldlm_lock_remove_from_lru(lock);
 230         class_handle_unhash(&lock->l_handle);
 231
 232 #if 0
 233         /* Wake anyone waiting for this lock */
 234         /* FIXME: I should probably add yet another flag, instead of using
 235          * l_export to only call this on clients */
 236         if (lock->l_export)
 237                 class_export_put(lock->l_export);
 238         lock->l_export = NULL;
 239         if (lock->l_export && lock->l_completion_ast)
 240                 lock->l_completion_ast(lock, 0);
 241 #endif
 242         EXIT;
 243         return 1;
 244 }
 245
 246 void ldlm_lock_destroy(struct ldlm_lock *lock)
 247 {
 248         int first;
 249         ENTRY;
 250         lock_res_and_lock(lock);
 251         first = ldlm_lock_destroy_internal(lock);
 252         unlock_res_and_lock(lock);
 253
 254         /* drop reference from hashtable only for first destroy */
 255         if (first)
 256                 LDLM_LOCK_PUT(lock);
 257         EXIT;
 258 }
 259
 260 void ldlm_lock_destroy_nolock(struct ldlm_lock *lock)
 261 {
 262         int first;
 263         ENTRY;
 264         first = ldlm_lock_destroy_internal(lock);
 265         /* drop reference from hashtable only for first destroy */
 266         if (first)
 267                 LDLM_LOCK_PUT(lock);
 268         EXIT;
 269 }
 270
 271 /* this is called by portals_handle2object with the handle lock taken */
 272 static void lock_handle_addref(void *lock)
 273 {
 274         LDLM_LOCK_GET((struct ldlm_lock *)lock);
 275 }
 276
 277 /*
 278  * usage: pass in a resource on which you have done ldlm_resource_get
 279  *        pass in a parent lock on which you have done a ldlm_lock_get
 280  *        after return, ldlm_*_put the resource and parent
 281  * returns: lock with refcount 2 - one for current caller and one for remote
 282  */
 283 static struct ldlm_lock *ldlm_lock_new(struct ldlm_lock *parent,
 284                                        struct ldlm_resource *resource)
 285 {
 286         struct ldlm_lock *lock;
 287         ENTRY;
 288
 289         if (resource == NULL)
 290                 LBUG();
 291
 292         OBD_SLAB_ALLOC(lock, ldlm_lock_slab, CFS_ALLOC_IO, sizeof(*lock));
 293         if (lock == NULL)
 294                 RETURN(NULL);
 295
 296         lock->l_resource = ldlm_resource_getref(resource);
 297
 298         atomic_set(&lock->l_refc, 2);
 299         CFS_INIT_LIST_HEAD(&lock->l_children);
 300         CFS_INIT_LIST_HEAD(&lock->l_res_link);
 301         CFS_INIT_LIST_HEAD(&lock->l_lru);
 302         CFS_INIT_LIST_HEAD(&lock->l_export_chain);
 303         CFS_INIT_LIST_HEAD(&lock->l_pending_chain);
 304         CFS_INIT_LIST_HEAD(&lock->l_tmp);
 305         CFS_INIT_LIST_HEAD(&lock->l_bl_ast);
 306         CFS_INIT_LIST_HEAD(&lock->l_cp_ast);
 307         cfs_waitq_init(&lock->l_waitq);
 308         lock->l_blocking_lock = NULL;
 309         lock->l_pidb = 0;
 310         lock->l_sl_mode.prev = NULL;
 311         lock->l_sl_mode.next = NULL;
 312         lock->l_sl_policy.prev = NULL;
 313         lock->l_sl_policy.next = NULL;
 314
 315         atomic_inc(&resource->lr_namespace->ns_locks);
 316
 317         if (parent != NULL) {
 318                 spin_lock(&resource->lr_namespace->ns_hash_lock);
 319                 lock->l_parent = LDLM_LOCK_GET(parent);
 320                 list_add(&lock->l_childof, &parent->l_children);
 321                 spin_unlock(&resource->lr_namespace->ns_hash_lock);
 322         }
 323
 324         CFS_INIT_LIST_HEAD(&lock->l_handle.h_link);
 325         class_handle_hash(&lock->l_handle, lock_handle_addref);
 326
 327         RETURN(lock);
 328 }
 329
 330 int ldlm_lock_change_resource(struct ldlm_namespace *ns, struct ldlm_lock *lock,
 331                               struct ldlm_res_id new_resid)
 332 {
 333         struct ldlm_resource *oldres = lock->l_resource;
 334         struct ldlm_resource *newres;
 335         int type;
 336         ENTRY;
 337
 338         LASSERT(ns->ns_client != 0);
 339
 340         lock_res_and_lock(lock);
 341         if (memcmp(&new_resid, &lock->l_resource->lr_name,
 342                    sizeof(lock->l_resource->lr_name)) == 0) {
 343                 /* Nothing to do */
 344                 unlock_res_and_lock(lock);
 345                 RETURN(0);
 346         }
 347
 348         LASSERT(new_resid.name[0] != 0);
 349
 350         /* This function assumes that the lock isn't on any lists */
 351         LASSERT(list_empty(&lock->l_res_link));
 352
 353         type = oldres->lr_type;
 354         unlock_res_and_lock(lock);
 355
 356         newres = ldlm_resource_get(ns, NULL, new_resid, type, 1);
 357         if (newres == NULL) {
 358                 LBUG();
 359                 RETURN(-ENOMEM);
 360         }
 361
 362         lock_res_and_lock(lock);
 363         LASSERT(memcmp(&new_resid, &lock->l_resource->lr_name,
 364                        sizeof(lock->l_resource->lr_name)) != 0);
 365         lock_res(newres);
 366         lock->l_resource = newres;
 367         unlock_res(newres);
 368         unlock_res(oldres);
 369         unlock_bitlock(lock);
 370
 371         /* ...and the flowers are still standing! */
 372         ldlm_resource_putref(oldres);
 373
 374         RETURN(0);
 375 }
 376
 377 /*
 378  *  HANDLES
 379  */
 380
 381 void ldlm_lock2handle(struct ldlm_lock *lock, struct lustre_handle *lockh)
 382 {
 383         lockh->cookie = lock->l_handle.h_cookie;
 384 }
 385
 386 /* if flags: atomically get the lock and set the flags.
 387  *           Return NULL if flag already set
 388  */
 389
 390 struct ldlm_lock *__ldlm_handle2lock(struct lustre_handle *handle, int flags)
 391 {
 392         struct ldlm_namespace *ns;
 393         struct ldlm_lock *lock = NULL, *retval = NULL;
 394         ENTRY;
 395
 396         LASSERT(handle);
 397
 398         lock = class_handle2object(handle->cookie);
 399         if (lock == NULL)
 400                 RETURN(NULL);
 401
 402         LASSERT(lock->l_resource != NULL);
 403         ns = lock->l_resource->lr_namespace;
 404         LASSERT(ns != NULL);
 405
 406         lock_res_and_lock(lock);
 407
 408         /* It's unlikely but possible that someone marked the lock as
 409          * destroyed after we did handle2object on it */
 410         if (lock->l_destroyed) {
 411                 unlock_res_and_lock(lock);
 412                 CDEBUG(D_INFO, "lock already destroyed: lock %p\n", lock);
 413                 LDLM_LOCK_PUT(lock);
 414                 GOTO(out, retval);
 415         }
 416
 417         if (flags && (lock->l_flags & flags)) {
 418                 unlock_res_and_lock(lock);
 419                 LDLM_LOCK_PUT(lock);
 420                 GOTO(out, retval);
 421         }
 422
 423         if (flags)
 424                 lock->l_flags |= flags;
 425
 426         unlock_res_and_lock(lock);
 427         retval = lock;
 428         EXIT;
 429  out:
 430         return retval;
 431 }
 432
 433 struct ldlm_lock *ldlm_handle2lock_ns(struct ldlm_namespace *ns,
 434                                       struct lustre_handle *handle)
 435 {
 436         struct ldlm_lock *retval = NULL;
 437         retval = __ldlm_handle2lock(handle, 0);
 438         return retval;
 439 }
 440
 441 void ldlm_lock2desc(struct ldlm_lock *lock, struct ldlm_lock_desc *desc)
 442 {
 443         struct obd_export *exp = lock->l_export?:lock->l_conn_export;
 444         /* INODEBITS_INTEROP: If the other side does not support
 445          * inodebits, reply with a plain lock descriptor.
 446          */
 447         if ((lock->l_resource->lr_type == LDLM_IBITS) &&
 448             (exp && !(exp->exp_connect_flags & OBD_CONNECT_IBITS))) {
 449                 struct ldlm_resource res = *lock->l_resource;
 450
 451                 /* Make sure all the right bits are set in this lock we
 452                    are going to pass to client */
 453                 LASSERTF(lock->l_policy_data.l_inodebits.bits ==
 454                          (MDS_INODELOCK_LOOKUP|MDS_INODELOCK_UPDATE),
 455                          "Inappropriate inode lock bits during "
 456                          "conversion " LPU64 "\n",
 457                          lock->l_policy_data.l_inodebits.bits);
 458                 res.lr_type = LDLM_PLAIN;
 459                 ldlm_res2desc(&res, &desc->l_resource);
 460                 /* Convert "new" lock mode to something old client can
 461                    understand */
 462                 if ((lock->l_req_mode == LCK_CR) ||
 463                     (lock->l_req_mode == LCK_CW))
 464                         desc->l_req_mode = LCK_PR;
 465                 else
 466                         desc->l_req_mode = lock->l_req_mode;
 467                 if ((lock->l_granted_mode == LCK_CR) ||
 468                     (lock->l_granted_mode == LCK_CW)) {
 469                         desc->l_granted_mode = LCK_PR;
 470                 } else {
 471                         /* We never grant PW/EX locks to clients */
 472                         LASSERT((lock->l_granted_mode != LCK_PW) &&
 473                                 (lock->l_granted_mode != LCK_EX));
 474                         desc->l_granted_mode = lock->l_granted_mode;
 475                 }
 476
 477                 /* We do not copy policy here, because there is no
 478                    policy for plain locks */
 479         } else {
 480                 ldlm_res2desc(lock->l_resource, &desc->l_resource);
 481                 desc->l_req_mode = lock->l_req_mode;
 482                 desc->l_granted_mode = lock->l_granted_mode;
 483                 desc->l_policy_data = lock->l_policy_data;
 484         }
 485 }
 486
 487 void ldlm_add_bl_work_item(struct ldlm_lock *lock, struct ldlm_lock *new,
 488                            struct list_head *work_list)
 489 {
 490         if ((lock->l_flags & LDLM_FL_AST_SENT) == 0) {
 491                 LDLM_DEBUG(lock, "lock incompatible; sending blocking AST.");
 492                 lock->l_flags |= LDLM_FL_AST_SENT;
 493                 /* If the enqueuing client said so, tell the AST recipient to
 494                  * discard dirty data, rather than writing back. */
 495                 if (new->l_flags & LDLM_AST_DISCARD_DATA)
 496                         lock->l_flags |= LDLM_FL_DISCARD_DATA;
 497                 LASSERT(list_empty(&lock->l_bl_ast));
 498                 list_add(&lock->l_bl_ast, work_list);
 499                 LDLM_LOCK_GET(lock);
 500                 LASSERT(lock->l_blocking_lock == NULL);
 501                 lock->l_blocking_lock = LDLM_LOCK_GET(new);
 502         }
 503 }
 504
 505 void ldlm_add_cp_work_item(struct ldlm_lock *lock, struct list_head *work_list)
 506 {
 507         if ((lock->l_flags & LDLM_FL_CP_REQD) == 0) {
 508                 lock->l_flags |= LDLM_FL_CP_REQD;
 509                 LDLM_DEBUG(lock, "lock granted; sending completion AST.");
 510                 LASSERT(list_empty(&lock->l_cp_ast));
 511                 list_add(&lock->l_cp_ast, work_list);
 512                 LDLM_LOCK_GET(lock);
 513         }
 514 }
 515
 516 /* must be called with lr_lock held */
 517 void ldlm_add_ast_work_item(struct ldlm_lock *lock, struct ldlm_lock *new,
 518                                 struct list_head *work_list)
 519 {
 520         ENTRY;
 521         check_res_locked(lock->l_resource);
 522         if (new)
 523                 ldlm_add_bl_work_item(lock, new, work_list);
 524         else
 525                 ldlm_add_cp_work_item(lock, work_list);
 526         EXIT;
 527 }
 528
 529 void ldlm_lock_addref(struct lustre_handle *lockh, __u32 mode)
 530 {
 531         struct ldlm_lock *lock;
 532
 533         lock = ldlm_handle2lock(lockh);
 534         LASSERT(lock != NULL);
 535         ldlm_lock_addref_internal(lock, mode);
 536         LDLM_LOCK_PUT(lock);
 537 }
 538
 539 void ldlm_lock_addref_internal_nolock(struct ldlm_lock *lock, __u32 mode)
 540 {
 541         ldlm_lock_remove_from_lru(lock);
 542         if (mode & (LCK_NL | LCK_CR | LCK_PR))
 543                 lock->l_readers++;
 544         if (mode & (LCK_EX | LCK_CW | LCK_PW | LCK_GROUP))
 545                 lock->l_writers++;
 546         lock->l_last_used = cfs_time_current();
 547         LDLM_LOCK_GET(lock);
 548         LDLM_DEBUG(lock, "ldlm_lock_addref(%s)", ldlm_lockname[mode]);
 549 }
 550
 551 /* only called for local locks */
 552 void ldlm_lock_addref_internal(struct ldlm_lock *lock, __u32 mode)
 553 {
 554         lock_res_and_lock(lock);
 555         ldlm_lock_addref_internal_nolock(lock, mode);
 556         unlock_res_and_lock(lock);
 557 }
 558
 559 void ldlm_lock_decref_internal(struct ldlm_lock *lock, __u32 mode)
 560 {
 561         struct ldlm_namespace *ns;
 562         ENTRY;
 563
 564         lock_res_and_lock(lock);
 565
 566         ns = lock->l_resource->lr_namespace;
 567
 568         LDLM_DEBUG(lock, "ldlm_lock_decref(%s)", ldlm_lockname[mode]);
 569         if (mode & (LCK_NL | LCK_CR | LCK_PR)) {
 570                 LASSERT(lock->l_readers > 0);
 571                 lock->l_readers--;
 572         }
 573         if (mode & (LCK_EX | LCK_CW | LCK_PW | LCK_GROUP)) {
 574                 LASSERT(lock->l_writers > 0);
 575                 lock->l_writers--;
 576         }
 577
 578         if (lock->l_flags & LDLM_FL_LOCAL &&
 579             !lock->l_readers && !lock->l_writers) {
 580                 /* If this is a local lock on a server namespace and this was
 581                  * the last reference, cancel the lock. */
 582                 CDEBUG(D_INFO, "forcing cancel of local lock\n");
 583                 lock->l_flags |= LDLM_FL_CBPENDING;
 584         }
 585
 586         if (!lock->l_readers && !lock->l_writers &&
 587             (lock->l_flags & LDLM_FL_CBPENDING)) {
 588                 /* If we received a blocked AST and this was the last reference,
 589                  * run the callback. */
 590                 if (ns->ns_client == LDLM_NAMESPACE_SERVER && lock->l_export)
 591                         CERROR("FL_CBPENDING set on non-local lock--just a "
 592                                "warning\n");
 593
 594                 LDLM_DEBUG(lock, "final decref done on cbpending lock");
 595
 596                 LDLM_LOCK_GET(lock); /* dropped by bl thread */
 597                 ldlm_lock_remove_from_lru(lock);
 598                 unlock_res_and_lock(lock);
 599                 if ((lock->l_flags & LDLM_FL_ATOMIC_CB) ||
 600                                 ldlm_bl_to_thread(ns, NULL, lock) != 0)
 601                         ldlm_handle_bl_callback(ns, NULL, lock);
 602         } else if (ns->ns_client == LDLM_NAMESPACE_CLIENT &&
 603                    !lock->l_readers && !lock->l_writers &&
 604                    !(lock->l_flags & LDLM_FL_NO_LRU)) {
 605                 /* If this is a client-side namespace and this was the last
 606                  * reference, put it on the LRU. */
 607                 LASSERT(list_empty(&lock->l_lru));
 608                 LASSERT(ns->ns_nr_unused >= 0);
 609                 spin_lock(&ns->ns_unused_lock);
 610                 list_add_tail(&lock->l_lru, &ns->ns_unused_list);
 611                 ns->ns_nr_unused++;
 612                 spin_unlock(&ns->ns_unused_lock);
 613                 unlock_res_and_lock(lock);
 614                 ldlm_cancel_lru(ns, LDLM_ASYNC);
 615         } else {
 616                 unlock_res_and_lock(lock);
 617         }
 618
 619         LDLM_LOCK_PUT(lock);    /* matches the ldlm_lock_get in addref */
 620
 621         EXIT;
 622 }
 623
 624 void ldlm_lock_decref(struct lustre_handle *lockh, __u32 mode)
 625 {
 626         struct ldlm_lock *lock = __ldlm_handle2lock(lockh, 0);
 627         LASSERTF(lock != NULL, "Non-existing lock: "LPX64"\n", lockh->cookie);
 628         ldlm_lock_decref_internal(lock, mode);
 629         LDLM_LOCK_PUT(lock);
 630 }
 631
 632 /* This will drop a lock reference and mark it for destruction, but will not
 633  * necessarily cancel the lock before returning. */
 634 void ldlm_lock_decref_and_cancel(struct lustre_handle *lockh, __u32 mode)
 635 {
 636         struct ldlm_lock *lock = __ldlm_handle2lock(lockh, 0);
 637         ENTRY;
 638
 639         LASSERT(lock != NULL);
 640
 641         LDLM_DEBUG(lock, "ldlm_lock_decref(%s)", ldlm_lockname[mode]);
 642         lock_res_and_lock(lock);
 643         lock->l_flags |= LDLM_FL_CBPENDING;
 644         unlock_res_and_lock(lock);
 645         ldlm_lock_decref_internal(lock, mode);
 646         LDLM_LOCK_PUT(lock);
 647 }
 648
 649 /*
 650  * search_granted_lock
 651  *
 652  * Description:
 653  *      Finds a position to insert the new lock.
 654  * Parameters:
 655  *      queue [input]:  the granted list where search acts on;
 656  *      req [input]:    the lock whose position to be located;
 657  *      lockp [output]: the position where the lock should be inserted before, or
 658  *                      NULL indicating @req should be appended to @queue.
 659  * Return Values:
 660  *      Bit-masks combination of following values indicating in which way the
 661  *      lock need to be inserted.
 662  *      - LDLM_JOIN_NONE:       noting about skip list needs to be fixed;
 663  *      - LDLM_MODE_JOIN_RIGHT: @req needs join right becoming the head of a
 664  *                              mode group;
 665  *      - LDLM_POLICY_JOIN_RIGHT: @req needs join right becoming the head of
 666  *                                a policy group.
 667  * NOTE: called by
 668  *  - ldlm_grant_lock_with_skiplist
 669  */
 670 static int search_granted_lock(struct list_head *queue,
 671                         struct ldlm_lock *req,
 672                         struct ldlm_lock **lockp)
 673 {
 674         struct list_head *tmp, *tmp_tail;
 675         struct ldlm_lock *lock, *mode_head_lock;
 676         int rc = LDLM_JOIN_NONE;
 677         ENTRY;
 678
 679         list_for_each(tmp, queue) {
 680                 lock = list_entry(tmp, struct ldlm_lock, l_res_link);
 681
 682                 if (lock->l_req_mode != req->l_req_mode) {
 683                         if (LDLM_SL_HEAD(&lock->l_sl_mode))
 684                                 tmp = &list_entry(lock->l_sl_mode.next,
 685                                                   struct ldlm_lock,
 686                                                   l_sl_mode)->l_res_link;
 687                         continue;
 688                 }
 689
 690                 /* found the same mode group */
 691                 if (lock->l_resource->lr_type == LDLM_PLAIN) {
 692                         *lockp = lock;
 693                         rc = LDLM_MODE_JOIN_RIGHT;
 694                         GOTO(out, rc);
 695                 } else if (lock->l_resource->lr_type == LDLM_IBITS) {
 696                         tmp_tail = tmp;
 697                         if (LDLM_SL_HEAD(&lock->l_sl_mode))
 698                                 tmp_tail = &list_entry(lock->l_sl_mode.next,
 699                                                        struct ldlm_lock,
 700                                                        l_sl_mode)->l_res_link;
 701                         mode_head_lock = lock;
 702                         for (;;) {
 703                                 if (lock->l_policy_data.l_inodebits.bits ==
 704                                     req->l_policy_data.l_inodebits.bits) {
 705                                         /* matched policy lock is found */
 706                                         *lockp = lock;
 707                                         rc |= LDLM_POLICY_JOIN_RIGHT;
 708
 709                                         /* if the policy group head is also a
 710                                          * mode group head or a single mode
 711                                          * group lock */
 712                                         if (LDLM_SL_HEAD(&lock->l_sl_mode) ||
 713                                             (tmp == tmp_tail &&
 714                                              LDLM_SL_EMPTY(&lock->l_sl_mode)))
 715                                                 rc |= LDLM_MODE_JOIN_RIGHT;
 716                                         GOTO(out, rc);
 717                                 }
 718
 719                                 if (LDLM_SL_HEAD(&lock->l_sl_policy))
 720                                         tmp = &list_entry(lock->l_sl_policy.next,
 721                                                           struct ldlm_lock,
 722                                                           l_sl_policy)->l_res_link;
 723
 724                                 if (tmp == tmp_tail)
 725                                         break;
 726                                 else
 727                                         tmp = tmp->next;
 728                                 lock = list_entry(tmp, struct ldlm_lock,
 729                                                   l_res_link);
 730                         }  /* for all locks in the matched mode group */
 731
 732                         /* no matched policy group is found, insert before
 733                          * the mode group head lock */
 734                         *lockp = mode_head_lock;
 735                         rc = LDLM_MODE_JOIN_RIGHT;
 736                         GOTO(out, rc);
 737                 } else {
 738                         LDLM_ERROR(lock, "is not LDLM_PLAIN or LDLM_IBITS lock");
 739                         LBUG();
 740                 }
 741         }
 742
 743         /* no matched mode group is found, append to the end */
 744         *lockp = NULL;
 745         rc = LDLM_JOIN_NONE;
 746         EXIT;
 747 out:
 748         return rc;
 749 }
 750
 751 static void ldlm_granted_list_add_lock(struct ldlm_lock *lock,
 752                                        struct ldlm_lock *lockp,
 753                                        int join)
 754 {
 755         struct ldlm_resource *res = lock->l_resource;
 756         ENTRY;
 757
 758         LASSERT(lockp || join == LDLM_JOIN_NONE);
 759
 760         check_res_locked(res);
 761
 762         ldlm_resource_dump(D_OTHER, res);
 763         CDEBUG(D_OTHER, "About to add this lock:\n");
 764         ldlm_lock_dump(D_OTHER, lock, 0);
 765
 766         if (lock->l_destroyed) {
 767                 CDEBUG(D_OTHER, "Lock destroyed, not adding to resource\n");
 768                 return;
 769         }
 770
 771         LASSERT(list_empty(&lock->l_res_link));
 772
 773         if (!lockp)
 774                 list_add_tail(&lock->l_res_link, &lock->l_resource->lr_granted);
 775         else if ((join & LDLM_MODE_JOIN_LEFT) || (join & LDLM_POLICY_JOIN_LEFT))
 776                 list_add(&lock->l_res_link, &lockp->l_res_link);
 777         else
 778                 list_add_tail(&lock->l_res_link, &lockp->l_res_link);
 779
 780         /* fix skip lists */
 781         if (join & LDLM_MODE_JOIN_RIGHT) {
 782                 LASSERT(! LDLM_SL_TAIL(&lockp->l_sl_mode));
 783                 if (LDLM_SL_EMPTY(&lockp->l_sl_mode)) {
 784                         lock->l_sl_mode.next = &lockp->l_sl_mode;
 785                         lockp->l_sl_mode.prev = &lock->l_sl_mode;
 786                 } else if (LDLM_SL_HEAD(&lockp->l_sl_mode)) {
 787                         lock->l_sl_mode.next = lockp->l_sl_mode.next;
 788                         lockp->l_sl_mode.next = NULL;
 789                         lock->l_sl_mode.next->prev = &lock->l_sl_mode;
 790                 }
 791         } else if (join & LDLM_MODE_JOIN_LEFT) {
 792                 LASSERT(! LDLM_SL_HEAD(&lockp->l_sl_mode));
 793                 if (LDLM_SL_EMPTY(&lockp->l_sl_mode)) {
 794                         lock->l_sl_mode.prev = &lockp->l_sl_mode;
 795                         lockp->l_sl_mode.next = &lock->l_sl_mode;
 796                 } else if (LDLM_SL_TAIL(&lockp->l_sl_mode)) {
 797                         lock->l_sl_mode.prev = lockp->l_sl_mode.prev;
 798                         lockp->l_sl_mode.prev = NULL;
 799                         lock->l_sl_mode.prev->next = &lock->l_sl_mode;
 800                 }
 801         }
 802
 803         if (join & LDLM_POLICY_JOIN_RIGHT) {
 804                 LASSERT(! LDLM_SL_TAIL(&lockp->l_sl_policy));
 805                 if (LDLM_SL_EMPTY(&lockp->l_sl_policy)) {
 806                         lock->l_sl_policy.next = &lockp->l_sl_policy;
 807                         lockp->l_sl_policy.prev = &lock->l_sl_policy;
 808                 } else if (LDLM_SL_HEAD(&lockp->l_sl_policy)) {
 809                         lock->l_sl_policy.next = lockp->l_sl_policy.next;
 810                         lockp->l_sl_policy.next = NULL;
 811                         lock->l_sl_policy.next->prev = &lock->l_sl_policy;
 812                 }
 813         } else if (join & LDLM_POLICY_JOIN_LEFT) {
 814                 LASSERT(! LDLM_SL_HEAD(&lockp->l_sl_policy));
 815                 if (LDLM_SL_EMPTY(&lockp->l_sl_policy)) {
 816                         lock->l_sl_policy.prev = &lockp->l_sl_policy;
 817                         lockp->l_sl_policy.next = &lock->l_sl_policy;
 818                 } else if (LDLM_SL_TAIL(&lockp->l_sl_policy)) {
 819                         lock->l_sl_policy.prev = lockp->l_sl_policy.prev;
 820                         lockp->l_sl_policy.prev = NULL;
 821                         lock->l_sl_policy.prev->next = &lock->l_sl_policy;
 822                 }
 823         }
 824
 825         EXIT;
 826 }
 827
 828 static void ldlm_grant_lock_with_skiplist(struct ldlm_lock *lock)
 829 {
 830         int join = LDLM_JOIN_NONE;
 831         struct ldlm_lock *lockp = NULL;
 832         ENTRY;
 833
 834         LASSERT(lock->l_req_mode == lock->l_granted_mode);
 835
 836         join = search_granted_lock(&lock->l_resource->lr_granted, lock, &lockp);
 837         ldlm_granted_list_add_lock(lock, lockp, join);
 838         EXIT;
 839 }
 840
 841 /* NOTE: called by
 842  *  - ldlm_lock_enqueue
 843  *  - ldlm_reprocess_queue
 844  *  - ldlm_lock_convert
 845  *
 846  * must be called with lr_lock held
 847  */
 848 void ldlm_grant_lock(struct ldlm_lock *lock, struct list_head *work_list)
 849 {
 850         struct ldlm_resource *res = lock->l_resource;
 851         ENTRY;
 852
 853         check_res_locked(res);
 854
 855         lock->l_granted_mode = lock->l_req_mode;
 856         if (res->lr_type == LDLM_PLAIN || res->lr_type == LDLM_IBITS)
 857                 ldlm_grant_lock_with_skiplist(lock);
 858         else
 859                 ldlm_resource_add_lock(res, &res->lr_granted, lock);
 860
 861         if (lock->l_granted_mode < res->lr_most_restr)
 862                 res->lr_most_restr = lock->l_granted_mode;
 863
 864         if (work_list && lock->l_completion_ast != NULL)
 865                 ldlm_add_ast_work_item(lock, NULL, work_list);
 866
 867         EXIT;
 868 }
 869
 870 /* returns a referenced lock or NULL.  See the flag descriptions below, in the
 871  * comment above ldlm_lock_match */
 872 static struct ldlm_lock *search_queue(struct list_head *queue, ldlm_mode_t mode,
 873                                       ldlm_policy_data_t *policy,
 874                                       struct ldlm_lock *old_lock, int flags)
 875 {
 876         struct ldlm_lock *lock;
 877         struct list_head *tmp;
 878
 879         list_for_each(tmp, queue) {
 880                 lock = list_entry(tmp, struct ldlm_lock, l_res_link);
 881
 882                 if (lock == old_lock)
 883                         break;
 884
 885                 /* llite sometimes wants to match locks that will be
 886                  * canceled when their users drop, but we allow it to match
 887                  * if it passes in CBPENDING and the lock still has users.
 888                  * this is generally only going to be used by children
 889                  * whose parents already hold a lock so forward progress
 890                  * can still happen. */
 891                 if (lock->l_flags & LDLM_FL_CBPENDING &&
 892                     !(flags & LDLM_FL_CBPENDING))
 893                         continue;
 894                 if (lock->l_flags & LDLM_FL_CBPENDING &&
 895                     lock->l_readers == 0 && lock->l_writers == 0)
 896                         continue;
 897
 898                 if (!(lock->l_req_mode & mode))
 899                         continue;
 900
 901                 if (lock->l_resource->lr_type == LDLM_EXTENT &&
 902                     (lock->l_policy_data.l_extent.start >
 903                      policy->l_extent.start ||
 904                      lock->l_policy_data.l_extent.end < policy->l_extent.end))
 905                         continue;
 906
 907                 if (unlikely(mode == LCK_GROUP) &&
 908                     lock->l_resource->lr_type == LDLM_EXTENT &&
 909                     lock->l_policy_data.l_extent.gid != policy->l_extent.gid)
 910                         continue;
 911
 912                 /* We match if we have existing lock with same or wider set
 913                    of bits. */
 914                 if (lock->l_resource->lr_type == LDLM_IBITS &&
 915                      ((lock->l_policy_data.l_inodebits.bits &
 916                       policy->l_inodebits.bits) !=
 917                       policy->l_inodebits.bits))
 918                         continue;
 919
 920                 if (lock->l_destroyed || (lock->l_flags & LDLM_FL_FAILED))
 921                         continue;
 922
 923                 if ((flags & LDLM_FL_LOCAL_ONLY) &&
 924                     !(lock->l_flags & LDLM_FL_LOCAL))
 925                         continue;
 926
 927                 if (flags & LDLM_FL_TEST_LOCK)
 928                         LDLM_LOCK_GET(lock);
 929                 else
 930                         ldlm_lock_addref_internal_nolock(lock, mode);
 931                 return lock;
 932         }
 933
 934         return NULL;
 935 }
 936
 937 void ldlm_lock_allow_match(struct ldlm_lock *lock)
 938 {
 939         lock_res_and_lock(lock);
 940         lock->l_flags |= LDLM_FL_LVB_READY;
 941         cfs_waitq_signal(&lock->l_waitq);
 942         unlock_res_and_lock(lock);
 943 }
 944
 945 /* Can be called in two ways:
 946  *
 947  * If 'ns' is NULL, then lockh describes an existing lock that we want to look
 948  * for a duplicate of.
 949  *
 950  * Otherwise, all of the fields must be filled in, to match against.
 951  *
 952  * If 'flags' contains LDLM_FL_LOCAL_ONLY, then only match local locks on the
 953  *     server (ie, connh is NULL)
 954  * If 'flags' contains LDLM_FL_BLOCK_GRANTED, then only locks on the granted
 955  *     list will be considered
 956  * If 'flags' contains LDLM_FL_CBPENDING, then locks that have been marked
 957  *     to be canceled can still be matched as long as they still have reader
 958  *     or writer refernces
 959  * If 'flags' contains LDLM_FL_TEST_LOCK, then don't actually reference a lock,
 960  *     just tell us if we would have matched.
 961  *
 962  * Returns 1 if it finds an already-existing lock that is compatible; in this
 963  * case, lockh is filled in with a addref()ed lock
 964  */
 965 int ldlm_lock_match(struct ldlm_namespace *ns, int flags,
 966                     struct ldlm_res_id *res_id, ldlm_type_t type,
 967                     ldlm_policy_data_t *policy, ldlm_mode_t mode,
 968                     struct lustre_handle *lockh)
 969 {
 970         struct ldlm_resource *res;
 971         struct ldlm_lock *lock, *old_lock = NULL;
 972         int rc = 0;
 973         ENTRY;
 974
 975         if (ns == NULL) {
 976                 old_lock = ldlm_handle2lock(lockh);
 977                 LASSERT(old_lock);
 978
 979                 ns = old_lock->l_resource->lr_namespace;
 980                 res_id = &old_lock->l_resource->lr_name;
 981                 type = old_lock->l_resource->lr_type;
 982                 mode = old_lock->l_req_mode;
 983         }
 984
 985         res = ldlm_resource_get(ns, NULL, *res_id, type, 0);
 986         if (res == NULL) {
 987                 LASSERT(old_lock == NULL);
 988                 RETURN(0);
 989         }
 990
 991         lock_res(res);
 992
 993         lock = search_queue(&res->lr_granted, mode, policy, old_lock, flags);
 994         if (lock != NULL)
 995                 GOTO(out, rc = 1);
 996         if (flags & LDLM_FL_BLOCK_GRANTED)
 997                 GOTO(out, rc = 0);
 998         lock = search_queue(&res->lr_converting, mode, policy, old_lock, flags);
 999         if (lock != NULL)
1000                 GOTO(out, rc = 1);
1001         lock = search_queue(&res->lr_waiting, mode, policy, old_lock, flags);
1002         if (lock != NULL)
1003                 GOTO(out, rc = 1);
1004
1005         EXIT;
1006  out:
1007         unlock_res(res);
1008         ldlm_resource_putref(res);
1009
1010         if (lock) {
1011                 ldlm_lock2handle(lock, lockh);
1012                 if ((flags & LDLM_FL_LVB_READY) && (!(lock->l_flags & LDLM_FL_LVB_READY))) {
1013                         struct l_wait_info lwi;
1014                         if (lock->l_completion_ast) {
1015                                 int err = lock->l_completion_ast(lock,
1016                                                           LDLM_FL_WAIT_NOREPROC,
1017                                                                  NULL);
1018                                 if (err) {
1019                                         if (flags & LDLM_FL_TEST_LOCK)
1020                                                 LDLM_LOCK_PUT(lock);
1021                                         else
1022                                                 ldlm_lock_decref_internal(lock, mode);
1023                                         rc = 0;
1024                                         goto out2;
1025                                 }
1026                         }
1027
1028                         lwi = LWI_TIMEOUT_INTR(cfs_time_seconds(obd_timeout), NULL,
1029                                                LWI_ON_SIGNAL_NOOP, NULL);
1030
1031                         /* XXX FIXME see comment on CAN_MATCH in lustre_dlm.h */
1032                         l_wait_event(lock->l_waitq,
1033                                      (lock->l_flags & LDLM_FL_LVB_READY), &lwi);
1034                 }
1035         }
1036  out2:
1037         if (rc) {
1038                 LDLM_DEBUG(lock, "matched ("LPU64" "LPU64")",
1039                            (type == LDLM_PLAIN || type == LDLM_IBITS) ?
1040                                 res_id->name[2] : policy->l_extent.start,
1041                            (type == LDLM_PLAIN || type == LDLM_IBITS) ?
1042                                 res_id->name[3] : policy->l_extent.end);
1043         } else if (!(flags & LDLM_FL_TEST_LOCK)) {/*less verbose for test-only*/
1044                 LDLM_DEBUG_NOLOCK("not matched ns %p type %u mode %u res "
1045                                   LPU64"/"LPU64" ("LPU64" "LPU64")", ns,
1046                                   type, mode, res_id->name[0], res_id->name[1],
1047                                   (type == LDLM_PLAIN || type == LDLM_IBITS) ?
1048                                         res_id->name[2] :policy->l_extent.start,
1049                                 (type == LDLM_PLAIN || type == LDLM_IBITS) ?
1050                                         res_id->name[3] : policy->l_extent.end);
1051         }
1052         if (old_lock)
1053                 LDLM_LOCK_PUT(old_lock);
1054         if (flags & LDLM_FL_TEST_LOCK && rc)
1055                 LDLM_LOCK_PUT(lock);
1056
1057         return rc;
1058 }
1059
1060 /* Returns a referenced lock */
1061 struct ldlm_lock *ldlm_lock_create(struct ldlm_namespace *ns,
1062                                    struct lustre_handle *parent_lock_handle,
1063                                    struct ldlm_res_id res_id, ldlm_type_t type,
1064                                    ldlm_mode_t mode,
1065                                    ldlm_blocking_callback blocking,
1066                                    ldlm_completion_callback completion,
1067                                    ldlm_glimpse_callback glimpse,
1068                                    void *data, __u32 lvb_len)
1069 {
1070         struct ldlm_resource *res, *parent_res = NULL;
1071         struct ldlm_lock *lock, *parent_lock = NULL;
1072         ENTRY;
1073
1074         if (parent_lock_handle) {
1075                 parent_lock = ldlm_handle2lock(parent_lock_handle);
1076                 if (parent_lock)
1077                         parent_res = parent_lock->l_resource;
1078         }
1079
1080         res = ldlm_resource_get(ns, parent_res, res_id, type, 1);
1081         if (res == NULL)
1082                 RETURN(NULL);
1083
1084         lock = ldlm_lock_new(parent_lock, res);
1085         ldlm_resource_putref(res);
1086         if (parent_lock != NULL)
1087                 LDLM_LOCK_PUT(parent_lock);
1088
1089         if (lock == NULL)
1090                 RETURN(NULL);
1091
1092         lock->l_req_mode = mode;
1093         lock->l_ast_data = data;
1094         lock->l_blocking_ast = blocking;
1095         lock->l_completion_ast = completion;
1096         lock->l_glimpse_ast = glimpse;
1097         lock->l_pid = cfs_curproc_pid();
1098
1099         if (lvb_len) {
1100                 lock->l_lvb_len = lvb_len;
1101                 OBD_ALLOC(lock->l_lvb_data, lvb_len);
1102                 if (lock->l_lvb_data == NULL) {
1103                         OBD_SLAB_FREE(lock, ldlm_lock_slab, sizeof(*lock));
1104                         RETURN(NULL);
1105                 }
1106         }
1107
1108         RETURN(lock);
1109 }
1110
1111 ldlm_error_t ldlm_lock_enqueue(struct ldlm_namespace *ns,
1112                                struct ldlm_lock **lockp,
1113                                void *cookie, int *flags)
1114 {
1115         struct ldlm_lock *lock = *lockp;
1116         struct ldlm_resource *res = lock->l_resource;
1117         int local = res->lr_namespace->ns_client;
1118         ldlm_processing_policy policy;
1119         ldlm_error_t rc = ELDLM_OK;
1120         ENTRY;
1121
1122         do_gettimeofday(&lock->l_enqueued_time);
1123         /* policies are not executed on the client or during replay */
1124         if ((*flags & (LDLM_FL_HAS_INTENT|LDLM_FL_REPLAY)) == LDLM_FL_HAS_INTENT
1125             && !local && ns->ns_policy) {
1126                 rc = ns->ns_policy(ns, lockp, cookie, lock->l_req_mode, *flags,
1127                                    NULL);
1128                 if (rc == ELDLM_LOCK_REPLACED) {
1129                         /* The lock that was returned has already been granted,
1130                          * and placed into lockp.  If it's not the same as the
1131                          * one we passed in, then destroy the old one and our
1132                          * work here is done. */
1133                         if (lock != *lockp) {
1134                                 ldlm_lock_destroy(lock);
1135                                 LDLM_LOCK_PUT(lock);
1136                         }
1137                         *flags |= LDLM_FL_LOCK_CHANGED;
1138                         RETURN(0);
1139                 } else if (rc != ELDLM_OK ||
1140                            (rc == ELDLM_OK && (*flags & LDLM_FL_INTENT_ONLY))) {
1141                         ldlm_lock_destroy(lock);
1142                         RETURN(rc);
1143                 }
1144         }
1145
1146         lock_res_and_lock(lock);
1147         if (local && lock->l_req_mode == lock->l_granted_mode) {
1148                 /* The server returned a blocked lock, but it was granted before
1149                  * we got a chance to actually enqueue it.  We don't need to do
1150                  * anything else. */
1151                 *flags &= ~(LDLM_FL_BLOCK_GRANTED |
1152                             LDLM_FL_BLOCK_CONV | LDLM_FL_BLOCK_WAIT);
1153                 GOTO(out, ELDLM_OK);
1154         }
1155
1156         /* Some flags from the enqueue want to make it into the AST, via the
1157          * lock's l_flags. */
1158         lock->l_flags |= *flags & LDLM_AST_DISCARD_DATA;
1159
1160         /* This distinction between local lock trees is very important; a client
1161          * namespace only has information about locks taken by that client, and
1162          * thus doesn't have enough information to decide for itself if it can
1163          * be granted (below).  In this case, we do exactly what the server
1164          * tells us to do, as dictated by the 'flags'.
1165          *
1166          * We do exactly the same thing during recovery, when the server is
1167          * more or less trusting the clients not to lie.
1168          *
1169          * FIXME (bug 268): Detect obvious lies by checking compatibility in
1170          * granted/converting queues. */
1171         ldlm_resource_unlink_lock(lock);
1172         if (local) {
1173                 if (*flags & LDLM_FL_BLOCK_CONV)
1174                         ldlm_resource_add_lock(res, &res->lr_converting, lock);
1175                 else if (*flags & (LDLM_FL_BLOCK_WAIT | LDLM_FL_BLOCK_GRANTED))
1176                         ldlm_resource_add_lock(res, &res->lr_waiting, lock);
1177                 else
1178                         ldlm_grant_lock(lock, NULL);
1179                 GOTO(out, ELDLM_OK);
1180         } else if (*flags & LDLM_FL_REPLAY) {
1181                 if (*flags & LDLM_FL_BLOCK_CONV) {
1182                         ldlm_resource_add_lock(res, &res->lr_converting, lock);
1183                         GOTO(out, ELDLM_OK);
1184                 } else if (*flags & LDLM_FL_BLOCK_WAIT) {
1185                         ldlm_resource_add_lock(res, &res->lr_waiting, lock);
1186                         GOTO(out, ELDLM_OK);
1187                 } else if (*flags & LDLM_FL_BLOCK_GRANTED) {
1188                         ldlm_grant_lock(lock, NULL);
1189                         GOTO(out, ELDLM_OK);
1190                 }
1191                 /* If no flags, fall through to normal enqueue path. */
1192         }
1193
1194         policy = ldlm_processing_policy_table[res->lr_type];
1195         policy(lock, flags, 1, &rc, NULL);
1196         GOTO(out, rc);
1197 out:
1198         unlock_res_and_lock(lock);
1199         return rc;
1200 }
1201
1202 /* Must be called with namespace taken: queue is waiting or converting. */
1203 int ldlm_reprocess_queue(struct ldlm_resource *res, struct list_head *queue,
1204                          struct list_head *work_list)
1205 {
1206         struct list_head *tmp, *pos;
1207         ldlm_processing_policy policy;
1208         int flags;
1209         int rc = LDLM_ITER_CONTINUE;
1210         ldlm_error_t err;
1211         ENTRY;
1212
1213         check_res_locked(res);
1214
1215         policy = ldlm_processing_policy_table[res->lr_type];
1216         LASSERT(policy);
1217
1218         list_for_each_safe(tmp, pos, queue) {
1219                 struct ldlm_lock *pending;
1220                 pending = list_entry(tmp, struct ldlm_lock, l_res_link);
1221
1222                 CDEBUG(D_INFO, "Reprocessing lock %p\n", pending);
1223
1224                 flags = 0;
1225                 rc = policy(pending, &flags, 0, &err, work_list);
1226                 if (rc != LDLM_ITER_CONTINUE)
1227                         break;
1228         }
1229
1230         RETURN(rc);
1231 }
1232
1233 int ldlm_run_bl_ast_work(struct list_head *rpc_list)
1234 {
1235         struct list_head *tmp, *pos;
1236         struct ldlm_lock_desc d;
1237         int rc = 0, retval = 0;
1238         ENTRY;
1239
1240         list_for_each_safe(tmp, pos, rpc_list) {
1241                 struct ldlm_lock *lock =
1242                         list_entry(tmp, struct ldlm_lock, l_bl_ast);
1243
1244                 /* nobody should touch l_bl_ast */
1245                 lock_res_and_lock(lock);
1246                 list_del_init(&lock->l_bl_ast);
1247
1248                 LASSERT(lock->l_flags & LDLM_FL_AST_SENT);
1249                 LASSERT(lock->l_bl_ast_run == 0);
1250                 LASSERT(lock->l_blocking_lock);
1251                 lock->l_bl_ast_run++;
1252                 unlock_res_and_lock(lock);
1253
1254                 ldlm_lock2desc(lock->l_blocking_lock, &d);
1255
1256                 LDLM_LOCK_PUT(lock->l_blocking_lock);
1257                 lock->l_blocking_lock = NULL;
1258                 rc = lock->l_blocking_ast(lock, &d, NULL, LDLM_CB_BLOCKING);
1259
1260                 if (rc == -ERESTART)
1261                         retval = rc;
1262                 else if (rc)
1263                         CDEBUG(D_DLMTRACE, "Failed AST - should clean & "
1264                                "disconnect client\n");
1265                 LDLM_LOCK_PUT(lock);
1266         }
1267         RETURN(retval);
1268 }
1269
1270 int ldlm_run_cp_ast_work(struct list_head *rpc_list)
1271 {
1272         struct list_head *tmp, *pos;
1273         int rc = 0, retval = 0;
1274         ENTRY;
1275
1276         /* It's possible to receive a completion AST before we've set
1277          * the l_completion_ast pointer: either because the AST arrived
1278          * before the reply, or simply because there's a small race
1279          * window between receiving the reply and finishing the local
1280          * enqueue. (bug 842)
1281          *
1282          * This can't happen with the blocking_ast, however, because we
1283          * will never call the local blocking_ast until we drop our
1284          * reader/writer reference, which we won't do until we get the
1285          * reply and finish enqueueing. */
1286
1287         list_for_each_safe(tmp, pos, rpc_list) {
1288                 struct ldlm_lock *lock =
1289                         list_entry(tmp, struct ldlm_lock, l_cp_ast);
1290
1291                 /* nobody should touch l_cp_ast */
1292                 lock_res_and_lock(lock);
1293                 list_del_init(&lock->l_cp_ast);
1294                 LASSERT(lock->l_flags & LDLM_FL_CP_REQD);
1295                 lock->l_flags &= ~LDLM_FL_CP_REQD;
1296                 unlock_res_and_lock(lock);
1297
1298                 if (lock->l_completion_ast != NULL)
1299                         rc = lock->l_completion_ast(lock, 0, 0);
1300                 if (rc == -ERESTART)
1301                         retval = rc;
1302                 else if (rc)
1303                         CDEBUG(D_DLMTRACE, "Failed AST - should clean & "
1304                                "disconnect client\n");
1305                 LDLM_LOCK_PUT(lock);
1306         }
1307         RETURN(retval);
1308 }
1309
1310 static int reprocess_one_queue(struct ldlm_resource *res, void *closure)
1311 {
1312         ldlm_reprocess_all(res);
1313         return LDLM_ITER_CONTINUE;
1314 }
1315
1316 void ldlm_reprocess_all_ns(struct ldlm_namespace *ns)
1317 {
1318         struct list_head *tmp;
1319         int i, rc;
1320
1321         ENTRY;
1322         spin_lock(&ns->ns_hash_lock);
1323         for (i = 0; i < RES_HASH_SIZE; i++) {
1324                 tmp = ns->ns_hash[i].next;
1325                 while (tmp != &(ns->ns_hash[i])) {
1326                         struct ldlm_resource *res =
1327                                 list_entry(tmp, struct ldlm_resource, lr_hash);
1328
1329                         ldlm_resource_getref(res);
1330                         spin_unlock(&ns->ns_hash_lock);
1331
1332                         rc = reprocess_one_queue(res, NULL);
1333
1334                         spin_lock(&ns->ns_hash_lock);
1335                         tmp = tmp->next;
1336                         ldlm_resource_putref_locked(res);
1337
1338                         if (rc == LDLM_ITER_STOP)
1339                                 GOTO(out, rc);
1340                 }
1341         }
1342  out:
1343         spin_unlock(&ns->ns_hash_lock);
1344         EXIT;
1345 }
1346
1347 void ldlm_reprocess_all(struct ldlm_resource *res)
1348 {
1349         struct list_head rpc_list = LIST_HEAD_INIT(rpc_list);
1350         int rc;
1351         ENTRY;
1352
1353         /* Local lock trees don't get reprocessed. */
1354         if (res->lr_namespace->ns_client) {
1355                 EXIT;
1356                 return;
1357         }
1358
1359  restart:
1360         lock_res(res);
1361         rc = ldlm_reprocess_queue(res, &res->lr_converting, &rpc_list);
1362         if (rc == LDLM_ITER_CONTINUE)
1363                 ldlm_reprocess_queue(res, &res->lr_waiting, &rpc_list);
1364         unlock_res(res);
1365
1366         rc = ldlm_run_cp_ast_work(&rpc_list);
1367         if (rc == -ERESTART) {
1368                 LASSERT(list_empty(&rpc_list));
1369                 goto restart;
1370         }
1371         EXIT;
1372 }
1373
1374 void ldlm_cancel_callback(struct ldlm_lock *lock)
1375 {
1376         check_res_locked(lock->l_resource);
1377         if (!(lock->l_flags & LDLM_FL_CANCEL)) {
1378                 lock->l_flags |= LDLM_FL_CANCEL;
1379                 if (lock->l_blocking_ast) {
1380                         // l_check_no_ns_lock(ns);
1381                         unlock_res_and_lock(lock);
1382                         lock->l_blocking_ast(lock, NULL, lock->l_ast_data,
1383                                              LDLM_CB_CANCELING);
1384                         lock_res_and_lock(lock);
1385                 } else {
1386                         LDLM_DEBUG(lock, "no blocking ast");
1387                 }
1388         }
1389 }
1390
1391 static void ldlm_unlink_lock_skiplist(struct ldlm_lock *req)
1392 {
1393         struct ldlm_lock *lock;
1394
1395         if (LDLM_SL_HEAD(&req->l_sl_mode)) {
1396                 lock = list_entry(req->l_res_link.next, struct ldlm_lock,
1397                                   l_res_link);
1398                 if (req->l_sl_mode.next == &lock->l_sl_mode) {
1399                         lock->l_sl_mode.prev = NULL;
1400                 } else {
1401                         lock->l_sl_mode.next = req->l_sl_mode.next;
1402                         lock->l_sl_mode.next->prev = &lock->l_sl_mode;
1403                 }
1404                 req->l_sl_mode.next = NULL;
1405         } else if (LDLM_SL_TAIL(&req->l_sl_mode)) {
1406                 lock = list_entry(req->l_res_link.prev, struct ldlm_lock,
1407                                   l_res_link);
1408                 if (req->l_sl_mode.prev == &lock->l_sl_mode) {
1409                         lock->l_sl_mode.next = NULL;
1410                 } else {
1411                         lock->l_sl_mode.prev = req->l_sl_mode.prev;
1412                         lock->l_sl_mode.prev->next = &lock->l_sl_mode;
1413                 }
1414                 req->l_sl_mode.prev = NULL;
1415         }
1416
1417         if (LDLM_SL_HEAD(&req->l_sl_policy)) {
1418                 lock = list_entry(req->l_res_link.next, struct ldlm_lock,
1419                                   l_res_link);
1420                 if (req->l_sl_policy.next == &lock->l_sl_policy) {
1421                         lock->l_sl_policy.prev = NULL;
1422                 } else {
1423                         lock->l_sl_policy.next = req->l_sl_policy.next;
1424                         lock->l_sl_policy.next->prev = &lock->l_sl_policy;
1425                 }
1426                 req->l_sl_policy.next = NULL;
1427         } else if (LDLM_SL_TAIL(&req->l_sl_policy)) {
1428                 lock = list_entry(req->l_res_link.prev, struct ldlm_lock,
1429                                   l_res_link);
1430                 if (req->l_sl_policy.prev == &lock->l_sl_policy) {
1431                         lock->l_sl_policy.next = NULL;
1432                 } else {
1433                         lock->l_sl_policy.prev = req->l_sl_policy.prev;
1434                         lock->l_sl_policy.prev->next = &lock->l_sl_policy;
1435                 }
1436                 req->l_sl_policy.prev = NULL;
1437         }
1438 }
1439
1440 void ldlm_lock_cancel(struct ldlm_lock *lock)
1441 {
1442         struct ldlm_resource *res;
1443         struct ldlm_namespace *ns;
1444         ENTRY;
1445
1446         lock_res_and_lock(lock);
1447
1448         res = lock->l_resource;
1449         ns = res->lr_namespace;
1450
1451         /* Please do not, no matter how tempting, remove this LBUG without
1452          * talking to me first. -phik */
1453         if (lock->l_readers || lock->l_writers) {
1454                 LDLM_ERROR(lock, "lock still has references");
1455                 LBUG();
1456         }
1457
1458         ldlm_del_waiting_lock(lock);
1459
1460         /* Releases res lock */
1461         ldlm_cancel_callback(lock);
1462
1463         /* Yes, second time, just in case it was added again while we were
1464            running with no res lock in ldlm_cancel_callback */
1465         ldlm_del_waiting_lock(lock);
1466         if (!(LDLM_SL_EMPTY(&lock->l_sl_mode) &&
1467               LDLM_SL_EMPTY(&lock->l_sl_policy)) &&
1468             (lock->l_resource->lr_type == LDLM_PLAIN ||
1469              lock->l_resource->lr_type == LDLM_IBITS))
1470                 ldlm_unlink_lock_skiplist(lock);
1471         ldlm_resource_unlink_lock(lock);
1472         ldlm_lock_destroy_nolock(lock);
1473         unlock_res_and_lock(lock);
1474
1475         EXIT;
1476 }
1477
1478 int ldlm_lock_set_data(struct lustre_handle *lockh, void *data)
1479 {
1480         struct ldlm_lock *lock = ldlm_handle2lock(lockh);
1481         ENTRY;
1482
1483         if (lock == NULL)
1484                 RETURN(-EINVAL);
1485
1486         lock->l_ast_data = data;
1487         LDLM_LOCK_PUT(lock);
1488         RETURN(0);
1489 }
1490
1491 void ldlm_cancel_locks_for_export(struct obd_export *exp)
1492 {
1493         struct ldlm_lock *lock;
1494         struct ldlm_resource *res;
1495
1496         spin_lock(&exp->exp_ldlm_data.led_lock);
1497         while(!list_empty(&exp->exp_ldlm_data.led_held_locks)) {
1498                 lock = list_entry(exp->exp_ldlm_data.led_held_locks.next,
1499                                   struct ldlm_lock, l_export_chain);
1500                 res = ldlm_resource_getref(lock->l_resource);
1501                 LDLM_LOCK_GET(lock);
1502                 spin_unlock(&exp->exp_ldlm_data.led_lock);
1503
1504                 LDLM_DEBUG(lock, "export %p", exp);
1505                 ldlm_lock_cancel(lock);
1506                 ldlm_reprocess_all(res);
1507
1508                 ldlm_resource_putref(res);
1509                 LDLM_LOCK_PUT(lock);
1510                 spin_lock(&exp->exp_ldlm_data.led_lock);
1511         }
1512         spin_unlock(&exp->exp_ldlm_data.led_lock);
1513 }
1514
1515 struct ldlm_resource *ldlm_lock_convert(struct ldlm_lock *lock, int new_mode,
1516                                         int *flags)
1517 {
1518         struct list_head rpc_list = LIST_HEAD_INIT(rpc_list);
1519         struct ldlm_resource *res;
1520         struct ldlm_namespace *ns;
1521         int granted = 0;
1522         int old_mode, rc;
1523         struct ldlm_lock *mark_lock = NULL;
1524         int join= LDLM_JOIN_NONE;
1525         ldlm_error_t err;
1526         ENTRY;
1527
1528         if (new_mode == lock->l_granted_mode) { // No changes? Just return.
1529                 *flags |= LDLM_FL_BLOCK_GRANTED;
1530                 RETURN(lock->l_resource);
1531         }
1532
1533         LASSERTF(new_mode == LCK_PW && lock->l_granted_mode == LCK_PR,
1534                  "new_mode %u, granted %u\n", new_mode, lock->l_granted_mode);
1535
1536         lock_res_and_lock(lock);
1537
1538         res = lock->l_resource;
1539         ns = res->lr_namespace;
1540
1541         old_mode = lock->l_req_mode;
1542         lock->l_req_mode = new_mode;
1543         if (res->lr_type == LDLM_PLAIN || res->lr_type == LDLM_IBITS) {
1544                 /* remember the lock position where the lock might be
1545                  * added back to the granted list later and also
1546                  * remember the join mode for skiplist fixing. */
1547                 if (LDLM_SL_HEAD(&lock->l_sl_mode))
1548                         join = LDLM_MODE_JOIN_RIGHT;
1549                 else if (LDLM_SL_TAIL(&lock->l_sl_mode))
1550                         join = LDLM_MODE_JOIN_LEFT;
1551                 if (LDLM_SL_HEAD(&lock->l_sl_policy))
1552                         join |= LDLM_POLICY_JOIN_RIGHT;
1553                 else if (LDLM_SL_TAIL(&lock->l_sl_policy))
1554                         join |= LDLM_POLICY_JOIN_LEFT;
1555
1556                 LASSERT(!((join & LDLM_MODE_JOIN_RIGHT) &&
1557                           (join & LDLM_POLICY_JOIN_LEFT)));
1558                 LASSERT(!((join & LDLM_MODE_JOIN_LEFT) &&
1559                           (join & LDLM_POLICY_JOIN_RIGHT)));
1560
1561                 if ((join & LDLM_MODE_JOIN_LEFT) ||
1562                     (join & LDLM_POLICY_JOIN_LEFT))
1563                         mark_lock = list_entry(lock->l_res_link.prev,
1564                                                struct ldlm_lock, l_res_link);
1565                 else if (lock->l_res_link.next != &res->lr_granted)
1566                         mark_lock = list_entry(lock->l_res_link.next,
1567                                                struct ldlm_lock, l_res_link);
1568                 if (join != LDLM_JOIN_NONE)
1569                         ldlm_unlink_lock_skiplist(lock);
1570         }
1571         ldlm_resource_unlink_lock(lock);
1572
1573         /* If this is a local resource, put it on the appropriate list. */
1574         if (res->lr_namespace->ns_client) {
1575                 if (*flags & (LDLM_FL_BLOCK_CONV | LDLM_FL_BLOCK_GRANTED)) {
1576                         ldlm_resource_add_lock(res, &res->lr_converting, lock);
1577                 } else {
1578                         /* This should never happen, because of the way the
1579                          * server handles conversions. */
1580                         LDLM_ERROR(lock, "Erroneous flags %d on local lock\n",
1581                                    *flags);
1582                         LBUG();
1583
1584                         ldlm_grant_lock(lock, &rpc_list);
1585                         granted = 1;
1586                         /* FIXME: completion handling not with ns_lock held ! */
1587                         if (lock->l_completion_ast)
1588                                 lock->l_completion_ast(lock, 0, NULL);
1589                 }
1590         } else {
1591                 int pflags = 0;
1592                 ldlm_processing_policy policy;
1593                 policy = ldlm_processing_policy_table[res->lr_type];
1594                 rc = policy(lock, &pflags, 0, &err, &rpc_list);
1595                 if (rc == LDLM_ITER_STOP) {
1596                         lock->l_req_mode = old_mode;
1597                         ldlm_granted_list_add_lock(lock, mark_lock, join);
1598                         res = NULL;
1599                 } else {
1600                         *flags |= LDLM_FL_BLOCK_GRANTED;
1601                         granted = 1;
1602                 }
1603         }
1604         unlock_res_and_lock(lock);
1605
1606         if (granted)
1607                 ldlm_run_cp_ast_work(&rpc_list);
1608         RETURN(res);
1609 }
1610
1611 void ldlm_lock_dump(int level, struct ldlm_lock *lock, int pos)
1612 {
1613         struct obd_device *obd = NULL;
1614
1615         if (!((libcfs_debug | D_ERROR) & level))
1616                 return;
1617
1618         if (!lock) {
1619                 CDEBUG(level, "  NULL LDLM lock\n");
1620                 return;
1621         }
1622
1623         CDEBUG(level," -- Lock dump: %p/"LPX64" (rc: %d) (pos: %d) (pid: %d)\n",
1624                lock, lock->l_handle.h_cookie, atomic_read(&lock->l_refc),
1625                pos, lock->l_pid);
1626         if (lock->l_conn_export != NULL)
1627                 obd = lock->l_conn_export->exp_obd;
1628         if (lock->l_export && lock->l_export->exp_connection) {
1629                 CDEBUG(level, "  Node: NID %s (rhandle: "LPX64")\n",
1630                      libcfs_nid2str(lock->l_export->exp_connection->c_peer.nid),
1631                      lock->l_remote_handle.cookie);
1632         } else if (obd == NULL) {
1633                 CDEBUG(level, "  Node: local\n");
1634         } else {
1635                 struct obd_import *imp = obd->u.cli.cl_import;
1636                 CDEBUG(level, "  Node: NID %s (rhandle: "LPX64")\n",
1637                        libcfs_nid2str(imp->imp_connection->c_peer.nid),
1638                        lock->l_remote_handle.cookie);
1639         }
1640         CDEBUG(level, "  Resource: %p ("LPU64"/"LPU64")\n", lock->l_resource,
1641                lock->l_resource->lr_name.name[0],
1642                lock->l_resource->lr_name.name[1]);
1643         CDEBUG(level, "  Req mode: %s, grant mode: %s, rc: %u, read: %d, "
1644                "write: %d flags: %#x\n", ldlm_lockname[lock->l_req_mode],
1645                ldlm_lockname[lock->l_granted_mode],
1646                atomic_read(&lock->l_refc), lock->l_readers, lock->l_writers,
1647                lock->l_flags);
1648         if (lock->l_resource->lr_type == LDLM_EXTENT)
1649                 CDEBUG(level, "  Extent: "LPU64" -> "LPU64
1650                        " (req "LPU64"-"LPU64")\n",
1651                        lock->l_policy_data.l_extent.start,
1652                        lock->l_policy_data.l_extent.end,
1653                        lock->l_req_extent.start, lock->l_req_extent.end);
1654         else if (lock->l_resource->lr_type == LDLM_FLOCK)
1655                 CDEBUG(level, "  Pid: %d Extent: "LPU64" -> "LPU64"\n",
1656                        lock->l_policy_data.l_flock.pid,
1657                        lock->l_policy_data.l_flock.start,
1658                        lock->l_policy_data.l_flock.end);
1659        else if (lock->l_resource->lr_type == LDLM_IBITS)
1660                 CDEBUG(level, "  Bits: "LPX64"\n",
1661                        lock->l_policy_data.l_inodebits.bits);
1662 }
1663
1664 void ldlm_lock_dump_handle(int level, struct lustre_handle *lockh)
1665 {
1666         struct ldlm_lock *lock;
1667
1668         if (!((libcfs_debug | D_ERROR) & level))
1669                 return;
1670
1671         lock = ldlm_handle2lock(lockh);
1672         if (lock == NULL)
1673                 return;
1674
1675         ldlm_lock_dump(D_OTHER, lock, 0);
1676
1677         LDLM_LOCK_PUT(lock);
1678 }
1679
1680 void _ldlm_lock_debug(struct ldlm_lock *lock, __u32 level,
1681                       struct libcfs_debug_msg_data *data, const char *fmt,
1682                       ...)
1683 {
1684         va_list args;
1685         cfs_debug_limit_state_t *cdls = data->msg_cdls;
1686
1687         va_start(args, fmt);
1688         if (lock->l_resource == NULL) {
1689                 libcfs_debug_vmsg2(cdls, data->msg_subsys, level, data->msg_file,
1690                                    data->msg_fn, data->msg_line, fmt, args,
1691                                    " ns: \?\? lock: %p/"LPX64" lrc: %d/%d,%d mode: %s/%s "
1692                                    "res: \?\? rrc=\?\? type: \?\?\? flags: %x remote: "
1693                                    LPX64" expref: %d pid: %u\n", lock,
1694                                    lock->l_handle.h_cookie, atomic_read(&lock->l_refc),
1695                                    lock->l_readers, lock->l_writers,
1696                                    ldlm_lockname[lock->l_granted_mode],
1697                                    ldlm_lockname[lock->l_req_mode],
1698                                    lock->l_flags, lock->l_remote_handle.cookie,
1699                                    lock->l_export ?
1700                                         atomic_read(&lock->l_export->exp_refcount) : -99,
1701                                    lock->l_pid);
1702                 va_end(args);
1703                 return;
1704         }
1705
1706         switch (lock->l_resource->lr_type) {
1707         case LDLM_EXTENT:
1708                 libcfs_debug_vmsg2(cdls, data->msg_subsys, level, data->msg_file,
1709                                    data->msg_fn, data->msg_line, fmt, args,
1710                                    " ns: %s lock: %p/"LPX64" lrc: %d/%d,%d mode: %s/%s "
1711                                    "res: "LPU64"/"LPU64" rrc: %d type: %s ["LPU64"->"LPU64
1712                                    "] (req "LPU64"->"LPU64") flags: %x remote: "LPX64
1713                                     " expref: %d pid: %u\n",
1714                                     lock->l_resource->lr_namespace->ns_name, lock,
1715                                     lock->l_handle.h_cookie, atomic_read(&lock->l_refc),
1716                                     lock->l_readers, lock->l_writers,
1717                                     ldlm_lockname[lock->l_granted_mode],
1718                                     ldlm_lockname[lock->l_req_mode],
1719                                     lock->l_resource->lr_name.name[0],
1720                                     lock->l_resource->lr_name.name[1],
1721                                     atomic_read(&lock->l_resource->lr_refcount),
1722                                     ldlm_typename[lock->l_resource->lr_type],
1723                                     lock->l_policy_data.l_extent.start,
1724                                     lock->l_policy_data.l_extent.end,
1725                                     lock->l_req_extent.start, lock->l_req_extent.end,
1726                                     lock->l_flags, lock->l_remote_handle.cookie,
1727                                     lock->l_export ?
1728                                         atomic_read(&lock->l_export->exp_refcount) : -99,
1729                                     lock->l_pid);
1730                 break;
1731         case LDLM_FLOCK:
1732                 libcfs_debug_vmsg2(cdls, data->msg_subsys, level, data->msg_file,
1733                                    data->msg_fn, data->msg_line, fmt, args,
1734                                    " ns: %s lock: %p/"LPX64" lrc: %d/%d,%d mode: %s/%s "
1735                                    "res: "LPU64"/"LPU64" rrc: %d type: %s pid: %d "
1736                                    "["LPU64"->"LPU64"] flags: %x remote: "LPX64
1737                                    " expref: %d pid: %u\n",
1738                                    lock->l_resource->lr_namespace->ns_name, lock,
1739                                    lock->l_handle.h_cookie, atomic_read(&lock->l_refc),
1740                                    lock->l_readers, lock->l_writers,
1741                                    ldlm_lockname[lock->l_granted_mode],
1742                                    ldlm_lockname[lock->l_req_mode],
1743                                    lock->l_resource->lr_name.name[0],
1744                                    lock->l_resource->lr_name.name[1],
1745                                    atomic_read(&lock->l_resource->lr_refcount),
1746                                    ldlm_typename[lock->l_resource->lr_type],
1747                                    lock->l_policy_data.l_flock.pid,
1748                                    lock->l_policy_data.l_flock.start,
1749                                    lock->l_policy_data.l_flock.end,
1750                                    lock->l_flags, lock->l_remote_handle.cookie,
1751                                    lock->l_export ?
1752                                         atomic_read(&lock->l_export->exp_refcount) : -99,
1753                                    lock->l_pid);
1754                 break;
1755         case LDLM_IBITS:
1756                 libcfs_debug_vmsg2(cdls, data->msg_subsys, level, data->msg_file,
1757                                    data->msg_fn, data->msg_line, fmt, args,
1758                                    " ns: %s lock: %p/"LPX64" lrc: %d/%d,%d mode: %s/%s "
1759                                    "res: "LPU64"/"LPU64" bits "LPX64" rrc: %d type: %s "
1760                                    "flags: %x remote: "LPX64" expref: %d "
1761                                    "pid %u\n",
1762                                    lock->l_resource->lr_namespace->ns_name,
1763                                    lock, lock->l_handle.h_cookie,
1764                                    atomic_read (&lock->l_refc),
1765                                    lock->l_readers, lock->l_writers,
1766                                    ldlm_lockname[lock->l_granted_mode],
1767                                    ldlm_lockname[lock->l_req_mode],
1768                                    lock->l_resource->lr_name.name[0],
1769                                    lock->l_resource->lr_name.name[1],
1770                                    lock->l_policy_data.l_inodebits.bits,
1771                                    atomic_read(&lock->l_resource->lr_refcount),
1772                                    ldlm_typename[lock->l_resource->lr_type],
1773                                    lock->l_flags, lock->l_remote_handle.cookie,
1774                                    lock->l_export ?
1775                                         atomic_read(&lock->l_export->exp_refcount) : -99,
1776                                    lock->l_pid);
1777                 break;
1778         default:
1779                 libcfs_debug_vmsg2(cdls, data->msg_subsys, level, data->msg_file,
1780                                    data->msg_fn, data->msg_line, fmt, args,
1781                                    " ns: %s lock: %p/"LPX64" lrc: %d/%d,%d mode: %s/%s "
1782                                    "res: "LPU64"/"LPU64" rrc: %d type: %s flags: %x "
1783                                    "remote: "LPX64" expref: %d pid: %u\n",
1784                                    lock->l_resource->lr_namespace->ns_name,
1785                                    lock, lock->l_handle.h_cookie,
1786                                    atomic_read (&lock->l_refc),
1787                                    lock->l_readers, lock->l_writers,
1788                                    ldlm_lockname[lock->l_granted_mode],
1789                                    ldlm_lockname[lock->l_req_mode],
1790                                    lock->l_resource->lr_name.name[0],
1791                                    lock->l_resource->lr_name.name[1],
1792                                    atomic_read(&lock->l_resource->lr_refcount),
1793                                    ldlm_typename[lock->l_resource->lr_type],
1794                                    lock->l_flags, lock->l_remote_handle.cookie,
1795                                    lock->l_export ?
1796                                          atomic_read(&lock->l_export->exp_refcount) : -99,
1797                                    lock->l_pid);
1798                 break;
1799         }
1800         va_end(args);
1801 }
1802 EXPORT_SYMBOL(_ldlm_lock_debug);