lustre/include/lustre_lite.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) 2011, 2012, 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
  37 #ifndef _LL_H
  38 #define _LL_H
  39
  40 /** \defgroup lite lite
  41  *
  42  * @{
  43  */
  44
  45 #if defined(__linux__)
  46 #include <linux/lustre_lite.h>
  47 #elif defined(__APPLE__)
  48 #include <darwin/lustre_lite.h>
  49 #elif defined(__WINNT__)
  50 #include <winnt/lustre_lite.h>
  51 #else
  52 #error Unsupported operating system.
  53 #endif
  54
  55 #include <obd_class.h>
  56 #include <obd_ost.h>
  57 #include <lustre_net.h>
  58 #include <lustre_mds.h>
  59 #include <lustre_ha.h>
  60
  61 /* 4UL * 1024 * 1024 */
  62 #define LL_MAX_BLKSIZE_BITS     (22)
  63 #define LL_MAX_BLKSIZE          (1UL<<LL_MAX_BLKSIZE_BITS)
  64
  65 #include <lustre/lustre_user.h>
  66
  67
  68 struct lustre_rw_params {
  69         int                lrp_lock_mode;
  70         ldlm_policy_data_t lrp_policy;
  71         obd_flag           lrp_brw_flags;
  72         int                lrp_ast_flags;
  73 };
  74
  75 /*
  76  * XXX nikita: this function lives in the header because it is used by both
  77  * llite kernel module and liblustre library, and there is no (?) better place
  78  * to put it in.
  79  */
  80 static inline void lustre_build_lock_params(int cmd, unsigned long open_flags,
  81                                             __u64 connect_flags,
  82                                             loff_t pos, ssize_t len,
  83                                             struct lustre_rw_params *params)
  84 {
  85         params->lrp_lock_mode = (cmd == OBD_BRW_READ) ? LCK_PR : LCK_PW;
  86         params->lrp_brw_flags = 0;
  87
  88         params->lrp_policy.l_extent.start = pos;
  89         params->lrp_policy.l_extent.end = pos + len - 1;
  90         /*
  91          * for now O_APPEND always takes local locks.
  92          */
  93         if (cmd == OBD_BRW_WRITE && (open_flags & O_APPEND)) {
  94                 params->lrp_policy.l_extent.start = 0;
  95                 params->lrp_policy.l_extent.end   = OBD_OBJECT_EOF;
  96         } else if (LIBLUSTRE_CLIENT && (connect_flags & OBD_CONNECT_SRVLOCK)) {
  97                 /*
  98                  * liblustre: OST-side locking for all non-O_APPEND
  99                  * reads/writes.
 100                  */
 101                 params->lrp_lock_mode = LCK_NL;
 102                 params->lrp_brw_flags = OBD_BRW_SRVLOCK;
 103         } else {
 104                 /*
 105                  * nothing special for the kernel. In the future llite may use
 106                  * OST-side locks for small writes into highly contended
 107                  * files.
 108                  */
 109         }
 110         params->lrp_ast_flags = (open_flags & O_NONBLOCK) ?
 111                 LDLM_FL_BLOCK_NOWAIT : 0;
 112 }
 113
 114 /*
 115  * This is embedded into liblustre and llite super-blocks to keep track of
 116  * connect flags (capabilities) supported by all imports given mount is
 117  * connected to.
 118  */
 119 struct lustre_client_ocd {
 120         /*
 121          * This is conjunction of connect_flags across all imports (LOVs) this
 122          * mount is connected to. This field is updated by cl_ocd_update()
 123          * under ->lco_lock.
 124          */
 125         __u64              lco_flags;
 126         struct mutex       lco_lock;
 127         struct obd_export *lco_md_exp;
 128         struct obd_export *lco_dt_exp;
 129 };
 130
 131 /*
 132  * Chain of hash overflow pages.
 133  */
 134 struct ll_dir_chain {
 135         /* XXX something. Later */
 136 };
 137
 138 static inline void ll_dir_chain_init(struct ll_dir_chain *chain)
 139 {
 140 }
 141
 142 static inline void ll_dir_chain_fini(struct ll_dir_chain *chain)
 143 {
 144 }
 145
 146 static inline unsigned long hash_x_index(__u64 hash, int hash64)
 147 {
 148 #ifdef __KERNEL__
 149         if (BITS_PER_LONG == 32 && hash64)
 150                 hash >>= 32;
 151 #endif
 152         /* save hash 0 as index 0 because otherwise we'll save it at
 153          * page index end (~0UL) and it causes truncate_inode_pages_range()
 154          * to loop forever.
 155          */
 156         return ~0UL - (hash + !hash);
 157 }
 158
 159 /** @} lite */
 160
 161 #endif