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