lustre/include/lustre_linkea.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, write to the
  18  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  19  * Boston, MA 021110-1307, USA
  20  *
  21  * GPL HEADER END
  22  */
  23 /*
  24  * Copyright (c) 2013, 2017, Intel Corporation.
  25  * Use is subject to license terms.
  26  *
  27  * Author: di wang <di.wang@intel.com>
  28  */
  29
  30 /* There are several reasons to restrict the linkEA size:
  31  *
  32  * 1. Under DNE mode, if we do not restrict the linkEA size, and if there
  33  *    are too many cross-MDTs hard links to the same object, then it will
  34  *    casue the llog overflow.
  35  *
  36  * 2. Some backend has limited size for EA. For example, if without large
  37  *    EA enabled, the ldiskfs will make all EAs to share one (4K) EA block.
  38  *
  39  * 3. Too many entries in linkEA will seriously affect linkEA performance
  40  *    because we only support to locate linkEA entry consecutively. */
  41 #define MAX_LINKEA_SIZE 4096
  42
  43 struct linkea_data {
  44         /**
  45          * Buffer to keep link EA body.
  46          */
  47         struct lu_buf           *ld_buf;
  48         /**
  49          * The matched header, entry and its lenght in the EA
  50          */
  51         struct link_ea_header   *ld_leh;
  52         struct link_ea_entry    *ld_lee;
  53         int                     ld_reclen;
  54 };
  55
  56 int linkea_data_new(struct linkea_data *ldata, struct lu_buf *buf);
  57 int linkea_init(struct linkea_data *ldata);
  58 int linkea_init_with_rec(struct linkea_data *ldata);
  59 void linkea_entry_unpack(const struct link_ea_entry *lee, int *reclen,
  60                          struct lu_name *lname, struct lu_fid *pfid);
  61 int linkea_entry_pack(struct link_ea_entry *lee, const struct lu_name *lname,
  62                       const struct lu_fid *pfid);
  63 bool linkea_will_overflow(struct linkea_data *ldata,
  64                           const struct lu_name *lname);
  65 int linkea_add_buf(struct linkea_data *ldata, const struct lu_name *lname,
  66                    const struct lu_fid *pfid, bool err_on_overflow);
  67 void linkea_del_buf(struct linkea_data *ldata, const struct lu_name *lname,
  68                     bool is_encrypted);
  69 int linkea_links_new(struct linkea_data *ldata, struct lu_buf *buf,
  70                      const struct lu_name *cname, const struct lu_fid *pfid);
  71 int linkea_overflow_shrink(struct linkea_data *ldata);
  72 int linkea_links_find(struct linkea_data *ldata, const struct lu_name *lname,
  73                       const struct lu_fid  *pfid);
  74
  75 static inline void linkea_first_entry(struct linkea_data *ldata)
  76 {
  77         LASSERT(ldata != NULL);
  78         LASSERT(ldata->ld_leh != NULL);
  79
  80         if (ldata->ld_leh->leh_reccount == 0)
  81                 ldata->ld_lee = NULL;
  82         else
  83                 ldata->ld_lee = (struct link_ea_entry *)(ldata->ld_leh + 1);
  84 }
  85
  86 static inline void linkea_next_entry(struct linkea_data *ldata)
  87 {
  88         LASSERT(ldata != NULL);
  89         LASSERT(ldata->ld_leh != NULL);
  90
  91         if (ldata->ld_lee != NULL) {
  92                 ldata->ld_lee = (struct link_ea_entry *)((char *)ldata->ld_lee +
  93                                                          ldata->ld_reclen);
  94                 if ((char *)ldata->ld_lee >= ((char *)ldata->ld_leh +
  95                                               ldata->ld_leh->leh_len))
  96                         ldata->ld_lee = NULL;
  97         }
  98 }