lustre/osd-ldiskfs/osd_oi.h

   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.sun.com/software/products/lustre/docs/GPLv2.pdf
  19  *
  20  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
  21  * CA 95054 USA or visit www.sun.com if you need additional information or
  22  * have any questions.
  23  *
  24  * GPL HEADER END
  25  */
  26 /*
  27  * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
  28  * Use is subject to license terms.
  29  *
  30  * Copyright (c) 2012, 2013, Intel Corporation.
  31  */
  32 /*
  33  * This file is part of Lustre, http://www.lustre.org/
  34  * Lustre is a trademark of Sun Microsystems, Inc.
  35  *
  36  * lustre/osd/osd_oi.h
  37  *
  38  * OSD Object Index
  39  *
  40  * Author: Nikita Danilov <nikita@clusterfs.com>
  41  */
  42
  43 /*
  44  * Object Index (oi) service runs in the bottom layer of server stack. In
  45  * translates fid local to this service to the storage cookie that uniquely
  46  * and efficiently identifies object (inode) of the underlying file system.
  47  */
  48
  49 #ifndef _OSD_OI_H
  50 #define _OSD_OI_H
  51
  52 #if defined(__KERNEL__)
  53
  54 /* struct rw_semaphore */
  55 #include <linux/rwsem.h>
  56 #include <lustre_fid.h>
  57 #include <lu_object.h>
  58 #include <md_object.h>
  59
  60 #define OSD_OI_FID_NR         (1UL << OSD_OI_FID_OID_BITS)
  61 #define OSD_OI_FID_NR_MAX     (1UL << OSD_OI_FID_OID_BITS_MAX)
  62
  63 #define OSD_OII_NOGEN (0)
  64
  65 struct lu_fid;
  66 struct osd_thread_info;
  67 struct lu_site;
  68 struct thandle;
  69
  70 struct dt_device;
  71 struct osd_device;
  72 struct osd_oi;
  73
  74 /*
  75  * Storage cookie. Datum uniquely identifying inode on the underlying file
  76  * system.
  77  *
  78  * osd_inode_id is the internal ldiskfs identifier for an object. It should
  79  * not be visible outside of the osd-ldiskfs. Other OSDs may have different
  80  * identifiers, so this cannot form any part of the OSD API.
  81  */
  82 struct osd_inode_id {
  83         __u32 oii_ino; /* inode number */
  84         __u32 oii_gen; /* inode generation */
  85 };
  86
  87 struct osd_idmap_cache {
  88         struct lu_fid           oic_fid;
  89         struct osd_inode_id     oic_lid;
  90         struct osd_device       *oic_dev;
  91 };
  92
  93 static inline void osd_id_pack(struct osd_inode_id *tgt,
  94                                const struct osd_inode_id *src)
  95 {
  96         tgt->oii_ino = cpu_to_be32(src->oii_ino);
  97         tgt->oii_gen = cpu_to_be32(src->oii_gen);
  98 }
  99
 100 static inline void osd_id_unpack(struct osd_inode_id *tgt,
 101                                  struct osd_inode_id *src)
 102 {
 103         tgt->oii_ino = be32_to_cpu(src->oii_ino);
 104         tgt->oii_gen = be32_to_cpu(src->oii_gen);
 105 }
 106
 107 static inline void osd_id_gen(struct osd_inode_id *id, __u32 ino, __u32 gen)
 108 {
 109         id->oii_ino = ino;
 110         id->oii_gen = gen;
 111 }
 112
 113 static inline void osd_id_to_inode(struct inode *inode,
 114                                    const struct osd_inode_id *id)
 115 {
 116         inode->i_ino        = id->oii_ino;
 117         inode->i_generation = id->oii_gen;
 118 }
 119
 120 static inline int osd_id_eq(const struct osd_inode_id *id0,
 121                             const struct osd_inode_id *id1)
 122 {
 123         return (id0->oii_ino == id1->oii_ino) &&
 124                (id0->oii_gen == id1->oii_gen ||
 125                 id0->oii_gen == OSD_OII_NOGEN ||
 126                 id1->oii_gen == OSD_OII_NOGEN);
 127 }
 128
 129 static inline int osd_id_eq_strict(const struct osd_inode_id *id0,
 130                                    const struct osd_inode_id *id1)
 131 {
 132         return (id0->oii_ino == id1->oii_ino && id0->oii_gen == id1->oii_gen);
 133 }
 134
 135 enum oi_check_flags {
 136         OI_CHECK_FLD    = 0x00000001,
 137         OI_KNOWN_ON_OST = 0x00000002,
 138 };
 139
 140 int osd_oi_mod_init(void);
 141 int osd_oi_init(struct osd_thread_info *info, struct osd_device *osd);
 142 void osd_oi_fini(struct osd_thread_info *info, struct osd_device *osd);
 143 int  osd_oi_lookup(struct osd_thread_info *info, struct osd_device *osd,
 144                    const struct lu_fid *fid, struct osd_inode_id *id,
 145                    enum oi_check_flags flags);
 146 int  osd_oi_insert(struct osd_thread_info *info, struct osd_device *osd,
 147                    const struct lu_fid *fid, const struct osd_inode_id *id,
 148                    struct thandle *th, enum oi_check_flags flags);
 149 int  osd_oi_delete(struct osd_thread_info *info,
 150                    struct osd_device *osd, const struct lu_fid *fid,
 151                    struct thandle *th, enum oi_check_flags flags);
 152 int  osd_oi_update(struct osd_thread_info *info, struct osd_device *osd,
 153                    const struct lu_fid *fid, const struct osd_inode_id *id,
 154                    struct thandle *th, enum oi_check_flags flags);
 155
 156 int fid_is_on_ost(struct osd_thread_info *info, struct osd_device *osd,
 157                   const struct lu_fid *fid, enum oi_check_flags flags);
 158 #endif /* __KERNEL__ */
 159 #endif /* _OSD_OI_H */