Whamcloud - gitweb
LU-8788 tests: modify create_pool to use as wrapper
[fs/lustre-release.git] / lustre / lov / lov_cl_internal.h
index af132b9..4edb452 100644 (file)
  *
  * You should have received a copy of the GNU General Public License
  * version 2 along with this program; If not, see
- * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
- *
- * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
- * CA 95054 USA or visit www.sun.com if you need additional information or
- * have any questions.
+ * http://www.gnu.org/licenses/gpl-2.0.html
  *
  * GPL HEADER END
  */
@@ -27,7 +23,7 @@
  * Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
  * Use is subject to license terms.
  *
- * Copyright (c) 2012, 2013, Intel Corporation.
+ * Copyright (c) 2012, 2016, Intel Corporation.
  */
 /*
  * This file is part of Lustre, http://www.lustre.org/
 #ifndef LOV_CL_INTERNAL_H
 #define LOV_CL_INTERNAL_H
 
-#ifdef __KERNEL__
-# include <libcfs/libcfs.h>
-#else
-# include <liblustre.h>
-#endif
-
+#include <libcfs/libcfs.h>
 #include <obd.h>
 #include <cl_object.h>
 #include "lov_internal.h"
  *     - top-page keeps a reference to its sub-page, and destroys it when it
  *       is destroyed.
  *
- *     - sub-lock keep a reference to its top-locks. Top-lock keeps a
- *       reference (and a hold, see cl_lock_hold()) on its sub-locks when it
- *       actively using them (that is, in cl_lock_state::CLS_QUEUING,
- *       cl_lock_state::CLS_ENQUEUED, cl_lock_state::CLS_HELD states). When
- *       moving into cl_lock_state::CLS_CACHED state, top-lock releases a
- *       hold. From this moment top-lock has only a 'weak' reference to its
- *       sub-locks. This reference is protected by top-lock
- *       cl_lock::cll_guard, and will be automatically cleared by the sub-lock
- *       when the latter is destroyed. When a sub-lock is canceled, a
- *       reference to it is removed from the top-lock array, and top-lock is
- *       moved into CLS_NEW state. It is guaranteed that all sub-locks exist
- *       while their top-lock is in CLS_HELD or CLS_CACHED states.
- *
  *     - IO's are not reference counted.
  *
  * To implement a connection between top and sub entities, lov layer is split
@@ -113,35 +91,6 @@ enum lov_device_flags {
  * Upper half.
  */
 
-/**
- * Resources that are used in memory-cleaning path, and whose allocation
- * cannot fail even when memory is tight. They are preallocated in sufficient
- * quantities in lov_device::ld_emerg[], and access to them is serialized
- * lov_device::ld_mutex.
- */
-struct lov_device_emerg {
-        /**
-         * Page list used to submit IO when memory is in pressure.
-         */
-        struct cl_page_list emrg_page_list;
-        /**
-         * sub-io's shared by all threads accessing this device when memory is
-         * too low to allocate sub-io's dynamically.
-         */
-        struct cl_io        emrg_subio;
-        /**
-         * Environments used by sub-io's in
-         * lov_device_emerg::emrg_subio.
-         */
-        struct lu_env      *emrg_env;
-        /**
-         * Refchecks for lov_device_emerg::emrg_env.
-         *
-         * \see cl_env_get()
-         */
-        int                 emrg_refcheck;
-};
-
 struct lov_device {
         /*
          * XXX Locking of lov-private data is missing.
@@ -152,14 +101,6 @@ struct lov_device {
         __u32                     ld_target_nr;
         struct lovsub_device    **ld_target;
         __u32                     ld_flags;
-
-        /** Emergency resources used in memory-cleansing paths. */
-        struct lov_device_emerg **ld_emrg;
-        /**
-         * Serializes access to lov_device::ld_emrg in low-memory
-         * conditions.
-         */
-       struct mutex              ld_mutex;
 };
 
 /**
@@ -226,7 +167,7 @@ struct lov_object {
         * How many IOs are on going on this object. Layout can be changed
         * only if there is no active IO.
         */
