xref: /freebsd/sys/fs/ext2fs/ext2_dinode.h (revision 5ca8e32633c4ffbbcd6762e5888b6a4ba0708c6c)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright (c) 2009 Aditya Sarawgi
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  */
28 
29 #ifndef _FS_EXT2FS_EXT2_DINODE_H_
30 #define	_FS_EXT2FS_EXT2_DINODE_H_
31 
32 /*
33  * Special inode numbers
34  * The root inode is the root of the file system.  Inode 0 can't be used for
35  * normal purposes and bad blocks are normally linked to inode 1, thus
36  * the root inode is 2.
37  * Inode 3 to 10 are reserved in ext2fs.
38  */
39 #define	EXT2_BADBLKINO		((ino_t)1)
40 #define	EXT2_ROOTINO		((ino_t)2)
41 #define	EXT2_ACLIDXINO		((ino_t)3)
42 #define	EXT2_ACLDATAINO		((ino_t)4)
43 #define	EXT2_BOOTLOADERINO	((ino_t)5)
44 #define	EXT2_UNDELDIRINO	((ino_t)6)
45 #define	EXT2_RESIZEINO		((ino_t)7)
46 #define	EXT2_JOURNALINO		((ino_t)8)
47 #define	EXT2_EXCLUDEINO		((ino_t)9)
48 #define	EXT2_REPLICAINO		((ino_t)10)
49 #define	EXT2_FIRSTINO		((ino_t)11)
50 
51 /*
52  * Inode flags
53  * The system supports EXT2_IMMUTABLE, EXT2_APPEND and EXT2_NODUMP flags.
54  * The current implementation also uses EXT3_INDEX, EXT4_EXTENTS and
55  * EXT4_HUGE_FILE with some restrictions imposed by the lack of write
56  * support.
57  */
58 #define	EXT2_SECRM		0x00000001	/* Secure deletion */
59 #define	EXT2_UNRM		0x00000002	/* Undelete */
60 #define	EXT2_COMPR		0x00000004	/* Compress file */
61 #define	EXT2_SYNC		0x00000008	/* Synchronous updates */
62 #define	EXT2_IMMUTABLE		0x00000010	/* Immutable file */
63 #define	EXT2_APPEND		0x00000020 /* Writes to file may only append */
64 #define	EXT2_NODUMP		0x00000040	/* Do not dump file */
65 #define	EXT2_NOATIME		0x00000080	/* Do not update atime */
66 #define	EXT3_INDEX		0x00001000	/* Hash-indexed directory */
67 #define	EXT4_IMAGIC		0x00002000	/* AFS directory */
68 #define	EXT4_JOURNAL_DATA	0x00004000 /* File data should be journaled */
69 #define	EXT4_NOTAIL		0x00008000 /* File tail should not be merged */
70 #define	EXT4_DIRSYNC		0x00010000	/* Dirsync behaviour */
71 #define	EXT4_TOPDIR		0x00020000 /* Top of directory hierarchies*/
72 #define	EXT4_HUGE_FILE		0x00040000	/* Set to each huge file */
73 #define	EXT4_EXTENTS		0x00080000	/* Inode uses extents */
74 #define	EXT4_EA_INODE		0x00200000	/* Inode used for large EA */
75 #define	EXT4_EOFBLOCKS		0x00400000 /* Blocks allocated beyond EOF */
76 #define	EXT4_INLINE_DATA	0x10000000 /* Inode has inline data */
77 #define	EXT4_PROJINHERIT	0x20000000 /* Children inherit project ID */
78 
79 /*
80  * Definitions for nanosecond timestamps.
81  * Ext3 inode versioning, 2006-12-13.
82  */
83 #define	EXT3_EPOCH_BITS	2
84 #define	EXT3_EPOCH_MASK	((1 << EXT3_EPOCH_BITS) - 1)
85 #define	EXT3_NSEC_MASK	(~0UL << EXT3_EPOCH_BITS)
86 
87 #define	E2DI_HAS_XTIME(ip)	(EXT2_HAS_RO_COMPAT_FEATURE(ip->i_e2fs,	\
88 				    EXT2F_ROCOMPAT_EXTRA_ISIZE))
89 #define	E2DI_HAS_HUGE_FILE(ip)	(EXT2_HAS_RO_COMPAT_FEATURE(ip->i_e2fs,	\
90 				    EXT2F_ROCOMPAT_HUGE_FILE))
91 
92 /*
93  * Constants relative to the data blocks
94  */
95 #define	EXT2_NDIR_BLOCKS		12
96 #define	EXT2_IND_BLOCK			EXT2_NDIR_BLOCKS
97 #define	EXT2_DIND_BLOCK			(EXT2_IND_BLOCK + 1)
98 #define	EXT2_TIND_BLOCK			(EXT2_DIND_BLOCK + 1)
99 #define	EXT2_N_BLOCKS			(EXT2_TIND_BLOCK + 1)
100 #define	EXT2_MAXSYMLINKLEN		(EXT2_N_BLOCKS * sizeof(uint32_t))
101 
102 /*
103  * Structure of an inode on the disk
104  */
105 struct ext2fs_dinode {
106 	uint16_t	e2di_mode;	/*   0: IFMT, permissions; see below. */
107 	uint16_t	e2di_uid;	/*   2: Owner UID */
108 	uint32_t	e2di_size;	/*   4: Size (in bytes) */
109 	uint32_t	e2di_atime;	/*   8: Access time */
110 	uint32_t	e2di_ctime;	/*  12: Change time */
111 	uint32_t	e2di_mtime;	/*  16: Modification time */
112 	uint32_t	e2di_dtime;	/*  20: Deletion time */
113 	uint16_t	e2di_gid;	/*  24: Owner GID */
114 	uint16_t	e2di_nlink;	/*  26: File link count */
115 	uint32_t	e2di_nblock;	/*  28: Blocks count */
116 	uint32_t	e2di_flags;	/*  32: Status flags (chflags) */
117 	uint32_t	e2di_version;	/*  36: Low 32 bits inode version */
118 	uint32_t	e2di_blocks[EXT2_N_BLOCKS]; /* 40: disk blocks */
119 	uint32_t	e2di_gen;	/* 100: generation number */
120 	uint32_t	e2di_facl;	/* 104: Low EA block */
121 	uint32_t	e2di_size_high;	/* 108: Upper bits of file size */
122 	uint32_t	e2di_faddr;	/* 112: Fragment address (obsolete) */
123 	uint16_t	e2di_nblock_high; /* 116: Blocks count bits 47:32 */
124 	uint16_t	e2di_facl_high;	/* 118: File EA bits 47:32 */
125 	uint16_t	e2di_uid_high;	/* 120: Owner UID top 16 bits */
126 	uint16_t	e2di_gid_high;	/* 122: Owner GID top 16 bits */
127 	uint16_t	e2di_chksum_lo;	  /* 124: Lower inode checksum */
128 	uint16_t	e2di_lx_reserved; /* 126: Unused */
129 	uint16_t	e2di_extra_isize; /* 128: Size of this inode */
130 	uint16_t	e2di_chksum_hi;	/* 130: High inode checksum */
131 	uint32_t	e2di_ctime_extra; /* 132: Extra change time */
132 	uint32_t	e2di_mtime_extra; /* 136: Extra modification time */
133 	uint32_t	e2di_atime_extra; /* 140: Extra access time */
134 	uint32_t	e2di_crtime;	/* 144: Creation (birth)time */
135 	uint32_t	e2di_crtime_extra; /* 148: Extra creation (birth)time */
136 	uint32_t	e2di_version_hi;  /* 152: High bits of inode version */
137 	uint32_t	e2di_projid;	/* 156: Project ID */
138 };
139 
140 #endif /* !_FS_EXT2FS_EXT2_DINODE_H_ */
141