[net-next-2.6.git] / fs / ocfs2 / dlmglue.h

/* -*- mode: c; c-basic-offset: 8; -*-
 * vim: noexpandtab sw=8 ts=8 sts=0:
 *
 * dlmglue.h
 *
 * description here
 *
 * Copyright (C) 2002, 2004 Oracle.  All rights reserved.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public
 * License along with this program; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 021110-1307, USA.
 */


#ifndef DLMGLUE_H
#define DLMGLUE_H

#include "dcache.h"

#define OCFS2_LVB_VERSION 5

struct ocfs2_meta_lvb {
	__u8         lvb_version;
	__u8         lvb_reserved0;
	__be16       lvb_idynfeatures;
	__be32       lvb_iclusters;
	__be32       lvb_iuid;
	__be32       lvb_igid;
	__be64       lvb_iatime_packed;
	__be64       lvb_ictime_packed;
	__be64       lvb_imtime_packed;
	__be64       lvb_isize;
	__be16       lvb_imode;
	__be16       lvb_inlink;
	__be32       lvb_iattr;
	__be32       lvb_igeneration;
	__be32       lvb_reserved2;
};

#define OCFS2_QINFO_LVB_VERSION 1

struct ocfs2_qinfo_lvb {
	__u8	lvb_version;
	__u8	lvb_reserved[3];
	__be32	lvb_bgrace;
	__be32	lvb_igrace;
	__be32	lvb_syncms;
	__be32	lvb_blocks;
	__be32	lvb_free_blk;
	__be32	lvb_free_entry;
};

#define OCFS2_ORPHAN_LVB_VERSION 1

struct ocfs2_orphan_scan_lvb {
	__u8	lvb_version;
	__u8	lvb_reserved[3];
	__be32	lvb_os_seqno;
};

/* ocfs2_inode_lock_full() 'arg_flags' flags */
/* don't wait on recovery. */
#define OCFS2_META_LOCK_RECOVERY	(0x01)
/* Instruct the dlm not to queue ourselves on the other node. */
#define OCFS2_META_LOCK_NOQUEUE		(0x02)
/* don't block waiting for the downconvert thread, instead return -EAGAIN */
#define OCFS2_LOCK_NONBLOCK		(0x04)

/* Locking subclasses of inode cluster lock */
enum {
	OI_LS_NORMAL = 0,
	OI_LS_PARENT,
	OI_LS_RENAME1,
	OI_LS_RENAME2,
	OI_LS_REFLINK_TARGET,
};

int ocfs2_dlm_init(struct ocfs2_super *osb);
void ocfs2_dlm_shutdown(struct ocfs2_super *osb, int hangup_pending);
void ocfs2_lock_res_init_once(struct ocfs2_lock_res *res);
void ocfs2_inode_lock_res_init(struct ocfs2_lock_res *res,
			       enum ocfs2_lock_type type,
			       unsigned int generation,
			       struct inode *inode);
void ocfs2_dentry_lock_res_init(struct ocfs2_dentry_lock *dl,
				u64 parent, struct inode *inode);
struct ocfs2_file_private;
void ocfs2_file_lock_res_init(struct ocfs2_lock_res *lockres,
			      struct ocfs2_file_private *fp);
struct ocfs2_mem_dqinfo;
void ocfs2_qinfo_lock_res_init(struct ocfs2_lock_res *lockres,
                               struct ocfs2_mem_dqinfo *info);
void ocfs2_refcount_lock_res_init(struct ocfs2_lock_res *lockres,
				  struct ocfs2_super *osb, u64 ref_blkno,
				  unsigned int generation);
void ocfs2_lock_res_free(struct ocfs2_lock_res *res);
int ocfs2_create_new_inode_locks(struct inode *inode);
int ocfs2_drop_inode_locks(struct inode *inode);
int ocfs2_rw_lock(struct inode *inode, int write);
void ocfs2_rw_unlock(struct inode *inode, int write);
int ocfs2_open_lock(struct inode *inode);
int ocfs2_try_open_lock(struct inode *inode, int write);
void ocfs2_open_unlock(struct inode *inode);
int ocfs2_inode_lock_atime(struct inode *inode,
			  struct vfsmount *vfsmnt,
			  int *level);
int ocfs2_inode_lock_full_nested(struct inode *inode,
			 struct buffer_head **ret_bh,
			 int ex,
			 int arg_flags,
			 int subclass);
