Whamcloud - gitweb
LU-3285 lvbo: pass lock as parameter to lvbo_update()
[fs/lustre-release.git] / lustre / include / lustre_dlm.h
index 57c3c15..2d0952e 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) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
  * Use is subject to license terms.
  *
- * Copyright (c) 2010, 2014, Intel Corporation.
+ * Copyright (c) 2010, 2016, Intel Corporation.
  */
 /*
  * This file is part of Lustre, http://www.lustre.org/
 struct obd_ops;
 struct obd_device;
 
+extern struct kset *ldlm_ns_kset;
+extern struct kset *ldlm_svc_kset;
+
 #define OBD_LDLM_DEVICENAME  "ldlm"
 
 #define LDLM_DEFAULT_LRU_SIZE (100 * num_online_cpus())
-#define LDLM_DEFAULT_MAX_ALIVE (cfs_time_seconds(3900)) /* 65 min */
+#define LDLM_DEFAULT_MAX_ALIVE         3900    /* 3900 seconds ~65 min */
 #define LDLM_CTIME_AGE_LIMIT (10)
 #define LDLM_DEFAULT_PARALLEL_AST_LIMIT 1024
 
 /**
  * LDLM non-error return states
  */
-typedef enum {
-        ELDLM_OK = 0,
-       ELDLM_LOCK_MATCHED = 1,
-
-        ELDLM_LOCK_CHANGED = 300,
-        ELDLM_LOCK_ABORTED = 301,
-        ELDLM_LOCK_REPLACED = 302,
-        ELDLM_NO_LOCK_DATA = 303,
-        ELDLM_LOCK_WOULDBLOCK = 304,
-
-        ELDLM_NAMESPACE_EXISTS = 400,
-        ELDLM_BAD_NAMESPACE    = 401
-} ldlm_error_t;
+enum ldlm_error {
+       ELDLM_OK                = 0,
+       ELDLM_LOCK_MATCHED      = 1,
+
+       ELDLM_LOCK_CHANGED      = 300,
+       ELDLM_LOCK_ABORTED      = 301,
+       ELDLM_LOCK_REPLACED     = 302,
+       ELDLM_NO_LOCK_DATA      = 303,
+       ELDLM_LOCK_WOULDBLOCK   = 304,
+
+       ELDLM_NAMESPACE_EXISTS  = 400,
+       ELDLM_BAD_NAMESPACE     = 401,
+};
 
 /**
  * LDLM namespace type.
@@ -91,10 +90,10 @@ typedef enum {
  * decisions about lack of conflicts or do any autonomous lock granting without
  * first speaking to a server.
  */
-typedef enum {
-        LDLM_NAMESPACE_SERVER = 1 << 0,
-        LDLM_NAMESPACE_CLIENT = 1 << 1
-} ldlm_side_t;
+enum ldlm_side {
+       LDLM_NAMESPACE_SERVER = 0x01,
+       LDLM_NAMESPACE_CLIENT = 0x02
+};
 
 /**
  * The blocking callback is overloaded to perform two functions.  These flags
@@ -147,16 +146,17 @@ typedef enum {
 #define LCK_COMPAT_COS (LCK_COS)
 /** @} Lock Compatibility Matrix */
 
-extern ldlm_mode_t lck_compat_array[];
+extern enum ldlm_mode lck_compat_array[];
 
-static inline void lockmode_verify(ldlm_mode_t mode)
+static inline void lockmode_verify(enum ldlm_mode mode)
 {
-       LASSERT(mode > LCK_MINMODE && mode < LCK_MAXMODE);
+       LASSERT(mode > LCK_MINMODE && mode < LCK_MAXMODE);
 }
 
-static inline int lockmode_compat(ldlm_mode_t exist_mode, ldlm_mode_t new_mode)
+static inline int lockmode_compat(enum ldlm_mode exist_mode,
+                                 enum ldlm_mode new_mode)
 {
-       return (lck_compat_array[exist_mode] & new_mode);
+       return lck_compat_array[exist_mode] & new_mode;
 }
 
 /*
@@ -254,20 +254,24 @@ struct ldlm_pool {
         *  server_slv * lock_volume_factor. */
        atomic_t                pl_lock_volume_factor;
        /** Time when last SLV from server was obtained. */
-       time_t                  pl_recalc_time;
+       time64_t                pl_recalc_time;
        /** Recalculation period for pool. */
-       time_t                  pl_recalc_period;
+       time64_t                pl_recalc_period;
        /** Recalculation and shrink operations. */
        struct ldlm_pool_ops    *pl_ops;
        /** Number of planned locks for next period. */
        int                     pl_grant_plan;
        /** Pool statistics. */
        struct lprocfs_stats    *pl_stats;