-       cfs_atomic_t           lo_active_ios;
+       atomic_t               lo_active_ios;
        /**
         * Waitq - wait for no one else is using lo_lsm
         */
@@ -260,6 +201,8 @@ struct lov_object {
                         * When top-object is destroyed (lov_delete_raid0())
                         * it releases its reference to a sub-object and waits
                         * until the latter is finally destroyed.
+                        *
+                        * May be vmalloc'd, must be freed with OBD_FREE_LARGE.
                         */
                        struct lovsub_object **lo_sub;
                        /**
@@ -285,92 +228,32 @@ struct lov_object {
 };
 
 /**
- * Flags that top-lock can set on each of its sub-locks.
- */
-enum lov_sub_flags {
-        /** Top-lock acquired a hold (cl_lock_hold()) on a sub-lock. */
-        LSF_HELD = 1 << 0
-};
-
-/**
  * State lov_lock keeps for each sub-lock.
  */
 struct lov_lock_sub {
-        /** sub-lock itself */
-        struct lovsub_lock  *sub_lock;
-        /** An array of per-sub-lock flags, taken from enum lov_sub_flags */
-        unsigned             sub_flags;
-        int                  sub_stripe;
-        struct cl_lock_descr sub_descr;
-        struct cl_lock_descr sub_got;
+       /** sub-lock itself */
+       struct cl_lock          sub_lock;
+       /** Set if the sublock has ever been enqueued, meaning it may
+        * hold resources of underlying layers */
+       unsigned int            sub_is_enqueued:1,
+                               sub_initialized:1;
+       int                     sub_stripe;
 };
 
 /**
  * lov-specific lock state.
  */
 struct lov_lock {
-        struct cl_lock_slice   lls_cl;
-        /** Number of sub-locks in this lock */
-        int                    lls_nr;
-        /**
-         * Number of existing sub-locks.
-         */
-        unsigned               lls_nr_filled;
-        /**
-         * Set when sub-lock was canceled, while top-lock was being
-         * used, or unused.
-         */
-       unsigned int           lls_cancel_race:1,
-                               lls_ever_canceled:1;
-        /**
-         * An array of sub-locks
-         *
-         * There are two issues with managing sub-locks:
-         *
-         *     - sub-locks are concurrently canceled, and
-         *
-         *     - sub-locks are shared with other top-locks.
-         *
-         * To manage cancellation, top-lock acquires a hold on a sublock
-         * (lov_sublock_adopt()) when the latter is inserted into
-         * lov_lock::lls_sub[]. This hold is released (lov_sublock_release())
-         * when top-lock is going into CLS_CACHED state or destroyed. Hold
-         * prevents sub-lock from cancellation.
-         *
-         * Sub-lock sharing means, among other things, that top-lock that is
-         * in the process of creation (i.e., not yet inserted into lock list)
-         * is already accessible to other threads once at least one of its
-         * sub-locks is created, see lov_lock_sub_init().
-         *
-         * Sub-lock can be in one of the following states:
-         *
-         *     - doesn't exist, lov_lock::lls_sub[]::sub_lock == NULL. Such
-         *       sub-lock was either never created (top-lock is in CLS_NEW
-         *       state), or it was created, then canceled, then destroyed
-         *       (lov_lock_unlink() cleared sub-lock pointer in the top-lock).
-         *
-         *     - sub-lock exists and is on
-         *       hold. (lov_lock::lls_sub[]::sub_flags & LSF_HELD). This is a
-         *       normal state of a sub-lock in CLS_HELD and CLS_CACHED states
-         *       of a top-lock.
-         *
-         *     - sub-lock exists, but is not held by the top-lock. This
-         *       happens after top-lock released a hold on sub-locks before
-         *       going into cache (lov_lock_unuse()).
-         *
-         * \todo To support wide-striping, array has to be replaced with a set
-         * of queues to avoid scanning.
-         */
-        struct lov_lock_sub   *lls_sub;
-        /**
-         * Original description with which lock was enqueued.
-         */
-        struct cl_lock_descr   lls_orig;
+       struct cl_lock_slice    lls_cl;
+       /** Number of sub-locks in this lock */
+       int                     lls_nr;
+       /** sublock array */
+       struct lov_lock_sub     lls_sub[0];
 };
 
 struct lov_page {
-        struct cl_page_slice lps_cl;
-        int                  lps_invalid;
+       struct cl_page_slice    lps_cl;
+       unsigned int            lps_stripe; /* stripe index */
 };
 
 /*
@@ -379,8 +262,6 @@ struct lov_page {
 
 struct lovsub_device {
         struct cl_device   acid_cl;
-        struct lov_device *acid_super;
-        int                acid_idx;
         struct cl_device  *acid_next;
 };
 
@@ -392,42 +273,10 @@ struct lovsub_object {
 };
 
 /**
- * A link between a top-lock and a sub-lock. Separate data-structure is
- * necessary, because top-locks and sub-locks are in M:N relationship.
- *
- * \todo This can be optimized for a (by far) most frequent case of a single
- * top-lock per sub-lock.
- */
-struct lov_lock_link {
-        struct lov_lock *lll_super;
-        /** An index within parent lock. */
-        int              lll_idx;
-        /**
-         * A linkage into per sub-lock list of all corresponding top-locks,
-         * hanging off lovsub_lock::lss_parents.
-         */
-        cfs_list_t       lll_list;
-};
-
-/**
  * Lock state at lovsub layer.
  */
 struct lovsub_lock {
         struct cl_lock_slice  lss_cl;
-        /**
-         * List of top-locks that have given sub-lock as their part. Protected
-         * by cl_lock::cll_guard mutex.
-         */
-        cfs_list_t            lss_parents;
-        /**
-         * Top-lock that initiated current operation on this sub-lock. This is
-         * only set during top-to-bottom lock operations like enqueue, and is
-         * used to optimize state change notification. Protected by
-         * cl_lock::cll_guard mutex.
-         *
-         * \see lovsub_lock_state_one().
-         */
-        struct cl_lock       *lss_active;
 };
 
 /**
@@ -436,7 +285,6 @@ struct lovsub_lock {
 struct lov_sublock_env {
         const struct lu_env *lse_env;
         struct cl_io        *lse_io;
-        struct lov_io_sub   *lse_sub;
 };
 
 struct lovsub_page {
@@ -447,54 +295,48 @@ struct lovsub_page {
 struct lov_thread_info {
        struct cl_object_conf   lti_stripe_conf;
        struct lu_fid           lti_fid;
-       struct cl_lock_descr    lti_ldescr;
        struct ost_lvb          lti_lvb;
        struct cl_2queue        lti_cl2q;
        struct cl_page_list     lti_plist;
-       struct cl_lock_closure  lti_closure;
        wait_queue_t            lti_waiter;
-       struct cl_attr          lti_attr;
 };
 
 /**
  * State that lov_io maintains for every sub-io.
  */
 struct lov_io_sub {
-        int                  sub_stripe;
-        /**
-         * sub-io for a stripe. Ideally sub-io's can be stopped and resumed
-         * independently, with lov acting as a scheduler to maximize overall
-         * throughput.
-         */
-        struct cl_io        *sub_io;
-        /**
-         * Linkage into a list (hanging off lov_io::lis_active) of all
-         * sub-io's active for the current IO iteration.
-         */
-        cfs_list_t           sub_linkage;
-        /**
-         * true, iff cl_io_init() was successfully executed against
-         * lov_io_sub::sub_io.
-         */
-        int                  sub_io_initialized;
-        /**
-         * True, iff lov_io_sub::sub_io and lov_io_sub::sub_env weren't
-         * allocated, but borrowed from a per-device emergency pool.
-         */
-        int                  sub_borrowed;
-        /**
-         * environment, in which sub-io executes.
-         */
-        struct lu_env *sub_env;
-        /**
-         * environment's refcheck.
-         *
-         * \see cl_env_get()
-         */
-        int                  sub_refcheck;
-        int                  sub_refcheck2;
-        int                  sub_reenter;
-        void                *sub_cookie;
+       __u16                   sub_stripe;
+       /**
+        * environment's refcheck.
+        *
+        * \see cl_env_get()
+        */
+       __u16                   sub_refcheck;
+       /**
+        * true, iff cl_io_init() was successfully executed against
+        * lov_io_sub::sub_io.
+        */
+       __u16                   sub_io_initialized:1,
+       /**
+        * True, iff lov_io_sub::sub_io and lov_io_sub::sub_env weren't
+        * allocated, but borrowed from a per-device emergency pool.
+        */
+                               sub_borrowed:1;
+       /**
+        * Linkage into a list (hanging off lov_io::lis_active) of all
+        * sub-io's active for the current IO iteration.
+        */
+       struct list_head        sub_linkage;
+       /**
+        * sub-io for a stripe. Ideally sub-io's can be stopped and resumed
+        * independently, with lov acting as a scheduler to maximize overall
+        * throughput.
+        */
+       struct cl_io            *sub_io;
+       /**
+        * environment, in which sub-io executes.
+        */
+       struct lu_env           *sub_env;
 };
 
 /**
@@ -522,32 +364,32 @@ struct lov_io {
          * starting position within a file, for the current io loop iteration
          * (stripe), used by ci_io_loop().
          */
-        obd_off            lis_pos;
-        /**
-         * end position with in a file, for the current stripe io. This is
-         * exclusive (i.e., next offset after last byte affected by io).
-         */
-        obd_off            lis_endpos;
+       loff_t                   lis_pos;
+       /**
+        * end position with in a file, for the current stripe io. This is
+        * exclusive (i.e., next offset after last byte affected by io).
+        */
+       loff_t                   lis_endpos;
 
-        int                lis_mem_frozen;
-        int                lis_stripe_count;
-        int                lis_active_subios;
+       int                     lis_stripe_count;
+       int                     lis_active_subios;
 
-        /**
-         * the index of ls_single_subio in ls_subios array
-         */
-        int                lis_single_subio_index;
-        struct cl_io       lis_single_subio;
+       /**
+        * the index of ls_single_subio in ls_subios array
+        */
+       int                     lis_single_subio_index;
+       struct cl_io            lis_single_subio;
 
-        /**
-         * size of ls_subios array, actually the highest stripe #
-         */
-        int                lis_nr_subios;
-        struct lov_io_sub *lis_subs;
-        /**
-         * List of active sub-io's.
-         */
-        cfs_list_t         lis_active;
+       /**
+        * size of ls_subios array, actually the highest stripe #
+        * May be vmalloc'd, must be freed with OBD_FREE_LARGE().
+        */
+       int                     lis_nr_subios;
+       struct lov_io_sub       *lis_subs;
+       /**
+        * List of active sub-io's.
+        */
+       struct list_head        lis_active;
 };
 
 struct lov_session {
@@ -555,20 +397,6 @@ struct lov_session {
         struct lov_sublock_env ls_subenv;
 };
 
-/**
- * State of transfer for lov.
- */
-struct lov_req {
-        struct cl_req_slice lr_cl;
-};
-
-/**
- * State of transfer for lovsub.
- */
-struct lovsub_req {
-        struct cl_req_slice lsrq_cl;
-};
-
 extern struct lu_device_type lov_device_type;
 extern struct lu_device_type lovsub_device_type;
 
@@ -579,13 +407,9 @@ extern struct kmem_cache *lov_lock_kmem;
 extern struct kmem_cache *lov_object_kmem;
 extern struct kmem_cache *lov_thread_kmem;
 extern struct kmem_cache *lov_session_kmem;
-extern struct kmem_cache *lov_req_kmem;
 
 extern struct kmem_cache *lovsub_lock_kmem;
 extern struct kmem_cache *lovsub_object_kmem;
-extern struct kmem_cache *lovsub_req_kmem;
-
-extern struct kmem_cache *lov_lock_link_kmem;
 
 int   lov_object_init     (const struct lu_env *env, struct lu_object *obj,
                            const struct lu_object_conf *conf);
@@ -608,16 +432,9 @@ int   lov_io_init_empty   (const struct lu_env *env, struct cl_object *obj,
                            struct cl_io *io);
 int   lov_io_init_released(const struct lu_env *env, struct cl_object *obj,
                            struct cl_io *io);
-void  lov_lock_unlink     (const struct lu_env *env, struct lov_lock_link *link,
-                           struct lovsub_lock *sub);
 
 struct lov_io_sub *lov_sub_get(const struct lu_env *env, struct lov_io *lio,
                                int stripe);
-void  lov_sub_put             (struct lov_io_sub *sub);
-int   lov_sublock_modify  (const struct lu_env *env, struct lov_lock *lov,
-                           struct lovsub_lock *sublock,
-                           const struct cl_lock_descr *d, int idx);
-
 
 int   lov_page_init       (const struct lu_env *env, struct cl_object *ob,
                           struct cl_page *page, pgoff_t index);
@@ -634,14 +451,8 @@ struct lu_object *lovsub_object_alloc(const struct lu_env *env,
                                       const struct lu_object_header *hdr,
                                       struct lu_device *dev);
 
-struct lov_lock_link *lov_lock_link_find(const struct lu_env *env,
-                                         struct lov_lock *lck,
-                                         struct lovsub_lock *sub);
-struct lov_io_sub    *lov_page_subio    (const struct lu_env *env,
-                                         struct lov_io *lio,
-                                         const struct cl_page_slice *slice);
-
 struct lov_stripe_md *lov_lsm_addref(struct lov_object *lov);
+int lov_page_stripe(const struct cl_page *page);
 
 #define lov_foreach_target(lov, var)                    \
         for (var = 0; var < lov_targets_nr(lov); ++var)
@@ -783,11 +594,6 @@ static inline struct lov_page *cl2lov_page(const struct cl_page_slice *slice)
         return container_of0(slice, struct lov_page, lps_cl);
 }
 