int ocfs2_inode_lock_with_page(struct inode *inode,
			      struct buffer_head **ret_bh,
			      int ex,
			      struct page *page);
/* Variants without special locking class or flags */
#define ocfs2_inode_lock_full(i, r, e, f)\
		ocfs2_inode_lock_full_nested(i, r, e, f, OI_LS_NORMAL)
#define ocfs2_inode_lock_nested(i, b, e, s)\
		ocfs2_inode_lock_full_nested(i, b, e, 0, s)
/* 99% of the time we don't want to supply any additional flags --
 * those are for very specific cases only. */
#define ocfs2_inode_lock(i, b, e) ocfs2_inode_lock_full_nested(i, b, e, 0, OI_LS_NORMAL)
void ocfs2_inode_unlock(struct inode *inode,
		       int ex);
int ocfs2_super_lock(struct ocfs2_super *osb,
		     int ex);
void ocfs2_super_unlock(struct ocfs2_super *osb,
			int ex);
int ocfs2_orphan_scan_lock(struct ocfs2_super *osb, u32 *seqno);
void ocfs2_orphan_scan_unlock(struct ocfs2_super *osb, u32 seqno);

int ocfs2_rename_lock(struct ocfs2_super *osb);
void ocfs2_rename_unlock(struct ocfs2_super *osb);
int ocfs2_nfs_sync_lock(struct ocfs2_super *osb, int ex);
void ocfs2_nfs_sync_unlock(struct ocfs2_super *osb, int ex);
int ocfs2_dentry_lock(struct dentry *dentry, int ex);
void ocfs2_dentry_unlock(struct dentry *dentry, int ex);
int ocfs2_file_lock(struct file *file, int ex, int trylock);
void ocfs2_file_unlock(struct file *file);
int ocfs2_qinfo_lock(struct ocfs2_mem_dqinfo *oinfo, int ex);
void ocfs2_qinfo_unlock(struct ocfs2_mem_dqinfo *oinfo, int ex);
struct ocfs2_refcount_tree;
int ocfs2_refcount_lock(struct ocfs2_refcount_tree *ref_tree, int ex);
void ocfs2_refcount_unlock(struct ocfs2_refcount_tree *ref_tree, int ex);


void ocfs2_mark_lockres_freeing(struct ocfs2_lock_res *lockres);
void ocfs2_simple_drop_lockres(struct ocfs2_super *osb,
			       struct ocfs2_lock_res *lockres);

/* for the downconvert thread */
void ocfs2_wake_downconvert_thread(struct ocfs2_super *osb);

struct ocfs2_dlm_debug *ocfs2_new_dlm_debug(void);
void ocfs2_put_dlm_debug(struct ocfs2_dlm_debug *dlm_debug);

/* To set the locking protocol on module initialization */
void ocfs2_set_locking_protocol(void);
#endif	/* DLMGLUE_H */
Commit	Line	Data
ccd979bd MF	1	/* -- mode: c; c-basic-offset: 8; --
	2	* vim: noexpandtab sw=8 ts=8 sts=0:
	3	*
	4	* dlmglue.h
	5	*
	6	* description here
	7	*
	8	* Copyright (C) 2002, 2004 Oracle. All rights reserved.
	9	*
	10	* This program is free software; you can redistribute it and/or
	11	* modify it under the terms of the GNU General Public
	12	* License as published by the Free Software Foundation; either
	13	* version 2 of the License, or (at your option) any later version.
	14	*
	15	* This program is distributed in the hope that it will be useful,
	16	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	17	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	18	* General Public License for more details.
	19	*
	20	* You should have received a copy of the GNU General Public
	21	* License along with this program; if not, write to the
	22	* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
	23	* Boston, MA 021110-1307, USA.
	24	*/
	25
	26
	27	#ifndef DLMGLUE_H
	28	#define DLMGLUE_H
	29
