POSIX.1-2003: Changing the group ID is permitted to a process with an
[dragonfly.git] / sys / vfs / ufs / dinode.h
1 /*-
2  * Copyright (c) 1982, 1989, 1993
3  *      The Regents of the University of California.  All rights reserved.
4  * (c) UNIX System Laboratories, Inc.
5  * All or some portions of this file are derived from material licensed
6  * to the University of California by American Telephone and Telegraph
7  * Co. or Unix System Laboratories, Inc. and are reproduced herein with
8  * the permission of UNIX System Laboratories, Inc.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  * 3. All advertising materials mentioning features or use of this software
19  *    must display the following acknowledgement:
20  *      This product includes software developed by the University of
21  *      California, Berkeley and its contributors.
22  * 4. Neither the name of the University nor the names of its contributors
23  *    may be used to endorse or promote products derived from this software
24  *    without specific prior written permission.
25  *
26  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
27  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
28  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
29  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
30  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
31  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
32  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
33  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
34  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
35  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36  * SUCH DAMAGE.
37  *
38  *      @(#)dinode.h    8.3 (Berkeley) 1/21/94
39  * $FreeBSD: src/sys/ufs/ufs/dinode.h,v 1.7 1999/08/28 00:52:27 peter Exp $
40  * $DragonFly: src/sys/vfs/ufs/dinode.h,v 1.3 2004/07/18 19:43:48 drhodus Exp $
41  */
42
43 #ifndef _UFS_UFS_DINODE_H_
44 #define _UFS_UFS_DINODE_H_
45
46 /*
47  * The root inode is the root of the filesystem.  Inode 0 can't be used for
48  * normal purposes and historically bad blocks were linked to inode 1, thus
49  * the root inode is 2.  (Inode 1 is no longer used for this purpose, however
50  * numerous dump tapes make this assumption, so we are stuck with it).
51  */
52 #define ROOTINO ((ino_t)2)
53
54 /*
55  * The Whiteout inode# is a dummy non-zero inode number which will
56  * never be allocated to a real file.  It is used as a place holder
57  * in the directory entry which has been tagged as a DT_W entry.
58  * See the comments about ROOTINO above.
59  */
60 #define WINO    ((ino_t)1)
61
62 /*
63  * A dinode contains all the meta-data associated with a UFS file.
64  * This structure defines the on-disk format of a dinode. Since
65  * this structure describes an on-disk structure, all its fields
66  * are defined by types with precise widths.
67  */
68
69 /* typedef int32_t ufs_daddr_t; */
70 #define NDADDR  12                      /* Direct addresses in inode. */
71 #define NIADDR  3                       /* Indirect addresses in inode. */
72
73 struct dinode {
74         uint16_t        di_mode;        /*   0: IFMT, permissions; see below. */
75         int16_t         di_nlink;       /*   2: File link count. */
76         union {
77                 uint16_t oldids[2];     /*   4: Ffs: old user and group ids. */
78                 int32_t   inumber;      /*   4: Lfs: inode number. */
79         } di_u;
80         uint64_t        di_size;        /*   8: File byte count. */
81         int32_t         di_atime;       /*  16: Last access time. */
82         int32_t         di_atimensec;   /*  20: Last access time. */
83         int32_t         di_mtime;       /*  24: Last modified time. */
84         int32_t         di_mtimensec;   /*  28: Last modified time. */
85         int32_t         di_ctime;       /*  32: Last inode change time. */
86         int32_t         di_ctimensec;   /*  36: Last inode change time. */
87         ufs_daddr_t     di_db[NDADDR];  /*  40: Direct disk blocks. */
88         ufs_daddr_t     di_ib[NIADDR];  /*  88: Indirect disk blocks. */
89         uint32_t        di_flags;       /* 100: Status flags (chflags). */
90         int32_t         di_blocks;      /* 104: Blocks actually held. */
91         int32_t         di_gen;         /* 108: Generation number. */
92         uint32_t        di_uid;         /* 112: File owner. */
93         uint32_t        di_gid;         /* 116: File group. */
94         int32_t         di_spare[2];    /* 120: Reserved; currently unused */
95 };
96
97 /*
98  * The di_db fields may be overlaid with other information for
99  * file types that do not have associated disk storage. Block
100  * and character devices overlay the first data block with their
101  * dev_t value. Short symbolic links place their path in the
102  * di_db area.
103  */
104 #define di_inumber      di_u.inumber
105 #define di_ogid         di_u.oldids[1]
106 #define di_ouid         di_u.oldids[0]
107 #define di_rdev         di_db[0]
108 #define di_shortlink    di_db
109 #define MAXSYMLINKLEN   ((NDADDR + NIADDR) * sizeof(ufs_daddr_t))
110
111 /* File permissions. */
112 #define IEXEC           0000100         /* Executable. */
113 #define IWRITE          0000200         /* Writeable. */
114 #define IREAD           0000400         /* Readable. */
115 #define ISVTX           0001000         /* Sticky bit. */
116 #define ISGID           0002000         /* Set-gid. */
117 #define ISUID           0004000         /* Set-uid. */
118
119 /* File types. */
120 #define IFMT            0170000         /* Mask of file type. */
121 #define IFIFO           0010000         /* Named pipe (fifo). */
122 #define IFCHR           0020000         /* Character device. */
123 #define IFDIR           0040000         /* Directory file. */
124 #define IFBLK           0060000         /* Block device. */
125 #define IFREG           0100000         /* Regular file. */
126 #define IFLNK           0120000         /* Symbolic link. */
127 #define IFSOCK          0140000         /* UNIX domain socket. */
128 #define IFWHT           0160000         /* Whiteout. */
129
130 #endif /* !_UFS_UFS_DINODE_H_ */