sys/ufs/ufs/dinode.h

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