lustre/lov/lov_internal.h

   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 [sun.com URL with a
  20  * copy of GPLv2].
  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
  37 #ifndef LOV_INTERNAL_H
  38 #define LOV_INTERNAL_H
  39
  40 #include <lustre/lustre_user.h>
  41
  42 struct lov_lock_handles {
  43         struct portals_handle   llh_handle;
  44         atomic_t                llh_refcount;
  45         int                     llh_stripe_count;
  46         struct lustre_handle    llh_handles[0];
  47 };
  48
  49 struct lov_request {
  50         struct obd_info          rq_oi;
  51         struct lov_request_set  *rq_rqset;
  52
  53         struct list_head         rq_link;
  54
  55         int                      rq_idx;        /* index in lov->tgts array */
  56         int                      rq_stripe;     /* stripe number */
  57         int                      rq_complete;
  58         int                      rq_rc;
  59         int                      rq_buflen;     /* length of sub_md */
  60
  61         obd_count                rq_oabufs;
  62         obd_count                rq_pgaidx;
  63 };
  64
  65 struct lov_request_set {
  66         struct ldlm_enqueue_info*set_ei;
  67         struct obd_info         *set_oi;
  68         atomic_t                 set_refcount;
  69         struct obd_export       *set_exp;
  70         /* XXX: There is @set_exp already, however obd_statfs gets obd_device
  71            only. */
  72         struct obd_device       *set_obd;
  73         int                      set_count;
  74         int                      set_completes;
  75         int                      set_success;
  76         struct llog_cookie      *set_cookies;
  77         int                      set_cookie_sent;
  78         struct obd_trans_info   *set_oti;
  79         obd_count                set_oabufs;
  80         struct brw_page         *set_pga;
  81         struct lov_lock_handles *set_lockh;
  82         struct list_head         set_list;
  83 };
  84
  85 #define LOV_AP_MAGIC 8200
  86
  87 struct lov_async_page {
  88         int                             lap_magic;
  89         int                             lap_stripe;
  90         obd_off                         lap_sub_offset;
  91         obd_id                          lap_loi_id;
  92         obd_gr                          lap_loi_gr;
  93         void                            *lap_sub_cookie;
  94         struct obd_async_page_ops       *lap_caller_ops;
  95         void                            *lap_caller_data;
  96 };
  97
  98 #define LAP_FROM_COOKIE(c)                                                     \
  99         (LASSERT(((struct lov_async_page *)(c))->lap_magic == LOV_AP_MAGIC),   \
 100          (struct lov_async_page *)(c))
 101
 102 extern cfs_mem_cache_t *lov_oinfo_slab;
 103
 104 static inline void lov_llh_addref(void *llhp)
 105 {
 106         struct lov_lock_handles *llh = llhp;
 107         atomic_inc(&llh->llh_refcount);
 108         CDEBUG(D_INFO, "GETting llh %p : new refcount %d\n", llh,
 109                atomic_read(&llh->llh_refcount));
 110 }
 111
 112 static inline struct lov_lock_handles *lov_llh_new(struct lov_stripe_md *lsm)
 113 {
 114         struct lov_lock_handles *llh;
 115
 116         OBD_ALLOC(llh, sizeof *llh +
 117                   sizeof(*llh->llh_handles) * lsm->lsm_stripe_count);
 118         if (llh == NULL)
 119                 return NULL;
 120         atomic_set(&llh->llh_refcount, 2);
 121         llh->llh_stripe_count = lsm->lsm_stripe_count;
 122         CFS_INIT_LIST_HEAD(&llh->llh_handle.h_link);
 123         class_handle_hash(&llh->llh_handle, lov_llh_addref);
 124         return llh;
 125 }
 126
 127 static inline struct lov_lock_handles *
 128 lov_handle2llh(struct lustre_handle *handle)
 129 {
 130         LASSERT(handle != NULL);
 131         return(class_handle2object(handle->cookie));
 132 }
 133
 134 static inline void lov_llh_put(struct lov_lock_handles *llh)
 135 {
 136         CDEBUG(D_INFO, "PUTting llh %p : new refcount %d\n", llh,
 137                atomic_read(&llh->llh_refcount) - 1);
 138         LASSERT(atomic_read(&llh->llh_refcount) > 0 &&
 139                 atomic_read(&llh->llh_refcount) < 0x5a5a);
 140         if (atomic_dec_and_test(&llh->llh_refcount)) {
 141                 class_handle_unhash(&llh->llh_handle);
 142                 /* The structure may be held by other threads because RCU.
 143                  *   -jxiong */
 144                 if (atomic_read(&llh->llh_refcount))
 145                         return;
 146
 147                 OBD_FREE_RCU(llh, sizeof *llh +
 148                              sizeof(*llh->llh_handles) * llh->llh_stripe_count,
 149                              &llh->llh_handle);
 150         }
 151 }
 152
 153 #define lov_uuid2str(lv, index) \
 154         (char *)((lv)->lov_tgts[index]->ltd_uuid.uuid)
 155
 156 /* lov_merge.c */
 157 void lov_merge_attrs(struct obdo *tgt, struct obdo *src, obd_flag valid,
 158                      struct lov_stripe_md *lsm, int stripeno, int *set);
 159 int lov_merge_lvb(struct obd_export *exp, struct lov_stripe_md *lsm,
 160                   struct ost_lvb *lvb, int kms_only);
 161 int lov_adjust_kms(struct obd_export *exp, struct lov_stripe_md *lsm,
 162                    obd_off size, int shrink);
 163
 164 /* lov_offset.c */
 165 obd_size lov_stripe_size(struct lov_stripe_md *lsm, obd_size ost_size,
 166                          int stripeno);
 167 int lov_stripe_offset(struct lov_stripe_md *lsm, obd_off lov_off,
 168                       int stripeno, obd_off *obd_off);
 169 obd_off lov_size_to_stripe(struct lov_stripe_md *lsm, obd_off file_size,
 170                            int stripeno);
 171 int lov_stripe_intersects(struct lov_stripe_md *lsm, int stripeno,
 172                           obd_off start, obd_off end,
 173                           obd_off *obd_start, obd_off *obd_end);
 174 int lov_stripe_number(struct lov_stripe_md *lsm, obd_off lov_off);
 175
 176 /* lov_qos.c */
 177 #define LOV_USES_ASSIGNED_STRIPE        0
 178 #define LOV_USES_DEFAULT_STRIPE         1
 179 int qos_add_tgt(struct obd_device *obd, __u32 index);
 180 int qos_del_tgt(struct obd_device *obd, __u32 index);
 181 void qos_shrink_lsm(struct lov_request_set *set);
 182 int qos_prep_create(struct obd_export *exp, struct lov_request_set *set);
 183 void qos_update(struct lov_obd *lov);
 184 int qos_remedy_create(struct lov_request_set *set, struct lov_request *req);
 185
 186 /* lov_request.c */
 187 void lov_set_add_req(struct lov_request *req, struct lov_request_set *set);
 188 void lov_update_set(struct lov_request_set *set,
 189                     struct lov_request *req, int rc);
 190 int lov_update_common_set(struct lov_request_set *set,
 191                           struct lov_request *req, int rc);
 192 int lov_prep_create_set(struct obd_export *exp, struct obd_info *oifo,
 193                         struct lov_stripe_md **ea, struct obdo *src_oa,
 194                         struct obd_trans_info *oti,
 195                         struct lov_request_set **reqset);
 196 int lov_update_create_set(struct lov_request_set *set,
 197                           struct lov_request *req, int rc);
 198 int lov_fini_create_set(struct lov_request_set *set, struct lov_stripe_md **ea);
 199 int lov_prep_brw_set(struct obd_export *exp, struct obd_info *oinfo,
 200                      obd_count oa_bufs, struct brw_page *pga,
 201                      struct obd_trans_info *oti,
 202                      struct lov_request_set **reqset);
 203 int lov_fini_brw_set(struct lov_request_set *set);
 204 int lov_prep_getattr_set(struct obd_export *exp, struct obd_info *oinfo,
 205                          struct lov_request_set **reqset);
 206 int lov_fini_getattr_set(struct lov_request_set *set);
 207 int lov_prep_destroy_set(struct obd_export *exp, struct obd_info *oinfo,
 208                          struct obdo *src_oa, struct lov_stripe_md *lsm,
 209                          struct obd_trans_info *oti,
 210                          struct lov_request_set **reqset);
 211 int lov_update_destroy_set(struct lov_request_set *set,
 212                            struct lov_request *req, int rc);
 213 int lov_fini_destroy_set(struct lov_request_set *set);
 214 int lov_prep_setattr_set(struct obd_export *exp, struct obd_info *oinfo,
 215                          struct obd_trans_info *oti,
 216                          struct lov_request_set **reqset);
 217 int lov_update_setattr_set(struct lov_request_set *set,
 218                            struct lov_request *req, int rc);
 219 int lov_fini_setattr_set(struct lov_request_set *set);
 220 int lov_prep_punch_set(struct obd_export *exp, struct obd_info *oinfo,
 221                        struct obd_trans_info *oti,
 222                        struct lov_request_set **reqset);
 223 int lov_fini_punch_set(struct lov_request_set *set);
 224 int lov_prep_sync_set(struct obd_export *exp, struct obd_info *obd_info,
 225                       struct obdo *src_oa,
 226                       struct lov_stripe_md *lsm, obd_off start,
 227                       obd_off end, struct lov_request_set **reqset);
 228 int lov_fini_sync_set(struct lov_request_set *set);
 229 int lov_prep_enqueue_set(struct obd_export *exp, struct obd_info *oinfo,
 230                          struct ldlm_enqueue_info *einfo,
 231                          struct lov_request_set **reqset);
 232 int lov_fini_enqueue_set(struct lov_request_set *set, __u32 mode, int rc,
 233                          struct ptlrpc_request_set *rqset);
 234 int lov_prep_match_set(struct obd_export *exp, struct obd_info *oinfo,
 235                        struct lov_stripe_md *lsm,
 236                        ldlm_policy_data_t *policy, __u32 mode,
 237                        struct lustre_handle *lockh,
 238                        struct lov_request_set **reqset);
 239 int lov_update_match_set(struct lov_request_set *set, struct lov_request *req,
 240                          int rc);
 241 int lov_fini_match_set(struct lov_request_set *set, __u32 mode, int flags);
 242 int lov_prep_cancel_set(struct obd_export *exp, struct obd_info *oinfo,
 243                         struct lov_stripe_md *lsm,
 244                         __u32 mode, struct lustre_handle *lockh,
 245                         struct lov_request_set **reqset);
 246 int lov_fini_cancel_set(struct lov_request_set *set);
 247 int lov_prep_statfs_set(struct obd_device *obd, struct obd_info *oinfo,
 248                         struct lov_request_set **reqset);
 249 void lov_update_statfs(struct obd_device *obd, struct obd_statfs *osfs,
 250                        struct obd_statfs *lov_sfs, int success);
 251 int lov_fini_statfs(struct obd_device *obd, struct obd_statfs *osfs,
 252                     int success);
 253 int lov_fini_statfs_set(struct lov_request_set *set);
 254
 255 /* lov_obd.c */
 256 void lov_fix_desc(struct lov_desc *desc);
 257 void lov_fix_desc_stripe_size(__u64 *val);
 258 void lov_fix_desc_stripe_count(__u32 *val);
 259 void lov_fix_desc_pattern(__u32 *val);
 260 void lov_fix_desc_qos_maxage(__u32 *val);
 261 int lov_get_stripecnt(struct lov_obd *lov, __u32 stripe_count);
 262 void lov_getref(struct obd_device *obd);
 263 void lov_putref(struct obd_device *obd);
 264
 265 /* lov_log.c */
 266 int lov_llog_init(struct obd_device *obd, struct obd_llog_group *olg,
 267                   struct obd_device *tgt, int count, struct llog_catid *logid,
 268                   struct obd_uuid *uuid);
 269 int lov_llog_finish(struct obd_device *obd, int count);
 270
 271 /* lov_pack.c */
 272 int lov_packmd(struct obd_export *exp, struct lov_mds_md **lmm,
 273                struct lov_stripe_md *lsm);
 274 int lov_unpackmd(struct obd_export *exp, struct lov_stripe_md **lsmp,
 275                  struct lov_mds_md *lmm, int lmm_bytes);
 276 int lov_setstripe(struct obd_export *exp,
 277                   struct lov_stripe_md **lsmp, struct lov_user_md *lump);
 278 int lov_setea(struct obd_export *exp, struct lov_stripe_md **lsmp,
 279               struct lov_user_md *lump);
 280 int lov_getstripe(struct obd_export *exp,
 281                   struct lov_stripe_md *lsm, struct lov_user_md *lump);
 282 int lov_alloc_memmd(struct lov_stripe_md **lsmp, int stripe_count,
 283                       int pattern, int magic);
 284 void lov_free_memmd(struct lov_stripe_md **lsmp);
 285
 286 void lov_dump_lmm_v1(int level, struct lov_mds_md_v1 *lmm);
 287 void lov_dump_lmm_join(int level, struct lov_mds_md_join *lmmj);
 288 /* lov_ea.c */
 289 int lov_unpackmd_join(struct lov_obd *lov, struct lov_stripe_md *lsm,
 290                       struct lov_mds_md *lmm);
 291 struct lov_stripe_md *lsm_alloc_plain(int stripe_count, int *size);
 292 void lsm_free_plain(struct lov_stripe_md *lsm);
 293
 294 struct lov_extent *lovea_idx2le(struct lov_stripe_md *lsm, int stripe_no);
 295 struct lov_extent *lovea_off2le(struct lov_stripe_md *lsm, obd_off lov_off);
 296 int lovea_destroy_object(struct lov_obd *lov, struct lov_stripe_md *lsm,
 297                          struct obdo *oa, void *data);
 298 /* lproc_lov.c */
 299 extern struct file_operations lov_proc_target_fops;
 300 #ifdef LPROCFS
 301 void lprocfs_lov_init_vars(struct lprocfs_static_vars *lvars);
 302 #else
 303 static inline void lprocfs_lov_init_vars(struct lprocfs_static_vars *lvars)
 304 {
 305         memset(lvars, 0, sizeof(*lvars));
 306 }
 307 #endif
 308
 309 #endif