xref: /linux/fs/xfs/libxfs/xfs_types.h (revision 44f57d78)
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 int32_t		xfs_tid_t;	/* transaction identifier */
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 typedef int64_t		xfs_sfiloff_t;	/* signed block number in a file */
37 
38 /*
39  * New verifiers will return the instruction address of the failing check.
40  * NULL means everything is ok.
41  */
42 typedef void *		xfs_failaddr_t;
43 
44 /*
45  * Null values for the types.
46  */
47 #define	NULLFSBLOCK	((xfs_fsblock_t)-1)
48 #define	NULLRFSBLOCK	((xfs_rfsblock_t)-1)
49 #define	NULLRTBLOCK	((xfs_rtblock_t)-1)
50 #define	NULLFILEOFF	((xfs_fileoff_t)-1)
51 
52 #define	NULLAGBLOCK	((xfs_agblock_t)-1)
53 #define	NULLAGNUMBER	((xfs_agnumber_t)-1)
54 
55 #define NULLCOMMITLSN	((xfs_lsn_t)-1)
56 
57 #define	NULLFSINO	((xfs_ino_t)-1)
58 #define	NULLAGINO	((xfs_agino_t)-1)
59 
60 /*
61  * Max values for extlen, extnum, aextnum.
62  */
63 #define	MAXEXTLEN	((xfs_extlen_t)0x001fffff)	/* 21 bits */
64 #define	MAXEXTNUM	((xfs_extnum_t)0x7fffffff)	/* signed int */
65 #define	MAXAEXTNUM	((xfs_aextnum_t)0x7fff)		/* signed short */
66 
67 /*
68  * Minimum and maximum blocksize and sectorsize.
69  * The blocksize upper limit is pretty much arbitrary.
70  * The sectorsize upper limit is due to sizeof(sb_sectsize).
71  * CRC enable filesystems use 512 byte inodes, meaning 512 byte block sizes
72  * cannot be used.
73  */
74 #define XFS_MIN_BLOCKSIZE_LOG	9	/* i.e. 512 bytes */
75 #define XFS_MAX_BLOCKSIZE_LOG	16	/* i.e. 65536 bytes */
76 #define XFS_MIN_BLOCKSIZE	(1 << XFS_MIN_BLOCKSIZE_LOG)
77 #define XFS_MAX_BLOCKSIZE	(1 << XFS_MAX_BLOCKSIZE_LOG)
78 #define XFS_MIN_CRC_BLOCKSIZE	(1 << (XFS_MIN_BLOCKSIZE_LOG + 1))
79 #define XFS_MIN_SECTORSIZE_LOG	9	/* i.e. 512 bytes */
80 #define XFS_MAX_SECTORSIZE_LOG	15	/* i.e. 32768 bytes */
81 #define XFS_MIN_SECTORSIZE	(1 << XFS_MIN_SECTORSIZE_LOG)
82 #define XFS_MAX_SECTORSIZE	(1 << XFS_MAX_SECTORSIZE_LOG)
83 
84 /*
85  * Inode fork identifiers.
86  */
87 #define	XFS_DATA_FORK	0
88 #define	XFS_ATTR_FORK	1
89 #define	XFS_COW_FORK	2
90 
91 /*
92  * Min numbers of data/attr fork btree root pointers.
93  */
94 #define MINDBTPTRS	3
95 #define MINABTPTRS	2
96 
97 /*
98  * MAXNAMELEN is the length (including the terminating null) of
99  * the longest permissible file (component) name.
100  */
101 #define MAXNAMELEN	256
102 
103 /*
104  * This enum is used in string mapping in xfs_trace.h; please keep the
105  * TRACE_DEFINE_ENUMs for it up to date.
106  */
107 typedef enum {
108 	XFS_LOOKUP_EQi, XFS_LOOKUP_LEi, XFS_LOOKUP_GEi
109 } xfs_lookup_t;
110 
111 #define XFS_AG_BTREE_CMP_FORMAT_STR \
112 	{ XFS_LOOKUP_EQi,	"eq" }, \
113 	{ XFS_LOOKUP_LEi,	"le" }, \
114 	{ XFS_LOOKUP_GEi,	"ge" }
115 
116 /*
117  * This enum is used in string mapping in xfs_trace.h and scrub/trace.h;
118  * please keep the TRACE_DEFINE_ENUMs for it up to date.
119  */
120 typedef enum {
121 	XFS_BTNUM_BNOi, XFS_BTNUM_CNTi, XFS_BTNUM_RMAPi, XFS_BTNUM_BMAPi,
122 	XFS_BTNUM_INOi, XFS_BTNUM_FINOi, XFS_BTNUM_REFCi, XFS_BTNUM_MAX
123 } xfs_btnum_t;
124 
125 #define XFS_BTNUM_STRINGS \
126 	{ XFS_BTNUM_BNOi,	"bnobt" }, \
127 	{ XFS_BTNUM_CNTi,	"cntbt" }, \
128 	{ XFS_BTNUM_RMAPi,	"rmapbt" }, \
129 	{ XFS_BTNUM_BMAPi,	"bmbt" }, \
130 	{ XFS_BTNUM_INOi,	"inobt" }, \
131 	{ XFS_BTNUM_FINOi,	"finobt" }, \
132 	{ XFS_BTNUM_REFCi,	"refcbt" }
133 
134 struct xfs_name {
135 	const unsigned char	*name;
136 	int			len;
137 	int			type;
138 };
139 
140 /*
141  * uid_t and gid_t are hard-coded to 32 bits in the inode.
142  * Hence, an 'id' in a dquot is 32 bits..
143  */
144 typedef uint32_t	xfs_dqid_t;
145 
146 /*
147  * Constants for bit manipulations.
148  */
149 #define	XFS_NBBYLOG	3		/* log2(NBBY) */
150 #define	XFS_WORDLOG	2		/* log2(sizeof(xfs_rtword_t)) */
151 #define	XFS_NBWORDLOG	(XFS_NBBYLOG + XFS_WORDLOG)
152 #define	XFS_NBWORD	(1 << XFS_NBWORDLOG)
153 #define	XFS_WORDMASK	((1 << XFS_WORDLOG) - 1)
154 
155 struct xfs_iext_cursor {
156 	struct xfs_iext_leaf	*leaf;
157 	int			pos;
158 };
159 
160 typedef enum {
161 	XFS_EXT_NORM, XFS_EXT_UNWRITTEN,
162 } xfs_exntst_t;
163 
164 typedef struct xfs_bmbt_irec
165 {
166 	xfs_fileoff_t	br_startoff;	/* starting file offset */
167 	xfs_fsblock_t	br_startblock;	/* starting block number */
168 	xfs_filblks_t	br_blockcount;	/* number of blocks */
169 	xfs_exntst_t	br_state;	/* extent state */
170 } xfs_bmbt_irec_t;
171 
172 /*
173  * Type verifier functions
174  */
175 struct xfs_mount;
176 
177 xfs_agblock_t xfs_ag_block_count(struct xfs_mount *mp, xfs_agnumber_t agno);
178 bool xfs_verify_agbno(struct xfs_mount *mp, xfs_agnumber_t agno,
179 		xfs_agblock_t agbno);
180 bool xfs_verify_fsbno(struct xfs_mount *mp, xfs_fsblock_t fsbno);
181 
182 void xfs_agino_range(struct xfs_mount *mp, xfs_agnumber_t agno,
183 		xfs_agino_t *first, xfs_agino_t *last);
184 bool xfs_verify_agino(struct xfs_mount *mp, xfs_agnumber_t agno,
185 		xfs_agino_t agino);
186 bool xfs_verify_agino_or_null(struct xfs_mount *mp, xfs_agnumber_t agno,
187 		xfs_agino_t agino);
188 bool xfs_verify_ino(struct xfs_mount *mp, xfs_ino_t ino);
189 bool xfs_internal_inum(struct xfs_mount *mp, xfs_ino_t ino);
190 bool xfs_verify_dir_ino(struct xfs_mount *mp, xfs_ino_t ino);
191 bool xfs_verify_rtbno(struct xfs_mount *mp, xfs_rtblock_t rtbno);
192 bool xfs_verify_icount(struct xfs_mount *mp, unsigned long long icount);
193 bool xfs_verify_dablk(struct xfs_mount *mp, xfs_fileoff_t off);
194 void xfs_icount_range(struct xfs_mount *mp, unsigned long long *min,
195 		unsigned long long *max);
196 
197 #endif	/* __XFS_TYPES_H__ */
198