1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  * dlmglue.h
4  *
5  * description here
6  *
7  * Copyright (C) 2002, 2004 Oracle.  All rights reserved.
8  */
9 
10 
11 #ifndef DLMGLUE_H
12 #define DLMGLUE_H
13 
14 #include "dcache.h"
15 
16 #define OCFS2_LVB_VERSION 5
17 
18 struct ocfs2_meta_lvb {
19 	__u8         lvb_version;
20 	__u8         lvb_reserved0;
21 	__be16       lvb_idynfeatures;
22 	__be32       lvb_iclusters;
23 	__be32       lvb_iuid;
24 	__be32       lvb_igid;
25 	__be64       lvb_iatime_packed;
26 	__be64       lvb_ictime_packed;
27 	__be64       lvb_imtime_packed;
28 	__be64       lvb_isize;
29 	__be16       lvb_imode;
30 	__be16       lvb_inlink;
31 	__be32       lvb_iattr;
32 	__be32       lvb_igeneration;
33 	__be32       lvb_reserved2;
34 };
35 
36 #define OCFS2_QINFO_LVB_VERSION 1
37 
38 struct ocfs2_qinfo_lvb {
39 	__u8	lvb_version;
40 	__u8	lvb_reserved[3];
41 	__be32	lvb_bgrace;
42 	__be32	lvb_igrace;
43 	__be32	lvb_syncms;
44 	__be32	lvb_blocks;
45 	__be32	lvb_free_blk;
46 	__be32	lvb_free_entry;
47 };
48 
49 #define OCFS2_ORPHAN_LVB_VERSION 1
50 
51 struct ocfs2_orphan_scan_lvb {
52 	__u8	lvb_version;
53 	__u8	lvb_reserved[3];
54 	__be32	lvb_os_seqno;
55 };
56 
57 #define OCFS2_TRIMFS_LVB_VERSION 1
58 
59 struct ocfs2_trim_fs_lvb {
60 	__u8	lvb_version;
61 	__u8	lvb_success;
62 	__u8	lvb_reserved[2];
63 	__be32	lvb_nodenum;
64 	__be64	lvb_start;
65 	__be64	lvb_len;
66 	__be64	lvb_minlen;
67 	__be64	lvb_trimlen;
68 };
69 
70 struct ocfs2_trim_fs_info {
71 	u8	tf_valid;	/* lvb is valid, or not */
72 	u8	tf_success;	/* trim is successful, or not */
73 	u32	tf_nodenum;	/* osb node number */
74 	u64	tf_start;	/* trim start offset in clusters */
75 	u64	tf_len;		/* trim end offset in clusters */
76 	u64	tf_minlen;	/* trim minimum contiguous free clusters */
77 	u64	tf_trimlen;	/* trimmed length in bytes */
78 };
79 
80 struct ocfs2_lock_holder {
81 	struct list_head oh_list;
82 	struct pid *oh_owner_pid;
83 	int oh_ex;
84 };
85 
86 /* ocfs2_inode_lock_full() 'arg_flags' flags */
87 /* don't wait on recovery. */
88 #define OCFS2_META_LOCK_RECOVERY	(0x01)
89 /* Instruct the dlm not to queue ourselves on the other node. */
90 #define OCFS2_META_LOCK_NOQUEUE		(0x02)
91 /* don't block waiting for the downconvert thread, instead return -EAGAIN */
92 #define OCFS2_LOCK_NONBLOCK		(0x04)
93 /* just get back disk inode bh if we've got cluster lock. */
94 #define OCFS2_META_LOCK_GETBH		(0x08)
95 
96 /* Locking subclasses of inode cluster lock */
97 enum {
98 	OI_LS_NORMAL = 0,
99 	OI_LS_PARENT,
100 	OI_LS_RENAME1,
101 	OI_LS_RENAME2,
102 	OI_LS_REFLINK_TARGET,
103 };
104 
105 int ocfs2_dlm_init(struct ocfs2_super *osb);
106 void ocfs2_dlm_shutdown(struct ocfs2_super *osb, int hangup_pending);
107 void ocfs2_lock_res_init_once(struct ocfs2_lock_res *res);
108 void ocfs2_inode_lock_res_init(struct ocfs2_lock_res *res,
109 			       enum ocfs2_lock_type type,
110 			       unsigned int generation,
111 			       struct inode *inode);
112 void ocfs2_dentry_lock_res_init(struct ocfs2_dentry_lock *dl,
113 				u64 parent, struct inode *inode);
114 struct ocfs2_file_private;
115 void ocfs2_file_lock_res_init(struct ocfs2_lock_res *lockres,
116 			      struct ocfs2_file_private *fp);
117 struct ocfs2_mem_dqinfo;
118 void ocfs2_qinfo_lock_res_init(struct ocfs2_lock_res *lockres,
119                                struct ocfs2_mem_dqinfo *info);
120 void ocfs2_refcount_lock_res_init(struct ocfs2_lock_res *lockres,
121 				  struct ocfs2_super *osb, u64 ref_blkno,
122 				  unsigned int generation);
123 void ocfs2_lock_res_free(struct ocfs2_lock_res *res);
124 int ocfs2_create_new_inode_locks(struct inode *inode);
125 int ocfs2_drop_inode_locks(struct inode *inode);
126 int ocfs2_rw_lock(struct inode *inode, int write);
127 int ocfs2_try_rw_lock(struct inode *inode, int write);
128 void ocfs2_rw_unlock(struct inode *inode, int write);
129 int ocfs2_open_lock(struct inode *inode);
130 int ocfs2_try_open_lock(struct inode *inode, int write);
131 void ocfs2_open_unlock(struct inode *inode);
132 int ocfs2_inode_lock_atime(struct inode *inode,
133 			  struct vfsmount *vfsmnt,
134 			  int *level, int wait);
135 int ocfs2_inode_lock_full_nested(struct inode *inode,
136 			 struct buffer_head **ret_bh,
137 			 int ex,
138 			 int arg_flags,
139 			 int subclass);
140 int ocfs2_inode_lock_with_page(struct inode *inode,
141 			      struct buffer_head **ret_bh,
142 			      int ex,
143 			      struct page *page);
144 /* Variants without special locking class or flags */
145 #define ocfs2_inode_lock_full(i, r, e, f)\
146 		ocfs2_inode_lock_full_nested(i, r, e, f, OI_LS_NORMAL)
147 #define ocfs2_inode_lock_nested(i, b, e, s)\
148 		ocfs2_inode_lock_full_nested(i, b, e, 0, s)
149 /* 99% of the time we don't want to supply any additional flags --
150  * those are for very specific cases only. */
151 #define ocfs2_inode_lock(i, b, e) ocfs2_inode_lock_full_nested(i, b, e, 0, OI_LS_NORMAL)
152 #define ocfs2_try_inode_lock(i, b, e)\
153 		ocfs2_inode_lock_full_nested(i, b, e, OCFS2_META_LOCK_NOQUEUE,\
154 		OI_LS_NORMAL)
155 void ocfs2_inode_unlock(struct inode *inode,
156 		       int ex);
157 int ocfs2_super_lock(struct ocfs2_super *osb,
158 		     int ex);
159 void ocfs2_super_unlock(struct ocfs2_super *osb,
160 			int ex);
161 int ocfs2_orphan_scan_lock(struct ocfs2_super *osb, u32 *seqno);
162 void ocfs2_orphan_scan_unlock(struct ocfs2_super *osb, u32 seqno);
163 
164 int ocfs2_rename_lock(struct ocfs2_super *osb);
165 void ocfs2_rename_unlock(struct ocfs2_super *osb);
166 int ocfs2_nfs_sync_lock(struct ocfs2_super *osb, int ex);
167 void ocfs2_nfs_sync_unlock(struct ocfs2_super *osb, int ex);
168 void ocfs2_trim_fs_lock_res_init(struct ocfs2_super *osb);
169 void ocfs2_trim_fs_lock_res_uninit(struct ocfs2_super *osb);
170 int ocfs2_trim_fs_lock(struct ocfs2_super *osb,
171 		       struct ocfs2_trim_fs_info *info, int trylock);
172 void ocfs2_trim_fs_unlock(struct ocfs2_super *osb,
173 			  struct ocfs2_trim_fs_info *info);
174 int ocfs2_dentry_lock(struct dentry *dentry, int ex);
175 void ocfs2_dentry_unlock(struct dentry *dentry, int ex);
176 int ocfs2_file_lock(struct file *file, int ex, int trylock);
177 void ocfs2_file_unlock(struct file *file);
178 int ocfs2_qinfo_lock(struct ocfs2_mem_dqinfo *oinfo, int ex);
179 void ocfs2_qinfo_unlock(struct ocfs2_mem_dqinfo *oinfo, int ex);
180 struct ocfs2_refcount_tree;
181 int ocfs2_refcount_lock(struct ocfs2_refcount_tree *ref_tree, int ex);
182 void ocfs2_refcount_unlock(struct ocfs2_refcount_tree *ref_tree, int ex);
183 
184 
185 void ocfs2_mark_lockres_freeing(struct ocfs2_super *osb,
186 				struct ocfs2_lock_res *lockres);
187 void ocfs2_simple_drop_lockres(struct ocfs2_super *osb,
188 			       struct ocfs2_lock_res *lockres);
189 
190 /* for the downconvert thread */
191 void ocfs2_wake_downconvert_thread(struct ocfs2_super *osb);
192 
193 struct ocfs2_dlm_debug *ocfs2_new_dlm_debug(void);
194 void ocfs2_put_dlm_debug(struct ocfs2_dlm_debug *dlm_debug);
195 
196 /* To set the locking protocol on module initialization */
197 void ocfs2_set_locking_protocol(void);
198 
199 /* The _tracker pair is used to avoid cluster recursive locking */
200 int ocfs2_inode_lock_tracker(struct inode *inode,
201 			     struct buffer_head **ret_bh,
202 			     int ex,
203 			     struct ocfs2_lock_holder *oh);
204 void ocfs2_inode_unlock_tracker(struct inode *inode,
205 				int ex,
206 				struct ocfs2_lock_holder *oh,
207 				int had_lock);
208 
209 #endif	/* DLMGLUE_H */
210