xref: /illumos-gate/usr/src/boot/include/ufs/ufs/dinode.h (revision 199767f8)
1 /*-
2  * Copyright (c) 2002 Networks Associates Technology, Inc.
3  * All rights reserved.
4  *
5  * This software was developed for the FreeBSD Project by Marshall
6  * Kirk McKusick and Network Associates Laboratories, the Security
7  * Research Division of Network Associates, Inc. under DARPA/SPAWAR
8  * contract N66001-01-C-8035 ("CBOSS"), as part of the DARPA CHATS
9  * research program
10  *
11  * Redistribution and use in source and binary forms, with or without
12  * modification, are permitted provided that the following conditions
13  * are met:
14  * 1. Redistributions of source code must retain the above copyright
15  *    notice, this list of conditions and the following disclaimer.
16  * 2. Redistributions in binary form must reproduce the above copyright
17  *    notice, this list of conditions and the following disclaimer in the
18  *    documentation and/or other materials provided with the distribution.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
21  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
24  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30  * SUCH DAMAGE.
31  *
32  * Copyright (c) 1982, 1989, 1993
33  *	The Regents of the University of California.  All rights reserved.
34  * (c) UNIX System Laboratories, Inc.
35  * All or some portions of this file are derived from material licensed
36  * to the University of California by American Telephone and Telegraph
37  * Co. or Unix System Laboratories, Inc. and are reproduced herein with
38  * the permission of UNIX System Laboratories, Inc.
39  *
40  * Redistribution and use in source and binary forms, with or without
41  * modification, are permitted provided that the following conditions
42  * are met:
43  * 1. Redistributions of source code must retain the above copyright
44  *    notice, this list of conditions and the following disclaimer.
45  * 2. Redistributions in binary form must reproduce the above copyright
46  *    notice, this list of conditions and the following disclaimer in the
47  *    documentation and/or other materials provided with the distribution.
48  * 3. The names of the authors may not be used to endorse or promote
49  *    products derived from this software without specific prior written
50  *    permission.
51  *
52  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
53  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
54  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
55  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
56  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
57  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
58  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
59  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
60  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
61  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
62  * SUCH DAMAGE.
63  *
64  *	@(#)dinode.h	8.3 (Berkeley) 1/21/94
65  * $FreeBSD$
66  */
67 
68 #ifndef _UFS_UFS_DINODE_H_
69 #define	_UFS_UFS_DINODE_H_
70 
71 /*
72  * The root inode is the root of the filesystem.  Inode 0 can't be used for
73  * normal purposes and historically bad blocks were linked to inode 1, thus
74  * the root inode is 2.  (Inode 1 is no longer used for this purpose, however
75  * numerous dump tapes make this assumption, so we are stuck with it).
76  */
77 #define	ROOTINO	((ino_t)2)
78 
79 /*
80  * The Whiteout inode# is a dummy non-zero inode number which will
81  * never be allocated to a real file.  It is used as a place holder
82  * in the directory entry which has been tagged as a DT_WHT entry.
83  * See the comments about ROOTINO above.
84  */
85 #define	WINO	((ino_t)1)
86 
87 /*
88  * The size of physical and logical block numbers and time fields in UFS.
89  */
90 typedef	int32_t	ufs1_daddr_t;
91 typedef	int64_t	ufs2_daddr_t;
92 typedef int64_t ufs_lbn_t;
93 typedef int64_t ufs_time_t;
94 
95 /* File permissions. */
96 #define	IEXEC		0000100		/* Executable. */
97 #define	IWRITE		0000200		/* Writeable. */
98 #define	IREAD		0000400		/* Readable. */
99 #define	ISVTX		0001000		/* Sticky bit. */
100 #define	ISGID		0002000		/* Set-gid. */
101 #define	ISUID		0004000		/* Set-uid. */
102 
103 /* File types. */
104 #define	IFMT		0170000		/* Mask of file type. */
105 #define	IFIFO		0010000		/* Named pipe (fifo). */
106 #define	IFCHR		0020000		/* Character device. */
107 #define	IFDIR		0040000		/* Directory file. */
108 #define	IFBLK		0060000		/* Block device. */
109 #define	IFREG		0100000		/* Regular file. */
110 #define	IFLNK		0120000		/* Symbolic link. */
111 #define	IFSOCK		0140000		/* UNIX domain socket. */
112 #define	IFWHT		0160000		/* Whiteout. */
113 
114 /*
115  * A dinode contains all the meta-data associated with a UFS2 file.
116  * This structure defines the on-disk format of a dinode. Since
117  * this structure describes an on-disk structure, all its fields
118  * are defined by types with precise widths.
119  */
120 
121 #define	NXADDR	2			/* External addresses in inode. */
122 #define	NDADDR	12			/* Direct addresses in inode. */
123 #define	NIADDR	3			/* Indirect addresses in inode. */
124 
125 struct ufs2_dinode {
126 	u_int16_t	di_mode;	/*   0: IFMT, permissions; see below. */
127 	int16_t		di_nlink;	/*   2: File link count. */
128 	u_int32_t	di_uid;		/*   4: File owner. */
129 	u_int32_t	di_gid;		/*   8: File group. */
130 	u_int32_t	di_blksize;	/*  12: Inode blocksize. */
131 	u_int64_t	di_size;	/*  16: File byte count. */
132 	u_int64_t	di_blocks;	/*  24: Blocks actually held. */
133 	ufs_time_t	di_atime;	/*  32: Last access time. */
134 	ufs_time_t	di_mtime;	/*  40: Last modified time. */
135 	ufs_time_t	di_ctime;	/*  48: Last inode change time. */
136 	ufs_time_t	di_birthtime;	/*  56: Inode creation time. */
137 	int32_t		di_mtimensec;	/*  64: Last modified time. */
138 	int32_t		di_atimensec;	/*  68: Last access time. */
139 	int32_t		di_ctimensec;	/*  72: Last inode change time. */
140 	int32_t		di_birthnsec;	/*  76: Inode creation time. */
141 	u_int32_t	di_gen;		/*  80: Generation number. */
142 	u_int32_t	di_kernflags;	/*  84: Kernel flags. */
143 	u_int32_t	di_flags;	/*  88: Status flags (chflags). */
144 	u_int32_t	di_extsize;	/*  92: External attributes size. */
145 	ufs2_daddr_t	di_extb[NXADDR];/*  96: External attributes block. */
146 	ufs2_daddr_t	di_db[NDADDR];	/* 112: Direct disk blocks. */
147 	ufs2_daddr_t	di_ib[NIADDR];	/* 208: Indirect disk blocks. */
148 	u_int64_t	di_modrev;	/* 232: i_modrev for NFSv4 */
149 	uint32_t	di_freelink;	/* 240: SUJ: Next unlinked inode. */
150 	uint32_t	di_spare[3];	/* 244: Reserved; currently unused */
151 };
152 
153 /*
154  * The di_db fields may be overlaid with other information for
155  * file types that do not have associated disk storage. Block
156  * and character devices overlay the first data block with their
157  * dev_t value. Short symbolic links place their path in the
158  * di_db area.
159  */
160 #define	di_rdev di_db[0]
161 
162 /*
163  * A UFS1 dinode contains all the meta-data associated with a UFS1 file.
164  * This structure defines the on-disk format of a UFS1 dinode. Since
165  * this structure describes an on-disk structure, all its fields
166  * are defined by types with precise widths.
167  */
168 struct ufs1_dinode {
169 	u_int16_t	di_mode;	/*   0: IFMT, permissions; see below. */
170 	int16_t		di_nlink;	/*   2: File link count. */
171 	u_int16_t	di_suid;	/*   4: File owner. */
172 	u_int16_t	di_sgid;	/*   6: File group. */
173 	u_int64_t	di_size;	/*   8: File byte count. */
174 	int32_t		di_atime;	/*  16: Last access time. */
175 	int32_t		di_atimensec;	/*  20: Last access time. */
176 	int32_t		di_mtime;	/*  24: Last modified time. */
177 	int32_t		di_mtimensec;	/*  28: Last modified time. */
178 	int32_t		di_ctime;	/*  32: Last inode change time. */
179 	int32_t		di_ctimensec;	/*  36: Last inode change time. */
180 	ufs1_daddr_t	di_db[NDADDR];	/*  40: Direct disk blocks. */
181 	ufs1_daddr_t	di_ib[NIADDR];	/*  88: Indirect disk blocks. */
182 	u_int32_t	di_flags;	/* 100: Status flags (chflags). */
183 	u_int32_t	di_blocks;	/* 104: Blocks actually held. */
184 	u_int32_t	di_gen;		/* 108: Generation number. */
185 	u_int32_t	di_shadow;	/* 112: shadow inode */
186 	u_int32_t	di_uid;		/* 116: long EFT version of uid */
187 	u_int32_t	di_gid;		/* 120: long EFT version of gid */
188 	u_int32_t	di_oeftflag;	/* 124: extended attr directory ino, 0 = none */
189 };
190 
191 #endif /* _UFS_UFS_DINODE_H_ */
192