lustre/osc/osc_lock.c

   1 /*
   2  * GPL HEADER START
   3  *
   4  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License version 2 only,
   8  * as published by the Free Software Foundation.
   9  *
  10  * This program is distributed in the hope that it will be useful, but
  11  * WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * General Public License version 2 for more details (a copy is included
  14  * in the LICENSE file that accompanied this code).
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * version 2 along with this program; If not, see
  18  * http://www.gnu.org/licenses/gpl-2.0.html
  19  *
  20  * GPL HEADER END
  21  */
  22 /*
  23  * Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
  24  * Use is subject to license terms.
  25  *
  26  * Copyright (c) 2011, 2016, Intel Corporation.
  27  */
  28 /*
  29  * This file is part of Lustre, http://www.lustre.org/
  30  * Lustre is a trademark of Sun Microsystems, Inc.
  31  *
  32  * Implementation of cl_lock for OSC layer.
  33  *
  34  *   Author: Nikita Danilov <nikita.danilov@sun.com>
  35  *   Author: Jinshan Xiong <jinshan.xiong@intel.com>
  36  */
  37
  38 #define DEBUG_SUBSYSTEM S_OSC
  39
  40 #include <libcfs/libcfs.h>
  41 /* fid_build_reg_res_name() */
  42 #include <lustre_fid.h>
  43 #include <lustre_osc.h>
  44
  45 #include "osc_internal.h"
  46
  47 /** \addtogroup osc
  48  *  @{
  49  */
  50
  51 /**
  52  * Returns a weak pointer to the ldlm lock identified by a handle. Returned
  53  * pointer cannot be dereferenced, as lock is not protected from concurrent
  54  * reclaim. This function is a helper for osc_lock_invariant().
  55  */
  56 static struct ldlm_lock *osc_handle_ptr(struct lustre_handle *handle)
  57 {
  58         struct ldlm_lock *lock;
  59
  60         lock = ldlm_handle2lock(handle);
  61         if (lock != NULL)
  62                 LDLM_LOCK_PUT(lock);
  63         return lock;
  64 }
  65
  66 /**
  67  * Invariant that has to be true all of the time.
  68  */
  69 static int osc_lock_invariant(struct osc_lock *ols)
  70 {
  71         struct ldlm_lock *lock        = osc_handle_ptr(&ols->ols_handle);
  72         struct ldlm_lock *olock       = ols->ols_dlmlock;
  73         int               handle_used = lustre_handle_is_used(&ols->ols_handle);
  74
  75         if (ergo(osc_lock_is_lockless(ols),
  76                  ols->ols_locklessable && ols->ols_dlmlock == NULL))
  77                 return 1;
  78
  79         /*
  80          * If all the following "ergo"s are true, return 1, otherwise 0
  81          */
  82         if (! ergo(olock != NULL, handle_used))
  83                 return 0;
  84
  85         if (! ergo(olock != NULL,
  86                    olock->l_handle.h_cookie == ols->ols_handle.cookie))
  87                 return 0;
  88
  89         if (! ergo(handle_used,
  90                    ergo(lock != NULL && olock != NULL, lock == olock) &&
  91                    ergo(lock == NULL, olock == NULL)))
  92                 return 0;
  93         /*
  94          * Check that ->ols_handle and ->ols_dlmlock are consistent, but
  95          * take into account that they are set at the different time.
  96          */
  97         if (! ergo(ols->ols_state == OLS_CANCELLED,
  98                    olock == NULL && !handle_used))
  99                 return 0;
 100         /*
 101          * DLM lock is destroyed only after we have seen cancellation
 102          * ast.
 103          */
 104         if (! ergo(olock != NULL && ols->ols_state < OLS_CANCELLED,
 105                    !ldlm_is_destroyed(olock)))
 106                 return 0;
 107
 108         if (! ergo(ols->ols_state == OLS_GRANTED,
 109                    olock != NULL &&
 110                    olock->l_req_mode == olock->l_granted_mode &&
 111                    ols->ols_hold))
 112                 return 0;
 113         return 1;
 114 }
 115
 116 /*****************************************************************************
 117  *
 118  * Lock operations.
 119  *
 120  */
 121
 122 void osc_lock_fini(const struct lu_env *env, struct cl_lock_slice *slice)
 123 {
 124         struct osc_lock  *ols = cl2osc_lock(slice);
 125
 126         LINVRNT(osc_lock_invariant(ols));
 127         LASSERT(ols->ols_dlmlock == NULL);
 128
 129         OBD_SLAB_FREE_PTR(ols, osc_lock_kmem);
 130 }
 131 EXPORT_SYMBOL(osc_lock_fini);
 132
 133 static void osc_lock_build_policy(const struct lu_env *env,
 134                                   const struct cl_lock *lock,
 135                                   union ldlm_policy_data *policy)
 136 {
 137         const struct cl_lock_descr *d = &lock->cll_descr;
 138
 139         osc_index2policy(policy, d->cld_obj, d->cld_start, d->cld_end);
 140         policy->l_extent.gid = d->cld_gid;
 141 }
 142
 143 /**
 144  * Updates object attributes from a lock value block (lvb) received together
 145  * with the DLM lock reply from the server. Copy of osc_update_enqueue()
 146  * logic.
 147  *
 148  * This can be optimized to not update attributes when lock is a result of a
 149  * local match.
 150  *
 151  * Called under lock and resource spin-locks.
 152  */
 153 static void osc_lock_lvb_update(const struct lu_env *env,
 154                                 struct osc_object *osc,
 155                                 struct ldlm_lock *dlmlock,
 156                                 struct ost_lvb *lvb)
 157 {
 158         struct cl_object  *obj = osc2cl(osc);
 159         struct lov_oinfo  *oinfo = osc->oo_oinfo;
 160         struct cl_attr    *attr = &osc_env_info(env)->oti_attr;
 161         unsigned           valid;
 162
 163         ENTRY;
 164
 165         valid = CAT_BLOCKS | CAT_ATIME | CAT_CTIME | CAT_MTIME | CAT_SIZE;
 166         if (lvb == NULL) {
 167                 LASSERT(dlmlock != NULL);
 168                 lvb = dlmlock->l_lvb_data;
 169         }
 170         cl_lvb2attr(attr, lvb);
 171
 172         cl_object_attr_lock(obj);
 173         if (dlmlock != NULL) {
 174                 __u64 size;
 175
 176                 check_res_locked(dlmlock->l_resource);
 177
 178                 LASSERT(lvb == dlmlock->l_lvb_data);
 179                 size = lvb->lvb_size;
 180
 181                 /* Extend KMS up to the end of this lock and no further
 182                  * A lock on [x,y] means a KMS of up to y + 1 bytes! */
 183                 if (size > dlmlock->l_policy_data.l_extent.end)
 184                         size = dlmlock->l_policy_data.l_extent.end + 1;
 185                 if (size >= oinfo->loi_kms) {
 186                         LDLM_DEBUG(dlmlock, "lock acquired, setting rss=%llu"
 187                                    ", kms=%llu", lvb->lvb_size, size);
 188                         valid |= CAT_KMS;
 189                         attr->cat_kms = size;
 190                 } else {
 191                         LDLM_DEBUG(dlmlock, "lock acquired, setting rss="
 192                                    "%llu; leaving kms=%llu, end=%llu",
 193                                    lvb->lvb_size, oinfo->loi_kms,
 194                                    dlmlock->l_policy_data.l_extent.end);
 195                 }
 196                 ldlm_lock_allow_match_locked(dlmlock);
 197         }
 198
 199         cl_object_attr_update(env, obj, attr, valid);
 200         cl_object_attr_unlock(obj);
 201
 202         EXIT;
 203 }
 204
 205 static void osc_lock_granted(const struct lu_env *env, struct osc_lock *oscl,
 206                              struct lustre_handle *lockh, bool lvb_update)
 207 {
 208         struct ldlm_lock *dlmlock;
 209
 210         dlmlock = ldlm_handle2lock_long(lockh, 0);
 211         LASSERT(dlmlock != NULL);
 212
 213         /* lock reference taken by ldlm_handle2lock_long() is
 214          * owned by osc_lock and released in osc_lock_detach()
 215          */
 216         lu_ref_add(&dlmlock->l_reference, "osc_lock", oscl);
 217         oscl->ols_has_ref = 1;
 218
 219         LASSERT(oscl->ols_dlmlock == NULL);
 220         oscl->ols_dlmlock = dlmlock;
 221
 222         /* This may be a matched lock for glimpse request, do not hold
 223          * lock reference in that case. */
 224         if (!oscl->ols_glimpse) {
 225                 /* hold a refc for non glimpse lock which will
 226                  * be released in osc_lock_cancel() */
 227                 lustre_handle_copy(&oscl->ols_handle, lockh);
 228                 ldlm_lock_addref(lockh, oscl->ols_einfo.ei_mode);
 229                 oscl->ols_hold = 1;
 230         }
 231
 232         /* Lock must have been granted. */
 233         lock_res_and_lock(dlmlock);
 234         if (dlmlock->l_granted_mode == dlmlock->l_req_mode) {
 235                 struct ldlm_extent *ext = &dlmlock->l_policy_data.l_extent;
 236                 struct cl_lock_descr *descr = &oscl->ols_cl.cls_lock->cll_descr;
 237
 238                 /* extend the lock extent, otherwise it will have problem when
 239                  * we decide whether to grant a lockless lock. */
 240                 descr->cld_mode  = osc_ldlm2cl_lock(dlmlock->l_granted_mode);
 241                 descr->cld_start = cl_index(descr->cld_obj, ext->start);
 242                 descr->cld_end   = cl_index(descr->cld_obj, ext->end);
 243                 descr->cld_gid   = ext->gid;
 244
 245                 /* no lvb update for matched lock */
 246                 if (lvb_update) {
 247                         LASSERT(oscl->ols_flags & LDLM_FL_LVB_READY);
 248                         osc_lock_lvb_update(env, cl2osc(oscl->ols_cl.cls_obj),
 249                                             dlmlock, NULL);
 250                 }
 251                 LINVRNT(osc_lock_invariant(oscl));
 252         }
 253         unlock_res_and_lock(dlmlock);
 254
 255         LASSERT(oscl->ols_state != OLS_GRANTED);
 256         oscl->ols_state = OLS_GRANTED;
 257 }
 258
 259 /**
 260  * Lock upcall function that is executed either when a reply to ENQUEUE rpc is
 261  * received from a server, or after osc_enqueue_base() matched a local DLM
 262  * lock.
 263  */
 264 static int osc_lock_upcall(void *cookie, struct lustre_handle *lockh,
 265                            int errcode)
 266 {
 267         struct osc_lock         *oscl  = cookie;
 268         struct cl_lock_slice    *slice = &oscl->ols_cl;
 269         struct lu_env           *env;
 270         int                     rc;
 271
 272         ENTRY;
 273
 274         env = cl_env_percpu_get();
 275         /* should never happen, similar to osc_ldlm_blocking_ast(). */
 276         LASSERT(!IS_ERR(env));
 277
 278         rc = ldlm_error2errno(errcode);
 279         if (oscl->ols_state == OLS_ENQUEUED) {
 280                 oscl->ols_state = OLS_UPCALL_RECEIVED;
 281         } else if (oscl->ols_state == OLS_CANCELLED) {
 282                 rc = -EIO;
 283         } else {
 284                 CERROR("Impossible state: %d\n", oscl->ols_state);
 285                 LBUG();
 286         }
 287
 288         if (rc == 0)
 289                 osc_lock_granted(env, oscl, lockh, errcode == ELDLM_OK);
 290
 291         /* Error handling, some errors are tolerable. */
 292         if (oscl->ols_locklessable && rc == -EUSERS) {
 293                 /* This is a tolerable error, turn this lock into
 294                  * lockless lock.
 295                  */
 296                 osc_object_set_contended(cl2osc(slice->cls_obj));
 297                 LASSERT(slice->cls_ops != oscl->ols_lockless_ops);
 298
 299                 /* Change this lock to ldlmlock-less lock. */
 300                 osc_lock_to_lockless(env, oscl, 1);
 301                 oscl->ols_state = OLS_GRANTED;
 302                 rc = 0;
 303         } else if (oscl->ols_glimpse && rc == -ENAVAIL) {
 304                 LASSERT(oscl->ols_flags & LDLM_FL_LVB_READY);
 305                 osc_lock_lvb_update(env, cl2osc(slice->cls_obj),
 306                                     NULL, &oscl->ols_lvb);
 307                 /* Hide the error. */
 308                 rc = 0;
 309         }
 310
 311         if (oscl->ols_owner != NULL)
 312                 cl_sync_io_note(env, oscl->ols_owner, rc);
 313         cl_env_percpu_put(env);
 314
 315         RETURN(rc);
 316 }
 317
 318 static int osc_lock_upcall_speculative(void *cookie,
 319                                        struct lustre_handle *lockh,
 320                                        int errcode)
 321 {
 322         struct osc_object       *osc = cookie;
 323         struct ldlm_lock        *dlmlock;
 324         struct lu_env           *env;
 325         __u16                    refcheck;
 326         ENTRY;
 327
 328         env = cl_env_get(&refcheck);
 329         LASSERT(!IS_ERR(env));
 330
 331         if (errcode == ELDLM_LOCK_MATCHED)
 332                 GOTO(out, errcode = ELDLM_OK);
 333
 334         if (errcode != ELDLM_OK)
 335                 GOTO(out, errcode);
 336
 337         dlmlock = ldlm_handle2lock(lockh);
 338         LASSERT(dlmlock != NULL);
 339
 340         lock_res_and_lock(dlmlock);
 341         LASSERT(dlmlock->l_granted_mode == dlmlock->l_req_mode);
 342
 343         /* there is no osc_lock associated with speculative locks */
 344         osc_lock_lvb_update(env, osc, dlmlock, NULL);
 345
 346         unlock_res_and_lock(dlmlock);
 347         LDLM_LOCK_PUT(dlmlock);
 348
 349 out:
 350         cl_object_put(env, osc2cl(osc));
 351         cl_env_put(env, &refcheck);
 352         RETURN(ldlm_error2errno(errcode));
 353 }
 354
 355 static int osc_lock_flush(struct osc_object *obj, pgoff_t start, pgoff_t end,
 356                           enum cl_lock_mode mode, bool discard)
 357 {
 358         struct lu_env           *env;
 359         __u16                   refcheck;
 360         int                     rc = 0;
 361         int                     rc2 = 0;
 362
 363         ENTRY;
 364
 365         env = cl_env_get(&refcheck);
 366         if (IS_ERR(env))
 367                 RETURN(PTR_ERR(env));
 368
 369         if (mode == CLM_WRITE) {
 370                 rc = osc_cache_writeback_range(env, obj, start, end, 1,
 371                                                discard);
 372                 CDEBUG(D_CACHE, "object %p: [%lu -> %lu] %d pages were %s.\n",
 373                        obj, start, end, rc,
 374                        discard ? "discarded" : "written back");
 375                 if (rc > 0)
 376                         rc = 0;
 377         }
 378
 379         rc2 = osc_lock_discard_pages(env, obj, start, end, discard);
 380         if (rc == 0 && rc2 < 0)
 381                 rc = rc2;
 382
 383         cl_env_put(env, &refcheck);
 384         RETURN(rc);
 385 }
 386
 387 /**
 388  * Helper for osc_dlm_blocking_ast() handling discrepancies between cl_lock
 389  * and ldlm_lock caches.
 390  */
 391 static int osc_dlm_blocking_ast0(const struct lu_env *env,
 392                                  struct ldlm_lock *dlmlock,
 393                                  void *data, int flag)
 394 {
 395         struct cl_object        *obj = NULL;
 396         int                     result = 0;
 397         bool                    discard;
 398         enum cl_lock_mode       mode = CLM_READ;
 399         ENTRY;
 400
 401         LASSERT(flag == LDLM_CB_CANCELING);
 402
 403         lock_res_and_lock(dlmlock);
 404         if (dlmlock->l_granted_mode != dlmlock->l_req_mode) {
 405                 dlmlock->l_ast_data = NULL;
 406                 unlock_res_and_lock(dlmlock);
 407                 RETURN(0);
 408         }
 409
 410         discard = ldlm_is_discard_data(dlmlock);
 411         if (dlmlock->l_granted_mode & (LCK_PW | LCK_GROUP))
 412                 mode = CLM_WRITE;
 413
 414         if (dlmlock->l_ast_data != NULL) {
 415                 obj = osc2cl(dlmlock->l_ast_data);
 416                 dlmlock->l_ast_data = NULL;
 417
 418                 cl_object_get(obj);
 419         }
 420
 421         unlock_res_and_lock(dlmlock);
 422
 423         /* if l_ast_data is NULL, the dlmlock was enqueued by AGL or
 424          * the object has been destroyed. */
 425         if (obj != NULL) {
 426                 struct ldlm_extent *extent = &dlmlock->l_policy_data.l_extent;
 427                 struct cl_attr *attr = &osc_env_info(env)->oti_attr;
 428                 __u64 old_kms;
 429
 430                 /* Destroy pages covered by the extent of the DLM lock */
 431                 result = osc_lock_flush(cl2osc(obj),
 432                                         cl_index(obj, extent->start),
 433                                         cl_index(obj, extent->end),
 434                                         mode, discard);
 435
 436                 /* losing a lock, update kms */
 437                 lock_res_and_lock(dlmlock);
 438                 cl_object_attr_lock(obj);
 439                 /* Must get the value under the lock to avoid race. */
 440                 old_kms = cl2osc(obj)->oo_oinfo->loi_kms;
 441                 /* Update the kms. Need to loop all granted locks.
 442                  * Not a problem for the client */
 443                 attr->cat_kms = ldlm_extent_shift_kms(dlmlock, old_kms);
 444
 445                 cl_object_attr_update(env, obj, attr, CAT_KMS);
 446                 cl_object_attr_unlock(obj);
 447                 unlock_res_and_lock(dlmlock);
 448
 449                 cl_object_put(env, obj);
 450         }
 451         RETURN(result);
 452 }
 453
 454 /**
 455  * Blocking ast invoked by ldlm when dlm lock is either blocking progress of
 456  * some other lock, or is canceled. This function is installed as a
 457  * ldlm_lock::l_blocking_ast() for client extent locks.
 458  *
 459  * Control flow is tricky, because ldlm uses the same call-back
 460  * (ldlm_lock::l_blocking_ast()) for both blocking and cancellation ast's.
 461  *
 462  * \param dlmlock lock for which ast occurred.
 463  *
 464  * \param new description of a conflicting lock in case of blocking ast.
 465  *
 466  * \param data value of dlmlock->l_ast_data
 467  *
 468  * \param flag LDLM_CB_BLOCKING or LDLM_CB_CANCELING. Used to distinguish
 469  *             cancellation and blocking ast's.
 470  *
 471  * Possible use cases:
 472  *
 473  *     - ldlm calls dlmlock->l_blocking_ast(..., LDLM_CB_CANCELING) to cancel
 474  *       lock due to lock lru pressure, or explicit user request to purge
 475  *       locks.
 476  *
 477  *     - ldlm calls dlmlock->l_blocking_ast(..., LDLM_CB_BLOCKING) to notify
 478  *       us that dlmlock conflicts with another lock that some client is
 479  *       enqueuing. Lock is canceled.
 480  *
 481  *           - cl_lock_cancel() is called. osc_lock_cancel() calls
 482  *             ldlm_cli_cancel() that calls
 483  *
 484  *                  dlmlock->l_blocking_ast(..., LDLM_CB_CANCELING)
 485  *
 486  *             recursively entering osc_ldlm_blocking_ast().
 487  *
 488  *     - client cancels lock voluntary (e.g., as a part of early cancellation):
 489  *
 490  *           cl_lock_cancel()->
 491  *             osc_lock_cancel()->
 492  *               ldlm_cli_cancel()->
 493  *                 dlmlock->l_blocking_ast(..., LDLM_CB_CANCELING)
 494  *
 495  */
 496 static int osc_ldlm_blocking_ast(struct ldlm_lock *dlmlock,
 497                                  struct ldlm_lock_desc *new, void *data,
 498                                  int flag)
 499 {
 500         int result = 0;
 501         ENTRY;
 502
 503         switch (flag) {
 504         case LDLM_CB_BLOCKING: {
 505                 struct lustre_handle lockh;
 506
 507                 ldlm_lock2handle(dlmlock, &lockh);
 508                 result = ldlm_cli_cancel(&lockh, LCF_ASYNC);
 509                 if (result == -ENODATA)
 510                         result = 0;
 511                 break;
 512         }
 513         case LDLM_CB_CANCELING: {
 514                 struct lu_env     *env;
 515                 __u16              refcheck;
 516
 517                 /*
 518                  * This can be called in the context of outer IO, e.g.,
 519                  *
 520                  *    osc_enqueue_base()->...
 521                  *      ->ldlm_prep_elc_req()->...
 522                  *        ->ldlm_cancel_callback()->...
 523                  *          ->osc_ldlm_blocking_ast()
 524                  *
 525                  * new environment has to be created to not corrupt outer
 526                  * context.
 527                  */
 528                 env = cl_env_get(&refcheck);
 529                 if (IS_ERR(env)) {
 530                         result = PTR_ERR(env);
 531                         break;
 532                 }
 533
 534                 result = osc_dlm_blocking_ast0(env, dlmlock, data, flag);
 535                 cl_env_put(env, &refcheck);
 536                 break;
 537         }
 538         default:
 539                 LBUG();
 540         }
 541         RETURN(result);
 542 }
 543
 544 int osc_ldlm_glimpse_ast(struct ldlm_lock *dlmlock, void *data)
 545 {
 546         struct ptlrpc_request   *req  = data;
 547         struct lu_env           *env;
 548         struct ost_lvb          *lvb;
 549         struct req_capsule      *cap;
 550         struct cl_object        *obj = NULL;
 551         int                     result;
 552         __u16                   refcheck;
 553
 554         ENTRY;
 555
 556         LASSERT(lustre_msg_get_opc(req->rq_reqmsg) == LDLM_GL_CALLBACK);
 557
 558         env = cl_env_get(&refcheck);
 559         if (IS_ERR(env))
 560                 GOTO(out, result = PTR_ERR(env));
 561
 562
 563         lock_res_and_lock(dlmlock);
 564         if (dlmlock->l_ast_data != NULL) {
 565                 obj = osc2cl(dlmlock->l_ast_data);
 566                 cl_object_get(obj);
 567         }
 568         unlock_res_and_lock(dlmlock);
 569
 570         if (obj != NULL) {
 571                 /* Do not grab the mutex of cl_lock for glimpse.
 572                  * See LU-1274 for details.
 573                  * BTW, it's okay for cl_lock to be cancelled during
 574                  * this period because server can handle this race.
 575                  * See ldlm_server_glimpse_ast() for details.
 576                  * cl_lock_mutex_get(env, lock); */
 577                 cap = &req->rq_pill;
 578                 req_capsule_extend(cap, &RQF_LDLM_GL_CALLBACK);
 579                 req_capsule_set_size(cap, &RMF_DLM_LVB, RCL_SERVER,
 580                                         sizeof *lvb);
 581                 result = req_capsule_server_pack(cap);
 582                 if (result == 0) {
 583                         lvb = req_capsule_server_get(cap, &RMF_DLM_LVB);
 584                         result = cl_object_glimpse(env, obj, lvb);
 585                 }
 586                 if (!exp_connect_lvb_type(req->rq_export))
 587                         req_capsule_shrink(&req->rq_pill, &RMF_DLM_LVB,
 588                                         sizeof(struct ost_lvb_v1), RCL_SERVER);
 589                 cl_object_put(env, obj);
 590         } else {
 591                 /*
 592                  * These errors are normal races, so we don't want to
 593                  * fill the console with messages by calling
 594                  * ptlrpc_error()
 595                  */
 596                 lustre_pack_reply(req, 1, NULL, NULL);
 597                 result = -ELDLM_NO_LOCK_DATA;
 598         }
 599         cl_env_put(env, &refcheck);
 600         EXIT;
 601
 602 out:
 603         req->rq_status = result;
 604         RETURN(result);
 605 }
 606 EXPORT_SYMBOL(osc_ldlm_glimpse_ast);
 607
 608 static int weigh_cb(const struct lu_env *env, struct cl_io *io,
 609                     struct osc_page *ops, void *cbdata)
 610 {
 611         struct cl_page *page = ops->ops_cl.cpl_page;
 612
 613         if (cl_page_is_vmlocked(env, page)
 614             || PageDirty(page->cp_vmpage) || PageWriteback(page->cp_vmpage)
 615            )
 616                 return CLP_GANG_ABORT;
 617
 618         *(pgoff_t *)cbdata = osc_index(ops) + 1;
 619         return CLP_GANG_OKAY;
 620 }
 621
 622 static unsigned long osc_lock_weight(const struct lu_env *env,
 623                                      struct osc_object *oscobj,
 624                                      struct ldlm_extent *extent)
 625 {
 626         struct cl_io     *io = osc_env_thread_io(env);
 627         struct cl_object *obj = cl_object_top(&oscobj->oo_cl);
 628         pgoff_t          page_index;
 629         int              result;
 630         ENTRY;
 631
 632         io->ci_obj = obj;
 633         io->ci_ignore_layout = 1;
 634         result = cl_io_init(env, io, CIT_MISC, io->ci_obj);
 635         if (result != 0)
 636                 RETURN(result);
 637
 638         page_index = cl_index(obj, extent->start);
 639         do {
 640                 result = osc_page_gang_lookup(env, io, oscobj,
 641                                               page_index,
 642                                               cl_index(obj, extent->end),
 643                                               weigh_cb, (void *)&page_index);
 644                 if (result == CLP_GANG_ABORT)
 645                         break;
 646                 if (result == CLP_GANG_RESCHED)
 647                         cond_resched();
 648         } while (result != CLP_GANG_OKAY);
 649         cl_io_fini(env, io);
 650
 651         return result == CLP_GANG_ABORT ? 1 : 0;
 652 }
 653
 654 /**
 655  * Get the weight of dlm lock for early cancellation.
 656  */
 657 unsigned long osc_ldlm_weigh_ast(struct ldlm_lock *dlmlock)
 658 {
 659         struct lu_env           *env;
 660         struct osc_object       *obj;
 661         struct osc_lock         *oscl;
 662         unsigned long            weight;
 663         bool                    found = false;
 664         __u16                   refcheck;
 665         ENTRY;
 666
 667         might_sleep();
 668         /*
 669          * osc_ldlm_weigh_ast has a complex context since it might be called
 670          * because of lock canceling, or from user's input. We have to make
 671          * a new environment for it. Probably it is implementation safe to use
 672          * the upper context because cl_lock_put don't modify environment
 673          * variables. But just in case ..
 674          */
 675         env = cl_env_get(&refcheck);
 676         if (IS_ERR(env))
 677                 /* Mostly because lack of memory, do not eliminate this lock */
 678                 RETURN(1);
 679
 680         LASSERT(dlmlock->l_resource->lr_type == LDLM_EXTENT);
 681         lock_res_and_lock(dlmlock);
 682         obj = dlmlock->l_ast_data;
 683         if (obj)
 684                 cl_object_get(osc2cl(obj));
 685         unlock_res_and_lock(dlmlock);
 686
 687         if (obj == NULL)
 688                 GOTO(out, weight = 1);
 689
 690         spin_lock(&obj->oo_ol_spin);
 691         list_for_each_entry(oscl, &obj->oo_ol_list, ols_nextlock_oscobj) {
 692                 if (oscl->ols_dlmlock != NULL && oscl->ols_dlmlock != dlmlock)
 693                         continue;
 694                 found = true;
 695         }
 696         spin_unlock(&obj->oo_ol_spin);
 697         if (found) {
 698                 /*
 699                  * If the lock is being used by an IO, definitely not cancel it.
 700                  */
 701                 GOTO(out, weight = 1);
 702         }
 703
 704         weight = osc_lock_weight(env, obj, &dlmlock->l_policy_data.l_extent);
 705         EXIT;
 706
 707 out:
 708         if (obj)
 709                 cl_object_put(env, osc2cl(obj));
 710
 711         cl_env_put(env, &refcheck);
 712         return weight;
 713 }
 714
 715 static void osc_lock_build_einfo(const struct lu_env *env,
 716                                  const struct cl_lock *lock,
 717                                  struct osc_object *osc,
 718                                  struct ldlm_enqueue_info *einfo)
 719 {
 720         einfo->ei_type   = LDLM_EXTENT;
 721         einfo->ei_mode   = osc_cl_lock2ldlm(lock->cll_descr.cld_mode);
 722         einfo->ei_cb_bl  = osc_ldlm_blocking_ast;
 723         einfo->ei_cb_cp  = ldlm_completion_ast;
 724         einfo->ei_cb_gl  = osc_ldlm_glimpse_ast;
 725         einfo->ei_cbdata = osc; /* value to be put into ->l_ast_data */
 726 }
 727
 728 /**
 729  * Determine if the lock should be converted into a lockless lock.
 730  *
 731  * Steps to check:
 732  * - if the lock has an explicite requirment for a non-lockless lock;
 733  * - if the io lock request type ci_lockreq;
 734  * - send the enqueue rpc to ost to make the further decision;
 735  * - special treat to truncate lockless lock
 736  *
 737  *  Additional policy can be implemented here, e.g., never do lockless-io
 738  *  for large extents.
 739  */
 740 void osc_lock_to_lockless(const struct lu_env *env,
 741                           struct osc_lock *ols, int force)
 742 {
 743         struct cl_lock_slice *slice = &ols->ols_cl;
 744         struct osc_io *oio = osc_env_io(env);
 745         struct cl_io *io = oio->oi_cl.cis_io;
 746         struct cl_object *obj = slice->cls_obj;
 747         struct osc_object *oob = cl2osc(obj);
 748         const struct osc_device *osd = lu2osc_dev(obj->co_lu.lo_dev);
 749         struct obd_connect_data *ocd;
 750
 751         LASSERT(ols->ols_state == OLS_NEW ||
 752                 ols->ols_state == OLS_UPCALL_RECEIVED);
 753
 754         if (force) {
 755                 ols->ols_locklessable = 1;
 756                 slice->cls_ops = ols->ols_lockless_ops;
 757         } else {
 758                 LASSERT(io->ci_lockreq == CILR_MANDATORY ||
 759                         io->ci_lockreq == CILR_MAYBE ||
 760                         io->ci_lockreq == CILR_NEVER);
 761
 762                 ocd = &class_exp2cliimp(osc_export(oob))->imp_connect_data;
 763                 ols->ols_locklessable = (io->ci_type != CIT_SETATTR) &&
 764                                         (io->ci_lockreq == CILR_MAYBE) &&
 765                                         (ocd->ocd_connect_flags &
 766                                          OBD_CONNECT_SRVLOCK);
 767                 if (io->ci_lockreq == CILR_NEVER ||
 768                     /* lockless IO */
 769                     (ols->ols_locklessable && osc_object_is_contended(oob)) ||
 770                     /* lockless truncate */
 771                     (cl_io_is_trunc(io) && osd->od_lockless_truncate &&
 772                      (ocd->ocd_connect_flags & OBD_CONNECT_TRUNCLOCK))) {
 773                         ols->ols_locklessable = 1;
 774                         slice->cls_ops = ols->ols_lockless_ops;
 775                 }
 776         }
 777         LASSERT(ergo(ols->ols_glimpse, !osc_lock_is_lockless(ols)));
 778 }
 779 EXPORT_SYMBOL(osc_lock_to_lockless);
 780
 781 static bool osc_lock_compatible(const struct osc_lock *qing,
 782                                 const struct osc_lock *qed)
 783 {
 784         struct cl_lock_descr *qed_descr = &qed->ols_cl.cls_lock->cll_descr;
 785         struct cl_lock_descr *qing_descr = &qing->ols_cl.cls_lock->cll_descr;
 786
 787         if (qed->ols_glimpse || qed->ols_speculative)
 788                 return true;
 789
 790         if (qing_descr->cld_mode == CLM_READ && qed_descr->cld_mode == CLM_READ)
 791                 return true;
 792
 793         if (qed->ols_state < OLS_GRANTED)
 794                 return true;
 795
 796         if (qed_descr->cld_mode  >= qing_descr->cld_mode &&
 797             qed_descr->cld_start <= qing_descr->cld_start &&
 798             qed_descr->cld_end   >= qing_descr->cld_end)
 799                 return true;
 800
 801         return false;
 802 }
 803
 804 void osc_lock_wake_waiters(const struct lu_env *env, struct osc_object *osc,
 805                            struct osc_lock *oscl)
 806 {
 807         spin_lock(&osc->oo_ol_spin);
 808         list_del_init(&oscl->ols_nextlock_oscobj);
 809         spin_unlock(&osc->oo_ol_spin);
 810
 811         spin_lock(&oscl->ols_lock);
 812         while (!list_empty(&oscl->ols_waiting_list)) {
 813                 struct osc_lock *scan;
 814
 815                 scan = list_entry(oscl->ols_waiting_list.next, struct osc_lock,
 816                                   ols_wait_entry);
 817                 list_del_init(&scan->ols_wait_entry);
 818
 819                 cl_sync_io_note(env, scan->ols_owner, 0);
 820         }
 821         spin_unlock(&oscl->ols_lock);
 822 }
 823 EXPORT_SYMBOL(osc_lock_wake_waiters);
 824
 825 int osc_lock_enqueue_wait(const struct lu_env *env, struct osc_object *obj,
 826                           struct osc_lock *oscl)
 827 {
 828         struct osc_lock         *tmp_oscl;
 829         struct cl_lock_descr    *need = &oscl->ols_cl.cls_lock->cll_descr;
 830         struct cl_sync_io       *waiter = &osc_env_info(env)->oti_anchor;
 831         int rc = 0;
 832
 833         ENTRY;
 834
 835         spin_lock(&obj->oo_ol_spin);
 836         list_add_tail(&oscl->ols_nextlock_oscobj, &obj->oo_ol_list);
 837
 838 restart:
 839         list_for_each_entry(tmp_oscl, &obj->oo_ol_list,
 840                             ols_nextlock_oscobj) {
 841                 struct cl_lock_descr *descr;
 842
 843                 if (tmp_oscl == oscl)
 844                         break;
 845
 846                 descr = &tmp_oscl->ols_cl.cls_lock->cll_descr;
 847                 if (descr->cld_start > need->cld_end ||
 848                     descr->cld_end   < need->cld_start)
 849                         continue;
 850
 851                 /* We're not supposed to give up group lock */
 852                 if (descr->cld_mode == CLM_GROUP)
 853                         break;
 854
 855                 if (!osc_lock_is_lockless(oscl) &&
 856                     osc_lock_compatible(oscl, tmp_oscl))
 857                         continue;
 858
 859                 /* wait for conflicting lock to be canceled */
 860                 cl_sync_io_init(waiter, 1, cl_sync_io_end);
 861                 oscl->ols_owner = waiter;
 862
 863                 spin_lock(&tmp_oscl->ols_lock);
 864                 /* add oscl into tmp's ols_waiting list */
 865                 list_add_tail(&oscl->ols_wait_entry,
 866                               &tmp_oscl->ols_waiting_list);
 867                 spin_unlock(&tmp_oscl->ols_lock);
 868
 869                 spin_unlock(&obj->oo_ol_spin);
 870                 rc = cl_sync_io_wait(env, waiter, 0);
 871                 spin_lock(&obj->oo_ol_spin);
 872
 873                 if (rc < 0)
 874                         break;
 875
 876                 oscl->ols_owner = NULL;
 877                 goto restart;
 878         }
 879         spin_unlock(&obj->oo_ol_spin);
 880
 881         RETURN(rc);
 882 }
 883 EXPORT_SYMBOL(osc_lock_enqueue_wait);
 884
 885 /**
 886  * Implementation of cl_lock_operations::clo_enqueue() method for osc
 887  * layer. This initiates ldlm enqueue:
 888  *
 889  *     - cancels conflicting locks early (osc_lock_enqueue_wait());
 890  *
 891  *     - calls osc_enqueue_base() to do actual enqueue.
 892  *
 893  * osc_enqueue_base() is supplied with an upcall function that is executed
 894  * when lock is received either after a local cached ldlm lock is matched, or
 895  * when a reply from the server is received.
 896  *
 897  * This function does not wait for the network communication to complete.
 898  */
 899 static int osc_lock_enqueue(const struct lu_env *env,
 900                             const struct cl_lock_slice *slice,
 901                             struct cl_io *unused, struct cl_sync_io *anchor)
 902 {
 903         struct osc_thread_info          *info  = osc_env_info(env);
 904         struct osc_io                   *oio   = osc_env_io(env);
 905         struct osc_object               *osc   = cl2osc(slice->cls_obj);
 906         struct osc_lock                 *oscl  = cl2osc_lock(slice);
 907         struct obd_export               *exp   = osc_export(osc);
 908         struct cl_lock                  *lock  = slice->cls_lock;
 909         struct ldlm_res_id              *resname = &info->oti_resname;
 910         union ldlm_policy_data          *policy  = &info->oti_policy;
 911         osc_enqueue_upcall_f            upcall   = osc_lock_upcall;
 912         void                            *cookie  = oscl;
 913         bool                            async    = false;
 914         int                             result;
 915
 916         ENTRY;
 917
 918         LASSERTF(ergo(oscl->ols_glimpse, lock->cll_descr.cld_mode <= CLM_READ),
 919                 "lock = %p, ols = %p\n", lock, oscl);
 920
 921         if (oscl->ols_state == OLS_GRANTED)
 922                 RETURN(0);
 923
 924         if ((oscl->ols_flags & LDLM_FL_NO_EXPANSION) &&
 925             !(exp_connect_lockahead_old(exp) || exp_connect_lockahead(exp))) {
 926                 result = -EOPNOTSUPP;
 927                 CERROR("%s: server does not support lockahead/locknoexpand:"
 928                        "rc = %d\n", exp->exp_obd->obd_name, result);
 929                 RETURN(result);
 930         }
 931
 932         if (oscl->ols_flags & LDLM_FL_TEST_LOCK)
 933                 GOTO(enqueue_base, 0);
 934
 935         /* For glimpse and/or speculative locks, do not wait for reply from
 936          * server on LDLM request */
 937         if (oscl->ols_glimpse || oscl->ols_speculative) {
 938                 /* Speculative and glimpse locks do not have an anchor */
 939                 LASSERT(equi(oscl->ols_speculative, anchor == NULL));
 940                 async = true;
 941                 GOTO(enqueue_base, 0);
 942         }
 943
 944         result = osc_lock_enqueue_wait(env, osc, oscl);
 945         if (result < 0)
 946                 GOTO(out, result);
 947
 948         /* we can grant lockless lock right after all conflicting locks
 949          * are canceled. */
 950         if (osc_lock_is_lockless(oscl)) {
 951                 oscl->ols_state = OLS_GRANTED;
 952                 oio->oi_lockless = 1;
 953                 RETURN(0);
 954         }
 955
 956 enqueue_base:
 957         oscl->ols_state = OLS_ENQUEUED;
 958         if (anchor != NULL) {
 959                 atomic_inc(&anchor->csi_sync_nr);
 960                 oscl->ols_owner = anchor;
 961         }
 962
 963         /**
 964          * DLM lock's ast data must be osc_object;
 965          * if glimpse or speculative lock, async of osc_enqueue_base()
 966          * must be true
 967          *
 968          * For non-speculative locks:
 969          * DLM's enqueue callback set to osc_lock_upcall() with cookie as
 970          * osc_lock.
 971          * For speculative locks:
 972          * osc_lock_upcall_speculative & cookie is the osc object, since
 973          * there is no osc_lock
 974          */
 975         ostid_build_res_name(&osc->oo_oinfo->loi_oi, resname);
 976         osc_lock_build_policy(env, lock, policy);
 977         if (oscl->ols_speculative) {
 978                 oscl->ols_einfo.ei_cbdata = NULL;
 979                 /* hold a reference for callback */
 980                 cl_object_get(osc2cl(osc));
 981                 upcall = osc_lock_upcall_speculative;
 982                 cookie = osc;
 983         }
 984         result = osc_enqueue_base(exp, resname, &oscl->ols_flags,
 985                                   policy, &oscl->ols_lvb,
 986                                   osc->oo_oinfo->loi_kms_valid,
 987                                   upcall, cookie,
 988                                   &oscl->ols_einfo, PTLRPCD_SET, async,
 989                                   oscl->ols_speculative);
 990         if (result == 0) {
 991                 if (osc_lock_is_lockless(oscl)) {
 992                         oio->oi_lockless = 1;
 993                 } else if (!async) {
 994                         LASSERT(oscl->ols_state == OLS_GRANTED);
 995                         LASSERT(oscl->ols_hold);
 996                         LASSERT(oscl->ols_dlmlock != NULL);
 997                 }
 998         } else if (oscl->ols_speculative) {
 999                 cl_object_put(env, osc2cl(osc));
1000                 if (oscl->ols_glimpse) {
1001                         /* hide error for AGL request */
1002                         result = 0;
1003                 }
1004         }
1005
1006 out:
1007         if (result < 0) {
1008                 oscl->ols_state = OLS_CANCELLED;
1009                 osc_lock_wake_waiters(env, osc, oscl);
1010
1011                 if (anchor != NULL)
1012                         cl_sync_io_note(env, anchor, result);
1013         }
1014         RETURN(result);
1015 }
1016
1017 /**
1018  * Breaks a link between osc_lock and dlm_lock.
1019  */
1020 static void osc_lock_detach(const struct lu_env *env, struct osc_lock *olck)
1021 {
1022         struct ldlm_lock *dlmlock;
1023
1024         ENTRY;
1025
1026         dlmlock = olck->ols_dlmlock;
1027         if (dlmlock == NULL)
1028                 RETURN_EXIT;
1029
1030         if (olck->ols_hold) {
1031                 olck->ols_hold = 0;
1032                 ldlm_lock_decref(&olck->ols_handle, olck->ols_einfo.ei_mode);
1033                 olck->ols_handle.cookie = 0ULL;
1034         }
1035
1036         olck->ols_dlmlock = NULL;
1037
1038         /* release a reference taken in osc_lock_upcall(). */
1039         LASSERT(olck->ols_has_ref);
1040         lu_ref_del(&dlmlock->l_reference, "osc_lock", olck);
1041         LDLM_LOCK_RELEASE(dlmlock);
1042         olck->ols_has_ref = 0;
1043
1044         EXIT;
1045 }
1046
1047 /**
1048  * Implements cl_lock_operations::clo_cancel() method for osc layer. This is
1049  * called (as part of cl_lock_cancel()) when lock is canceled either voluntary
1050  * (LRU pressure, early cancellation, umount, etc.) or due to the conflict
1051  * with some other lock some where in the cluster. This function does the
1052  * following:
1053  *
1054  *     - invalidates all pages protected by this lock (after sending dirty
1055  *       ones to the server, as necessary);
1056  *
1057  *     - decref's underlying ldlm lock;
1058  *
1059  *     - cancels ldlm lock (ldlm_cli_cancel()).
1060  */
1061 void osc_lock_cancel(const struct lu_env *env,
1062                      const struct cl_lock_slice *slice)
1063 {
1064         struct osc_object *obj  = cl2osc(slice->cls_obj);
1065         struct osc_lock   *oscl = cl2osc_lock(slice);
1066
1067         ENTRY;
1068
1069         LINVRNT(osc_lock_invariant(oscl));
1070
1071         osc_lock_detach(env, oscl);
1072         oscl->ols_state = OLS_CANCELLED;
1073         oscl->ols_flags &= ~LDLM_FL_LVB_READY;
1074
1075         osc_lock_wake_waiters(env, obj, oscl);
1076         EXIT;
1077 }
1078 EXPORT_SYMBOL(osc_lock_cancel);
1079
1080 int osc_lock_print(const struct lu_env *env, void *cookie,
1081                    lu_printer_t p, const struct cl_lock_slice *slice)
1082 {
1083         struct osc_lock *lock = cl2osc_lock(slice);
1084
1085         (*p)(env, cookie, "%p %#llx %#llx %d %p ",
1086              lock->ols_dlmlock, lock->ols_flags, lock->ols_handle.cookie,
1087              lock->ols_state, lock->ols_owner);
1088         osc_lvb_print(env, cookie, p, &lock->ols_lvb);
1089         return 0;
1090 }
1091 EXPORT_SYMBOL(osc_lock_print);
1092
1093 static const struct cl_lock_operations osc_lock_ops = {
1094         .clo_fini    = osc_lock_fini,
1095         .clo_enqueue = osc_lock_enqueue,
1096         .clo_cancel  = osc_lock_cancel,
1097         .clo_print   = osc_lock_print,
1098 };
1099
1100 static void osc_lock_lockless_cancel(const struct lu_env *env,
1101                                      const struct cl_lock_slice *slice)
1102 {
1103         struct osc_lock      *ols   = cl2osc_lock(slice);
1104         struct osc_object    *osc   = cl2osc(slice->cls_obj);
1105         struct cl_lock_descr *descr = &slice->cls_lock->cll_descr;
1106         int result;
1107
1108         LASSERT(ols->ols_dlmlock == NULL);
1109         result = osc_lock_flush(osc, descr->cld_start, descr->cld_end,
1110                                 descr->cld_mode, false);
1111         if (result)
1112                 CERROR("Pages for lockless lock %p were not purged(%d)\n",
1113                        ols, result);
1114
1115         osc_lock_wake_waiters(env, osc, ols);
1116 }
1117
1118 static const struct cl_lock_operations osc_lock_lockless_ops = {
1119         .clo_fini      = osc_lock_fini,
1120         .clo_enqueue   = osc_lock_enqueue,
1121         .clo_cancel    = osc_lock_lockless_cancel,
1122         .clo_print     = osc_lock_print
1123 };
1124
1125 void osc_lock_set_writer(const struct lu_env *env, const struct cl_io *io,
1126                          struct cl_object *obj, struct osc_lock *oscl)
1127 {
1128         struct cl_lock_descr *descr = &oscl->ols_cl.cls_lock->cll_descr;
1129         pgoff_t io_start;
1130         pgoff_t io_end;
1131
1132         if (!cl_object_same(io->ci_obj, obj))
1133                 return;
1134
1135         if (likely(io->ci_type == CIT_WRITE)) {
1136                 io_start = cl_index(obj, io->u.ci_rw.rw_range.cir_pos);
1137                 io_end = cl_index(obj, io->u.ci_rw.rw_range.cir_pos +
1138                                   io->u.ci_rw.rw_range.cir_count - 1);
1139         } else {
1140                 LASSERT(cl_io_is_mkwrite(io));
1141                 io_start = io_end = io->u.ci_fault.ft_index;
1142         }
1143
1144         if (descr->cld_mode >= CLM_WRITE &&
1145             (cl_io_is_append(io) ||
1146              (descr->cld_start <= io_start && descr->cld_end >= io_end))) {
1147                 struct osc_io *oio = osc_env_io(env);
1148
1149                 /* There must be only one lock to match the write region */
1150                 LASSERT(oio->oi_write_osclock == NULL);
1151                 oio->oi_write_osclock = oscl;
1152         }
1153 }
1154 EXPORT_SYMBOL(osc_lock_set_writer);
1155
1156 int osc_lock_init(const struct lu_env *env,
1157                   struct cl_object *obj, struct cl_lock *lock,
1158                   const struct cl_io *io)
1159 {
1160         struct osc_lock *oscl;
1161         __u32 enqflags = lock->cll_descr.cld_enq_flags;
1162
1163         OBD_SLAB_ALLOC_PTR_GFP(oscl, osc_lock_kmem, GFP_NOFS);
1164         if (oscl == NULL)
1165                 return -ENOMEM;
1166
1167         oscl->ols_state = OLS_NEW;
1168         spin_lock_init(&oscl->ols_lock);
1169         INIT_LIST_HEAD(&oscl->ols_waiting_list);
1170         INIT_LIST_HEAD(&oscl->ols_wait_entry);
1171         INIT_LIST_HEAD(&oscl->ols_nextlock_oscobj);
1172         oscl->ols_lockless_ops = &osc_lock_lockless_ops;
1173
1174         /* Speculative lock requests must be either no_expand or glimpse
1175          * request (CEF_GLIMPSE).  non-glimpse no_expand speculative extent
1176          * locks will break ofd_intent_cb. (see comment there)*/
1177         LASSERT(ergo((enqflags & CEF_SPECULATIVE) != 0,
1178                 (enqflags & (CEF_LOCK_NO_EXPAND | CEF_GLIMPSE)) != 0));
1179
1180         oscl->ols_flags = osc_enq2ldlm_flags(enqflags);
1181         oscl->ols_speculative = !!(enqflags & CEF_SPECULATIVE);
1182
1183         if (oscl->ols_flags & LDLM_FL_HAS_INTENT) {
1184                 oscl->ols_flags |= LDLM_FL_BLOCK_GRANTED;
1185                 oscl->ols_glimpse = 1;
1186         }
1187         osc_lock_build_einfo(env, lock, cl2osc(obj), &oscl->ols_einfo);
1188
1189         cl_lock_slice_add(lock, &oscl->ols_cl, obj, &osc_lock_ops);
1190
1191         if (!(enqflags & CEF_MUST))
1192                 /* try to convert this lock to a lockless lock */
1193                 osc_lock_to_lockless(env, oscl, (enqflags & CEF_NEVER));
1194         if (oscl->ols_locklessable && !(enqflags & CEF_DISCARD_DATA))
1195                 oscl->ols_flags |= LDLM_FL_DENY_ON_CONTENTION;
1196
1197         if (io->ci_type == CIT_WRITE || cl_io_is_mkwrite(io))
1198                 osc_lock_set_writer(env, io, obj, oscl);
1199
1200         LDLM_DEBUG_NOLOCK("lock %p, osc lock %p, flags %#llx",
1201                           lock, oscl, oscl->ols_flags);
1202
1203         return 0;
1204 }
1205
1206 /**
1207  * Finds an existing lock covering given index and optionally different from a
1208  * given \a except lock.
1209  */
1210 struct ldlm_lock *osc_obj_dlmlock_at_pgoff(const struct lu_env *env,
1211                                            struct osc_object *obj,
1212                                            pgoff_t index,
1213                                            enum osc_dap_flags dap_flags)
1214 {
1215         struct osc_thread_info *info = osc_env_info(env);
1216         struct ldlm_res_id *resname = &info->oti_resname;
1217         union ldlm_policy_data *policy  = &info->oti_policy;
1218         struct lustre_handle lockh;
1219         struct ldlm_lock *lock = NULL;
1220         enum ldlm_mode mode;
1221         __u64 flags;
1222
1223         ENTRY;
1224
1225         ostid_build_res_name(&obj->oo_oinfo->loi_oi, resname);
1226         osc_index2policy(policy, osc2cl(obj), index, index);
1227         policy->l_extent.gid = LDLM_GID_ANY;
1228
1229         flags = LDLM_FL_BLOCK_GRANTED | LDLM_FL_CBPENDING;
1230         if (dap_flags & OSC_DAP_FL_TEST_LOCK)
1231                 flags |= LDLM_FL_TEST_LOCK;
1232         /*
1233          * It is fine to match any group lock since there could be only one
1234          * with a uniq gid and it conflicts with all other lock modes too
1235          */
1236 again:
1237         mode = osc_match_base(osc_export(obj), resname, LDLM_EXTENT, policy,
1238                                LCK_PR | LCK_PW | LCK_GROUP, &flags, obj, &lockh,
1239                                dap_flags & OSC_DAP_FL_CANCELING);
1240         if (mode != 0) {
1241                 lock = ldlm_handle2lock(&lockh);
1242                 /* RACE: the lock is cancelled so let's try again */
1243                 if (unlikely(lock == NULL))
1244                         goto again;
1245         }
1246
1247         RETURN(lock);
1248 }
1249 /** @} osc */