d680efe9 MF	30	#include "dcache.h"
d680efe9 MF	31
15b1e36b	32	#define OCFS2_LVB_VERSION 5
ccd979bd MF	33
ccd979bd MF	34	struct ocfs2_meta_lvb {
4d3b83f7	35	__u8 lvb_version;
24c19ef4	36	__u8 lvb_reserved0;
15b1e36b	37	__be16 lvb_idynfeatures;
ccd979bd MF	38	__be32 lvb_iclusters;
	39	__be32 lvb_iuid;
	40	__be32 lvb_igid;
	41	__be64 lvb_iatime_packed;
	42	__be64 lvb_ictime_packed;
	43	__be64 lvb_imtime_packed;
	44	__be64 lvb_isize;
	45	__be16 lvb_imode;
	46	__be16 lvb_inlink;
ca4d147e	47	__be32 lvb_iattr;
f9e2d82e MF	48	__be32 lvb_igeneration;
f9e2d82e MF	49	__be32 lvb_reserved2;
ccd979bd MF	50	};
ccd979bd MF	51
9e33d69f JK	52	#define OCFS2_QINFO_LVB_VERSION 1
	53
	54	struct ocfs2_qinfo_lvb {
	55	__u8 lvb_version;
	56	__u8 lvb_reserved[3];
	57	__be32 lvb_bgrace;
	58	__be32 lvb_igrace;
	59	__be32 lvb_syncms;
	60	__be32 lvb_blocks;
	61	__be32 lvb_free_blk;
	62	__be32 lvb_free_entry;
	63	};
	64
83273932 SE	65	#define OCFS2_ORPHAN_LVB_VERSION 1
	66
	67	struct ocfs2_orphan_scan_lvb {
	68	__u8 lvb_version;
	69	__u8 lvb_reserved[3];
	70	__be32 lvb_os_seqno;
	71	};
	72
e63aecb6	73	/* ocfs2_inode_lock_full() 'arg_flags' flags */
ccd979bd MF	74	/* don't wait on recovery. */
	75	#define OCFS2_META_LOCK_RECOVERY (0x01)
	76	/* Instruct the dlm not to queue ourselves on the other node. */
	77	#define OCFS2_META_LOCK_NOQUEUE (0x02)
34d024f8	78	/* don't block waiting for the downconvert thread, instead return -EAGAIN */
ccd979bd MF	79	#define OCFS2_LOCK_NONBLOCK (0x04)
ccd979bd MF	80
cb25797d JK	81	/* Locking subclasses of inode cluster lock */
	82	enum {
	83	OI_LS_NORMAL = 0,
	84	OI_LS_PARENT,
	85	OI_LS_RENAME1,
	86	OI_LS_RENAME2,
07eaac94	87	OI_LS_REFLINK_TARGET,
cb25797d JK	88	};
cb25797d JK	89
ccd979bd	90	int ocfs2_dlm_init(struct ocfs2_super *osb);
286eaa95	91	void ocfs2_dlm_shutdown(struct ocfs2_super *osb, int hangup_pending);
ccd979bd MF	92	void ocfs2_lock_res_init_once(struct ocfs2_lock_res *res);
	93	void ocfs2_inode_lock_res_init(struct ocfs2_lock_res *res,
	94	enum ocfs2_lock_type type,
24c19ef4	95	unsigned int generation,
ccd979bd	96	struct inode *inode);
d680efe9 MF	97	void ocfs2_dentry_lock_res_init(struct ocfs2_dentry_lock *dl,
d680efe9 MF	98	u64 parent, struct inode *inode);
cf8e06f1 MF	99	struct ocfs2_file_private;
	100	void ocfs2_file_lock_res_init(struct ocfs2_lock_res *lockres,
	101	struct ocfs2_file_private *fp);
9e33d69f JK	102	struct ocfs2_mem_dqinfo;
	103	void ocfs2_qinfo_lock_res_init(struct ocfs2_lock_res *lockres,
	104	struct ocfs2_mem_dqinfo *info);
8dec98ed TM	105	void ocfs2_refcount_lock_res_init(struct ocfs2_lock_res *lockres,
	106	struct ocfs2_super *osb, u64 ref_blkno,
	107	unsigned int generation);
ccd979bd MF	108	void ocfs2_lock_res_free(struct ocfs2_lock_res *res);
	109	int ocfs2_create_new_inode_locks(struct inode *inode);
	110	int ocfs2_drop_inode_locks(struct inode *inode);
ccd979bd MF	111	int ocfs2_rw_lock(struct inode *inode, int write);
ccd979bd MF	112	void ocfs2_rw_unlock(struct inode *inode, int write);
50008630 TY	113	int ocfs2_open_lock(struct inode *inode);
	114	int ocfs2_try_open_lock(struct inode *inode, int write);
	115	void ocfs2_open_unlock(struct inode *inode);
