BSD 4_4 release
[unix-history] / usr / src / sys / ufs / ufs / dinode.h
index 2d9af20..47a1ffc 100644 (file)
 /*
 /*
- * Copyright (c) 1982, 1989 The Regents of the University of California.
- * All rights reserved.
+ * Copyright (c) 1982, 1989, 1993
+ *     The Regents of the University of California.  All rights reserved.
  *
  *
- * Redistribution and use in source and binary forms are permitted
- * provided that the above copyright notice and this paragraph are
- * duplicated in all such forms and that any documentation,
- * advertising materials, and other materials related to such
- * distribution and use acknowledge that the software was developed
- * by the University of California, Berkeley.  The name of the
- * University may not be used to endorse or promote products derived
- * from this software without specific prior written permission.
- * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
- * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
- * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ * 3. All advertising materials mentioning features or use of this software
+ *    must display the following acknowledgement:
+ *     This product includes software developed by the University of
+ *     California, Berkeley and its contributors.
+ * 4. Neither the name of the University nor the names of its contributors
+ *    may be used to endorse or promote products derived from this software
+ *    without specific prior written permission.
  *
  *
- *     @(#)dinode.h    7.8 (Berkeley) %G%
+ * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ *
+ *     @(#)dinode.h    8.1 (Berkeley) 6/11/93
+ */
+
+/*
+ * The root inode is the root of the file system.  Inode 0 can't be used for
+ * normal purposes and historically bad blocks were linked to inode 1, thus
+ * the root inode is 2.  (Inode 1 is no longer used for this purpose, however
+ * numerous dump tapes make this assumption, so we are stuck with it).
  */
  */
+#define        ROOTINO ((ino_t)2)
 
 /*
 
 /*
- * This structure defines the on-disk format of an inode.
+ * A dinode contains all the meta-data associated with a UFS file.
+ * This structure defines the on-disk format of a dinode.
  */
 
 #define        NDADDR  12              /* direct addresses in inode */
 #define        NIADDR  3               /* indirect addresses in inode */
 
 struct dinode {
  */
 
 #define        NDADDR  12              /* direct addresses in inode */
 #define        NIADDR  3               /* indirect addresses in inode */
 
 struct dinode {
-       u_short di_mode;        /*  0: mode and type of file */
-       short   di_nlink;       /*  2: number of links to file */
-       uid_t   di_uid;         /*  4: owner's user id */
-       gid_t   di_gid;         /*  6: owner's group id */
-       u_quad  di_qsize;       /*  8: number of bytes in file */
-       time_t  di_atime;       /* 16: time last accessed */
-       long    di_atspare;
-       time_t  di_mtime;       /* 24: time last modified */
-       long    di_mtspare;
-       time_t  di_ctime;       /* 32: last time inode changed */
-       long    di_ctspare;
-       daddr_t di_db[NDADDR];  /* 40: disk block addresses */
-       daddr_t di_ib[NIADDR];  /* 88: indirect blocks */
-       long    di_flags;       /* 100: status, currently unused */
-       long    di_blocks;      /* 104: blocks actually held */
-       long    di_gen;         /* 108: generation number */
-       long    di_spare[4];    /* 112: reserved, currently unused */
+       u_short         di_mode;        /*   0: mode and type of file */
+       short           di_nlink;       /*   2: number of links to file */
+       union {
+               u_short oldids[2];      /*   4: ffs: old user and group ids */
+               ino_t   inumber;        /*   4: lfs: inode number */
+       } di_u;
+       u_quad_t        di_size;        /*   8: number of bytes in file */
+       struct timespec di_atime;       /*  16: time last accessed */
+       struct timespec di_mtime;       /*  24: time last modified */
+       struct timespec di_ctime;       /*  32: last time inode changed */
+       daddr_t         di_db[NDADDR];  /*  40: disk block addresses */
+       daddr_t         di_ib[NIADDR];  /*  88: indirect blocks */
+       u_long          di_flags;       /* 100: status flags */
+       long            di_blocks;      /* 104: blocks actually held */
+       long            di_gen;         /* 108: generation number */
+       u_long          di_uid;         /* 112: owner's user id */
+       u_long          di_gid;         /* 116: owner's group id */
+       long            di_spare[2];    /* 120: reserved, currently unused */
 };
 
 };
 
-#if BYTE_ORDER == LITTLE_ENDIAN || defined(tahoe) /* ugh! -- must be fixed */
-#define        di_size         di_qsize.val[0]
-#else /* BYTE_ORDER == BIG_ENDIAN */
-#define        di_size         di_qsize.val[1]
-#endif
+/*
+ * The di_db fields may be overlaid with other information for
+ * file types that do not have associated disk storage. Block
+ * and character devices overlay the first data block with their
+ * dev_t value. Short symbolic links place their path in the
+ * di_db area.
+ */
+#define        di_ouid         di_u.oldids[0]
+#define        di_ogid         di_u.oldids[1]
+#define        di_inumber      di_u.inumber
 #define        di_rdev         di_db[0]
 #define        di_rdev         di_db[0]
+#define di_shortlink   di_db
+#define        MAXSYMLINKLEN   ((NDADDR + NIADDR) * sizeof(daddr_t))
 
 /* file modes */
 
 /* file modes */
-#define        IFMT            0170000         /* type of file */
+#define        IFMT            0170000         /* mask of file type */
 #define        IFIFO           0010000         /* named pipe (fifo) */
 #define        IFIFO           0010000         /* named pipe (fifo) */
-#define        IFCHR           0020000         /* character special */
+#define        IFCHR           0020000         /* character special device */
 #define        IFDIR           0040000         /* directory */
 #define        IFDIR           0040000         /* directory */
-#define        IFBLK           0060000         /* block special */
-#define        IFREG           0100000         /* regular */
+#define        IFBLK           0060000         /* block special device */
+#define        IFREG           0100000         /* regular file */
 #define        IFLNK           0120000         /* symbolic link */
 #define        IFLNK           0120000         /* symbolic link */
-#define        IFSOCK          0140000         /* socket */
+#define        IFSOCK          0140000         /* UNIX domain socket */
 
 
-#define        ISUID           04000           /* set user id on execution */
-#define        ISGID           02000           /* set group id on execution */
-#define        ISVTX           01000           /* save swapped text even after use */
-#define        IREAD           0400            /* read, write, execute permissions */
-#define        IWRITE          0200
-#define        IEXEC           0100
+#define        ISUID           04000           /* set user identifier when exec'ing */
+#define        ISGID           02000           /* set group identifier when exec'ing */
+#define        ISVTX           01000           /* save execution information on exit */
+#define        IREAD           0400            /* read permission */
+#define        IWRITE          0200            /* write permission */
+#define        IEXEC           0100            /* execute permission */