-static inline struct lov_req *cl2lov_req(const struct cl_req_slice *slice)
-{
-        return container_of0(slice, struct lov_req, lr_cl);
-}
-
 static inline struct lovsub_page *
 cl2lovsub_page(const struct cl_page_slice *slice)
 {
@@ -795,11 +601,6 @@ cl2lovsub_page(const struct cl_page_slice *slice)
         return container_of0(slice, struct lovsub_page, lsb_cl);
 }
 
-static inline struct lovsub_req *cl2lovsub_req(const struct cl_req_slice *slice)
-{
-        return container_of0(slice, struct lovsub_req, lsrq_cl);
-}
-
 static inline struct lov_io *cl2lov_io(const struct lu_env *env,
                                 const struct cl_io_slice *ios)
 {
@@ -827,12 +628,15 @@ static inline struct lov_thread_info *lov_env_info(const struct lu_env *env)
 static inline struct lov_layout_raid0 *lov_r0(struct lov_object *lov)
 {
        LASSERT(lov->lo_type == LLT_RAID0);
-       LASSERT(lov->lo_lsm->lsm_wire.lw_magic == LOV_MAGIC ||
-               lov->lo_lsm->lsm_wire.lw_magic == LOV_MAGIC_V3);
+       LASSERT(lov->lo_lsm->lsm_magic == LOV_MAGIC ||
+               lov->lo_lsm->lsm_magic == LOV_MAGIC_V3);
        return &lov->u.raid0;
 }
 
+/* lov_pack.c */
+int lov_getstripe(struct lov_object *obj, struct lov_stripe_md *lsm,
+                 struct lov_user_md __user *lump);
+
 /** @} lov */
 
 #endif
-