e63aecb6	116	int ocfs2_inode_lock_atime(struct inode *inode,
7f1a37e3 TY	117	struct vfsmount *vfsmnt,
7f1a37e3 TY	118	int *level);
cb25797d	119	int ocfs2_inode_lock_full_nested(struct inode *inode,
ccd979bd MF	120	struct buffer_head **ret_bh,
ccd979bd MF	121	int ex,
cb25797d JK	122	int arg_flags,
cb25797d JK	123	int subclass);
e63aecb6	124	int ocfs2_inode_lock_with_page(struct inode *inode,
ccd979bd MF	125	struct buffer_head **ret_bh,
	126	int ex,
	127	struct page *page);
cb25797d JK	128	/* Variants without special locking class or flags */
	129	#define ocfs2_inode_lock_full(i, r, e, f)\
	130	ocfs2_inode_lock_full_nested(i, r, e, f, OI_LS_NORMAL)
	131	#define ocfs2_inode_lock_nested(i, b, e, s)\
	132	ocfs2_inode_lock_full_nested(i, b, e, 0, s)
ccd979bd MF	133	/* 99% of the time we don't want to supply any additional flags --
ccd979bd MF	134	* those are for very specific cases only. */
cb25797d	135	#define ocfs2_inode_lock(i, b, e) ocfs2_inode_lock_full_nested(i, b, e, 0, OI_LS_NORMAL)
e63aecb6	136	void ocfs2_inode_unlock(struct inode *inode,
ccd979bd MF	137	int ex);
	138	int ocfs2_super_lock(struct ocfs2_super *osb,
	139	int ex);
	140	void ocfs2_super_unlock(struct ocfs2_super *osb,
	141	int ex);
df152c24 SM	142	int ocfs2_orphan_scan_lock(struct ocfs2_super osb, u32 seqno);
df152c24 SM	143	void ocfs2_orphan_scan_unlock(struct ocfs2_super *osb, u32 seqno);
83273932	144
ccd979bd MF	145	int ocfs2_rename_lock(struct ocfs2_super *osb);
ccd979bd MF	146	void ocfs2_rename_unlock(struct ocfs2_super *osb);
6ca497a8	147	int ocfs2_nfs_sync_lock(struct ocfs2_super *osb, int ex);
6ca497a8	148	void ocfs2_nfs_sync_unlock(struct ocfs2_super *osb, int ex);
d680efe9 MF	149	int ocfs2_dentry_lock(struct dentry *dentry, int ex);
d680efe9 MF	150	void ocfs2_dentry_unlock(struct dentry *dentry, int ex);
cf8e06f1 MF	151	int ocfs2_file_lock(struct file *file, int ex, int trylock);
cf8e06f1 MF	152	void ocfs2_file_unlock(struct file *file);
9e33d69f JK	153	int ocfs2_qinfo_lock(struct ocfs2_mem_dqinfo *oinfo, int ex);
9e33d69f JK	154	void ocfs2_qinfo_unlock(struct ocfs2_mem_dqinfo *oinfo, int ex);
8dec98ed TM	155	struct ocfs2_refcount_tree;
	156	int ocfs2_refcount_lock(struct ocfs2_refcount_tree *ref_tree, int ex);
	157	void ocfs2_refcount_unlock(struct ocfs2_refcount_tree *ref_tree, int ex);
9e33d69f	158
d680efe9	159
ccd979bd	160	void ocfs2_mark_lockres_freeing(struct ocfs2_lock_res *lockres);
d680efe9 MF	161	void ocfs2_simple_drop_lockres(struct ocfs2_super *osb,
d680efe9 MF	162	struct ocfs2_lock_res *lockres);
ccd979bd	163
34d024f8	164	/* for the downconvert thread */
34d024f8	165	void ocfs2_wake_downconvert_thread(struct ocfs2_super *osb);
ccd979bd MF	166
	167	struct ocfs2_dlm_debug *ocfs2_new_dlm_debug(void);
	168	void ocfs2_put_dlm_debug(struct ocfs2_dlm_debug *dlm_debug);
	169
63e0c48a JB	170	/* To set the locking protocol on module initialization */
63e0c48a JB	171	void ocfs2_set_locking_protocol(void);
ccd979bd	172	#endif /* DLMGLUE_H */