xref: /openbmc/linux/fs/xfs/libxfs/xfs_types.h (revision f21e49be)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * Copyright (c) 2000-2005 Silicon Graphics, Inc.
4  * All Rights Reserved.
5  */
6 #ifndef __XFS_TYPES_H__
7 #define	__XFS_TYPES_H__
8 
9 typedef uint32_t	prid_t;		/* project ID */
10 
11 typedef uint32_t	xfs_agblock_t;	/* blockno in alloc. group */
12 typedef uint32_t	xfs_agino_t;	/* inode # within allocation grp */
13 typedef uint32_t	xfs_extlen_t;	/* extent length in blocks */
14 typedef uint32_t	xfs_agnumber_t;	/* allocation group number */
15 typedef int32_t		xfs_extnum_t;	/* # of extents in a file */
16 typedef int16_t		xfs_aextnum_t;	/* # extents in an attribute fork */
17 typedef int64_t		xfs_fsize_t;	/* bytes in a file */
18 typedef uint64_t	xfs_ufsize_t;	/* unsigned bytes in a file */
19 
20 typedef int32_t		xfs_suminfo_t;	/* type of bitmap summary info */
21 typedef uint32_t	xfs_rtword_t;	/* word type for bitmap manipulations */
22 
23 typedef int64_t		xfs_lsn_t;	/* log sequence number */
24 typedef int64_t		xfs_csn_t;	/* CIL sequence number */
25 
26 typedef uint32_t	xfs_dablk_t;	/* dir/attr block number (in file) */
27 typedef uint32_t	xfs_dahash_t;	/* dir/attr hash value */
28 
29 typedef uint64_t	xfs_fsblock_t;	/* blockno in filesystem (agno|agbno) */
30 typedef uint64_t	xfs_rfsblock_t;	/* blockno in filesystem (raw) */
31 typedef uint64_t	xfs_rtblock_t;	/* extent (block) in realtime area */
32 typedef uint64_t	xfs_fileoff_t;	/* block number in a file */
33 typedef uint64_t	xfs_filblks_t;	/* number of blocks in a file */
34 
35 typedef int64_t		xfs_srtblock_t;	/* signed version of xfs_rtblock_t */
36 
37 /*
38  * New verifiers will return the instruction address of the failing check.
39  * NULL means everything is ok.
40  */
41 typedef void *		xfs_failaddr_t;
42 
43 /*
44  * Null values for the types.
45  */
46 #define	NULLFSBLOCK	((xfs_fsblock_t)-1)
47 #define	NULLRFSBLOCK	((xfs_rfsblock_t)-1)
48 #define	NULLRTBLOCK	((xfs_rtblock_t)-1)
49 #define	NULLFILEOFF	((xfs_fileoff_t)-1)
50 
51 #define	NULLAGBLOCK	((xfs_agblock_t)-1)
52 #define	NULLAGNUMBER	((xfs_agnumber_t)-1)
53 
54 #define NULLCOMMITLSN	((xfs_lsn_t)-1)
55 
56 #define	NULLFSINO	((xfs_ino_t)-1)
57 #define	NULLAGINO	((xfs_agino_t)-1)
58 
59 /*
60  * Max values for extlen, extnum, aextnum.
61  */
62 #define	MAXEXTLEN	((xfs_extlen_t)0x001fffff)	/* 21 bits */
63 #define	MAXEXTNUM	((xfs_extnum_t)0x7fffffff)	/* signed int */
64 #define	MAXAEXTNUM	((xfs_aextnum_t)0x7fff)		/* signed short */
65 
66 /*
67  * Minimum and maximum blocksize and sectorsize.
68  * The blocksize upper limit is pretty much arbitrary.
69  * The sectorsize upper limit is due to sizeof(sb_sectsize).
70  * CRC enable filesystems use 512 byte inodes, meaning 512 byte block sizes
71  * cannot be used.
72  */
73 #define XFS_MIN_BLOCKSIZE_LOG	9	/* i.e. 512 bytes */
74 #define XFS_MAX_BLOCKSIZE_LOG	16	/* i.e. 65536 bytes */
75 #define XFS_MIN_BLOCKSIZE	(1 << XFS_MIN_BLOCKSIZE_LOG)
76 #define XFS_MAX_BLOCKSIZE	(1 << XFS_MAX_BLOCKSIZE_LOG)
77 #define XFS_MIN_CRC_BLOCKSIZE	(1 << (XFS_MIN_BLOCKSIZE_LOG + 1))
78 #define XFS_MIN_SECTORSIZE_LOG	9	/* i.e. 512 bytes */
79 #define XFS_MAX_SECTORSIZE_LOG	15	/* i.e. 32768 bytes */
80 #define XFS_MIN_SECTORSIZE	(1 << XFS_MIN_SECTORSIZE_LOG)
81 #define XFS_MAX_SECTORSIZE	(1 << XFS_MAX_SECTORSIZE_LOG)
82 
83 /*
84  * Inode fork identifiers.
85  */
86 #define	XFS_DATA_FORK	0
87 #define	XFS_ATTR_FORK	1
88 #define	XFS_COW_FORK	2
89 
90 #define XFS_WHICHFORK_STRINGS \
91 	{ XFS_DATA_FORK, 	"data" }, \
92 	{ XFS_ATTR_FORK,	"attr" }, \
93 	{ XFS_COW_FORK,		"cow" }
94 
95 /*
96  * Min numbers of data/attr fork btree root pointers.
97  */
98 #define MINDBTPTRS	3
99 #define MINABTPTRS	2
100 
101 /*
102  * MAXNAMELEN is the length (including the terminating null) of
103  * the longest permissible file (component) name.
104  */
105 #define MAXNAMELEN	256
106 
107 /*
108  * This enum is used in string mapping in xfs_trace.h; please keep the
109  * TRACE_DEFINE_ENUMs for it up to date.
110  */
111 typedef enum {
112 	XFS_LOOKUP_EQi, XFS_LOOKUP_LEi, XFS_LOOKUP_GEi
113 } xfs_lookup_t;
114 
115 #define XFS_AG_BTREE_CMP_FORMAT_STR \
116 	{ XFS_LOOKUP_EQi,	"eq" }, \
117 	{ XFS_LOOKUP_LEi,	"le" }, \
118 	{ XFS_LOOKUP_GEi,	"ge" }
119 
120 /*
121  * This enum is used in string mapping in xfs_trace.h and scrub/trace.h;
122  * please keep the TRACE_DEFINE_ENUMs for it up to date.
123  */
124 typedef enum {
125 	XFS_BTNUM_BNOi, XFS_BTNUM_CNTi, XFS_BTNUM_RMAPi, XFS_BTNUM_BMAPi,
126 	XFS_BTNUM_INOi, XFS_BTNUM_FINOi, XFS_BTNUM_REFCi, XFS_BTNUM_MAX
127 } xfs_btnum_t;
128 
129 #define XFS_BTNUM_STRINGS \
130 	{ XFS_BTNUM_BNOi,	"bnobt" }, \
131 	{ XFS_BTNUM_CNTi,	"cntbt" }, \
132 	{ XFS_BTNUM_RMAPi,	"rmapbt" }, \
133 	{ XFS_BTNUM_BMAPi,	"bmbt" }, \
134 	{ XFS_BTNUM_INOi,	"inobt" }, \
135 	{ XFS_BTNUM_FINOi,	"finobt" }, \
136 	{ XFS_BTNUM_REFCi,	"refcbt" }
137 
138 struct xfs_name {
139 	const unsigned char	*name;
140 	int			len;
141 	int			type;
142 };
143 
144 /*
145  * uid_t and gid_t are hard-coded to 32 bits in the inode.
146  * Hence, an 'id' in a dquot is 32 bits..
147  */
148 typedef uint32_t	xfs_dqid_t;
149 
150 /*
151  * Constants for bit manipulations.
152  */
153 #define	XFS_NBBYLOG	3		/* log2(NBBY) */
154 #define	XFS_WORDLOG	2		/* log2(sizeof(xfs_rtword_t)) */
155 #define	XFS_NBWORDLOG	(XFS_NBBYLOG + XFS_WORDLOG)
156 #define	XFS_NBWORD	(1 << XFS_NBWORDLOG)
157 #define	XFS_WORDMASK	((1 << XFS_WORDLOG) - 1)
158 
159 struct xfs_iext_cursor {
160 	struct xfs_iext_leaf	*leaf;
161 	int			pos;
162 };
163 
164 typedef enum {
165 	XFS_EXT_NORM, XFS_EXT_UNWRITTEN,
166 } xfs_exntst_t;
167 
168 typedef struct xfs_bmbt_irec
169 {
170 	xfs_fileoff_t	br_startoff;	/* starting file offset */
171 	xfs_fsblock_t	br_startblock;	/* starting block number */
172 	xfs_filblks_t	br_blockcount;	/* number of blocks */
173 	xfs_exntst_t	br_state;	/* extent state */
174 } xfs_bmbt_irec_t;
175 
176 /* per-AG block reservation types */
177 enum xfs_ag_resv_type {
178 	XFS_AG_RESV_NONE = 0,
179 	XFS_AG_RESV_AGFL,
180 	XFS_AG_RESV_METADATA,
181 	XFS_AG_RESV_RMAPBT,
182 };
183 
184 /*
185  * Type verifier functions
186  */
187 struct xfs_mount;
188 
189 xfs_agblock_t xfs_ag_block_count(struct xfs_mount *mp, xfs_agnumber_t agno);
190 bool xfs_verify_agbno(struct xfs_mount *mp, xfs_agnumber_t agno,
191 		xfs_agblock_t agbno);
192 bool xfs_verify_fsbno(struct xfs_mount *mp, xfs_fsblock_t fsbno);
193 bool xfs_verify_fsbext(struct xfs_mount *mp, xfs_fsblock_t fsbno,
194 		xfs_fsblock_t len);
195 
196 void xfs_agino_range(struct xfs_mount *mp, xfs_agnumber_t agno,
197 		xfs_agino_t *first, xfs_agino_t *last);
198 bool xfs_verify_agino(struct xfs_mount *mp, xfs_agnumber_t agno,
199 		xfs_agino_t agino);
200 bool xfs_verify_agino_or_null(struct xfs_mount *mp, xfs_agnumber_t agno,
201 		xfs_agino_t agino);
202 bool xfs_verify_ino(struct xfs_mount *mp, xfs_ino_t ino);
203 bool xfs_internal_inum(struct xfs_mount *mp, xfs_ino_t ino);
204 bool xfs_verify_dir_ino(struct xfs_mount *mp, xfs_ino_t ino);
205 bool xfs_verify_rtbno(struct xfs_mount *mp, xfs_rtblock_t rtbno);
206 bool xfs_verify_rtext(struct xfs_mount *mp, xfs_rtblock_t rtbno,
207 		xfs_rtblock_t len);
208 bool xfs_verify_icount(struct xfs_mount *mp, unsigned long long icount);
209 bool xfs_verify_dablk(struct xfs_mount *mp, xfs_fileoff_t off);
210 void xfs_icount_range(struct xfs_mount *mp, unsigned long long *min,
211 		unsigned long long *max);
212 bool xfs_verify_fileoff(struct xfs_mount *mp, xfs_fileoff_t off);
213 bool xfs_verify_fileext(struct xfs_mount *mp, xfs_fileoff_t off,
214 		xfs_fileoff_t len);
215 
216 #endif	/* __XFS_TYPES_H__ */
217