+
+       /* sysfs object */
+       struct kobject           pl_kobj;
+       struct completion        pl_kobj_unregister;
 };
 
 typedef int (*ldlm_res_policy)(struct ldlm_namespace *, struct ldlm_lock **,
-                              void *req_cookie, ldlm_mode_t mode, __u64 flags,
-                              void *data);
+                              void *req_cookie, enum ldlm_mode mode,
+                              __u64 flags, void *data);
 
 typedef int (*ldlm_cancel_cbt)(struct ldlm_lock *lock);
 
@@ -285,11 +289,10 @@ typedef int (*ldlm_cancel_cbt)(struct ldlm_lock *lock);
  * of ldlm_[res_]lvbo_[init,update,fill]() functions.
  */
 struct ldlm_valblock_ops {
-        int (*lvbo_init)(struct ldlm_resource *res);
-        int (*lvbo_update)(struct ldlm_resource *res,
-                           struct ptlrpc_request *r,
-                           int increase);
-        int (*lvbo_free)(struct ldlm_resource *res);
+       int (*lvbo_init)(struct ldlm_resource *res);
+       int (*lvbo_update)(struct ldlm_resource *res, struct ldlm_lock *lock,
+                          struct ptlrpc_request *r,  int increase);
+       int (*lvbo_free)(struct ldlm_resource *res);
        /* Return size of lvb data appropriate RPC size can be reserved */
        int (*lvbo_size)(struct ldlm_lock *lock);
        /* Called to fill in lvb data to RPC buffer @buf */
@@ -300,10 +303,10 @@ struct ldlm_valblock_ops {
  * LDLM pools related, type of lock pool in the namespace.
  * Greedy means release cached locks aggressively
  */
-typedef enum {
+enum ldlm_appetite {
        LDLM_NAMESPACE_GREEDY = 1 << 0,
        LDLM_NAMESPACE_MODEST = 1 << 1
-} ldlm_appetite_t;
+};
 
 /**
  * Default values for the "max_nolock_size", "contention_time" and
@@ -330,26 +333,19 @@ struct ldlm_ns_bucket {
 
 enum {
        /** LDLM namespace lock stats */
-        LDLM_NSS_LOCKS          = 0,
-        LDLM_NSS_LAST
+       LDLM_NSS_LOCKS          = 0,
+       LDLM_NSS_LAST
 };
 
-typedef enum {
-        /** invalide type */
-        LDLM_NS_TYPE_UNKNOWN    = 0,
-        /** mdc namespace */
-        LDLM_NS_TYPE_MDC,
-        /** mds namespace */
-        LDLM_NS_TYPE_MDT,
-        /** osc namespace */
-        LDLM_NS_TYPE_OSC,
-        /** ost namespace */
-        LDLM_NS_TYPE_OST,
-        /** mgc namespace */
-        LDLM_NS_TYPE_MGC,
-        /** mgs namespace */
-        LDLM_NS_TYPE_MGT,
-} ldlm_ns_type_t;
+enum ldlm_ns_type {
+       LDLM_NS_TYPE_UNKNOWN = 0,       /**< invalid type */
+       LDLM_NS_TYPE_MDC,               /**< MDC namespace */
+       LDLM_NS_TYPE_MDT,               /**< MDT namespace */
+       LDLM_NS_TYPE_OSC,               /**< OSC namespace */
+       LDLM_NS_TYPE_OST,               /**< OST namespace */
+       LDLM_NS_TYPE_MGC,               /**< MGC namespace */
+       LDLM_NS_TYPE_MGT,               /**< MGT namespace */
+};
 
 /**
  * LDLM Namespace.
@@ -377,7 +373,7 @@ struct ldlm_namespace {
        struct obd_device       *ns_obd;
 
        /** Flag indicating if namespace is on client instead of server */
-       ldlm_side_t             ns_client;
+       enum ldlm_side          ns_client;
 
        /** Resource hash table for namespace. */
        struct cfs_hash         *ns_rs_hash;
@@ -426,8 +422,10 @@ struct ldlm_namespace {
         * controlled by available memory on this client and on server.
         */
        unsigned int            ns_max_unused;
+
        /** Maximum allowed age (last used time) for locks in the LRU */
-       unsigned int            ns_max_age;
+       ktime_t                 ns_max_age;
+
        /**
         * Server only: number of times we evicted clients due to lack of reply
         * to ASTs.
@@ -471,7 +469,7 @@ struct ldlm_namespace {
        /** LDLM pool structure for this namespace */
        struct ldlm_pool        ns_pool;
        /** Definition of how eagerly unused locks will be released from LRU */
-       ldlm_appetite_t         ns_appetite;
+       enum ldlm_appetite      ns_appetite;
 
        /**
         * If more than \a ns_contended_locks are found, the resource is
@@ -516,6 +514,9 @@ struct ldlm_namespace {
         * Which bucket should we start with the lock reclaim.
         */
        int                     ns_reclaim_start;
+
+       struct kobject          ns_kobj; /* sysfs object */
+       struct completion       ns_kobj_unregister;
 };
 
 /**
@@ -588,10 +589,27 @@ struct ldlm_glimpse_work {
        __u32                    gl_flags;/* see LDLM_GL_WORK_* below */
        union ldlm_gl_desc      *gl_desc; /* glimpse descriptor to be packed in
                                           * glimpse callback request */
+       ptlrpc_interpterer_t     gl_interpret_reply;
+       void                    *gl_interpret_data;
 };
 
