blob: e5da5809ed95bac2d58ff2fd81bc448eb6a552fc [file] [log] [blame]
Thomas Gleixner328970d2019-05-24 12:04:05 +02001/* SPDX-License-Identifier: GPL-2.0-or-later */
Masahiro Yamadafa60ce22021-05-06 18:06:44 -07002/*
Mark Fashehccd979b2005-12-15 14:31:24 -08003 * dlmglue.h
4 *
5 * description here
6 *
7 * Copyright (C) 2002, 2004 Oracle. All rights reserved.
Mark Fashehccd979b2005-12-15 14:31:24 -08008 */
9
10
11#ifndef DLMGLUE_H
12#define DLMGLUE_H
13
Mark Fashehd680efe2006-09-08 14:14:34 -070014#include "dcache.h"
15
Mark Fasheh15b1e362007-09-07 13:58:15 -070016#define OCFS2_LVB_VERSION 5
Mark Fashehccd979b2005-12-15 14:31:24 -080017
18struct ocfs2_meta_lvb {
Mark Fasheh4d3b83f2006-09-12 15:22:18 -070019 __u8 lvb_version;
Mark Fasheh24c19ef2006-09-22 17:28:19 -070020 __u8 lvb_reserved0;
Mark Fasheh15b1e362007-09-07 13:58:15 -070021 __be16 lvb_idynfeatures;
Mark Fashehccd979b2005-12-15 14:31:24 -080022 __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;
Herbert Poetzlca4d1472006-07-03 17:27:12 -070031 __be32 lvb_iattr;
Mark Fashehf9e2d822006-09-12 15:35:49 -070032 __be32 lvb_igeneration;
33 __be32 lvb_reserved2;
Mark Fashehccd979b2005-12-15 14:31:24 -080034};
35
Jan Kara9e33d692008-08-25 19:56:50 +020036#define OCFS2_QINFO_LVB_VERSION 1
37
38struct 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
Srinivas Eeda83273932009-06-03 17:02:55 -070049#define OCFS2_ORPHAN_LVB_VERSION 1
50
51struct ocfs2_orphan_scan_lvb {
52 __u8 lvb_version;
53 __u8 lvb_reserved[3];
54 __be32 lvb_os_seqno;
55};
56
Gang He4882abe2018-01-31 16:15:10 -080057#define OCFS2_TRIMFS_LVB_VERSION 1
58
59struct 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
70struct 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
Eric Ren439a36b2017-02-22 15:40:41 -080080struct ocfs2_lock_holder {
81 struct list_head oh_list;
82 struct pid *oh_owner_pid;
Larry Chen133b81f2018-06-07 17:04:43 -070083 int oh_ex;
Eric Ren439a36b2017-02-22 15:40:41 -080084};
85
Mark Fashehe63aecb62007-10-18 15:30:42 -070086/* ocfs2_inode_lock_full() 'arg_flags' flags */
Mark Fashehccd979b2005-12-15 14:31:24 -080087/* 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)
Mark Fasheh34d024f2007-09-24 15:56:19 -070091/* don't block waiting for the downconvert thread, instead return -EAGAIN */
Mark Fashehccd979b2005-12-15 14:31:24 -080092#define OCFS2_LOCK_NONBLOCK (0x04)
Eric Ren439a36b2017-02-22 15:40:41 -080093/* just get back disk inode bh if we've got cluster lock. */
94#define OCFS2_META_LOCK_GETBH (0x08)
Mark Fashehccd979b2005-12-15 14:31:24 -080095
Jan Karacb257972009-06-04 15:26:50 +020096/* Locking subclasses of inode cluster lock */
97enum {
98 OI_LS_NORMAL = 0,
99 OI_LS_PARENT,
100 OI_LS_RENAME1,
101 OI_LS_RENAME2,
Tao Ma07eaac92010-09-07 13:30:06 +0800102 OI_LS_REFLINK_TARGET,
Jan Karacb257972009-06-04 15:26:50 +0200103};
104
Mark Fashehccd979b2005-12-15 14:31:24 -0800105int ocfs2_dlm_init(struct ocfs2_super *osb);
Joel Becker286eaa92008-02-01 15:03:57 -0800106void ocfs2_dlm_shutdown(struct ocfs2_super *osb, int hangup_pending);
Mark Fashehccd979b2005-12-15 14:31:24 -0800107void ocfs2_lock_res_init_once(struct ocfs2_lock_res *res);
108void ocfs2_inode_lock_res_init(struct ocfs2_lock_res *res,
109 enum ocfs2_lock_type type,
Mark Fasheh24c19ef2006-09-22 17:28:19 -0700110 unsigned int generation,
Mark Fashehccd979b2005-12-15 14:31:24 -0800111 struct inode *inode);
Mark Fashehd680efe2006-09-08 14:14:34 -0700112void ocfs2_dentry_lock_res_init(struct ocfs2_dentry_lock *dl,
113 u64 parent, struct inode *inode);
Mark Fashehcf8e06f2007-12-20 16:43:10 -0800114struct ocfs2_file_private;
115void ocfs2_file_lock_res_init(struct ocfs2_lock_res *lockres,
116 struct ocfs2_file_private *fp);
Jan Kara9e33d692008-08-25 19:56:50 +0200117struct ocfs2_mem_dqinfo;
118void ocfs2_qinfo_lock_res_init(struct ocfs2_lock_res *lockres,
119 struct ocfs2_mem_dqinfo *info);
Tao Ma8dec98e2009-08-18 11:19:58 +0800120void ocfs2_refcount_lock_res_init(struct ocfs2_lock_res *lockres,
121 struct ocfs2_super *osb, u64 ref_blkno,
122 unsigned int generation);
Mark Fashehccd979b2005-12-15 14:31:24 -0800123void ocfs2_lock_res_free(struct ocfs2_lock_res *res);
124int ocfs2_create_new_inode_locks(struct inode *inode);
125int ocfs2_drop_inode_locks(struct inode *inode);
Mark Fashehccd979b2005-12-15 14:31:24 -0800126int ocfs2_rw_lock(struct inode *inode, int write);
Gang He06e7f132018-01-31 16:15:17 -0800127int ocfs2_try_rw_lock(struct inode *inode, int write);
Mark Fashehccd979b2005-12-15 14:31:24 -0800128void ocfs2_rw_unlock(struct inode *inode, int write);
Tiger Yang50008632007-03-20 16:01:38 -0700129int ocfs2_open_lock(struct inode *inode);
130int ocfs2_try_open_lock(struct inode *inode, int write);
131void ocfs2_open_unlock(struct inode *inode);
Mark Fashehe63aecb62007-10-18 15:30:42 -0700132int ocfs2_inode_lock_atime(struct inode *inode,
Tiger Yang7f1a37e2006-11-15 15:48:42 +0800133 struct vfsmount *vfsmnt,
Gang Hec4c24162018-01-31 16:15:25 -0800134 int *level, int wait);
Jan Karacb257972009-06-04 15:26:50 +0200135int ocfs2_inode_lock_full_nested(struct inode *inode,
Mark Fashehccd979b2005-12-15 14:31:24 -0800136 struct buffer_head **ret_bh,
137 int ex,
Jan Karacb257972009-06-04 15:26:50 +0200138 int arg_flags,
139 int subclass);
Mark Fashehe63aecb62007-10-18 15:30:42 -0700140int ocfs2_inode_lock_with_page(struct inode *inode,
Mark Fashehccd979b2005-12-15 14:31:24 -0800141 struct buffer_head **ret_bh,
142 int ex,
143 struct page *page);
Jan Karacb257972009-06-04 15:26:50 +0200144/* 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)
Mark Fashehccd979b2005-12-15 14:31:24 -0800149/* 99% of the time we don't want to supply any additional flags --
150 * those are for very specific cases only. */
Jan Karacb257972009-06-04 15:26:50 +0200151#define ocfs2_inode_lock(i, b, e) ocfs2_inode_lock_full_nested(i, b, e, 0, OI_LS_NORMAL)
Gang He06e7f132018-01-31 16:15:17 -0800152#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)
Mark Fashehe63aecb62007-10-18 15:30:42 -0700155void ocfs2_inode_unlock(struct inode *inode,
Mark Fashehccd979b2005-12-15 14:31:24 -0800156 int ex);
157int ocfs2_super_lock(struct ocfs2_super *osb,
158 int ex);
159void ocfs2_super_unlock(struct ocfs2_super *osb,
160 int ex);
Sunil Mushrandf152c242009-06-22 11:40:07 -0700161int ocfs2_orphan_scan_lock(struct ocfs2_super *osb, u32 *seqno);
162void ocfs2_orphan_scan_unlock(struct ocfs2_super *osb, u32 seqno);
Srinivas Eeda83273932009-06-03 17:02:55 -0700163
Mark Fashehccd979b2005-12-15 14:31:24 -0800164int ocfs2_rename_lock(struct ocfs2_super *osb);
165void ocfs2_rename_unlock(struct ocfs2_super *osb);
wengang wang6ca497a2009-03-06 21:29:10 +0800166int ocfs2_nfs_sync_lock(struct ocfs2_super *osb, int ex);
167void ocfs2_nfs_sync_unlock(struct ocfs2_super *osb, int ex);
Gang He4882abe2018-01-31 16:15:10 -0800168void ocfs2_trim_fs_lock_res_init(struct ocfs2_super *osb);
169void ocfs2_trim_fs_lock_res_uninit(struct ocfs2_super *osb);
170int ocfs2_trim_fs_lock(struct ocfs2_super *osb,
171 struct ocfs2_trim_fs_info *info, int trylock);
172void ocfs2_trim_fs_unlock(struct ocfs2_super *osb,
173 struct ocfs2_trim_fs_info *info);
Mark Fashehd680efe2006-09-08 14:14:34 -0700174int ocfs2_dentry_lock(struct dentry *dentry, int ex);
175void ocfs2_dentry_unlock(struct dentry *dentry, int ex);
Mark Fashehcf8e06f2007-12-20 16:43:10 -0800176int ocfs2_file_lock(struct file *file, int ex, int trylock);
177void ocfs2_file_unlock(struct file *file);
Jan Kara9e33d692008-08-25 19:56:50 +0200178int ocfs2_qinfo_lock(struct ocfs2_mem_dqinfo *oinfo, int ex);
179void ocfs2_qinfo_unlock(struct ocfs2_mem_dqinfo *oinfo, int ex);
Tao Ma8dec98e2009-08-18 11:19:58 +0800180struct ocfs2_refcount_tree;
181int ocfs2_refcount_lock(struct ocfs2_refcount_tree *ref_tree, int ex);
182void ocfs2_refcount_unlock(struct ocfs2_refcount_tree *ref_tree, int ex);
Jan Kara9e33d692008-08-25 19:56:50 +0200183
Mark Fashehd680efe2006-09-08 14:14:34 -0700184
Jan Kara84d86f82014-04-03 14:46:57 -0700185void ocfs2_mark_lockres_freeing(struct ocfs2_super *osb,
186 struct ocfs2_lock_res *lockres);
Mark Fashehd680efe2006-09-08 14:14:34 -0700187void ocfs2_simple_drop_lockres(struct ocfs2_super *osb,
188 struct ocfs2_lock_res *lockres);
Mark Fashehccd979b2005-12-15 14:31:24 -0800189
Mark Fasheh34d024f2007-09-24 15:56:19 -0700190/* for the downconvert thread */
Mark Fasheh34d024f2007-09-24 15:56:19 -0700191void ocfs2_wake_downconvert_thread(struct ocfs2_super *osb);
Mark Fashehccd979b2005-12-15 14:31:24 -0800192
193struct ocfs2_dlm_debug *ocfs2_new_dlm_debug(void);
194void ocfs2_put_dlm_debug(struct ocfs2_dlm_debug *dlm_debug);
195
Joel Becker63e0c482008-01-30 16:58:36 -0800196/* To set the locking protocol on module initialization */
197void ocfs2_set_locking_protocol(void);
Eric Ren439a36b2017-02-22 15:40:41 -0800198
199/* The _tracker pair is used to avoid cluster recursive locking */
200int ocfs2_inode_lock_tracker(struct inode *inode,
201 struct buffer_head **ret_bh,
202 int ex,
203 struct ocfs2_lock_holder *oh);
204void ocfs2_inode_unlock_tracker(struct inode *inode,
205 int ex,
206 struct ocfs2_lock_holder *oh,
207 int had_lock);
208
Mark Fashehccd979b2005-12-15 14:31:24 -0800209#endif /* DLMGLUE_H */