xref: /linux/fs/ocfs2/dlmglue.h (revision 49e1900d4cc2e7bcecb681fe60f0990bec2dcce8)
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 4
33 
34 struct ocfs2_meta_lvb {
35 	__u8         lvb_version;
36 	__u8         lvb_reserved0;
37 	__be16       lvb_reserved1;
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 /* ocfs2_meta_lock_full() and ocfs2_data_lock_full() 'arg_flags' flags */
53 /* don't wait on recovery. */
54 #define OCFS2_META_LOCK_RECOVERY	(0x01)
55 /* Instruct the dlm not to queue ourselves on the other node. */
56 #define OCFS2_META_LOCK_NOQUEUE		(0x02)
57 /* don't block waiting for the vote thread, instead return -EAGAIN */
58 #define OCFS2_LOCK_NONBLOCK		(0x04)
59 
60 int ocfs2_dlm_init(struct ocfs2_super *osb);
61 void ocfs2_dlm_shutdown(struct ocfs2_super *osb);
62 void ocfs2_lock_res_init_once(struct ocfs2_lock_res *res);
63 void ocfs2_inode_lock_res_init(struct ocfs2_lock_res *res,
64 			       enum ocfs2_lock_type type,
65 			       unsigned int generation,
66 			       struct inode *inode);
67 void ocfs2_dentry_lock_res_init(struct ocfs2_dentry_lock *dl,
68 				u64 parent, struct inode *inode);
69 void ocfs2_lock_res_free(struct ocfs2_lock_res *res);
70 int ocfs2_create_new_inode_locks(struct inode *inode);
71 int ocfs2_drop_inode_locks(struct inode *inode);
72 int ocfs2_data_lock_full(struct inode *inode,
73 			 int write,
74 			 int arg_flags);
75 #define ocfs2_data_lock(inode, write) ocfs2_data_lock_full(inode, write, 0)
76 int ocfs2_data_lock_with_page(struct inode *inode,
77 			      int write,
78 			      struct page *page);
79 void ocfs2_data_unlock(struct inode *inode,
80 		       int write);
81 int ocfs2_rw_lock(struct inode *inode, int write);
82 void ocfs2_rw_unlock(struct inode *inode, int write);
83 int ocfs2_open_lock(struct inode *inode);
84 int ocfs2_try_open_lock(struct inode *inode, int write);
85 void ocfs2_open_unlock(struct inode *inode);
86 int ocfs2_meta_lock_atime(struct inode *inode,
87 			  struct vfsmount *vfsmnt,
88 			  int *level);
89 int ocfs2_meta_lock_full(struct inode *inode,
90 			 struct buffer_head **ret_bh,
91 			 int ex,
92 			 int arg_flags);
93 int ocfs2_meta_lock_with_page(struct inode *inode,
94 			      struct buffer_head **ret_bh,
95 			      int ex,
96 			      struct page *page);
97 /* 99% of the time we don't want to supply any additional flags --
98  * those are for very specific cases only. */
99 #define ocfs2_meta_lock(i, b, e) ocfs2_meta_lock_full(i, b, e, 0)
100 void ocfs2_meta_unlock(struct inode *inode,
101 		       int ex);
102 int ocfs2_super_lock(struct ocfs2_super *osb,
103 		     int ex);
104 void ocfs2_super_unlock(struct ocfs2_super *osb,
105 			int ex);
106 int ocfs2_rename_lock(struct ocfs2_super *osb);
107 void ocfs2_rename_unlock(struct ocfs2_super *osb);
108 int ocfs2_dentry_lock(struct dentry *dentry, int ex);
109 void ocfs2_dentry_unlock(struct dentry *dentry, int ex);
110 
111 void ocfs2_mark_lockres_freeing(struct ocfs2_lock_res *lockres);
112 void ocfs2_simple_drop_lockres(struct ocfs2_super *osb,
113 			       struct ocfs2_lock_res *lockres);
114 
115 /* for the vote thread */
116 void ocfs2_process_blocked_lock(struct ocfs2_super *osb,
117 				struct ocfs2_lock_res *lockres);
118 
119 struct ocfs2_dlm_debug *ocfs2_new_dlm_debug(void);
120 void ocfs2_put_dlm_debug(struct ocfs2_dlm_debug *dlm_debug);
121 
122 /* aids in debugging and tracking lvbs */
123 void ocfs2_dump_meta_lvb_info(u64 level,
124 			      const char *function,
125 			      unsigned int line,
126 			      struct ocfs2_lock_res *lockres);
127 #define mlog_meta_lvb(__level, __lockres) ocfs2_dump_meta_lvb_info(__level, __PRETTY_FUNCTION__, __LINE__, __lockres)
128 
129 #endif	/* DLMGLUE_H */
130