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 
30 #include "dcache.h"
31 
32 #define OCFS2_LVB_VERSION 5
33 
34 struct ocfs2_meta_lvb {
35 	__u8         lvb_version;
36 	__u8         lvb_reserved0;
37 	__be16       lvb_idynfeatures;
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;
47 	__be32       lvb_iattr;
48 	__be32       lvb_igeneration;
49 	__be32       lvb_reserved2;
50 };
51 
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 
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 
73 #define OCFS2_TRIMFS_LVB_VERSION 1
74 
75 struct ocfs2_trim_fs_lvb {
76 	__u8	lvb_version;
77 	__u8	lvb_success;
78 	__u8	lvb_reserved[2];
79 	__be32	lvb_nodenum;
80 	__be64	lvb_start;
81 	__be64	lvb_len;
82 	__be64	lvb_minlen;
83 	__be64	lvb_trimlen;
84 };
85 
86 struct ocfs2_trim_fs_info {
87 	u8	tf_valid;	/* lvb is valid, or not */
88 	u8	tf_success;	/* trim is successful, or not */
89 	u32	tf_nodenum;	/* osb node number */
90 	u64	tf_start;	/* trim start offset in clusters */
91 	u64	tf_len;		/* trim end offset in clusters */
92 	u64	tf_minlen;	/* trim minimum contiguous free clusters */
93 	u64	tf_trimlen;	/* trimmed length in bytes */
94 };
95 
96 struct ocfs2_lock_holder {
97 	struct list_head oh_list;
98 	struct pid *oh_owner_pid;
99 	int oh_ex;
100 };
101 
102 /* ocfs2_inode_lock_full() 'arg_flags' flags */
103 /* don't wait on recovery. */
104 #define OCFS2_META_LOCK_RECOVERY	(0x01)
105 /* Instruct the dlm not to queue ourselves on the other node. */
106 #define OCFS2_META_LOCK_NOQUEUE		(0x02)
107 /* don't block waiting for the downconvert thread, instead return -EAGAIN */
108 #define OCFS2_LOCK_NONBLOCK		(0x04)
109 /* just get back disk inode bh if we've got cluster lock. */
110 #define OCFS2_META_LOCK_GETBH		(0x08)
111 
112 /* Locking subclasses of inode cluster lock */
113 enum {
114 	OI_LS_NORMAL = 0,
115 	OI_LS_PARENT,
116 	OI_LS_RENAME1,
117 	OI_LS_RENAME2,
118 	OI_LS_REFLINK_TARGET,
119 };
120 
121 int ocfs2_dlm_init(struct ocfs2_super *osb);
122 void ocfs2_dlm_shutdown(struct ocfs2_super *osb, int hangup_pending);
123 void ocfs2_lock_res_init_once(struct ocfs2_lock_res *res);
124 void ocfs2_inode_lock_res_init(struct ocfs2_lock_res *res,
125 			       enum ocfs2_lock_type type,
126 			       unsigned int generation,
127 			       struct inode *inode);
128 void ocfs2_dentry_lock_res_init(struct ocfs2_dentry_lock *dl,
129 				u64 parent, struct inode *inode);
130 struct ocfs2_file_private;
131 void ocfs2_file_lock_res_init(struct ocfs2_lock_res *lockres,
132 			      struct ocfs2_file_private *fp);
133 struct ocfs2_mem_dqinfo;
134 void ocfs2_qinfo_lock_res_init(struct ocfs2_lock_res *lockres,
135                                struct ocfs2_mem_dqinfo *info);
136 void ocfs2_refcount_lock_res_init(struct ocfs2_lock_res *lockres,
137 				  struct ocfs2_super *osb, u64 ref_blkno,
138 				  unsigned int generation);
139 void ocfs2_lock_res_free(struct ocfs2_lock_res *res);
140 int ocfs2_create_new_inode_locks(struct inode *inode);
141 int ocfs2_drop_inode_locks(struct inode *inode);
142 int ocfs2_rw_lock(struct inode *inode, int write);
143 int ocfs2_try_rw_lock(struct inode *inode, int write);
144 void ocfs2_rw_unlock(struct inode *inode, int write);
145 int ocfs2_open_lock(struct inode *inode);
146 int ocfs2_try_open_lock(struct inode *inode, int write);
147 void ocfs2_open_unlock(struct inode *inode);
148 int ocfs2_inode_lock_atime(struct inode *inode,
149 			  struct vfsmount *vfsmnt,
150 			  int *level, int wait);
151 int ocfs2_inode_lock_full_nested(struct inode *inode,
152 			 struct buffer_head **ret_bh,
153 			 int ex,
154 			 int arg_flags,
155 			 int subclass);
156 int ocfs2_inode_lock_with_page(struct inode *inode,
157 			      struct buffer_head **ret_bh,
158 			      int ex,
159 			      struct page *page);
160 /* Variants without special locking class or flags */
161 #define ocfs2_inode_lock_full(i, r, e, f)\
162 		ocfs2_inode_lock_full_nested(i, r, e, f, OI_LS_NORMAL)
163 #define ocfs2_inode_lock_nested(i, b, e, s)\
164 		ocfs2_inode_lock_full_nested(i, b, e, 0, s)
165 /* 99% of the time we don't want to supply any additional flags --
166  * those are for very specific cases only. */
167 #define ocfs2_inode_lock(i, b, e) ocfs2_inode_lock_full_nested(i, b, e, 0, OI_LS_NORMAL)
168 #define ocfs2_try_inode_lock(i, b, e)\
169 		ocfs2_inode_lock_full_nested(i, b, e, OCFS2_META_LOCK_NOQUEUE,\
170 		OI_LS_NORMAL)
171 void ocfs2_inode_unlock(struct inode *inode,
172 		       int ex);
173 int ocfs2_super_lock(struct ocfs2_super *osb,
174 		     int ex);
175 void ocfs2_super_unlock(struct ocfs2_super *osb,
176 			int ex);
177 int ocfs2_orphan_scan_lock(struct ocfs2_super *osb, u32 *seqno);
178 void ocfs2_orphan_scan_unlock(struct ocfs2_super *osb, u32 seqno);
179 
180 int ocfs2_rename_lock(struct ocfs2_super *osb);
181 void ocfs2_rename_unlock(struct ocfs2_super *osb);
182 int ocfs2_nfs_sync_lock(struct ocfs2_super *osb, int ex);
183 void ocfs2_nfs_sync_unlock(struct ocfs2_super *osb, int ex);
184 void ocfs2_trim_fs_lock_res_init(struct ocfs2_super *osb);
185 void ocfs2_trim_fs_lock_res_uninit(struct ocfs2_super *osb);
186 int ocfs2_trim_fs_lock(struct ocfs2_super *osb,
187 		       struct ocfs2_trim_fs_info *info, int trylock);
188 void ocfs2_trim_fs_unlock(struct ocfs2_super *osb,
189 			  struct ocfs2_trim_fs_info *info);
190 int ocfs2_dentry_lock(struct dentry *dentry, int ex);
191 void ocfs2_dentry_unlock(struct dentry *dentry, int ex);
192 int ocfs2_file_lock(struct file *file, int ex, int trylock);
193 void ocfs2_file_unlock(struct file *file);
194 int ocfs2_qinfo_lock(struct ocfs2_mem_dqinfo *oinfo, int ex);
195 void ocfs2_qinfo_unlock(struct ocfs2_mem_dqinfo *oinfo, int ex);
196 struct ocfs2_refcount_tree;
197 int ocfs2_refcount_lock(struct ocfs2_refcount_tree *ref_tree, int ex);
198 void ocfs2_refcount_unlock(struct ocfs2_refcount_tree *ref_tree, int ex);
199 
200 
201 void ocfs2_mark_lockres_freeing(struct ocfs2_super *osb,
202 				struct ocfs2_lock_res *lockres);
203 void ocfs2_simple_drop_lockres(struct ocfs2_super *osb,
204 			       struct ocfs2_lock_res *lockres);
205 
206 /* for the downconvert thread */
207 void ocfs2_wake_downconvert_thread(struct ocfs2_super *osb);
208 
209 struct ocfs2_dlm_debug *ocfs2_new_dlm_debug(void);
210 void ocfs2_put_dlm_debug(struct ocfs2_dlm_debug *dlm_debug);
211 
212 /* To set the locking protocol on module initialization */
213 void ocfs2_set_locking_protocol(void);
214 
215 /* The _tracker pair is used to avoid cluster recursive locking */
216 int ocfs2_inode_lock_tracker(struct inode *inode,
217 			     struct buffer_head **ret_bh,
218 			     int ex,
219 			     struct ocfs2_lock_holder *oh);
220 void ocfs2_inode_unlock_tracker(struct inode *inode,
221 				int ex,
222 				struct ocfs2_lock_holder *oh,
223 				int had_lock);
224 
225 #endif	/* DLMGLUE_H */
226