-/** The ldlm_glimpse_work is allocated on the stack and should not be freed. */
-#define LDLM_GL_WORK_NOFREE 0x1
+struct ldlm_cb_set_arg {
+       struct ptlrpc_request_set       *set;
+       int                              type; /* LDLM_{CP,BL,GL}_CALLBACK */
+       atomic_t                         restart;
+       struct list_head                *list;
+       union ldlm_gl_desc              *gl_desc; /* glimpse AST descriptor */
+       ptlrpc_interpterer_t             gl_interpret_reply;
+       void                            *gl_interpret_data;
+};
+
+struct ldlm_cb_async_args {
+       struct ldlm_cb_set_arg  *ca_set_arg;
+       struct ldlm_lock        *ca_lock;
+};
+
+/** The ldlm_glimpse_work was slab allocated & must be freed accordingly.*/
+#define LDLM_GL_WORK_SLAB_ALLOCATED 0x1
 
 /** Interval node data for each LDLM_EXTENT lock. */
 struct ldlm_interval {
@@ -610,7 +628,7 @@ struct ldlm_interval {
 struct ldlm_interval_tree {
        /** Tree size. */
        int                     lit_size;
-       ldlm_mode_t             lit_mode;  /* lock mode */
+       enum ldlm_mode          lit_mode;  /* lock mode */
        struct interval_node    *lit_root; /* actual ldlm_interval */
 };
 
@@ -618,22 +636,20 @@ struct ldlm_interval_tree {
 #define LUSTRE_TRACKS_LOCK_EXP_REFS (0)
 
 /** Cancel flags. */
-typedef enum {
-        LCF_ASYNC      = 0x1, /* Cancel locks asynchronously. */
-        LCF_LOCAL      = 0x2, /* Cancel locks locally, not notifing server */
-        LCF_BL_AST     = 0x4, /* Cancel locks marked as LDLM_FL_BL_AST
-                               * in the same RPC */
-} ldlm_cancel_flags_t;
+enum ldlm_cancel_flags {
+       LCF_ASYNC       = 0x1, /* Cancel locks asynchronously. */
+       LCF_LOCAL       = 0x2, /* Cancel locks locally, not notifing server */
+       LCF_BL_AST      = 0x4, /* Cancel LDLM_FL_BL_AST locks in the same RPC */
+};
 
 struct ldlm_flock {
-        __u64 start;
-        __u64 end;
-        __u64 owner;
-        __u64 blocking_owner;
-        struct obd_export *blocking_export;
-       /* Protected by the hash lock */
-       __u32 blocking_refs;
-        __u32 pid;
+       __u64 start;
+       __u64 end;
+       __u64 owner;
+       __u64 blocking_owner;
+       struct obd_export *blocking_export;
+       atomic_t blocking_refs;
+       __u32 pid;
 };
 
 union ldlm_policy_data {
@@ -642,14 +658,12 @@ union ldlm_policy_data {
        struct ldlm_inodebits l_inodebits;
 };
 
-typedef union ldlm_policy_data ldlm_policy_data_t;
-
-void ldlm_convert_policy_to_wire(ldlm_type_t type,
-                                 const ldlm_policy_data_t *lpolicy,
-                                 ldlm_wire_policy_data_t *wpolicy);
-void ldlm_convert_policy_to_local(struct obd_export *exp, ldlm_type_t type,
-                                  const ldlm_wire_policy_data_t *wpolicy,
-                                  ldlm_policy_data_t *lpolicy);
+void ldlm_convert_policy_to_wire(enum ldlm_type type,
+                                const union ldlm_policy_data *lpolicy,
+                                union ldlm_wire_policy_data *wpolicy);
+void ldlm_convert_policy_to_local(struct obd_export *exp, enum ldlm_type type,
+                                 const union ldlm_wire_policy_data *wpolicy,
+                                 union ldlm_policy_data *lpolicy);
 
 enum lvb_type {
        LVB_T_NONE      = 0,
@@ -730,11 +744,11 @@ struct ldlm_lock {
         * Requested mode.
         * Protected by lr_lock.
         */
-       ldlm_mode_t             l_req_mode;
+       enum ldlm_mode          l_req_mode;
        /**
         * Granted mode, also protected by lr_lock.
         */
-       ldlm_mode_t             l_granted_mode;
+       enum ldlm_mode          l_granted_mode;
        /** Lock completion handler pointer. Called when lock is granted. */
        ldlm_completion_callback l_completion_ast;
        /**
@@ -778,7 +792,7 @@ struct ldlm_lock {
         * Representation of private data specific for a lock type.
         * Examples are: extent range for extent lock or bitmask for ibits locks
         */
-       ldlm_policy_data_t      l_policy_data;
+       union ldlm_policy_data  l_policy_data;
 
        /**
         * Lock state flags. Protected by lr_lock.
@@ -803,13 +817,12 @@ struct ldlm_lock {
         * Seconds. It will be updated if there is any activity related to
         * the lock, e.g. enqueue the lock or send blocking AST.
         */
-       cfs_time_t              l_last_activity;
+       time64_t                l_last_activity;
 
        /**
-        * Time last used by e.g. being matched by lock match.
-        * Jiffies. Should be converted to time if needed.
+        * Time, in nanoseconds, last used by e.g. being matched by lock match.
         */
-       cfs_time_t              l_last_used;
+       ktime_t                 l_last_used;
 
        /** Originally requested extent for the extent lock. */
        struct ldlm_extent      l_req_extent;
@@ -822,6 +835,7 @@ struct ldlm_lock {
 
        /**
         * Temporary storage for a LVB received during an enqueue operation.
+        * May be vmalloc'd, so needs to be freed with OBD_FREE_LARGE().
         */
        __u32                   l_lvb_len;
        void                    *l_lvb_data;
@@ -845,8 +859,7 @@ struct ldlm_lock {
         * The lists this could be linked into are:
         * waiting_locks_list (protected by waiting_locks_spinlock),
         * then if the lock timed out, it is moved to
-        * expired_lock_thread.elt_expired_locks for further processing.
-        * Protected by elt_lock.
+        * expired_lock_list for further processing.
         */
        struct list_head        l_pending_chain;
 
@@ -909,6 +922,13 @@ struct ldlm_lock {
        struct list_head        l_exp_list;
 };
 
+/** For uncommitted cross-MDT lock, store transno this lock belongs to */
+#define l_transno l_client_cookie
+
+/** For uncommitted cross-MDT lock, which is client lock, share with l_rk_ast
+ *  which is for server. */
+#define l_slc_link l_rk_ast
+
 /**
  * LDLM resource description.
  * Basically, resource is a representation for a single object.
@@ -968,7 +988,7 @@ struct ldlm_resource {
        };
 
        /** Type of locks this resource can hold. Only one type per resource. */
-       ldlm_type_t             lr_type; /* LDLM_{PLAIN,EXTENT,FLOCK,IBITS} */
+       enum ldlm_type          lr_type; /* LDLM_{PLAIN,EXTENT,FLOCK,IBITS} */
 
        /**
         * Server-side-only lock value block elements.
@@ -1095,15 +1115,15 @@ struct ldlm_ast_work {
  * Common ldlm_enqueue parameters
  */
 struct ldlm_enqueue_info {
-       __u32 ei_type;   /** Type of the lock being enqueued. */
-       __u32 ei_mode;   /** Mode of the lock being enqueued. */
-       void *ei_cb_bl;  /** blocking lock callback */
-       void *ei_cb_local_bl;  /** blocking local lock callback */
-       void *ei_cb_cp;  /** lock completion callback */
-       void *ei_cb_gl;  /** lock glimpse callback */
-       void *ei_cbdata; /** Data to be passed into callbacks. */
-       void *ei_namespace; /** lock namespace **/
-       unsigned int ei_enq_slave:1; /* whether enqueue slave stripes */
+       enum ldlm_type  ei_type;        /** Type of the lock being enqueued. */
+       enum ldlm_mode  ei_mode;        /** Mode of the lock being enqueued. */
+       void            *ei_cb_bl;      /** blocking lock callback */
+       void            *ei_cb_local_bl; /** blocking local lock callback */
+       void            *ei_cb_cp;      /** lock completion callback */
+       void            *ei_cb_gl;      /** lock glimpse callback */
+       void            *ei_cbdata;     /** Data to be passed into callbacks. */
+       void            *ei_namespace;  /** lock namespace **/
+       unsigned int    ei_enq_slave:1; /** whether enqueue slave stripes */
 };
 
 #define ei_res_id      ei_cb_gl
@@ -1112,7 +1132,7 @@ extern struct obd_ops ldlm_obd_ops;
 
 extern char *ldlm_lockname[];
 extern char *ldlm_typename[];
-extern char *ldlm_it2str(int it);
+extern const char *ldlm_it2str(enum ldlm_intent_flags it);
 
 /**
  * Just a fancy CDEBUG call with log level preset to LDLM_DEBUG.
@@ -1145,7 +1165,7 @@ void _ldlm_lock_debug(struct ldlm_lock *lock,
  * Rate-limited version of lock printing function.
  */
 #define LDLM_DEBUG_LIMIT(mask, lock, fmt, a...) do {                         \
-        static cfs_debug_limit_state_t _ldlm_cdls;                           \
+       static struct cfs_debug_limit_state _ldlm_cdls;                      \
         LIBCFS_DEBUG_MSG_DATA_DECL(msgdata, mask, &_ldlm_cdls);              \
         ldlm_lock_debug(&msgdata, mask, &_ldlm_cdls, lock, "### " fmt , ##a);\
 } while (0)
@@ -1169,8 +1189,41 @@ void _ldlm_lock_debug(struct ldlm_lock *lock,
 # define LDLM_ERROR(lock, fmt, a...) ((void)0)
 #endif
 
+/*
+ * Three intentions can be used for the policy functions in
+ * ldlm_processing_policy.
+ *
+ * LDLM_PROCESS_RESCAN:
+ *
+ * It's used when policy functions are called from ldlm_reprocess_queue() to
+ * reprocess the wait & convert list and try to grant locks, blocking ASTs
+ * have already been sent in this situation, completion ASTs need be sent for
+ * the locks being granted.
+ *
+ * LDLM_PROCESS_ENQUEUE:
+ *
+ * It's used when policy functions are called from ldlm_lock_enqueue() to
+ * process the wait & convert list for handling an enqueue request, blocking
+ * ASTs have not been sent yet, so list of conflicting locks would be
+ * collected and ASTs sent.
+ *
+ * LDLM_PROCESS_RECOVERY:
+ *
+ * It's used when policy functions are called from ldlm_reprocess_queue() to
+ * reprocess the wait & convert list when recovery done. In case of blocking
+ * ASTs are lost before recovery, it needs not only to grant locks if
+ * available, but also send blocking ASTs to the locks doesn't have AST sent
+ * flag. Completion ASTs need be sent for the locks being granted.
+ */
+enum ldlm_process_intention {
+       LDLM_PROCESS_RESCAN = 0,
+       LDLM_PROCESS_ENQUEUE = 1,
+       LDLM_PROCESS_RECOVERY = 2,
+};
+
 typedef int (*ldlm_processing_policy)(struct ldlm_lock *lock, __u64 *flags,
-                                     int first_enq, ldlm_error_t *err,
+                                     enum ldlm_process_intention intention,
+                                     enum ldlm_error *err,
                                      struct list_head *work_list);
 
 /**
@@ -1204,6 +1257,19 @@ int ldlm_flock_completion_ast(struct ldlm_lock *lock, __u64 flags, void *data);
 /* ldlm_extent.c */
 __u64 ldlm_extent_shift_kms(struct ldlm_lock *lock, __u64 old_kms);
 
+struct ldlm_prolong_args {
+       struct obd_export       *lpa_export;
+       struct ldlm_res_id      lpa_resid;
+       struct ldlm_extent      lpa_extent;
+       enum ldlm_mode          lpa_mode;
+       int                     lpa_timeout;
+       int                     lpa_locks_cnt;
+       int                     lpa_blocks_cnt;
+};
+void ldlm_lock_prolong_one(struct ldlm_lock *lock,
+                          struct ldlm_prolong_args *arg);
+void ldlm_resource_prolong(struct ldlm_prolong_args *arg);
+
 struct ldlm_callback_suite {
         ldlm_completion_callback lcs_completion;
         ldlm_blocking_callback   lcs_blocking;
@@ -1265,7 +1331,7 @@ void ldlm_lock2handle(const struct ldlm_lock *lock,
 struct ldlm_lock *__ldlm_handle2lock(const struct lustre_handle *, __u64 flags);
 void ldlm_cancel_callback(struct ldlm_lock *);
 int ldlm_lock_remove_from_lru(struct ldlm_lock *);
-int ldlm_lock_set_data(struct lustre_handle *, void *);
+int ldlm_lock_set_data(const struct lustre_handle *lockh, void *data);
 
 /**
  * Obtain a lock reference by its handle.
@@ -1293,9 +1359,11 @@ ldlm_handle2lock_long(const struct lustre_handle *h, __u64 flags)
  * Update Lock Value Block Operations (LVBO) on a resource taking into account
  * data from request \a r
  */
-static inline int ldlm_res_lvbo_update(struct ldlm_resource *res,
-                                       struct ptlrpc_request *r, int increase)
+static inline int ldlm_lvbo_update(struct ldlm_resource *res,
+                                  struct ldlm_lock *lock,
+                                  struct ptlrpc_request *req, int increase)
 {
+       struct ldlm_namespace *ns = ldlm_res_to_ns(res);
        int rc;
 
        /* delayed lvb init may be required */
@@ -1305,17 +1373,21 @@ static inline int ldlm_res_lvbo_update(struct ldlm_resource *res,
                return rc;
        }
 
-        if (ldlm_res_to_ns(res)->ns_lvbo &&
-            ldlm_res_to_ns(res)->ns_lvbo->lvbo_update) {
-                return ldlm_res_to_ns(res)->ns_lvbo->lvbo_update(res, r,
-                                                                 increase);
-        }
-        return 0;
+       if (ns->ns_lvbo && ns->ns_lvbo->lvbo_update)
+               return ns->ns_lvbo->lvbo_update(res, lock, req, increase);
+
+       return 0;
+}
+
+static inline int ldlm_res_lvbo_update(struct ldlm_resource *res,
+                                      struct ptlrpc_request *req, int increase)
+{
+       return ldlm_lvbo_update(res, NULL, req, increase);
 }
 
-int ldlm_error2errno(ldlm_error_t error);
-ldlm_error_t ldlm_errno2error(int err_no); /* don't call it `errno': this
-                                            * confuses user-space. */
+int ldlm_error2errno(enum ldlm_error error);
+enum ldlm_error ldlm_errno2error(int err_no); /* don't call it `errno': this
+                                              * confuses user-space. */
 #if LUSTRE_TRACKS_LOCK_EXP_REFS
 void ldlm_dump_export_locks(struct obd_export *exp);
 #endif
@@ -1365,39 +1437,46 @@ struct ldlm_lock *ldlm_lock_get(struct ldlm_lock *lock);
 void ldlm_lock_put(struct ldlm_lock *lock);
 void ldlm_lock_destroy(struct ldlm_lock *lock);
 void ldlm_lock2desc(struct ldlm_lock *lock, struct ldlm_lock_desc *desc);
-void ldlm_lock_addref(struct lustre_handle *lockh, __u32 mode);
-int  ldlm_lock_addref_try(struct lustre_handle *lockh, __u32 mode);
-void ldlm_lock_decref(struct lustre_handle *lockh, __u32 mode);
-void ldlm_lock_decref_and_cancel(struct lustre_handle *lockh, __u32 mode);
+void ldlm_lock_addref(const struct lustre_handle *lockh, enum ldlm_mode mode);
+int  ldlm_lock_addref_try(const struct lustre_handle *lockh,
+                         enum ldlm_mode mode);
+void ldlm_lock_decref(const struct lustre_handle *lockh, enum ldlm_mode mode);
+void ldlm_lock_decref_and_cancel(const struct lustre_handle *lockh,
+                                enum ldlm_mode mode);
 void ldlm_lock_fail_match_locked(struct ldlm_lock *lock);
 void ldlm_lock_fail_match(struct ldlm_lock *lock);
 void ldlm_lock_allow_match(struct ldlm_lock *lock);
 void ldlm_lock_allow_match_locked(struct ldlm_lock *lock);
-ldlm_mode_t ldlm_lock_match(struct ldlm_namespace *ns, __u64 flags,
-                            const struct ldlm_res_id *, ldlm_type_t type,
-                            ldlm_policy_data_t *, ldlm_mode_t mode,
-                            struct lustre_handle *, int unref);
-ldlm_mode_t ldlm_revalidate_lock_handle(struct lustre_handle *lockh,
-                                        __u64 *bits);
-struct ldlm_resource *ldlm_lock_convert(struct ldlm_lock *lock, int new_mode,
-                                        __u32 *flags);
-void ldlm_lock_downgrade(struct ldlm_lock *lock, int new_mode);
+enum ldlm_mode ldlm_lock_match(struct ldlm_namespace *ns, __u64 flags,
+                              const struct ldlm_res_id *, enum ldlm_type type,
+                              union ldlm_policy_data *, enum ldlm_mode mode,
+                              struct lustre_handle *, int unref);
+enum ldlm_mode ldlm_revalidate_lock_handle(const struct lustre_handle *lockh,
+                                          __u64 *bits);
+struct ldlm_resource *ldlm_lock_convert(struct ldlm_lock *lock,
+                                       enum ldlm_mode new_mode, __u32 *flags);
+void ldlm_lock_downgrade(struct ldlm_lock *lock, enum ldlm_mode new_mode);
 void ldlm_lock_cancel(struct ldlm_lock *lock);
 void ldlm_reprocess_all(struct ldlm_resource *res);
-void ldlm_reprocess_all_ns(struct ldlm_namespace *ns);
-void ldlm_lock_dump_handle(int level, struct lustre_handle *);
+void ldlm_reprocess_recovery_done(struct ldlm_namespace *ns);
+void ldlm_lock_dump_handle(int level, const struct lustre_handle *lockh);
 void ldlm_unlink_lock_skiplist(struct ldlm_lock *req);
 
 /* resource.c */
-struct ldlm_namespace *
-ldlm_namespace_new(struct obd_device *obd, char *name,
-                   ldlm_side_t client, ldlm_appetite_t apt,
-                   ldlm_ns_type_t ns_type);
+struct ldlm_namespace *ldlm_namespace_new(struct obd_device *obd, char *name,
+                                         enum ldlm_side client,
+                                         enum ldlm_appetite apt,
+                                         enum ldlm_ns_type ns_type);
 int ldlm_namespace_cleanup(struct ldlm_namespace *ns, __u64 flags);
+void ldlm_namespace_free_prior(struct ldlm_namespace *ns,
+                              struct obd_import *imp,
+                              int force);
+void ldlm_namespace_free_post(struct ldlm_namespace *ns);
 void ldlm_namespace_free(struct ldlm_namespace *ns,
-                         struct obd_import *imp, int force);
-void ldlm_namespace_register(struct ldlm_namespace *ns, ldlm_side_t client);
-void ldlm_namespace_unregister(struct ldlm_namespace *ns, ldlm_side_t client);
+                        struct obd_import *imp, int force);
+void ldlm_namespace_register(struct ldlm_namespace *ns, enum ldlm_side client);
+void ldlm_namespace_unregister(struct ldlm_namespace *ns,
+                              enum ldlm_side client);
 void ldlm_namespace_get(struct ldlm_namespace *ns);
 void ldlm_namespace_put(struct ldlm_namespace *ns);
 int ldlm_proc_setup(void);
@@ -1409,9 +1488,9 @@ static inline void ldlm_proc_cleanup(void) {}
 
 /* resource.c - internal */
 struct ldlm_resource *ldlm_resource_get(struct ldlm_namespace *ns,
-                                        struct ldlm_resource *parent,
-                                        const struct ldlm_res_id *,
-                                        ldlm_type_t type, int create);
+                                       struct ldlm_resource *parent,
+                                       const struct ldlm_res_id *,
+                                       enum ldlm_type type, int create);
 struct ldlm_resource *ldlm_resource_getref(struct ldlm_resource *res);
 int ldlm_resource_putref(struct ldlm_resource *res);
 void ldlm_resource_add_lock(struct ldlm_resource *res,
@@ -1419,7 +1498,7 @@ void ldlm_resource_add_lock(struct ldlm_resource *res,
                            struct ldlm_lock *lock);
 void ldlm_resource_unlink_lock(struct ldlm_lock *lock);
 void ldlm_res2desc(struct ldlm_resource *res, struct ldlm_resource_desc *desc);
-void ldlm_dump_all_namespaces(ldlm_side_t client, int level);
+void ldlm_dump_all_namespaces(enum ldlm_side client, int level);
 void ldlm_namespace_dump(int level, struct ldlm_namespace *);
 void ldlm_resource_dump(int level, struct ldlm_resource *);
 int ldlm_lock_change_resource(struct ldlm_namespace *, struct ldlm_lock *,
@@ -1453,9 +1532,9 @@ int ldlm_completion_ast(struct ldlm_lock *lock, __u64 flags, void *data);
  * to obtain and release locks.
  * @{ */
 int ldlm_cli_enqueue(struct obd_export *exp, struct ptlrpc_request **reqp,
-                     struct ldlm_enqueue_info *einfo,
-                     const struct ldlm_res_id *res_id,
-                    ldlm_policy_data_t const *policy, __u64 *flags,
+                    struct ldlm_enqueue_info *einfo,
+                    const struct ldlm_res_id *res_id,
+                    union ldlm_policy_data const *policy, __u64 *flags,
                     void *lvb, __u32 lvb_len, enum lvb_type lvb_type,
                     struct lustre_handle *lockh, int async);
 int ldlm_prep_enqueue_req(struct obd_export *exp,
@@ -1471,44 +1550,45 @@ int ldlm_handle_enqueue0(struct ldlm_namespace *ns, struct ptlrpc_request *req,
                         const struct ldlm_request *dlm_req,
                         const struct ldlm_callback_suite *cbs);
 int ldlm_cli_enqueue_fini(struct obd_export *exp, struct ptlrpc_request *req,
-                          ldlm_type_t type, __u8 with_policy, ldlm_mode_t mode,
-                         __u64 *flags, void *lvb, __u32 lvb_len,
-                          struct lustre_handle *lockh, int rc);
+                         enum ldlm_type type, __u8 with_policy,
+                         enum ldlm_mode mode, __u64 *flags, void *lvb,
+                         __u32 lvb_len,
+                         const struct lustre_handle *lockh, int rc);
 int ldlm_cli_enqueue_local(struct ldlm_namespace *ns,
-                           const struct ldlm_res_id *res_id,
-                           ldlm_type_t type, ldlm_policy_data_t *policy,
-                          ldlm_mode_t mode, __u64 *flags,
-                           ldlm_blocking_callback blocking,
-                           ldlm_completion_callback completion,
-                           ldlm_glimpse_callback glimpse,
+                          const struct ldlm_res_id *res_id,
+                          enum ldlm_type type, union ldlm_policy_data *policy,
+                          enum ldlm_mode mode, __u64 *flags,
+                          ldlm_blocking_callback blocking,
+                          ldlm_completion_callback completion,
+                          ldlm_glimpse_callback glimpse,
                           void *data, __u32 lvb_len, enum lvb_type lvb_type,
-                           const __u64 *client_cookie,
-                           struct lustre_handle *lockh);
-int ldlm_server_ast(struct lustre_handle *lockh, struct ldlm_lock_desc *new,
-                    void *data, __u32 data_len);
-int ldlm_cli_convert(struct lustre_handle *, int new_mode, __u32 *flags);
+                          const __u64 *client_cookie,
+                          struct lustre_handle *lockh);
+int ldlm_cli_convert(const struct lustre_handle *lockh, int new_mode,
+                    __u32 *flags);
 int ldlm_cli_update_pool(struct ptlrpc_request *req);
-int ldlm_cli_cancel(struct lustre_handle *lockh,
-                   ldlm_cancel_flags_t cancel_flags);
+int ldlm_cli_cancel(const struct lustre_handle *lockh,
+                   enum ldlm_cancel_flags cancel_flags);
 int ldlm_cli_cancel_unused(struct ldlm_namespace *, const struct ldlm_res_id *,
-                           ldlm_cancel_flags_t flags, void *opaque);
+                          enum ldlm_cancel_flags flags, void *opaque);
 int ldlm_cli_cancel_unused_resource(struct ldlm_namespace *ns,
-                                    const struct ldlm_res_id *res_id,
-                                    ldlm_policy_data_t *policy,
-                                    ldlm_mode_t mode,
-                                    ldlm_cancel_flags_t flags,
-                                    void *opaque);
+                                   const struct ldlm_res_id *res_id,
+                                   union ldlm_policy_data *policy,
+                                   enum ldlm_mode mode,
+                                   enum ldlm_cancel_flags flags, void *opaque);
 int ldlm_cli_cancel_req(struct obd_export *exp, struct list_head *head,
-                       int count, ldlm_cancel_flags_t flags);
+                       int count, enum ldlm_cancel_flags flags);
 int ldlm_cancel_resource_local(struct ldlm_resource *res,
                               struct list_head *cancels,
-                              ldlm_policy_data_t *policy,
-                              ldlm_mode_t mode, __u64 lock_flags,
-                              ldlm_cancel_flags_t cancel_flags, void *opaque);
+                              union ldlm_policy_data *policy,
+                              enum ldlm_mode mode, __u64 lock_flags,
+                              enum ldlm_cancel_flags cancel_flags,
+                              void *opaque);
 int ldlm_cli_cancel_list_local(struct list_head *cancels, int count,
-                               ldlm_cancel_flags_t flags);
+                              enum ldlm_cancel_flags flags);
 int ldlm_cli_cancel_list(struct list_head *head, int count,
-                         struct ptlrpc_request *req, ldlm_cancel_flags_t flags);
+                        struct ptlrpc_request *req,
+                        enum ldlm_cancel_flags flags);
 /** @} ldlm_cli_api */
 
 /* mds/handler.c */
@@ -1558,12 +1638,12 @@ void unlock_res_and_lock(struct ldlm_lock *lock);
  * There are not used outside of ldlm.
  * @{
  */
-int ldlm_pools_recalc(ldlm_side_t client);
+int ldlm_pools_recalc(enum ldlm_side client);
 int ldlm_pools_init(void);
 void ldlm_pools_fini(void);
 
 int ldlm_pool_init(struct ldlm_pool *pl, struct ldlm_namespace *ns,
-                   int idx, ldlm_side_t client);
+                  int idx, enum ldlm_side client);
 int ldlm_pool_shrink(struct ldlm_pool *pl, int nr, gfp_t gfp_mask);
 void ldlm_pool_fini(struct ldlm_pool *pl);
 int ldlm_pool_setup(struct ldlm_pool *pl, int limit);
@@ -1579,5 +1659,18 @@ void ldlm_pool_add(struct ldlm_pool *pl, struct ldlm_lock *lock);
 void ldlm_pool_del(struct ldlm_pool *pl, struct ldlm_lock *lock);
 /** @} */
 
+static inline int ldlm_extent_overlap(const struct ldlm_extent *ex1,
+                                     const struct ldlm_extent *ex2)
+{
+       return ex1->start <= ex2->end && ex2->start <= ex1->end;
+}
+
+/* check if @ex1 contains @ex2 */
+static inline int ldlm_extent_contain(const struct ldlm_extent *ex1,
+                                     const struct ldlm_extent *ex2)
+{
+       return ex1->start <= ex2->start && ex1->end >= ex2->end;
+}
+
 #endif
 /** @} LDLM */