xref: /linux/fs/ocfs2/inode.h (revision aa23aa55166c2865ac430168c4b9d405cf8c6980)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /* -*- mode: c; c-basic-offset: 8; -*-
3  * vim: noexpandtab sw=8 ts=8 sts=0:
4  *
5  * inode.h
6  *
7  * Function prototypes
8  *
9  * Copyright (C) 2002, 2004 Oracle.  All rights reserved.
10  */
11 
12 #ifndef OCFS2_INODE_H
13 #define OCFS2_INODE_H
14 
15 #include "extent_map.h"
16 
17 /* OCFS2 Inode Private Data */
18 struct ocfs2_inode_info
19 {
20 	u64			ip_blkno;
21 
22 	struct ocfs2_lock_res		ip_rw_lockres;
23 	struct ocfs2_lock_res		ip_inode_lockres;
24 	struct ocfs2_lock_res		ip_open_lockres;
25 
26 	/* protects allocation changes on this inode. */
27 	struct rw_semaphore		ip_alloc_sem;
28 
29 	/* protects extended attribute changes on this inode */
30 	struct rw_semaphore		ip_xattr_sem;
31 
32 	/* These fields are protected by ip_lock */
33 	spinlock_t			ip_lock;
34 	u32				ip_open_count;
35 	struct list_head		ip_io_markers;
36 	u32				ip_clusters;
37 
38 	u16				ip_dyn_features;
39 	struct mutex			ip_io_mutex;
40 	u32				ip_flags; /* see below */
41 	u32				ip_attr; /* inode attributes */
42 
43 	/* Record unwritten extents during direct io. */
44 	struct list_head		ip_unwritten_list;
45 
46 	/* protected by recovery_lock. */
47 	struct inode			*ip_next_orphan;
48 
49 	struct ocfs2_caching_info	ip_metadata_cache;
50 	struct ocfs2_extent_map		ip_extent_map;
51 	struct inode			vfs_inode;
52 	struct jbd2_inode		ip_jinode;
53 
54 	u32				ip_dir_start_lookup;
55 
56 	/* Only valid if the inode is the dir. */
57 	u32				ip_last_used_slot;
58 	u64				ip_last_used_group;
59 	u32				ip_dir_lock_gen;
60 
61 	struct ocfs2_alloc_reservation	ip_la_data_resv;
62 
63 	/*
64 	 * Transactions that contain inode's metadata needed to complete
65 	 * fsync and fdatasync, respectively.
66 	 */
67 	tid_t i_sync_tid;
68 	tid_t i_datasync_tid;
69 
70 	struct dquot *i_dquot[MAXQUOTAS];
71 };
72 
73 /*
74  * Flags for the ip_flags field
75  */
76 /* System file inodes  */
77 #define OCFS2_INODE_SYSTEM_FILE		0x00000001
78 #define OCFS2_INODE_JOURNAL		0x00000002
79 #define OCFS2_INODE_BITMAP		0x00000004
80 /* This inode has been wiped from disk */
81 #define OCFS2_INODE_DELETED		0x00000008
82 /* Has the inode been orphaned on another node?
83  *
84  * This hints to ocfs2_drop_inode that it should clear i_nlink before
85  * continuing.
86  *
87  * We *only* set this on unlink vote from another node. If the inode
88  * was locally orphaned, then we're sure of the state and don't need
89  * to twiddle i_nlink later - it's either zero or not depending on
90  * whether our unlink succeeded. Otherwise we got this from a node
91  * whose intention was to orphan the inode, however he may have
92  * crashed, failed etc, so we let ocfs2_drop_inode zero the value and
93  * rely on ocfs2_delete_inode to sort things out under the proper
94  * cluster locks.
95  */
96 #define OCFS2_INODE_MAYBE_ORPHANED	0x00000010
97 /* Does someone have the file open O_DIRECT */
98 #define OCFS2_INODE_OPEN_DIRECT		0x00000020
99 /* Tell the inode wipe code it's not in orphan dir */
100 #define OCFS2_INODE_SKIP_ORPHAN_DIR     0x00000040
101 /* Entry in orphan dir with 'dio-' prefix */
102 #define OCFS2_INODE_DIO_ORPHAN_ENTRY	0x00000080
103 
104 static inline struct ocfs2_inode_info *OCFS2_I(struct inode *inode)
105 {
106 	return container_of(inode, struct ocfs2_inode_info, vfs_inode);
107 }
108 
109 #define INODE_JOURNAL(i) (OCFS2_I(i)->ip_flags & OCFS2_INODE_JOURNAL)
110 #define SET_INODE_JOURNAL(i) (OCFS2_I(i)->ip_flags |= OCFS2_INODE_JOURNAL)
111 
112 extern const struct address_space_operations ocfs2_aops;
113 extern const struct ocfs2_caching_operations ocfs2_inode_caching_ops;
114 
115 static inline struct ocfs2_caching_info *INODE_CACHE(struct inode *inode)
116 {
117 	return &OCFS2_I(inode)->ip_metadata_cache;
118 }
119 
120 void ocfs2_evict_inode(struct inode *inode);
121 int ocfs2_drop_inode(struct inode *inode);
122 
123 /* Flags for ocfs2_iget() */
124 #define OCFS2_FI_FLAG_SYSFILE		0x1
125 #define OCFS2_FI_FLAG_ORPHAN_RECOVERY	0x2
126 #define OCFS2_FI_FLAG_FILECHECK_CHK	0x4
127 #define OCFS2_FI_FLAG_FILECHECK_FIX	0x8
128 
129 struct inode *ocfs2_ilookup(struct super_block *sb, u64 feoff);
130 struct inode *ocfs2_iget(struct ocfs2_super *osb, u64 feoff, unsigned flags,
131 			 int sysfile_type);
132 int ocfs2_inode_revalidate(struct dentry *dentry);
133 void ocfs2_populate_inode(struct inode *inode, struct ocfs2_dinode *fe,
134 			  int create_ino);
135 void ocfs2_sync_blockdev(struct super_block *sb);
136 void ocfs2_refresh_inode(struct inode *inode,
137 			 struct ocfs2_dinode *fe);
138 int ocfs2_mark_inode_dirty(handle_t *handle,
139 			   struct inode *inode,
140 			   struct buffer_head *bh);
141 
142 void ocfs2_set_inode_flags(struct inode *inode);
143 void ocfs2_get_inode_flags(struct ocfs2_inode_info *oi);
144 
145 static inline blkcnt_t ocfs2_inode_sector_count(struct inode *inode)
146 {
147 	int c_to_s_bits = OCFS2_SB(inode->i_sb)->s_clustersize_bits - 9;
148 
149 	return (blkcnt_t)OCFS2_I(inode)->ip_clusters << c_to_s_bits;
150 }
151 
152 /* Validate that a bh contains a valid inode */
153 int ocfs2_validate_inode_block(struct super_block *sb,
154 			       struct buffer_head *bh);
155 /*
156  * Read an inode block into *bh.  If *bh is NULL, a bh will be allocated.
157  * This is a cached read.  The inode will be validated with
158  * ocfs2_validate_inode_block().
159  */
160 int ocfs2_read_inode_block(struct inode *inode, struct buffer_head **bh);
161 /* The same, but can be passed OCFS2_BH_* flags */
162 int ocfs2_read_inode_block_full(struct inode *inode, struct buffer_head **bh,
163 				int flags);
164 
165 static inline struct ocfs2_inode_info *cache_info_to_inode(struct ocfs2_caching_info *ci)
166 {
167 	return container_of(ci, struct ocfs2_inode_info, ip_metadata_cache);
168 }
169 
170 /* Does this inode have the reflink flag set? */
171 static inline bool ocfs2_is_refcount_inode(struct inode *inode)
172 {
173 	return (OCFS2_I(inode)->ip_dyn_features & OCFS2_HAS_REFCOUNT_FL);
174 }
175 
176 #endif /* OCFS2_INODE_H */
177