lustre/lov/lov_object.c

   1 /* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
   2  * vim:expandtab:shiftwidth=8:tabstop=8:
   3  *
   4  * GPL HEADER START
   5  *
   6  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License version 2 only,
  10  * as published by the Free Software Foundation.
  11  *
  12  * This program is distributed in the hope that it will be useful, but
  13  * WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * General Public License version 2 for more details (a copy is included
  16  * in the LICENSE file that accompanied this code).
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * version 2 along with this program; If not, see
  20  * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
  21  *
  22  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
  23  * CA 95054 USA or visit www.sun.com if you need additional information or
  24  * have any questions.
  25  *
  26  * GPL HEADER END
  27  */
  28 /*
  29  * Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
  30  * Use is subject to license terms.
  31  */
  32 /*
  33  * This file is part of Lustre, http://www.lustre.org/
  34  * Lustre is a trademark of Sun Microsystems, Inc.
  35  *
  36  * Implementation of cl_object for LOV layer.
  37  *
  38  *   Author: Nikita Danilov <nikita.danilov@sun.com>
  39  */
  40
  41 #define DEBUG_SUBSYSTEM S_LOV
  42
  43 #include "lov_cl_internal.h"
  44
  45 /** \addtogroup lov
  46  *  @{
  47  */
  48
  49 /*****************************************************************************
  50  *
  51  * Layout operations.
  52  *
  53  */
  54
  55 struct lov_layout_operations {
  56         int (*llo_init)(const struct lu_env *env, struct lov_device *dev,
  57                         struct lov_object *lov,
  58                         const struct cl_object_conf *conf,
  59                         union lov_layout_state *state);
  60         void (*llo_delete)(const struct lu_env *env, struct lov_object *lov,
  61                            union lov_layout_state *state);
  62         void (*llo_fini)(const struct lu_env *env, struct lov_object *lov,
  63                          union lov_layout_state *state);
  64         void (*llo_install)(const struct lu_env *env, struct lov_object *lov,
  65                             union lov_layout_state *state);
  66         int  (*llo_print)(const struct lu_env *env, void *cookie,
  67                           lu_printer_t p, const struct lu_object *o);
  68         struct cl_page *(*llo_page_init)(const struct lu_env *env,
  69                                          struct cl_object *obj,
  70                                          struct cl_page *page,
  71                                          cfs_page_t *vmpage);
  72         int  (*llo_lock_init)(const struct lu_env *env,
  73                               struct cl_object *obj, struct cl_lock *lock,
  74                               const struct cl_io *io);
  75         int  (*llo_io_init)(const struct lu_env *env,
  76                             struct cl_object *obj, struct cl_io *io);
  77         int  (*llo_getattr)(const struct lu_env *env, struct cl_object *obj,
  78                             struct cl_attr *attr);
  79 };
  80
  81 /*****************************************************************************
  82  *
  83  * Lov object layout operations.
  84  *
  85  */
  86
  87 static void lov_install_empty(const struct lu_env *env,
  88                               struct lov_object *lov,
  89                               union  lov_layout_state *state)
  90 {
  91         /*
  92          * File without objects.
  93          */
  94 }
  95
  96 static int lov_init_empty(const struct lu_env *env,
  97                           struct lov_device *dev, struct lov_object *lov,
  98                           const struct cl_object_conf *conf,
  99                           union  lov_layout_state *state)
 100 {
 101         return 0;
 102 }
 103
 104 static void lov_install_raid0(const struct lu_env *env,
 105                               struct lov_object *lov,
 106                               union  lov_layout_state *state)
 107 {
 108         lov->u = *state;
 109 }
 110
 111 static void oinfo_get_fid(const struct lov_oinfo *oinfo, struct lu_fid *fid)
 112 {
 113         __u64 idx = oinfo->loi_id;
 114
 115         /* See idif definition in wiki:CMD3_interoperability_architecture */
 116
 117         LASSERT(oinfo->loi_gr < 1ULL << 16);
 118         LASSERT(oinfo->loi_id < 1ULL << 49);
 119         ENTRY;
 120
 121         /*
 122          * Now that the fid of stripe is not unique now, ost_idx have to
 123          * be used to make it unique. This is ok because the stripe fids
 124          * are just used in client side(to locate the objects). -jay
 125          */
 126         fid->f_seq = ((__u64)oinfo->loi_ost_idx) << 32 |
 127                      oinfo->loi_gr << 16 | idx >> 32;
 128         fid->f_oid = idx; /* truncated to 32 bits by assignment */
 129         fid->f_ver = 0;
 130         EXIT;
 131 }
 132
 133 static struct cl_object *lov_sub_find(const struct lu_env *env,
 134                                       struct cl_device *dev,
 135                                       const struct lu_fid *fid,
 136                                       const struct cl_object_conf *conf)
 137 {
 138         struct lu_object *o;
 139
 140         ENTRY;
 141         o = lu_object_find_at(env, cl2lu_dev(dev), fid, &conf->coc_lu);
 142         LASSERT(ergo(!IS_ERR(o), o->lo_dev->ld_type == &lovsub_device_type));
 143         RETURN(lu2cl(o));
 144 }
 145
 146 static int lov_init_sub(const struct lu_env *env, struct lov_object *lov,
 147                         struct cl_object *stripe,
 148                         struct lov_layout_raid0 *r0, int idx)
 149 {
 150         struct cl_object_header *hdr;
 151         struct cl_object_header *subhdr;
 152         struct cl_object_header *parent;
 153         struct lov_oinfo        *oinfo;
 154         int result;
 155
 156         hdr    = cl_object_header(lov2cl(lov));
 157         subhdr = cl_object_header(stripe);
 158         parent = subhdr->coh_parent;
 159
 160         oinfo = r0->lo_lsm->lsm_oinfo[idx];
 161         CDEBUG(D_INODE, DFID"@%p[%d] -> "DFID"@%p: id: "LPU64" gr: "LPU64
 162                " idx: %d gen: %d\n",
 163                PFID(&subhdr->coh_lu.loh_fid), subhdr, idx,
 164                PFID(&hdr->coh_lu.loh_fid), hdr,
 165                oinfo->loi_id, oinfo->loi_gr,
 166                oinfo->loi_ost_idx, oinfo->loi_ost_gen);
 167
 168         if (parent == NULL) {
 169                 subhdr->coh_parent = hdr;
 170                 subhdr->coh_nesting = hdr->coh_nesting + 1;
 171                 lu_object_ref_add(&stripe->co_lu, "lov-parent", lov);
 172                 r0->lo_sub[idx] = cl2lovsub(stripe);
 173                 r0->lo_sub[idx]->lso_super = lov;
 174                 r0->lo_sub[idx]->lso_index = idx;
 175                 result = 0;
 176         } else {
 177                 CERROR("Stripe is already owned by other file (%i).\n", idx);
 178                 LU_OBJECT_DEBUG(D_ERROR, env, &stripe->co_lu, "\n");
 179                 LU_OBJECT_DEBUG(D_ERROR, env, lu_object_top(&parent->coh_lu),
 180                                 "old\n");
 181                 LU_OBJECT_HEADER(D_ERROR, env, lov2lu(lov), "new\n");
 182                 cl_object_put(env, stripe);
 183                 result = -EIO;
 184         }
 185         return result;
 186 }
 187
 188 static int lov_init_raid0(const struct lu_env *env,
 189                           struct lov_device *dev, struct lov_object *lov,
 190                           const struct cl_object_conf *conf,
 191                           union  lov_layout_state *state)
 192 {
 193         int result;
 194         int i;
 195
 196         struct cl_object        *stripe;
 197         struct lov_thread_info  *lti     = lov_env_info(env);
 198         struct cl_object_conf   *subconf = &lti->lti_stripe_conf;
 199         struct lov_stripe_md    *lsm     = conf->u.coc_md->lsm;
 200         struct lu_fid           *ofid    = &lti->lti_fid;
 201         struct lov_layout_raid0 *r0      = &state->raid0;
 202
 203         ENTRY;
 204         r0->lo_nr  = conf->u.coc_md->lsm->lsm_stripe_count;
 205         r0->lo_lsm = conf->u.coc_md->lsm;
 206         LASSERT(r0->lo_nr <= lov_targets_nr(dev));
 207
 208         OBD_ALLOC(r0->lo_sub, r0->lo_nr * sizeof r0->lo_sub[0]);
 209         if (r0->lo_sub != NULL) {
 210                 result = 0;
 211                 subconf->coc_inode = conf->coc_inode;
 212                 /*
 213                  * Create stripe cl_objects.
 214                  */
 215                 for (i = 0; i < r0->lo_nr && result == 0; ++i) {
 216                         struct cl_device *subdev;
 217                         struct lov_oinfo *oinfo = lsm->lsm_oinfo[i];
 218                         int ost_idx = oinfo->loi_ost_idx;
 219
 220                         oinfo_get_fid(oinfo, ofid);
 221                         subdev = lovsub2cl_dev(dev->ld_target[ost_idx]);
 222                         subconf->u.coc_oinfo = oinfo;
 223                         LASSERTF(subdev != NULL, "not init ost %d\n", ost_idx);
 224                         stripe = lov_sub_find(env, subdev, ofid, subconf);
 225                         if (!IS_ERR(stripe))
 226                                 result = lov_init_sub(env, lov, stripe, r0, i);
 227                         else
 228                                 result = PTR_ERR(stripe);
 229                 }
 230         } else
 231                 result = -ENOMEM;
 232         RETURN(result);
 233 }
 234
 235 static void lov_delete_empty(const struct lu_env *env, struct lov_object *lov,
 236                              union lov_layout_state *state)
 237 {
 238         LASSERT(lov->lo_type == LLT_EMPTY);
 239 }
 240
 241 static void lov_subobject_kill(const struct lu_env *env, struct lov_object *lov,
 242                                struct lovsub_object *los, int idx)
 243 {
 244         struct cl_object        *sub;
 245         struct lov_layout_raid0 *r0;
 246         struct lu_site          *site;
 247         cfs_waitlink_t          *waiter;
 248
 249         r0  = &lov->u.raid0;
 250         LASSERT(r0->lo_sub[idx] == los);
 251
 252         sub  = lovsub2cl(los);
 253         site = sub->co_lu.lo_dev->ld_site;
 254
 255         cl_object_kill(env, sub);
 256         /* release a reference to the sub-object and ... */
 257         lu_object_ref_del(&sub->co_lu, "lov-parent", lov);
 258         cl_object_put(env, sub);
 259
 260         /* ... wait until it is actually destroyed---sub-object clears its
 261          * ->lo_sub[] slot in lovsub_object_fini() */
 262         if (r0->lo_sub[idx] == los) {
 263                 waiter = &lov_env_info(env)->lti_waiter;
 264                 cfs_waitlink_init(waiter);
 265                 cfs_waitq_add(&site->ls_marche_funebre, waiter);
 266                 set_current_state(CFS_TASK_UNINT);
 267
 268                 while (r0->lo_sub[idx] == los)
 269                         /* this wait-queue is signaled at the end of
 270                          * lu_object_free(). */
 271                         cfs_waitq_wait(waiter, CFS_TASK_UNINT);
 272                 cfs_waitq_del(&site->ls_marche_funebre, waiter);
 273         }
 274         LASSERT(r0->lo_sub[idx] == NULL);
 275 }
 276
 277 static void lov_delete_raid0(const struct lu_env *env, struct lov_object *lov,
 278                              union lov_layout_state *state)
 279 {
 280         struct lov_layout_raid0 *r0 = &state->raid0;
 281         int                      i;
 282
 283         ENTRY;
 284         if (r0->lo_sub != NULL) {
 285                 for (i = 0; i < r0->lo_nr; ++i) {
 286                         struct lovsub_object *los = r0->lo_sub[i];
 287
 288                         if (los != NULL)
 289                                 /*
 290                                  * If top-level object is to be evicted from
 291                                  * the cache, so are its sub-objects.
 292                                  */
 293                                 lov_subobject_kill(env, lov, los, i);
 294                 }
 295         }
 296         EXIT;
 297 }
 298
 299 static void lov_fini_empty(const struct lu_env *env, struct lov_object *lov,
 300                            union lov_layout_state *state)
 301 {
 302         LASSERT(lov->lo_type == LLT_EMPTY);
 303 }
 304
 305 static void lov_fini_raid0(const struct lu_env *env, struct lov_object *lov,
 306                            union lov_layout_state *state)
 307 {
 308         struct lov_layout_raid0 *r0 = &state->raid0;
 309
 310         ENTRY;
 311         if (r0->lo_sub != NULL) {
 312                 OBD_FREE(r0->lo_sub, r0->lo_nr * sizeof r0->lo_sub[0]);
 313                 r0->lo_sub = NULL;
 314         }
 315         EXIT;
 316 }
 317
 318 static int lov_print_empty(const struct lu_env *env, void *cookie,
 319                            lu_printer_t p, const struct lu_object *o)
 320 {
 321         (*p)(env, cookie, "empty\n");
 322         return 0;
 323 }
 324
 325 static int lov_print_raid0(const struct lu_env *env, void *cookie,
 326                            lu_printer_t p, const struct lu_object *o)
 327 {
 328         struct lov_object       *lov = lu2lov(o);
 329         struct lov_layout_raid0 *r0  = lov_r0(lov);
 330         int i;
 331
 332         (*p)(env, cookie, "stripes: %d:\n", r0->lo_nr);
 333         for (i = 0; i < r0->lo_nr; ++i) {
 334                 struct lu_object *sub;
 335
 336                 if (r0->lo_sub[i] != NULL) {
 337                         sub = lovsub2lu(r0->lo_sub[i]);
 338                         lu_object_print(env, cookie, p, sub);
 339                 } else
 340                         (*p)(env, cookie, "sub %d absent\n", i);
 341         }
 342         return 0;
 343 }
 344
 345 /**
 346  * Implements cl_object_operations::coo_attr_get() method for an object
 347  * without stripes (LLT_EMPTY layout type).
 348  *
 349  * The only attributes this layer is authoritative in this case is
 350  * cl_attr::cat_blocks---it's 0.
 351  */
 352 static int lov_attr_get_empty(const struct lu_env *env, struct cl_object *obj,
 353                               struct cl_attr *attr)
 354 {
 355         attr->cat_blocks = 0;
 356         return 0;
 357 }
 358
 359 static int lov_attr_get_raid0(const struct lu_env *env, struct cl_object *obj,
 360                               struct cl_attr *attr)
 361 {
 362         struct lov_object       *lov = cl2lov(obj);
 363         struct lov_layout_raid0 *r0 = lov_r0(lov);
 364         struct lov_stripe_md    *lsm = lov->u.raid0.lo_lsm;
 365         struct ost_lvb          *lvb = &lov_env_info(env)->lti_lvb;
 366         __u64                    kms;
 367         int                      result = 0;
 368
 369         ENTRY;
 370         if (!r0->lo_attr_valid) {
 371                 /*
 372                  * Fill LVB with attributes already initialized by the upper
 373                  * layer.
 374                  */
 375                 cl_attr2lvb(lvb, attr);
 376                 kms = attr->cat_kms;
 377
 378                 /*
 379                  * XXX that should be replaced with a loop over sub-objects,
 380                  * doing cl_object_attr_get() on them. But for now, let's
 381                  * reuse old lov code.
 382                  */
 383
 384                 /*
 385                  * XXX take lsm spin-lock to keep lov_merge_lvb_kms()
 386                  * happy. It's not needed, because new code uses
 387                  * ->coh_attr_guard spin-lock to protect consistency of
 388                  * sub-object attributes.
 389                  */
 390                 lov_stripe_lock(lsm);
 391                 result = lov_merge_lvb_kms(lsm, lvb, &kms);
 392                 lov_stripe_unlock(lsm);
 393                 if (result == 0) {
 394                         cl_lvb2attr(attr, lvb);
 395                         attr->cat_kms = kms;
 396                         r0->lo_attr_valid = 1;
 397                         r0->lo_attr = *attr;
 398                 }
 399         } else
 400                 *attr = r0->lo_attr;
 401         RETURN(result);
 402 }
 403
 404 const static struct lov_layout_operations lov_dispatch[] = {
 405         [LLT_EMPTY] = {
 406                 .llo_init      = lov_init_empty,
 407                 .llo_delete    = lov_delete_empty,
 408                 .llo_fini      = lov_fini_empty,
 409                 .llo_install   = lov_install_empty,
 410                 .llo_print     = lov_print_empty,
 411                 .llo_page_init = lov_page_init_empty,
 412                 .llo_lock_init = NULL,
 413                 .llo_io_init   = lov_io_init_empty,
 414                 .llo_getattr   = lov_attr_get_empty
 415         },
 416         [LLT_RAID0] = {
 417                 .llo_init      = lov_init_raid0,
 418                 .llo_delete    = lov_delete_raid0,
 419                 .llo_fini      = lov_fini_raid0,
 420                 .llo_install   = lov_install_raid0,
 421                 .llo_print     = lov_print_raid0,
 422                 .llo_page_init = lov_page_init_raid0,
 423                 .llo_lock_init = lov_lock_init_raid0,
 424                 .llo_io_init   = lov_io_init_raid0,
 425                 .llo_getattr   = lov_attr_get_raid0
 426         }
 427 };
 428
 429
 430 /**
 431  * Performs a double-dispatch based on the layout type of an object.
 432  */
 433 #define LOV_2DISPATCH_NOLOCK(obj, op, ...)                              \
 434 ({                                                                      \
 435         struct lov_object                      *__obj = (obj);          \
 436         enum lov_layout_type                    __llt;                  \
 437                                                                         \
 438         __llt = __obj->lo_type;                                         \
 439         LASSERT(0 <= __llt && __llt < ARRAY_SIZE(lov_dispatch));        \
 440         lov_dispatch[__llt].op(__VA_ARGS__);                            \
 441 })
 442
 443 #define LOV_2DISPATCH_MAYLOCK(obj, op, lock, ...)                       \
 444 ({                                                                      \
 445         struct lov_object                      *__obj = (obj);          \
 446         int                                     __lock = !!(lock);      \
 447         typeof(lov_dispatch[0].op(__VA_ARGS__)) __result;               \
 448                                                                         \
 449         __lock &= __obj->lo_owner != cfs_current();                     \
 450         if (__lock)                                                     \
 451                 down_read(&__obj->lo_type_guard);                       \
 452         __result = LOV_2DISPATCH_NOLOCK(obj, op, __VA_ARGS__);          \
 453         if (__lock)                                                     \
 454                 up_read(&__obj->lo_type_guard);                         \
 455         __result;                                                       \
 456 })
 457
 458 /**
 459  * Performs a locked double-dispatch based on the layout type of an object.
 460  */
 461 #define LOV_2DISPATCH(obj, op, ...)                     \
 462         LOV_2DISPATCH_MAYLOCK(obj, op, 1, __VA_ARGS__)
 463
 464 #define LOV_2DISPATCH_VOID(obj, op, ...)                                \
 465 do {                                                                    \
 466         struct lov_object                      *__obj = (obj);          \
 467         enum lov_layout_type                    __llt;                  \
 468                                                                         \
 469         if (__obj->lo_owner != cfs_current())                           \
 470                 down_read(&__obj->lo_type_guard);                       \
 471         __llt = __obj->lo_type;                                         \
 472         LASSERT(0 <= __llt && __llt < ARRAY_SIZE(lov_dispatch));        \
 473         lov_dispatch[__llt].op(__VA_ARGS__);                            \
 474         if (__obj->lo_owner != cfs_current())                           \
 475                 up_read(&__obj->lo_type_guard);                         \
 476 } while (0)
 477
 478 static int lov_layout_change(const struct lu_env *env,
 479                              struct lov_object *obj, enum lov_layout_type llt,
 480                              const struct cl_object_conf *conf)
 481 {
 482         int result;
 483         union lov_layout_state       *state = &lov_env_info(env)->lti_state;
 484         const struct lov_layout_operations *old_ops;
 485         const struct lov_layout_operations *new_ops;
 486
 487         LASSERT(0 <= obj->lo_type && obj->lo_type < ARRAY_SIZE(lov_dispatch));
 488         LASSERT(0 <= llt && llt < ARRAY_SIZE(lov_dispatch));
 489         ENTRY;
 490
 491         old_ops = &lov_dispatch[obj->lo_type];
 492         new_ops = &lov_dispatch[llt];
 493
 494         result = new_ops->llo_init(env, lu2lov_dev(obj->lo_cl.co_lu.lo_dev),
 495                                    obj, conf, state);
 496         if (result == 0) {
 497                 struct cl_object_header *hdr = cl_object_header(&obj->lo_cl);
 498                 void                    *cookie;
 499                 struct lu_env           *nested;
 500                 int                      refcheck;
 501
 502                 cookie = cl_env_reenter();
 503                 nested = cl_env_get(&refcheck);
 504                 if (!IS_ERR(nested))
 505                         cl_object_prune(nested, &obj->lo_cl);
 506                 else
 507                         result = PTR_ERR(nested);
 508                 cl_env_put(nested, &refcheck);
 509                 cl_env_reexit(cookie);
 510
 511                 old_ops->llo_fini(env, obj, &obj->u);
 512                 LASSERT(list_empty(&hdr->coh_locks));
 513                 LASSERT(hdr->coh_tree.rnode == NULL);
 514                 LASSERT(hdr->coh_pages == 0);
 515
 516                 new_ops->llo_install(env, obj, state);
 517                 obj->lo_type = llt;
 518         } else
 519                 new_ops->llo_fini(env, obj, state);
 520         RETURN(result);
 521 }
 522
 523 /*****************************************************************************
 524  *
 525  * Lov object operations.
 526  *
 527  */
 528
 529 int lov_object_init(const struct lu_env *env, struct lu_object *obj,
 530                     const struct lu_object_conf *conf)
 531 {
 532         struct lov_device            *dev   = lu2lov_dev(obj->lo_dev);
 533         struct lov_object            *lov   = lu2lov(obj);
 534         const struct cl_object_conf  *cconf = lu2cl_conf(conf);
 535         union  lov_layout_state      *set   = &lov_env_info(env)->lti_state;
 536         const struct lov_layout_operations *ops;
 537         int result;
 538
 539         ENTRY;
 540         init_rwsem(&lov->lo_type_guard);
 541
 542         /* no locking is necessary, as object is being created */
 543         lov->lo_type = cconf->u.coc_md->lsm != NULL ? LLT_RAID0 : LLT_EMPTY;
 544         ops = &lov_dispatch[lov->lo_type];
 545         result = ops->llo_init(env, dev, lov, cconf, set);
 546         if (result == 0)
 547                 ops->llo_install(env, lov, set);
 548         else
 549                 ops->llo_fini(env, lov, set);
 550         RETURN(result);
 551 }
 552
 553 static int lov_conf_set(const struct lu_env *env, struct cl_object *obj,
 554                         const struct cl_object_conf *conf)
 555 {
 556         struct lov_object *lov = cl2lov(obj);
 557         int result;
 558
 559         ENTRY;
 560         /*
 561          * Currently only LLT_EMPTY -> LLT_RAID0 transition is supported.
 562          */
 563         LASSERT(lov->lo_owner != cfs_current());
 564         down_write(&lov->lo_type_guard);
 565         LASSERT(lov->lo_owner == NULL);
 566         lov->lo_owner = cfs_current();
 567         if (lov->lo_type == LLT_EMPTY && conf->u.coc_md->lsm != NULL)
 568                 result = lov_layout_change(env, lov, LLT_RAID0, conf);
 569         else
 570                 result = -EOPNOTSUPP;
 571         lov->lo_owner = NULL;
 572         up_write(&lov->lo_type_guard);
 573         RETURN(result);
 574 }
 575
 576 static void lov_object_delete(const struct lu_env *env, struct lu_object *obj)
 577 {
 578         struct lov_object *lov = lu2lov(obj);
 579
 580         ENTRY;
 581         LOV_2DISPATCH_VOID(lov, llo_delete, env, lov, &lov->u);
 582         EXIT;
 583 }
 584
 585 static void lov_object_free(const struct lu_env *env, struct lu_object *obj)
 586 {
 587         struct lov_object *lov = lu2lov(obj);
 588
 589         ENTRY;
 590         LOV_2DISPATCH_VOID(lov, llo_fini, env, lov, &lov->u);
 591         lu_object_fini(obj);
 592         OBD_SLAB_FREE_PTR(lov, lov_object_kmem);
 593         EXIT;
 594 }
 595
 596 static int lov_object_print(const struct lu_env *env, void *cookie,
 597                             lu_printer_t p, const struct lu_object *o)
 598 {
 599         return LOV_2DISPATCH(lu2lov(o), llo_print, env, cookie, p, o);
 600 }
 601
 602 struct cl_page *lov_page_init(const struct lu_env *env, struct cl_object *obj,
 603                               struct cl_page *page, cfs_page_t *vmpage)
 604 {
 605         return LOV_2DISPATCH(cl2lov(obj),
 606                              llo_page_init, env, obj, page, vmpage);
 607 }
 608
 609 /**
 610  * Implements cl_object_operations::clo_io_init() method for lov
 611  * layer. Dispatches to the appropriate layout io initialization method.
 612  */
 613 int lov_io_init(const struct lu_env *env, struct cl_object *obj,
 614                 struct cl_io *io)
 615 {
 616         CL_IO_SLICE_CLEAN(lov_env_io(env), lis_cl);
 617         /*
 618          * Do not take lock in case of CIT_MISC io, because
 619          *
 620          *     - if this is an io for a glimpse, then we don't care;
 621          *
 622          *     - if this not a glimpse (writepage or lock cancellation), then
 623          *       layout change cannot happen because a page or a lock
 624          *       already exist; and
 625          *
 626          *     - lock ordering (lock mutex nests within layout rw-semaphore)
 627          *       is obeyed in case of lock cancellation.
 628          */
 629         return LOV_2DISPATCH_MAYLOCK(cl2lov(obj), llo_io_init,
 630                                      io->ci_type != CIT_MISC, env, obj, io);
 631 }
 632
 633 /**
 634  * An implementation of cl_object_operations::clo_attr_get() method for lov
 635  * layer. For raid0 layout this collects and merges attributes of all
 636  * sub-objects.
 637  */
 638 static int lov_attr_get(const struct lu_env *env, struct cl_object *obj,
 639                         struct cl_attr *attr)
 640 {
 641         /* do not take lock, as this function is called under a
 642          * spin-lock. Layout is protected from changing by ongoing IO. */
 643         return LOV_2DISPATCH_NOLOCK(cl2lov(obj), llo_getattr, env, obj, attr);
 644 }
 645
 646 static int lov_attr_set(const struct lu_env *env, struct cl_object *obj,
 647                         const struct cl_attr *attr, unsigned valid)
 648 {
 649         /*
 650          * No dispatch is required here, as no layout implements this.
 651          */
 652         return 0;
 653 }
 654
 655 int lov_lock_init(const struct lu_env *env, struct cl_object *obj,
 656                   struct cl_lock *lock, const struct cl_io *io)
 657 {
 658         return LOV_2DISPATCH(cl2lov(obj), llo_lock_init, env, obj, lock, io);
 659 }
 660
 661 static const struct cl_object_operations lov_ops = {
 662         .coo_page_init = lov_page_init,
 663         .coo_lock_init = lov_lock_init,
 664         .coo_io_init   = lov_io_init,
 665         .coo_attr_get  = lov_attr_get,
 666         .coo_attr_set  = lov_attr_set,
 667         .coo_conf_set  = lov_conf_set
 668 };
 669
 670 static const struct lu_object_operations lov_lu_obj_ops = {
 671         .loo_object_init      = lov_object_init,
 672         .loo_object_delete    = lov_object_delete,
 673         .loo_object_release   = NULL,
 674         .loo_object_free      = lov_object_free,
 675         .loo_object_print     = lov_object_print,
 676         .loo_object_invariant = NULL
 677 };
 678
 679 struct lu_object *lov_object_alloc(const struct lu_env *env,
 680                                    const struct lu_object_header *unused,
 681                                    struct lu_device *dev)
 682 {
 683         struct lov_object *lov;
 684         struct lu_object  *obj;
 685
 686         ENTRY;
 687         OBD_SLAB_ALLOC_PTR_GFP(lov, lov_object_kmem, CFS_ALLOC_IO);
 688         if (lov != NULL) {
 689                 obj = lov2lu(lov);
 690                 lu_object_init(obj, NULL, dev);
 691                 lov->lo_cl.co_ops = &lov_ops;
 692                 lov->lo_type = -1; /* invalid, to catch uninitialized type */
 693                 /*
 694                  * object io operation vector (cl_object::co_iop) is installed
 695                  * later in lov_object_init(), as different vectors are used
 696                  * for object with different layouts.
 697                  */
 698                 obj->lo_ops = &lov_lu_obj_ops;
 699         } else
 700                 obj = NULL;
 701         RETURN(obj);
 702 }
 703
 704 /** @} lov */