[PATCH] OCFS2: The Second Oracle Cluster Filesystem
[linux-2.6.git] / fs / ocfs2 / dlmglue.h
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 #define OCFS2_LVB_VERSION 2
31
32 struct ocfs2_meta_lvb {
33         __be32       lvb_version;
34         __be32       lvb_iclusters;
35         __be32       lvb_iuid;
36         __be32       lvb_igid;
37         __be64       lvb_iatime_packed;
38         __be64       lvb_ictime_packed;
39         __be64       lvb_imtime_packed;
40         __be64       lvb_isize;
41         __be16       lvb_imode;
42         __be16       lvb_inlink;
43         __be32       lvb_reserved[3];
44 };
45
46 /* ocfs2_meta_lock_full() and ocfs2_data_lock_full() 'arg_flags' flags */
47 /* don't wait on recovery. */
48 #define OCFS2_META_LOCK_RECOVERY        (0x01)
49 /* Instruct the dlm not to queue ourselves on the other node. */
50 #define OCFS2_META_LOCK_NOQUEUE         (0x02)
51 /* don't block waiting for the vote thread, instead return -EAGAIN */
52 #define OCFS2_LOCK_NONBLOCK             (0x04)
53
54 int ocfs2_dlm_init(struct ocfs2_super *osb);
55 void ocfs2_dlm_shutdown(struct ocfs2_super *osb);
56 void ocfs2_lock_res_init_once(struct ocfs2_lock_res *res);
57 void ocfs2_inode_lock_res_init(struct ocfs2_lock_res *res,
58                                enum ocfs2_lock_type type,
59                                struct inode *inode);
60 void ocfs2_lock_res_free(struct ocfs2_lock_res *res);
61 int ocfs2_create_new_inode_locks(struct inode *inode);
62 int ocfs2_drop_inode_locks(struct inode *inode);
63 int ocfs2_data_lock_full(struct inode *inode,
64                          int write,
65                          int arg_flags);
66 #define ocfs2_data_lock(inode, write) ocfs2_data_lock_full(inode, write, 0)
67 int ocfs2_data_lock_with_page(struct inode *inode,
68                               int write,
69                               struct page *page);
70 void ocfs2_data_unlock(struct inode *inode,
71                        int write);
72 int ocfs2_rw_lock(struct inode *inode, int write);
73 void ocfs2_rw_unlock(struct inode *inode, int write);
74 int ocfs2_meta_lock_full(struct inode *inode,
75                          struct ocfs2_journal_handle *handle,
76                          struct buffer_head **ret_bh,
77                          int ex,
78                          int arg_flags);
79 int ocfs2_meta_lock_with_page(struct inode *inode,
80                               struct ocfs2_journal_handle *handle,
81                               struct buffer_head **ret_bh,
82                               int ex,
83                               struct page *page);
84 /* 99% of the time we don't want to supply any additional flags --
85  * those are for very specific cases only. */
86 #define ocfs2_meta_lock(i, h, b, e) ocfs2_meta_lock_full(i, h, b, e, 0)
87 void ocfs2_meta_unlock(struct inode *inode,
88                        int ex);
89 int ocfs2_super_lock(struct ocfs2_super *osb,
90                      int ex);
91 void ocfs2_super_unlock(struct ocfs2_super *osb,
92                         int ex);
93 int ocfs2_rename_lock(struct ocfs2_super *osb);
94 void ocfs2_rename_unlock(struct ocfs2_super *osb);
95 void ocfs2_mark_lockres_freeing(struct ocfs2_lock_res *lockres);
96
97 /* for the vote thread */
98 void ocfs2_process_blocked_lock(struct ocfs2_super *osb,
99                                 struct ocfs2_lock_res *lockres);
100
101 struct ocfs2_dlm_debug *ocfs2_new_dlm_debug(void);
102 void ocfs2_put_dlm_debug(struct ocfs2_dlm_debug *dlm_debug);
103
104 /* aids in debugging and tracking lvbs */
105 void ocfs2_dump_meta_lvb_info(u64 level,
106                               const char *function,
107                               unsigned int line,
108                               struct ocfs2_lock_res *lockres);
109 #define mlog_meta_lvb(__level, __lockres) ocfs2_dump_meta_lvb_info(__level, __PRETTY_FUNCTION__, __LINE__, __lockres)
110
111 #endif  /* DLMGLUE_H */