Home | History | Annotate | Line # | Download | only in lfs
      1  1.210  perseant /*	$NetBSD: lfs.h,v 1.210 2025/09/17 03:50:38 perseant Exp $	*/
      2  1.148  dholland 
      3  1.199  dholland /*  from NetBSD: dinode.h,v 1.25 2016/01/22 23:06:10 dholland Exp  */
      4  1.198  dholland /*  from NetBSD: dir.h,v 1.25 2015/09/01 06:16:03 dholland Exp  */
      5    1.6   mycroft 
      6    1.1   mycroft /*-
      7   1.46  perseant  * Copyright (c) 1999, 2000, 2001, 2002, 2003 The NetBSD Foundation, Inc.
      8   1.11  perseant  * All rights reserved.
      9   1.11  perseant  *
     10   1.11  perseant  * This code is derived from software contributed to The NetBSD Foundation
     11   1.11  perseant  * by Konrad E. Schroder <perseant (at) hhhh.org>.
     12   1.11  perseant  *
     13   1.11  perseant  * Redistribution and use in source and binary forms, with or without
     14   1.11  perseant  * modification, are permitted provided that the following conditions
     15   1.11  perseant  * are met:
     16   1.11  perseant  * 1. Redistributions of source code must retain the above copyright
     17   1.11  perseant  *    notice, this list of conditions and the following disclaimer.
     18   1.11  perseant  * 2. Redistributions in binary form must reproduce the above copyright
     19   1.11  perseant  *    notice, this list of conditions and the following disclaimer in the
     20   1.11  perseant  *    documentation and/or other materials provided with the distribution.
     21   1.11  perseant  *
     22   1.11  perseant  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     23   1.11  perseant  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     24   1.11  perseant  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     25   1.11  perseant  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     26   1.11  perseant  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     27   1.11  perseant  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     28   1.11  perseant  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     29   1.11  perseant  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     30   1.11  perseant  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     31   1.11  perseant  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     32   1.11  perseant  * POSSIBILITY OF SUCH DAMAGE.
     33   1.11  perseant  */
     34   1.11  perseant /*-
     35    1.1   mycroft  * Copyright (c) 1991, 1993
     36    1.1   mycroft  *	The Regents of the University of California.  All rights reserved.
     37    1.1   mycroft  *
     38    1.1   mycroft  * Redistribution and use in source and binary forms, with or without
     39    1.1   mycroft  * modification, are permitted provided that the following conditions
     40    1.1   mycroft  * are met:
     41    1.1   mycroft  * 1. Redistributions of source code must retain the above copyright
     42    1.1   mycroft  *    notice, this list of conditions and the following disclaimer.
     43    1.1   mycroft  * 2. Redistributions in binary form must reproduce the above copyright
     44    1.1   mycroft  *    notice, this list of conditions and the following disclaimer in the
     45    1.1   mycroft  *    documentation and/or other materials provided with the distribution.
     46   1.69       agc  * 3. Neither the name of the University nor the names of its contributors
     47    1.1   mycroft  *    may be used to endorse or promote products derived from this software
     48    1.1   mycroft  *    without specific prior written permission.
     49    1.1   mycroft  *
     50    1.1   mycroft  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     51    1.1   mycroft  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     52    1.1   mycroft  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     53    1.1   mycroft  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     54    1.1   mycroft  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     55    1.1   mycroft  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     56    1.1   mycroft  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     57    1.1   mycroft  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     58    1.1   mycroft  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     59    1.1   mycroft  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     60    1.1   mycroft  * SUCH DAMAGE.
     61    1.1   mycroft  *
     62    1.9      fvdl  *	@(#)lfs.h	8.9 (Berkeley) 5/8/95
     63    1.1   mycroft  */
     64  1.148  dholland /*
     65  1.148  dholland  * Copyright (c) 2002 Networks Associates Technology, Inc.
     66  1.148  dholland  * All rights reserved.
     67  1.148  dholland  *
     68  1.148  dholland  * This software was developed for the FreeBSD Project by Marshall
     69  1.148  dholland  * Kirk McKusick and Network Associates Laboratories, the Security
     70  1.148  dholland  * Research Division of Network Associates, Inc. under DARPA/SPAWAR
     71  1.148  dholland  * contract N66001-01-C-8035 ("CBOSS"), as part of the DARPA CHATS
     72  1.148  dholland  * research program
     73  1.148  dholland  *
     74  1.148  dholland  * Copyright (c) 1982, 1989, 1993
     75  1.148  dholland  *	The Regents of the University of California.  All rights reserved.
     76  1.148  dholland  * (c) UNIX System Laboratories, Inc.
     77  1.148  dholland  * All or some portions of this file are derived from material licensed
     78  1.148  dholland  * to the University of California by American Telephone and Telegraph
     79  1.148  dholland  * Co. or Unix System Laboratories, Inc. and are reproduced herein with
     80  1.148  dholland  * the permission of UNIX System Laboratories, Inc.
     81  1.148  dholland  *
     82  1.148  dholland  * Redistribution and use in source and binary forms, with or without
     83  1.148  dholland  * modification, are permitted provided that the following conditions
     84  1.148  dholland  * are met:
     85  1.148  dholland  * 1. Redistributions of source code must retain the above copyright
     86  1.148  dholland  *    notice, this list of conditions and the following disclaimer.
     87  1.148  dholland  * 2. Redistributions in binary form must reproduce the above copyright
     88  1.148  dholland  *    notice, this list of conditions and the following disclaimer in the
     89  1.148  dholland  *    documentation and/or other materials provided with the distribution.
     90  1.148  dholland  * 3. Neither the name of the University nor the names of its contributors
     91  1.148  dholland  *    may be used to endorse or promote products derived from this software
     92  1.148  dholland  *    without specific prior written permission.
     93  1.148  dholland  *
     94  1.148  dholland  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     95  1.148  dholland  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     96  1.148  dholland  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     97  1.148  dholland  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     98  1.148  dholland  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     99  1.148  dholland  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
    100  1.148  dholland  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
    101  1.148  dholland  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
    102  1.148  dholland  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
    103  1.148  dholland  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
    104  1.148  dholland  * SUCH DAMAGE.
    105  1.148  dholland  *
    106  1.148  dholland  *	@(#)dinode.h	8.9 (Berkeley) 3/29/95
    107  1.148  dholland  */
    108  1.148  dholland /*
    109  1.148  dholland  * Copyright (c) 1982, 1986, 1989, 1993
    110  1.148  dholland  *	The Regents of the University of California.  All rights reserved.
    111  1.148  dholland  * (c) UNIX System Laboratories, Inc.
    112  1.148  dholland  * All or some portions of this file are derived from material licensed
    113  1.148  dholland  * to the University of California by American Telephone and Telegraph
    114  1.148  dholland  * Co. or Unix System Laboratories, Inc. and are reproduced herein with
    115  1.148  dholland  * the permission of UNIX System Laboratories, Inc.
    116  1.148  dholland  *
    117  1.148  dholland  * Redistribution and use in source and binary forms, with or without
    118  1.148  dholland  * modification, are permitted provided that the following conditions
    119  1.148  dholland  * are met:
    120  1.148  dholland  * 1. Redistributions of source code must retain the above copyright
    121  1.148  dholland  *    notice, this list of conditions and the following disclaimer.
    122  1.148  dholland  * 2. Redistributions in binary form must reproduce the above copyright
    123  1.148  dholland  *    notice, this list of conditions and the following disclaimer in the
    124  1.148  dholland  *    documentation and/or other materials provided with the distribution.
    125  1.148  dholland  * 3. Neither the name of the University nor the names of its contributors
    126  1.148  dholland  *    may be used to endorse or promote products derived from this software
    127  1.148  dholland  *    without specific prior written permission.
    128  1.148  dholland  *
    129  1.148  dholland  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
    130  1.148  dholland  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
    131  1.148  dholland  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
    132  1.148  dholland  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
    133  1.148  dholland  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
    134  1.148  dholland  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
    135  1.148  dholland  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
    136  1.148  dholland  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
    137  1.148  dholland  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
    138  1.148  dholland  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
    139  1.148  dholland  * SUCH DAMAGE.
    140  1.148  dholland  *
    141  1.148  dholland  *	@(#)dir.h	8.5 (Berkeley) 4/27/95
    142  1.148  dholland  */
    143    1.1   mycroft 
    144  1.149  dholland /*
    145  1.149  dholland  * NOTE: COORDINATE ON-DISK FORMAT CHANGES WITH THE FREEBSD PROJECT.
    146  1.149  dholland  */
    147  1.149  dholland 
    148   1.42      matt #ifndef _UFS_LFS_LFS_H_
    149   1.42      matt #define _UFS_LFS_LFS_H_
    150   1.42      matt 
    151  1.177  dholland #if !defined(_KERNEL) && !defined(_STANDALONE)
    152  1.177  dholland #include <stddef.h> /* for offsetof */
    153  1.177  dholland #endif
    154  1.177  dholland 
    155  1.118        ad #include <sys/rwlock.h>
    156  1.123        ad #include <sys/mutex.h>
    157  1.124        ad #include <sys/queue.h>
    158  1.124        ad #include <sys/condvar.h>
    159  1.140  dholland #include <sys/mount.h>
    160  1.140  dholland #include <sys/pool.h>
    161  1.139  dholland 
    162   1.11  perseant /*
    163   1.11  perseant  * Compile-time options for LFS.
    164   1.11  perseant  */
    165   1.61  perseant #define LFS_IFIND_RETRIES  16
    166   1.61  perseant #define LFS_LOGLENGTH      1024 /* size of debugging log */
    167   1.61  perseant #define LFS_MAX_ACTIVE	   10	/* Dirty segments before ckp forced */
    168   1.39  perseant 
    169   1.11  perseant /*
    170   1.61  perseant  * Fixed filesystem layout parameters
    171   1.11  perseant  */
    172   1.61  perseant #define	LFS_LABELPAD	8192		/* LFS label size */
    173   1.61  perseant #define	LFS_SBPAD	8192		/* LFS superblock size */
    174   1.61  perseant 
    175   1.61  perseant #define	LFS_UNUSED_INUM	0		/* 0: out of band inode number */
    176   1.61  perseant #define	LFS_IFILE_INUM	1		/* 1: IFILE inode number */
    177   1.61  perseant 					/* 2: Root inode number */
    178  1.141  dholland #define	LFS_LOSTFOUNDINO 3		/* 3: lost+found inode number */
    179   1.61  perseant #define	LFS_FIRST_INUM	4		/* 4: first free inode number */
    180   1.61  perseant 
    181  1.145  dholland /*
    182  1.145  dholland  * The root inode is the root of the file system.  Inode 0 can't be used for
    183  1.145  dholland  * normal purposes and historically bad blocks were linked to inode 1, thus
    184  1.145  dholland  * the root inode is 2.  (Inode 1 is no longer used for this purpose, however
    185  1.145  dholland  * numerous dump tapes make this assumption, so we are stuck with it).
    186  1.145  dholland  */
    187  1.145  dholland #define	ULFS_ROOTINO	((ino_t)2)
    188  1.145  dholland 
    189  1.145  dholland /*
    190  1.145  dholland  * The Whiteout inode# is a dummy non-zero inode number which will
    191  1.145  dholland  * never be allocated to a real file.  It is used as a place holder
    192  1.145  dholland  * in the directory entry which has been tagged as a LFS_DT_WHT entry.
    193  1.145  dholland  * See the comments about ULFS_ROOTINO above.
    194  1.145  dholland  */
    195  1.145  dholland #define	ULFS_WINO	((ino_t)1)
    196  1.145  dholland 
    197  1.145  dholland 
    198   1.61  perseant #define	LFS_V1_SUMMARY_SIZE	512     /* V1 fixed summary size */
    199   1.61  perseant #define	LFS_DFL_SUMMARY_SIZE	512	/* Default summary size */
    200   1.61  perseant 
    201   1.92  christos #define LFS_MAXNAMLEN	255		/* maximum name length in a dir */
    202   1.92  christos 
    203  1.140  dholland #define ULFS_NXADDR	2
    204  1.140  dholland #define	ULFS_NDADDR	12		/* Direct addresses in inode. */
    205  1.140  dholland #define	ULFS_NIADDR	3		/* Indirect addresses in inode. */
    206  1.140  dholland 
    207  1.140  dholland /*
    208  1.140  dholland  * Adjustable filesystem parameters
    209  1.140  dholland  */
    210   1.37  perseant #ifndef LFS_ATIME_IFILE
    211   1.61  perseant # define LFS_ATIME_IFILE 0 /* Store atime info in ifile (optional in LFSv1) */
    212   1.37  perseant #endif
    213   1.61  perseant #define LFS_MARKV_MAXBLKCNT	65536	/* Max block count for lfs_markv() */
    214   1.61  perseant 
    215   1.35  perseant /*
    216  1.142  dholland  * Directories
    217  1.142  dholland  */
    218  1.142  dholland 
    219  1.142  dholland /*
    220  1.184  dholland  * Directories in LFS are files; they use the same inode and block
    221  1.184  dholland  * mapping structures that regular files do. The directory per se is
    222  1.184  dholland  * manifested in the file contents: an unordered, unstructured
    223  1.184  dholland  * sequence of variable-size directory entries.
    224  1.184  dholland  *
    225  1.184  dholland  * This format and structure is taken (via what was originally shared
    226  1.184  dholland  * ufs-level code) from FFS. Each directory entry is a fixed header
    227  1.184  dholland  * followed by a string, the total length padded to a 4-byte boundary.
    228  1.184  dholland  * All strings include a null terminator; the maximum string length
    229  1.184  dholland  * is LFS_MAXNAMLEN, which is 255.
    230  1.184  dholland  *
    231  1.189  dholland  * The directory entry header structure (struct lfs_dirheader) is just
    232  1.189  dholland  * the header information. A complete entry is this plus a null-
    233  1.189  dholland  * terminated name following it, plus some amount of padding. The
    234  1.189  dholland  * length of the name (not including the null terminator) is given by
    235  1.189  dholland  * the namlen field of the header; the complete record length,
    236  1.189  dholland  * including the null terminator and padding, is given by the reclen
    237  1.189  dholland  * field of the header. The record length is always 4-byte aligned.
    238  1.189  dholland  * (Even on 64-bit volumes, the record length is only 4-byte aligned,
    239  1.189  dholland  * not 8-byte.)
    240  1.184  dholland  *
    241  1.184  dholland  * Historically, FFS directories were/are organized into blocks of
    242  1.184  dholland  * size DIRBLKSIZE that can be written atomically to disk at the
    243  1.184  dholland  * hardware level. Directory entries are not allowed to cross the
    244  1.184  dholland  * boundaries of these blocks. The resulting atomicity is important
    245  1.184  dholland  * for the integrity of FFS volumes; however, for LFS it's irrelevant.
    246  1.184  dholland  * All we have to care about is not writing out directories that
    247  1.184  dholland  * confuse earlier ufs-based versions of the LFS code.
    248  1.184  dholland  *
    249  1.184  dholland  * This means [to be determined]. (XXX)
    250  1.184  dholland  *
    251  1.184  dholland  * As DIRBLKSIZE in its FFS sense is hardware-dependent, and file
    252  1.184  dholland  * system images do from time to time move to different hardware, code
    253  1.184  dholland  * that reads directories should be prepared to handle directories
    254  1.184  dholland  * written in a context where DIRBLKSIZE was different (smaller or
    255  1.184  dholland  * larger) than its current value. Note however that it is not
    256  1.184  dholland  * sensible for DIRBLKSIZE to be larger than the volume fragment size,
    257  1.184  dholland  * and not practically possible for it to be larger than the volume
    258  1.184  dholland  * block size.
    259  1.184  dholland  *
    260  1.184  dholland  * Some further notes:
    261  1.184  dholland  *    - the LFS_DIRSIZ macro provides the minimum space needed to hold
    262  1.184  dholland  *      a directory entry.
    263  1.184  dholland  *    - any particular entry may be arbitrarily larger (which is why the
    264  1.184  dholland  *      header stores both the entry size and the name size) to pad out
    265  1.184  dholland  *      unused space.
    266  1.189  dholland  *    - historically the padding in an entry is not necessarily zeroed
    267  1.189  dholland  *      but may contain trash.
    268  1.184  dholland  *    - dp->d_reclen is the size of the entry. This is always 4-byte
    269  1.184  dholland  *      aligned.
    270  1.184  dholland  *    - dp->d_namlen is the length of the string, and should always be
    271  1.184  dholland  *      the same as strlen(dp->d_name).
    272  1.184  dholland  *    - in particular, space available in an entry is given by
    273  1.184  dholland  *      dp->d_reclen - LFS_DIRSIZ(dp), and all space available within a
    274  1.184  dholland  *      directory block is tucked away within an existing entry.
    275  1.184  dholland  *    - all space within a directory block is part of some entry.
    276  1.184  dholland  *    - therefore, inserting a new entry requires finding and
    277  1.184  dholland  *      splitting a suitable existing entry, and when entries are
    278  1.184  dholland  *      removed their space is merged into the entry ahead of them.
    279  1.184  dholland  *    - an empty/unused entry has d_ino set to 0. This normally only
    280  1.184  dholland  *      appears in the first entry in a block, as elsewhere the unused
    281  1.189  dholland  *      entry should have been merged into the one before it. However,
    282  1.189  dholland  *      fsck leaves such entries behind so they must be tolerated
    283  1.189  dholland  *      elsewhere.
    284  1.184  dholland  *    - a completely empty directory block has one entry whose
    285  1.184  dholland  *      d_reclen is DIRBLKSIZ and whose d_ino is 0.
    286  1.184  dholland  *
    287  1.189  dholland  * The "old directory format" referenced by the fs->lfs_isolddirfmt
    288  1.189  dholland  * flag (and some other things) refers to when the type field was
    289  1.189  dholland  * added to directory entries. This change was made to FFS in the 80s,
    290  1.189  dholland  * well before LFS was first written; there should be no LFS volumes
    291  1.189  dholland  * (and certainly no LFS v2-format volumes or LFS64 volumes) where the
    292  1.189  dholland  * old format pertains. All of the related logic should probably be
    293  1.189  dholland  * removed; however, it hasn't been yet, and we get to carry it around
    294  1.189  dholland  * until we can be conclusively sure it isn't needed.
    295  1.189  dholland  *
    296  1.189  dholland  * In the "old directory format" there is no type field and the namlen
    297  1.189  dholland  * field is correspondingly 16 bits wide. On big-endian volumes this
    298  1.189  dholland  * has no effect: namlen cannot exceed 255, so the upper byte is
    299  1.189  dholland  * always 0 and this reads back from the type field as LFS_DT_UNKNOWN.
    300  1.189  dholland  * On little-endian volumes, the namlen field will always be 0 and
    301  1.189  dholland  * the namlen value needs to be read out of the type field. (The type
    302  1.189  dholland  * is always LFS_DT_UNKNOWN.) The directory accessor functions take
    303  1.189  dholland  * care of this so nothing else needs to be aware of it.
    304  1.189  dholland  *
    305  1.189  dholland  * LFS_OLDDIRFMT and LFS_NEWDIRFMT are code numbers for the old and
    306  1.189  dholland  * new directory format respectively. These codes do not appear on
    307  1.189  dholland  * disk; they're generated from a runtime macro called FSFMT() that's
    308  1.189  dholland  * cued by other things. This is why (confusingly) LFS_OLDDIRFMT is 1
    309  1.189  dholland  * and LFS_NEWDIRFMT is 0.
    310  1.189  dholland  *
    311  1.189  dholland  * FSFMT(), LFS_OLDDIRFMT, and LFS_NEWDIRFMT should be removed. (XXX)
    312  1.146  dholland  */
    313  1.146  dholland 
    314  1.146  dholland /*
    315  1.146  dholland  * Directory block size.
    316  1.146  dholland  */
    317  1.146  dholland #undef	LFS_DIRBLKSIZ
    318  1.146  dholland #define	LFS_DIRBLKSIZ	DEV_BSIZE
    319  1.146  dholland 
    320  1.146  dholland /*
    321  1.184  dholland  * Convert between stat structure type codes and directory entry type codes.
    322  1.146  dholland  */
    323  1.146  dholland #define	LFS_IFTODT(mode)	(((mode) & 0170000) >> 12)
    324  1.146  dholland #define	LFS_DTTOIF(dirtype)	((dirtype) << 12)
    325  1.146  dholland 
    326  1.146  dholland /*
    327  1.142  dholland  * Theoretically, directories can be more than 2Gb in length; however, in
    328  1.142  dholland  * practice this seems unlikely. So, we define the type doff_t as a 32-bit
    329  1.142  dholland  * quantity to keep down the cost of doing lookup on a 32-bit machine.
    330  1.142  dholland  */
    331  1.142  dholland #define	doff_t		int32_t
    332  1.142  dholland #define	lfs_doff_t	int32_t
    333  1.155  dholland #define	LFS_MAXDIRSIZE	(0x7fffffff)
    334  1.142  dholland 
    335  1.145  dholland /*
    336  1.145  dholland  * File types for d_type
    337  1.145  dholland  */
    338  1.145  dholland #define	LFS_DT_UNKNOWN	 0
    339  1.145  dholland #define	LFS_DT_FIFO	 1
    340  1.145  dholland #define	LFS_DT_CHR	 2
    341  1.145  dholland #define	LFS_DT_DIR	 4
    342  1.145  dholland #define	LFS_DT_BLK	 6
    343  1.145  dholland #define	LFS_DT_REG	 8
    344  1.145  dholland #define	LFS_DT_LNK	10
    345  1.145  dholland #define	LFS_DT_SOCK	12
    346  1.145  dholland #define	LFS_DT_WHT	14
    347  1.145  dholland 
    348  1.145  dholland /*
    349  1.150  dholland  * (See notes above)
    350  1.145  dholland  */
    351  1.191  dholland 
    352  1.191  dholland struct lfs_dirheader32 {
    353  1.199  dholland 	uint32_t dh_ino;		/* inode number of entry */
    354  1.199  dholland 	uint16_t dh_reclen;		/* length of this record */
    355  1.199  dholland 	uint8_t  dh_type; 		/* file type, see below */
    356  1.199  dholland 	uint8_t  dh_namlen;		/* length of string in d_name */
    357  1.187  dholland };
    358  1.206  riastrad __CTASSERT(sizeof(struct lfs_dirheader32) == 8);
    359  1.145  dholland 
    360  1.191  dholland struct lfs_dirheader64 {
    361  1.207  riastrad 	uint64_t dh_ino;		/* inode number of entry */
    362  1.199  dholland 	uint16_t dh_reclen;		/* length of this record */
    363  1.199  dholland 	uint8_t  dh_type; 		/* file type, see below */
    364  1.199  dholland 	uint8_t  dh_namlen;		/* length of string in d_name */
    365  1.207  riastrad } __aligned(4) __packed;
    366  1.206  riastrad __CTASSERT(sizeof(struct lfs_dirheader64) == 12);
    367  1.191  dholland 
    368  1.191  dholland union lfs_dirheader {
    369  1.191  dholland 	struct lfs_dirheader64 u_64;
    370  1.191  dholland 	struct lfs_dirheader32 u_32;
    371  1.191  dholland };
    372  1.207  riastrad __CTASSERT(__alignof(union lfs_dirheader) == __alignof(struct lfs_dirheader64));
    373  1.208  christos #ifndef __lint__
    374  1.207  riastrad __CTASSERT(__alignof(union lfs_dirheader) == __alignof(struct lfs_dirheader32));
    375  1.208  christos #endif
    376  1.191  dholland 
    377  1.191  dholland typedef union lfs_dirheader LFS_DIRHEADER;
    378  1.191  dholland 
    379  1.145  dholland /*
    380  1.190  dholland  * Template for manipulating directories.
    381  1.145  dholland  */
    382  1.191  dholland 
    383  1.191  dholland struct lfs_dirtemplate32 {
    384  1.191  dholland 	struct lfs_dirheader32	dot_header;
    385  1.191  dholland 	char			dot_name[4];	/* must be multiple of 4 */
    386  1.191  dholland 	struct lfs_dirheader32	dotdot_header;
    387  1.191  dholland 	char			dotdot_name[4];	/* ditto */
    388  1.191  dholland };
    389  1.206  riastrad __CTASSERT(sizeof(struct lfs_dirtemplate32) == 2*(8 + 4));
    390  1.191  dholland 
    391  1.191  dholland struct lfs_dirtemplate64 {
    392  1.191  dholland 	struct lfs_dirheader64	dot_header;
    393  1.190  dholland 	char			dot_name[4];	/* must be multiple of 4 */
    394  1.191  dholland 	struct lfs_dirheader64	dotdot_header;
    395  1.190  dholland 	char			dotdot_name[4];	/* ditto */
    396  1.145  dholland };
    397  1.206  riastrad __CTASSERT(sizeof(struct lfs_dirtemplate64) == 2*(12 + 4));
    398  1.145  dholland 
    399  1.191  dholland union lfs_dirtemplate {
    400  1.191  dholland 	struct lfs_dirtemplate64 u_64;
    401  1.191  dholland 	struct lfs_dirtemplate32 u_32;
    402  1.191  dholland };
    403  1.191  dholland 
    404  1.190  dholland #if 0
    405  1.145  dholland /*
    406  1.145  dholland  * This is the old format of directories, sans type element.
    407  1.145  dholland  */
    408  1.145  dholland struct lfs_odirtemplate {
    409  1.199  dholland 	uint32_t	dot_ino;
    410  1.145  dholland 	int16_t		dot_reclen;
    411  1.199  dholland 	uint16_t	dot_namlen;
    412  1.145  dholland 	char		dot_name[4];	/* must be multiple of 4 */
    413  1.199  dholland 	uint32_t	dotdot_ino;
    414  1.145  dholland 	int16_t		dotdot_reclen;
    415  1.199  dholland 	uint16_t	dotdot_namlen;
    416  1.145  dholland 	char		dotdot_name[4];	/* ditto */
    417  1.145  dholland };
    418  1.206  riastrad __CTASSERT(sizeof(struct lfs_odirtemplate) == 2*(8 + 4));
    419  1.190  dholland #endif
    420  1.145  dholland 
    421  1.142  dholland /*
    422  1.143  dholland  * Inodes
    423  1.143  dholland  */
    424  1.143  dholland 
    425  1.143  dholland /*
    426  1.151  dholland  * A dinode contains all the meta-data associated with a LFS file.
    427  1.143  dholland  * This structure defines the on-disk format of a dinode. Since
    428  1.143  dholland  * this structure describes an on-disk structure, all its fields
    429  1.143  dholland  * are defined by types with precise widths.
    430  1.143  dholland  */
    431  1.143  dholland 
    432  1.180  dholland struct lfs32_dinode {
    433  1.199  dholland 	uint16_t	di_mode;	/*   0: IFMT, permissions; see below. */
    434  1.143  dholland 	int16_t		di_nlink;	/*   2: File link count. */
    435  1.199  dholland 	uint32_t	di_inumber;	/*   4: Inode number. */
    436  1.199  dholland 	uint64_t	di_size;	/*   8: File byte count. */
    437  1.143  dholland 	int32_t		di_atime;	/*  16: Last access time. */
    438  1.143  dholland 	int32_t		di_atimensec;	/*  20: Last access time. */
    439  1.143  dholland 	int32_t		di_mtime;	/*  24: Last modified time. */
    440  1.143  dholland 	int32_t		di_mtimensec;	/*  28: Last modified time. */
    441  1.143  dholland 	int32_t		di_ctime;	/*  32: Last inode change time. */
    442  1.143  dholland 	int32_t		di_ctimensec;	/*  36: Last inode change time. */
    443  1.143  dholland 	int32_t		di_db[ULFS_NDADDR]; /*  40: Direct disk blocks. */
    444  1.143  dholland 	int32_t		di_ib[ULFS_NIADDR]; /*  88: Indirect disk blocks. */
    445  1.199  dholland 	uint32_t	di_flags;	/* 100: Status flags (chflags). */
    446  1.199  dholland 	uint32_t	di_blocks;	/* 104: Blocks actually held. */
    447  1.143  dholland 	int32_t		di_gen;		/* 108: Generation number. */
    448  1.199  dholland 	uint32_t	di_uid;		/* 112: File owner. */
    449  1.199  dholland 	uint32_t	di_gid;		/* 116: File group. */
    450  1.199  dholland 	uint64_t	di_modrev;	/* 120: i_modrev for NFSv4 */
    451  1.143  dholland };
    452  1.206  riastrad __CTASSERT(sizeof(struct lfs32_dinode) == 128);
    453  1.143  dholland 
    454  1.180  dholland struct lfs64_dinode {
    455  1.199  dholland 	uint16_t	di_mode;	/*   0: IFMT, permissions; see below. */
    456  1.143  dholland 	int16_t		di_nlink;	/*   2: File link count. */
    457  1.199  dholland 	uint32_t	di_uid;		/*   4: File owner. */
    458  1.199  dholland 	uint32_t	di_gid;		/*   8: File group. */
    459  1.199  dholland 	uint32_t	di_blksize;	/*  12: Inode blocksize. */
    460  1.199  dholland 	uint64_t	di_size;	/*  16: File byte count. */
    461  1.199  dholland 	uint64_t	di_blocks;	/*  24: Bytes actually held. */
    462  1.143  dholland 	int64_t		di_atime;	/*  32: Last access time. */
    463  1.143  dholland 	int64_t		di_mtime;	/*  40: Last modified time. */
    464  1.143  dholland 	int64_t		di_ctime;	/*  48: Last inode change time. */
    465  1.143  dholland 	int64_t		di_birthtime;	/*  56: Inode creation time. */
    466  1.143  dholland 	int32_t		di_mtimensec;	/*  64: Last modified time. */
    467  1.143  dholland 	int32_t		di_atimensec;	/*  68: Last access time. */
    468  1.143  dholland 	int32_t		di_ctimensec;	/*  72: Last inode change time. */
    469  1.143  dholland 	int32_t		di_birthnsec;	/*  76: Inode creation time. */
    470  1.143  dholland 	int32_t		di_gen;		/*  80: Generation number. */
    471  1.199  dholland 	uint32_t	di_kernflags;	/*  84: Kernel flags. */
    472  1.199  dholland 	uint32_t	di_flags;	/*  88: Status flags (chflags). */
    473  1.143  dholland 	int32_t		di_extsize;	/*  92: External attributes block. */
    474  1.143  dholland 	int64_t		di_extb[ULFS_NXADDR];/* 96: External attributes block. */
    475  1.143  dholland 	int64_t		di_db[ULFS_NDADDR]; /* 112: Direct disk blocks. */
    476  1.143  dholland 	int64_t		di_ib[ULFS_NIADDR]; /* 208: Indirect disk blocks. */
    477  1.199  dholland 	uint64_t	di_modrev;	/* 232: i_modrev for NFSv4 */
    478  1.199  dholland 	uint64_t	di_inumber;	/* 240: Inode number */
    479  1.204    martin 	uint64_t	di_spare[1];	/* 248: Reserved; currently unused */
    480  1.143  dholland };
    481  1.206  riastrad __CTASSERT(sizeof(struct lfs64_dinode) == 256);
    482  1.143  dholland 
    483  1.180  dholland union lfs_dinode {
    484  1.180  dholland 	struct lfs64_dinode u_64;
    485  1.180  dholland 	struct lfs32_dinode u_32;
    486  1.180  dholland };
    487  1.207  riastrad __CTASSERT(__alignof(union lfs_dinode) == __alignof(struct lfs64_dinode));
    488  1.207  riastrad __CTASSERT(__alignof(union lfs_dinode) == __alignof(struct lfs32_dinode));
    489  1.180  dholland 
    490  1.143  dholland /*
    491  1.143  dholland  * The di_db fields may be overlaid with other information for
    492  1.143  dholland  * file types that do not have associated disk storage. Block
    493  1.143  dholland  * and character devices overlay the first data block with their
    494  1.143  dholland  * dev_t value. Short symbolic links place their path in the
    495  1.143  dholland  * di_db area.
    496  1.143  dholland  */
    497  1.143  dholland #define	di_rdev		di_db[0]
    498  1.143  dholland 
    499  1.143  dholland /* Size of the on-disk inode. */
    500  1.180  dholland //#define	LFS_DINODE1_SIZE	(sizeof(struct ulfs1_dinode))	/* 128 */
    501  1.180  dholland //#define	LFS_DINODE2_SIZE	(sizeof(struct ulfs2_dinode))
    502  1.143  dholland 
    503  1.144  dholland /* File types, found in the upper bits of di_mode. */
    504  1.144  dholland #define	LFS_IFMT	0170000		/* Mask of file type. */
    505  1.144  dholland #define	LFS_IFIFO	0010000		/* Named pipe (fifo). */
    506  1.144  dholland #define	LFS_IFCHR	0020000		/* Character device. */
    507  1.144  dholland #define	LFS_IFDIR	0040000		/* Directory file. */
    508  1.144  dholland #define	LFS_IFBLK	0060000		/* Block device. */
    509  1.144  dholland #define	LFS_IFREG	0100000		/* Regular file. */
    510  1.144  dholland #define	LFS_IFLNK	0120000		/* Symbolic link. */
    511  1.144  dholland #define	LFS_IFSOCK	0140000		/* UNIX domain socket. */
    512  1.144  dholland #define	LFS_IFWHT	0160000		/* Whiteout. */
    513  1.144  dholland 
    514  1.143  dholland /*
    515   1.61  perseant  * "struct buf" associated definitions
    516   1.35  perseant  */
    517   1.35  perseant 
    518   1.61  perseant /* Unassigned disk addresses. */
    519   1.61  perseant #define	UNASSIGNED	-1
    520   1.61  perseant #define UNWRITTEN	-2
    521   1.61  perseant 
    522   1.61  perseant /* Unused logical block number */
    523   1.61  perseant #define LFS_UNUSED_LBN	-1
    524   1.46  perseant 
    525   1.61  perseant /*
    526   1.61  perseant  * On-disk and in-memory checkpoint segment usage structure.
    527   1.61  perseant  */
    528    1.1   mycroft typedef struct segusage SEGUSE;
    529    1.1   mycroft struct segusage {
    530  1.199  dholland 	uint32_t su_nbytes;		/* 0: number of live bytes */
    531  1.199  dholland 	uint32_t su_olastmod;		/* 4: SEGUSE last modified timestamp */
    532  1.199  dholland 	uint16_t su_nsums;		/* 8: number of summaries in segment */
    533  1.199  dholland 	uint16_t su_ninos;		/* 10: number of inode blocks in seg */
    534   1.37  perseant 
    535   1.37  perseant #define	SEGUSE_ACTIVE		0x01	/*  segment currently being written */
    536   1.37  perseant #define	SEGUSE_DIRTY		0x02	/*  segment has data in it */
    537   1.37  perseant #define	SEGUSE_SUPERBLOCK	0x04	/*  segment contains a superblock */
    538   1.49  perseant #define SEGUSE_ERROR		0x08	/*  cleaner: do not clean segment */
    539   1.49  perseant #define SEGUSE_EMPTY		0x10	/*  segment is empty */
    540   1.86  perseant #define SEGUSE_INVAL		0x20	/*  segment is invalid */
    541  1.199  dholland 	uint32_t su_flags;		/* 12: segment flags */
    542  1.199  dholland 	uint64_t su_lastmod;		/* 16: last modified timestamp */
    543    1.1   mycroft };
    544  1.206  riastrad __CTASSERT(sizeof(struct segusage) == 24);
    545    1.1   mycroft 
    546   1.37  perseant typedef struct segusage_v1 SEGUSE_V1;
    547   1.37  perseant struct segusage_v1 {
    548  1.199  dholland 	uint32_t su_nbytes;		/* 0: number of live bytes */
    549  1.199  dholland 	uint32_t su_lastmod;		/* 4: SEGUSE last modified timestamp */
    550  1.199  dholland 	uint16_t su_nsums;		/* 8: number of summaries in segment */
    551  1.199  dholland 	uint16_t su_ninos;		/* 10: number of inode blocks in seg */
    552  1.199  dholland 	uint32_t su_flags;		/* 12: segment flags  */
    553   1.37  perseant };
    554  1.206  riastrad __CTASSERT(sizeof(struct segusage_v1) == 16);
    555   1.37  perseant 
    556   1.61  perseant /*
    557   1.61  perseant  * On-disk file information.  One per file with data blocks in the segment.
    558  1.178  dholland  *
    559  1.178  dholland  * The FINFO structure is a header; it is followed by fi_nblocks block
    560  1.178  dholland  * pointers, which are logical block numbers of the file. (These are the
    561  1.178  dholland  * blocks of the file present in this segment.)
    562   1.61  perseant  */
    563  1.178  dholland 
    564  1.178  dholland typedef struct finfo64 FINFO64;
    565  1.178  dholland struct finfo64 {
    566  1.199  dholland 	uint32_t fi_nblocks;		/* number of blocks */
    567  1.199  dholland 	uint32_t fi_version;		/* version number */
    568  1.199  dholland 	uint64_t fi_ino;		/* inode number */
    569  1.199  dholland 	uint32_t fi_lastlength;		/* length of last block in array */
    570  1.199  dholland 	uint32_t fi_pad;		/* unused */
    571  1.207  riastrad } __aligned(4) __packed;
    572  1.206  riastrad __CTASSERT(sizeof(struct finfo64) == 24);
    573  1.178  dholland 
    574  1.178  dholland typedef struct finfo32 FINFO32;
    575  1.178  dholland struct finfo32 {
    576  1.199  dholland 	uint32_t fi_nblocks;		/* number of blocks */
    577  1.199  dholland 	uint32_t fi_version;		/* version number */
    578  1.199  dholland 	uint32_t fi_ino;		/* inode number */
    579  1.199  dholland 	uint32_t fi_lastlength;		/* length of last block in array */
    580    1.1   mycroft };
    581  1.206  riastrad __CTASSERT(sizeof(struct finfo32) == 16);
    582  1.178  dholland 
    583  1.178  dholland typedef union finfo {
    584  1.178  dholland 	struct finfo64 u_64;
    585  1.178  dholland 	struct finfo32 u_32;
    586  1.178  dholland } FINFO;
    587  1.207  riastrad __CTASSERT(__alignof(union finfo) == __alignof(struct finfo64));
    588  1.208  christos #ifndef __lint__
    589  1.207  riastrad __CTASSERT(__alignof(union finfo) == __alignof(struct finfo32));
    590  1.208  christos #endif
    591   1.37  perseant 
    592   1.61  perseant /*
    593  1.193  dholland  * inode info (part of the segment summary)
    594  1.193  dholland  *
    595  1.193  dholland  * Each one of these is just a block number; wrapping the structure
    596  1.193  dholland  * around it gives more contextual information in the code about
    597  1.193  dholland  * what's going on.
    598  1.193  dholland  */
    599  1.193  dholland 
    600  1.193  dholland typedef struct iinfo64 {
    601  1.193  dholland 	uint64_t ii_block;		/* block number */
    602  1.207  riastrad } __aligned(4) __packed IINFO64;
    603  1.206  riastrad __CTASSERT(sizeof(struct iinfo64) == 8);
    604  1.193  dholland 
    605  1.193  dholland typedef struct iinfo32 {
    606  1.193  dholland 	uint32_t ii_block;		/* block number */
    607  1.193  dholland } IINFO32;
    608  1.206  riastrad __CTASSERT(sizeof(struct iinfo32) == 4);
    609  1.193  dholland 
    610  1.193  dholland typedef union iinfo {
    611  1.193  dholland 	struct iinfo64 u_64;
    612  1.193  dholland 	struct iinfo32 u_32;
    613  1.193  dholland } IINFO;
    614  1.207  riastrad __CTASSERT(__alignof(union iinfo) == __alignof(struct iinfo64));
    615  1.208  christos #ifndef __lint__
    616  1.207  riastrad __CTASSERT(__alignof(union iinfo) == __alignof(struct iinfo32));
    617  1.208  christos #endif
    618  1.193  dholland 
    619  1.193  dholland /*
    620   1.61  perseant  * Index file inode entries.
    621   1.61  perseant  */
    622  1.176  dholland 
    623  1.210  perseant /* magic values for daddrs */
    624  1.176  dholland #define	LFS_UNUSED_DADDR	0	/* out-of-band daddr */
    625  1.210  perseant #ifdef DEBUG
    626  1.210  perseant # define LFS_ILLEGAL_DADDR	-1	/* out-of-band daddr */
    627  1.210  perseant # define DADDR_IS_BAD(daddr) \
    628  1.210  perseant 	((daddr) == LFS_UNUSED_DADDR || (daddr) == LFS_ILLEGAL_DADDR)
    629  1.210  perseant #else /* ! DEBUG */
    630  1.210  perseant # define LFS_ILLEGAL_DADDR	LFS_UNUSED_DADDR
    631  1.209  perseant # define DADDR_IS_BAD(daddr) ((daddr) == LFS_UNUSED_DADDR)
    632  1.210  perseant #endif /* ! DEBUG */
    633  1.210  perseant 
    634  1.205  riastrad /* magic value for if_nextfree -- indicate orphaned file */
    635  1.205  riastrad #define LFS_ORPHAN_NEXTFREE(fs) \
    636  1.205  riastrad 	((fs)->lfs_is64 ? ~(uint64_t)0 : ~(uint32_t)0)
    637  1.176  dholland 
    638  1.210  perseant #define INUM_IS_BAD(fs, ino) \
    639  1.210  perseant 	(ino == LFS_UNUSED_INUM || ino == LFS_ORPHAN_NEXTFREE(fs))
    640  1.210  perseant 
    641  1.176  dholland typedef struct ifile64 IFILE64;
    642  1.176  dholland struct ifile64 {
    643  1.199  dholland 	uint32_t if_version;		/* inode version number */
    644  1.199  dholland 	uint32_t if_atime_nsec;		/* and nanoseconds */
    645  1.199  dholland 	uint64_t if_atime_sec;		/* Last access time, seconds */
    646  1.176  dholland 	int64_t	  if_daddr;		/* inode disk address */
    647  1.199  dholland 	uint64_t if_nextfree;		/* next-unallocated inode */
    648  1.207  riastrad } __aligned(4) __packed;
    649  1.206  riastrad __CTASSERT(sizeof(struct ifile64) == 32);
    650  1.176  dholland 
    651  1.176  dholland typedef struct ifile32 IFILE32;
    652  1.176  dholland struct ifile32 {
    653  1.199  dholland 	uint32_t if_version;		/* inode version number */
    654   1.61  perseant 	int32_t	  if_daddr;		/* inode disk address */
    655  1.199  dholland 	uint32_t if_nextfree;		/* next-unallocated inode */
    656  1.199  dholland 	uint32_t if_atime_sec;		/* Last access time, seconds */
    657  1.199  dholland 	uint32_t if_atime_nsec;		/* and nanoseconds */
    658   1.61  perseant };
    659  1.206  riastrad __CTASSERT(sizeof(struct ifile32) == 20);
    660   1.61  perseant 
    661   1.61  perseant typedef struct ifile_v1 IFILE_V1;
    662   1.61  perseant struct ifile_v1 {
    663  1.199  dholland 	uint32_t if_version;		/* inode version number */
    664   1.61  perseant 	int32_t	  if_daddr;		/* inode disk address */
    665  1.199  dholland 	uint32_t if_nextfree;		/* next-unallocated inode */
    666   1.61  perseant #if LFS_ATIME_IFILE
    667  1.176  dholland #error "this cannot work"
    668   1.61  perseant 	struct timespec if_atime;	/* Last access time */
    669   1.61  perseant #endif
    670   1.61  perseant };
    671  1.206  riastrad __CTASSERT(sizeof(struct ifile_v1) == 12);
    672   1.61  perseant 
    673   1.61  perseant /*
    674  1.176  dholland  * Note: struct ifile_v1 is often handled by accessing the first three
    675  1.176  dholland  * fields of struct ifile32. (XXX: Blah.  This should be cleaned up as
    676  1.176  dholland  * it may in some cases violate the strict-aliasing rules.)
    677  1.176  dholland  */
    678  1.176  dholland typedef union ifile {
    679  1.176  dholland 	struct ifile64 u_64;
    680  1.176  dholland 	struct ifile32 u_32;
    681  1.176  dholland 	struct ifile_v1 u_v1;
    682  1.176  dholland } IFILE;
    683  1.207  riastrad __CTASSERT(__alignof(union ifile) == __alignof(struct ifile64));
    684  1.208  christos #ifndef __lint__
    685  1.207  riastrad __CTASSERT(__alignof(union ifile) == __alignof(struct ifile32));
    686  1.207  riastrad __CTASSERT(__alignof(union ifile) == __alignof(struct ifile_v1));
    687  1.208  christos #endif
    688  1.176  dholland 
    689  1.176  dholland /*
    690   1.61  perseant  * Cleaner information structure.  This resides in the ifile and is used
    691   1.61  perseant  * to pass information from the kernel to the cleaner.
    692   1.61  perseant  */
    693  1.175  dholland 
    694  1.175  dholland /* flags for ->flags */
    695  1.114  perseant #define LFS_CLEANER_MUST_CLEAN	0x01
    696  1.175  dholland 
    697  1.175  dholland typedef struct _cleanerinfo32 {
    698  1.199  dholland 	uint32_t clean;			/* 0: number of clean segments */
    699  1.199  dholland 	uint32_t dirty;			/* 4: number of dirty segments */
    700  1.175  dholland 	int32_t   bfree;		/* 8: disk blocks free */
    701  1.175  dholland 	int32_t	  avail;		/* 12: disk blocks available */
    702  1.199  dholland 	uint32_t free_head;		/* 16: head of the inode free list */
    703  1.199  dholland 	uint32_t free_tail;		/* 20: tail of the inode free list */
    704  1.199  dholland 	uint32_t flags;			/* 24: status word from the kernel */
    705  1.175  dholland } CLEANERINFO32;
    706  1.206  riastrad __CTASSERT(sizeof(struct _cleanerinfo32) == 28);
    707  1.175  dholland 
    708  1.175  dholland typedef struct _cleanerinfo64 {
    709  1.199  dholland 	uint32_t clean;			/* 0: number of clean segments */
    710  1.199  dholland 	uint32_t dirty;			/* 4: number of dirty segments */
    711  1.175  dholland 	int64_t   bfree;		/* 8: disk blocks free */
    712  1.175  dholland 	int64_t	  avail;		/* 16: disk blocks available */
    713  1.199  dholland 	uint64_t free_head;		/* 24: head of the inode free list */
    714  1.199  dholland 	uint64_t free_tail;		/* 32: tail of the inode free list */
    715  1.199  dholland 	uint32_t flags;			/* 40: status word from the kernel */
    716  1.199  dholland 	uint32_t pad;			/* 44: must be 64-bit aligned */
    717  1.207  riastrad } __aligned(4) __packed CLEANERINFO64;
    718  1.206  riastrad __CTASSERT(sizeof(struct _cleanerinfo64) == 48);
    719  1.175  dholland 
    720  1.175  dholland /* this must not go to disk directly of course */
    721  1.175  dholland typedef union _cleanerinfo {
    722  1.175  dholland 	CLEANERINFO32 u_32;
    723  1.175  dholland 	CLEANERINFO64 u_64;
    724   1.61  perseant } CLEANERINFO;
    725  1.208  christos #ifndef __lint__
    726  1.207  riastrad __CTASSERT(__alignof(union _cleanerinfo) == __alignof(struct _cleanerinfo32));
    727  1.207  riastrad __CTASSERT(__alignof(union _cleanerinfo) == __alignof(struct _cleanerinfo64));
    728  1.208  christos #endif
    729   1.61  perseant 
    730   1.61  perseant /*
    731   1.61  perseant  * On-disk segment summary information
    732   1.61  perseant  */
    733  1.177  dholland 
    734  1.177  dholland /* magic value for ss_magic */
    735  1.177  dholland #define SS_MAGIC	0x061561
    736  1.177  dholland 
    737  1.177  dholland /* flags for ss_flags */
    738  1.177  dholland #define	SS_DIROP	0x01		/* segment begins a dirop */
    739  1.177  dholland #define	SS_CONT		0x02		/* more partials to finish this write*/
    740  1.177  dholland #define	SS_CLEAN	0x04		/* written by the cleaner */
    741  1.177  dholland #define	SS_RFW		0x08		/* written by the roll-forward agent */
    742  1.177  dholland #define	SS_RECLAIM	0x10		/* written by the roll-forward agent */
    743  1.177  dholland 
    744  1.194  dholland /* type used for reading checksum signatures from metadata structures */
    745  1.194  dholland typedef uint32_t lfs_checkword;
    746  1.194  dholland 
    747   1.61  perseant typedef struct segsum_v1 SEGSUM_V1;
    748   1.61  perseant struct segsum_v1 {
    749  1.199  dholland 	uint32_t ss_sumsum;		/* 0: check sum of summary block */
    750  1.199  dholland 	uint32_t ss_datasum;		/* 4: check sum of data */
    751  1.199  dholland 	uint32_t ss_magic;		/* 8: segment summary magic number */
    752   1.61  perseant 	int32_t	  ss_next;		/* 12: next segment */
    753  1.199  dholland 	uint32_t ss_create;		/* 16: creation time stamp */
    754  1.199  dholland 	uint16_t ss_nfinfo;		/* 20: number of file info structures */
    755  1.199  dholland 	uint16_t ss_ninos;		/* 22: number of inodes in summary */
    756  1.199  dholland 	uint16_t ss_flags;		/* 24: used for directory operations */
    757  1.199  dholland 	uint16_t ss_pad;		/* 26: extra space */
    758   1.61  perseant 	/* FINFO's and inode daddr's... */
    759   1.61  perseant };
    760  1.206  riastrad __CTASSERT(sizeof(struct segsum_v1) == 28);
    761   1.61  perseant 
    762  1.177  dholland typedef struct segsum32 SEGSUM32;
    763  1.177  dholland struct segsum32 {
    764  1.199  dholland 	uint32_t ss_sumsum;		/* 0: check sum of summary block */
    765  1.199  dholland 	uint32_t ss_datasum;		/* 4: check sum of data */
    766  1.199  dholland 	uint32_t ss_magic;		/* 8: segment summary magic number */
    767  1.169  dholland 	int32_t	  ss_next;		/* 12: next segment (disk address) */
    768  1.199  dholland 	uint32_t ss_ident;		/* 16: roll-forward fsid */
    769  1.199  dholland 	uint16_t ss_nfinfo;		/* 20: number of file info structures */
    770  1.199  dholland 	uint16_t ss_ninos;		/* 22: number of inodes in summary */
    771  1.199  dholland 	uint16_t ss_flags;		/* 24: used for directory operations */
    772  1.199  dholland 	uint8_t  ss_pad[2];		/* 26: extra space */
    773  1.199  dholland 	uint32_t ss_reclino;		/* 28: inode being reclaimed */
    774  1.199  dholland 	uint64_t ss_serial;		/* 32: serial number */
    775  1.199  dholland 	uint64_t ss_create;		/* 40: time stamp */
    776   1.61  perseant 	/* FINFO's and inode daddr's... */
    777  1.207  riastrad } __aligned(4) __packed;
    778  1.206  riastrad __CTASSERT(sizeof(struct segsum32) == 48);
    779   1.61  perseant 
    780  1.177  dholland typedef struct segsum64 SEGSUM64;
    781  1.177  dholland struct segsum64 {
    782  1.199  dholland 	uint32_t ss_sumsum;		/* 0: check sum of summary block */
    783  1.199  dholland 	uint32_t ss_datasum;		/* 4: check sum of data */
    784  1.199  dholland 	uint32_t ss_magic;		/* 8: segment summary magic number */
    785  1.199  dholland 	uint32_t ss_ident;		/* 12: roll-forward fsid */
    786  1.177  dholland 	int64_t	  ss_next;		/* 16: next segment (disk address) */
    787  1.199  dholland 	uint16_t ss_nfinfo;		/* 24: number of file info structures */
    788  1.199  dholland 	uint16_t ss_ninos;		/* 26: number of inodes in summary */
    789  1.199  dholland 	uint16_t ss_flags;		/* 28: used for directory operations */
    790  1.199  dholland 	uint8_t  ss_pad[2];		/* 30: extra space */
    791  1.199  dholland 	uint64_t ss_reclino;		/* 32: inode being reclaimed */
    792  1.199  dholland 	uint64_t ss_serial;		/* 40: serial number */
    793  1.199  dholland 	uint64_t ss_create;		/* 48: time stamp */
    794  1.177  dholland 	/* FINFO's and inode daddr's... */
    795  1.207  riastrad } __aligned(4) __packed;
    796  1.206  riastrad __CTASSERT(sizeof(struct segsum64) == 56);
    797  1.177  dholland 
    798  1.177  dholland typedef union segsum SEGSUM;
    799  1.177  dholland union segsum {
    800  1.177  dholland 	struct segsum64 u_64;
    801  1.177  dholland 	struct segsum32 u_32;
    802  1.177  dholland 	struct segsum_v1 u_v1;
    803  1.177  dholland };
    804  1.207  riastrad __CTASSERT(__alignof(union segsum) == __alignof(struct segsum64));
    805  1.207  riastrad __CTASSERT(__alignof(union segsum) == __alignof(struct segsum32));
    806  1.208  christos #ifndef __lint__
    807  1.207  riastrad __CTASSERT(__alignof(union segsum) == __alignof(struct segsum_v1));
    808  1.208  christos #endif
    809   1.61  perseant 
    810   1.61  perseant /*
    811   1.61  perseant  * On-disk super block.
    812  1.171  dholland  *
    813  1.171  dholland  * We have separate superblock structures for the 32-bit and 64-bit
    814  1.171  dholland  * LFS, and accessor functions to hide the differences.
    815  1.171  dholland  *
    816  1.171  dholland  * For lfs64, the format version is always 2; version 1 lfs is old.
    817  1.171  dholland  * For both, the inode format version is 0; for lfs32 this selects the
    818  1.171  dholland  * same 32-bit inode as always, and for lfs64 this selects the larger
    819  1.171  dholland  * 64-bit inode structure we got from ffsv2.
    820  1.171  dholland  *
    821  1.171  dholland  * In lfs64:
    822  1.197  dholland  *   - inode numbers are 64 bit now
    823  1.171  dholland  *   - segments may not be larger than 4G (counted in bytes)
    824  1.171  dholland  *   - there may not be more than 2^32 (or perhaps 2^31) segments
    825  1.171  dholland  *   - the total volume size is limited to 2^63 frags and/or 2^63
    826  1.171  dholland  *     disk blocks, and probably in practice 2^63 bytes.
    827   1.61  perseant  */
    828  1.171  dholland 
    829  1.171  dholland #define	       LFS_MAGIC       		0x070162
    830  1.171  dholland #define        LFS_MAGIC_SWAPPED	0x62010700
    831  1.171  dholland 
    832  1.196  dholland #define        LFS64_MAGIC     		(0x19620701 ^ 0xffffffff)
    833  1.196  dholland #define        LFS64_MAGIC_SWAPPED      (0x01076219 ^ 0xffffffff)
    834  1.171  dholland 
    835  1.171  dholland #define	       LFS_VERSION     		2
    836  1.171  dholland 
    837  1.171  dholland #define LFS_MIN_SBINTERVAL     5	/* min superblock segment spacing */
    838  1.171  dholland #define LFS_MAXNUMSB	       10	/* max number of superblocks */
    839  1.171  dholland 
    840  1.171  dholland /* flags for dlfs_pflags */
    841  1.171  dholland #define LFS_PF_CLEAN 0x1
    842  1.171  dholland 
    843  1.171  dholland /* Inode format versions */
    844  1.171  dholland #define LFS_44INODEFMT 0
    845  1.171  dholland #define LFS_MAXINODEFMT 0
    846  1.171  dholland 
    847   1.10        pk struct dlfs {
    848  1.199  dholland 	uint32_t dlfs_magic;	  /* 0: magic number */
    849  1.199  dholland 	uint32_t dlfs_version;	  /* 4: version number */
    850   1.49  perseant 
    851  1.199  dholland 	uint32_t dlfs_size;	  /* 8: number of blocks in fs (v1) */
    852   1.49  perseant 				  /*	number of frags in fs (v2) */
    853  1.199  dholland 	uint32_t dlfs_ssize;	  /* 12: number of blocks per segment (v1) */
    854   1.49  perseant 				  /*	 number of bytes per segment (v2) */
    855  1.199  dholland 	uint32_t dlfs_dsize;	  /* 16: number of disk blocks in fs */
    856  1.199  dholland 	uint32_t dlfs_bsize;	  /* 20: file system block size */
    857  1.199  dholland 	uint32_t dlfs_fsize;	  /* 24: size of frag blocks in fs */
    858  1.199  dholland 	uint32_t dlfs_frag;	  /* 28: number of frags in a block in fs */
    859    1.1   mycroft 
    860    1.1   mycroft /* Checkpoint region. */
    861  1.199  dholland 	uint32_t dlfs_freehd;	  /* 32: start of the free inode list */
    862  1.168  dholland 	int32_t   dlfs_bfree;	  /* 36: number of free frags */
    863  1.199  dholland 	uint32_t dlfs_nfiles;	  /* 40: number of allocated inodes */
    864   1.49  perseant 	int32_t	  dlfs_avail;	  /* 44: blocks available for writing */
    865   1.49  perseant 	int32_t	  dlfs_uinodes;	  /* 48: inodes in cache not yet on disk */
    866   1.49  perseant 	int32_t	  dlfs_idaddr;	  /* 52: inode file disk address */
    867  1.199  dholland 	uint32_t dlfs_ifile;	  /* 56: inode file inode number */
    868   1.54  perseant 	int32_t	  dlfs_lastseg;	  /* 60: address of last segment written */
    869   1.54  perseant 	int32_t	  dlfs_nextseg;	  /* 64: address of next segment to write */
    870   1.54  perseant 	int32_t	  dlfs_curseg;	  /* 68: current segment being written */
    871   1.54  perseant 	int32_t	  dlfs_offset;	  /* 72: offset in curseg for next partial */
    872   1.49  perseant 	int32_t	  dlfs_lastpseg;  /* 76: address of last partial written */
    873  1.199  dholland 	uint32_t dlfs_inopf;	  /* 80: v1: time stamp; v2: inodes per frag */
    874    1.1   mycroft 
    875    1.1   mycroft /* These are configuration parameters. */
    876  1.199  dholland 	uint32_t dlfs_minfree;	  /* 84: minimum percentage of free blocks */
    877    1.1   mycroft 
    878    1.1   mycroft /* These fields can be computed from the others. */
    879  1.199  dholland 	uint64_t dlfs_maxfilesize; /* 88: maximum representable file size */
    880  1.199  dholland 	uint32_t dlfs_fsbpseg;	  /* 96: frags (fsb) per segment */
    881  1.199  dholland 	uint32_t dlfs_inopb;	  /* 100: inodes per block */
    882  1.199  dholland 	uint32_t dlfs_ifpb;	  /* 104: IFILE entries per block */
    883  1.199  dholland 	uint32_t dlfs_sepb;	  /* 108: SEGUSE entries per block */
    884  1.199  dholland 	uint32_t dlfs_nindir;	  /* 112: indirect pointers per block */
    885  1.199  dholland 	uint32_t dlfs_nseg;	  /* 116: number of segments */
    886  1.199  dholland 	uint32_t dlfs_nspf;	  /* 120: number of sectors per fragment */
    887  1.199  dholland 	uint32_t dlfs_cleansz;	  /* 124: cleaner info size in blocks */
    888  1.199  dholland 	uint32_t dlfs_segtabsz;	  /* 128: segment table size in blocks */
    889  1.199  dholland 	uint32_t dlfs_segmask;	  /* 132: calculate offset within a segment */
    890  1.199  dholland 	uint32_t dlfs_segshift;	  /* 136: fast mult/div for segments */
    891  1.199  dholland 	uint32_t dlfs_bshift;	  /* 140: calc block number from file offset */
    892  1.199  dholland 	uint32_t dlfs_ffshift;	  /* 144: fast mult/div for frag from file */
    893  1.199  dholland 	uint32_t dlfs_fbshift;	  /* 148: fast mult/div for frag from block */
    894  1.199  dholland 	uint64_t dlfs_bmask;	  /* 152: calc block offset from file offset */
    895  1.199  dholland 	uint64_t dlfs_ffmask;	  /* 160: calc frag offset from file offset */
    896  1.199  dholland 	uint64_t dlfs_fbmask;	  /* 168: calc frag offset from block offset */
    897  1.199  dholland 	uint32_t dlfs_blktodb;	  /* 176: blktodb and dbtoblk shift constant */
    898  1.199  dholland 	uint32_t dlfs_sushift;	  /* 180: fast mult/div for segusage table */
    899   1.49  perseant 
    900   1.49  perseant 	int32_t	  dlfs_maxsymlinklen; /* 184: max length of an internal symlink */
    901  1.171  dholland 				  /* 188: superblock disk offsets */
    902  1.171  dholland 	int32_t	  dlfs_sboffs[LFS_MAXNUMSB];
    903    1.3       cgd 
    904  1.199  dholland 	uint32_t dlfs_nclean;	  /* 228: Number of clean segments */
    905   1.11  perseant 	u_char	  dlfs_fsmnt[MNAMELEN];	 /* 232: name mounted on */
    906  1.199  dholland 	uint16_t dlfs_pflags;	  /* 322: file system persistent flags */
    907   1.49  perseant 	int32_t	  dlfs_dmeta;	  /* 324: total number of dirty summaries */
    908  1.199  dholland 	uint32_t dlfs_minfreeseg; /* 328: segments not counted in bfree */
    909  1.199  dholland 	uint32_t dlfs_sumsize;	  /* 332: size of summary blocks */
    910  1.199  dholland 	uint64_t dlfs_serial;	  /* 336: serial number */
    911  1.199  dholland 	uint32_t dlfs_ibsize;	  /* 344: size of inode blocks */
    912  1.165  dholland 	int32_t	  dlfs_s0addr;	  /* 348: start of segment 0 */
    913  1.199  dholland 	uint64_t dlfs_tstamp;	  /* 352: time stamp */
    914  1.199  dholland 	uint32_t dlfs_inodefmt;	  /* 360: inode format version */
    915  1.199  dholland 	uint32_t dlfs_interleave; /* 364: segment interleave */
    916  1.199  dholland 	uint32_t dlfs_ident;	  /* 368: per-fs identifier */
    917  1.199  dholland 	uint32_t dlfs_fsbtodb;	  /* 372: fsbtodb and dbtodsb shift constant */
    918  1.199  dholland 	uint32_t dlfs_resvseg;	  /* 376: segments reserved for the cleaner */
    919  1.105  perseant 	int8_t	  dlfs_pad[128];  /* 380: round to 512 bytes */
    920    1.5   mycroft /* Checksum -- last valid disk field. */
    921  1.199  dholland 	uint32_t dlfs_cksum;	  /* 508: checksum for superblock checking */
    922   1.10        pk };
    923    1.1   mycroft 
    924  1.171  dholland struct dlfs64 {
    925  1.199  dholland 	uint32_t dlfs_magic;	  /* 0: magic number */
    926  1.199  dholland 	uint32_t dlfs_version;	  /* 4: version number (2) */
    927  1.171  dholland 
    928  1.199  dholland 	uint64_t dlfs_size;	  /* 8: number of frags in fs (v2) */
    929  1.199  dholland 	uint64_t dlfs_dsize;	  /* 16: number of disk blocks in fs */
    930  1.199  dholland 	uint32_t dlfs_ssize;	  /* 24: number of bytes per segment (v2) */
    931  1.199  dholland 	uint32_t dlfs_bsize;	  /* 28: file system block size */
    932  1.199  dholland 	uint32_t dlfs_fsize;	  /* 32: size of frag blocks in fs */
    933  1.199  dholland 	uint32_t dlfs_frag;	  /* 36: number of frags in a block in fs */
    934  1.171  dholland 
    935  1.171  dholland /* Checkpoint region. */
    936  1.199  dholland 	uint64_t dlfs_freehd;	  /* 40: start of the free inode list */
    937  1.199  dholland 	uint64_t dlfs_nfiles;	  /* 48: number of allocated inodes */
    938  1.182  dholland 	int64_t   dlfs_bfree;	  /* 56: number of free frags */
    939  1.182  dholland 	int64_t	  dlfs_avail;	  /* 64: blocks available for writing */
    940  1.182  dholland 	int64_t	  dlfs_idaddr;	  /* 72: inode file disk address */
    941  1.182  dholland 	int32_t	  dlfs_uinodes;	  /* 80: inodes in cache not yet on disk */
    942  1.199  dholland 	uint32_t dlfs_unused_0;	  /* 84: not used */
    943  1.182  dholland 	int64_t	  dlfs_lastseg;	  /* 88: address of last segment written */
    944  1.182  dholland 	int64_t	  dlfs_nextseg;	  /* 96: address of next segment to write */
    945  1.182  dholland 	int64_t	  dlfs_curseg;	  /* 104: current segment being written */
    946  1.182  dholland 	int64_t	  dlfs_offset;	  /* 112: offset in curseg for next partial */
    947  1.182  dholland 	int64_t	  dlfs_lastpseg;  /* 120: address of last partial written */
    948  1.199  dholland 	uint32_t dlfs_inopf;	  /* 128: inodes per frag */
    949  1.171  dholland 
    950  1.171  dholland /* These are configuration parameters. */
    951  1.199  dholland 	uint32_t dlfs_minfree;	  /* 132: minimum percentage of free blocks */
    952  1.171  dholland 
    953  1.171  dholland /* These fields can be computed from the others. */
    954  1.199  dholland 	uint64_t dlfs_maxfilesize; /* 136: maximum representable file size */
    955  1.199  dholland 	uint32_t dlfs_fsbpseg;	  /* 144: frags (fsb) per segment */
    956  1.199  dholland 	uint32_t dlfs_inopb;	  /* 148: inodes per block */
    957  1.199  dholland 	uint32_t dlfs_ifpb;	  /* 152: IFILE entries per block */
    958  1.199  dholland 	uint32_t dlfs_sepb;	  /* 156: SEGUSE entries per block */
    959  1.199  dholland 	uint32_t dlfs_nindir;	  /* 160: indirect pointers per block */
    960  1.199  dholland 	uint32_t dlfs_nseg;	  /* 164: number of segments */
    961  1.199  dholland 	uint32_t dlfs_nspf;	  /* 168: number of sectors per fragment */
    962  1.199  dholland 	uint32_t dlfs_cleansz;	  /* 172: cleaner info size in blocks */
    963  1.199  dholland 	uint32_t dlfs_segtabsz;	  /* 176: segment table size in blocks */
    964  1.199  dholland 	uint32_t dlfs_bshift;	  /* 180: calc block number from file offset */
    965  1.199  dholland 	uint32_t dlfs_ffshift;	  /* 184: fast mult/div for frag from file */
    966  1.199  dholland 	uint32_t dlfs_fbshift;	  /* 188: fast mult/div for frag from block */
    967  1.199  dholland 	uint64_t dlfs_bmask;	  /* 192: calc block offset from file offset */
    968  1.199  dholland 	uint64_t dlfs_ffmask;	  /* 200: calc frag offset from file offset */
    969  1.199  dholland 	uint64_t dlfs_fbmask;	  /* 208: calc frag offset from block offset */
    970  1.199  dholland 	uint32_t dlfs_blktodb;	  /* 216: blktodb and dbtoblk shift constant */
    971  1.199  dholland 	uint32_t dlfs_sushift;	  /* 220: fast mult/div for segusage table */
    972  1.171  dholland 
    973  1.182  dholland 				  /* 224: superblock disk offsets */
    974  1.171  dholland 	int64_t	   dlfs_sboffs[LFS_MAXNUMSB];
    975  1.171  dholland 
    976  1.182  dholland 	int32_t	  dlfs_maxsymlinklen; /* 304: max len of an internal symlink */
    977  1.199  dholland 	uint32_t dlfs_nclean;	  /* 308: Number of clean segments */
    978  1.182  dholland 	u_char	  dlfs_fsmnt[MNAMELEN];	 /* 312: name mounted on */
    979  1.199  dholland 	uint16_t dlfs_pflags;	  /* 402: file system persistent flags */
    980  1.182  dholland 	int32_t	  dlfs_dmeta;	  /* 404: total number of dirty summaries */
    981  1.199  dholland 	uint32_t dlfs_minfreeseg; /* 408: segments not counted in bfree */
    982  1.199  dholland 	uint32_t dlfs_sumsize;	  /* 412: size of summary blocks */
    983  1.199  dholland 	uint32_t dlfs_ibsize;	  /* 416: size of inode blocks */
    984  1.199  dholland 	uint32_t dlfs_inodefmt;	  /* 420: inode format version */
    985  1.199  dholland 	uint64_t dlfs_serial;	  /* 424: serial number */
    986  1.182  dholland 	int64_t	  dlfs_s0addr;	  /* 432: start of segment 0 */
    987  1.199  dholland 	uint64_t dlfs_tstamp;	  /* 440: time stamp */
    988  1.199  dholland 	uint32_t dlfs_interleave; /* 448: segment interleave */
    989  1.199  dholland 	uint32_t dlfs_ident;	  /* 452: per-fs identifier */
    990  1.199  dholland 	uint32_t dlfs_fsbtodb;	  /* 456: fsbtodb and dbtodsb shift constant */
    991  1.199  dholland 	uint32_t dlfs_resvseg;	  /* 460: segments reserved for the cleaner */
    992  1.182  dholland 	int8_t	  dlfs_pad[44];   /* 464: round to 512 bytes */
    993  1.171  dholland /* Checksum -- last valid disk field. */
    994  1.199  dholland 	uint32_t dlfs_cksum;	  /* 508: checksum for superblock checking */
    995  1.171  dholland };
    996  1.171  dholland 
    997  1.207  riastrad __CTASSERT(__alignof(struct dlfs) == __alignof(struct dlfs64));
    998  1.207  riastrad 
    999  1.101  perseant /* Type used for the inode bitmap */
   1000  1.199  dholland typedef uint32_t lfs_bm_t;
   1001  1.101  perseant 
   1002   1.61  perseant /*
   1003  1.104  perseant  * Linked list of segments whose byte count needs updating following a
   1004  1.104  perseant  * file truncation.
   1005  1.104  perseant  */
   1006  1.104  perseant struct segdelta {
   1007  1.104  perseant 	long segnum;
   1008  1.104  perseant 	size_t num;
   1009  1.104  perseant 	LIST_ENTRY(segdelta) list;
   1010  1.104  perseant };
   1011  1.104  perseant 
   1012  1.104  perseant /*
   1013   1.61  perseant  * In-memory super block.
   1014   1.61  perseant  */
   1015   1.10        pk struct lfs {
   1016  1.171  dholland 	union {				/* on-disk parameters */
   1017  1.171  dholland 		struct dlfs u_32;
   1018  1.171  dholland 		struct dlfs64 u_64;
   1019  1.171  dholland 	} lfs_dlfs_u;
   1020   1.26  perseant 
   1021    1.1   mycroft /* These fields are set at mount time and are meaningless on disk. */
   1022  1.181  dholland 	unsigned lfs_is64 : 1,		/* are we lfs64 or lfs32? */
   1023  1.185  dholland 		lfs_dobyteswap : 1,	/* are we opposite-endian? */
   1024  1.185  dholland 		lfs_hasolddirfmt : 1;	/* dir entries have no d_type */
   1025  1.171  dholland 
   1026    1.5   mycroft 	struct segment *lfs_sp;		/* current segment being written */
   1027    1.5   mycroft 	struct vnode *lfs_ivnode;	/* vnode for the ifile */
   1028  1.199  dholland 	uint32_t  lfs_seglock;		/* single-thread the segment writer */
   1029    1.5   mycroft 	pid_t	  lfs_lockpid;		/* pid of lock holder */
   1030   1.98  perseant 	lwpid_t	  lfs_locklwp;		/* lwp of lock holder */
   1031  1.199  dholland 	uint32_t lfs_iocount;		/* number of ios pending */
   1032  1.199  dholland 	uint32_t lfs_writer;		/* don't allow any dirops to start */
   1033  1.199  dholland 	uint32_t lfs_dirops;		/* count of active directory ops */
   1034  1.201      maya 	kcondvar_t lfs_diropscv;	/* condvar of active directory ops */
   1035  1.199  dholland 	uint32_t lfs_dirvcount;		/* count of VDIROP nodes in this fs */
   1036  1.199  dholland 	uint32_t lfs_doifile;		/* Write ifile blocks on next write */
   1037  1.199  dholland 	uint32_t lfs_nactive;		/* Number of segments since last ckp */
   1038    1.5   mycroft 	int8_t	  lfs_fmod;		/* super block modified flag */
   1039    1.5   mycroft 	int8_t	  lfs_ronly;		/* mounted read-only flag */
   1040   1.39  perseant #define LFS_NOTYET  0x01
   1041   1.39  perseant #define LFS_IFDIRTY 0x02
   1042   1.39  perseant #define LFS_WARNED  0x04
   1043   1.64  perseant #define LFS_UNDIROP 0x08
   1044    1.5   mycroft 	int8_t	  lfs_flags;		/* currently unused flag */
   1045  1.199  dholland 	uint16_t lfs_activesb;		/* toggle between superblocks */
   1046   1.61  perseant 	daddr_t	  lfs_sbactive;		/* disk address of current sb write */
   1047   1.49  perseant 	struct vnode *lfs_flushvp;	/* vnode being flushed */
   1048  1.102  perseant 	int lfs_flushvp_fakevref;	/* fake vref count for flushvp */
   1049   1.49  perseant 	struct vnode *lfs_unlockvp;	/* being inactivated in lfs_segunlock */
   1050  1.199  dholland 	uint32_t lfs_diropwait;		/* # procs waiting on dirop flush */
   1051   1.37  perseant 	size_t lfs_devbsize;		/* Device block size */
   1052   1.37  perseant 	size_t lfs_devbshift;		/* Device block shift */
   1053  1.118        ad 	krwlock_t lfs_fraglock;
   1054  1.123        ad 	krwlock_t lfs_iflock;		/* Ifile lock */
   1055  1.123        ad 	kcondvar_t lfs_stopcv;		/* Wrap lock */
   1056  1.123        ad 	struct lwp *lfs_stoplwp;
   1057   1.25  perseant 	pid_t lfs_rfpid;		/* Process ID of roll-forward agent */
   1058   1.49  perseant 	int	  lfs_nadirop;		/* number of active dirop nodes */
   1059   1.49  perseant 	long	  lfs_ravail;		/* blocks pre-reserved for writing */
   1060   1.75  perseant 	long	  lfs_favail;		/* blocks pre-reserved for writing */
   1061  1.153  dholland 	struct lfs_res_blk *lfs_resblk;	/* Reserved memory for pageout */
   1062   1.46  perseant 	TAILQ_HEAD(, inode) lfs_dchainhd; /* dirop vnodes */
   1063   1.46  perseant 	TAILQ_HEAD(, inode) lfs_pchainhd; /* paging vnodes */
   1064   1.46  perseant #define LFS_RESHASH_WIDTH 17
   1065   1.76     perry 	LIST_HEAD(, lfs_res_blk) lfs_reshash[LFS_RESHASH_WIDTH];
   1066  1.199  dholland 	int	  lfs_pdflush;		/* pagedaemon wants us to flush */
   1067  1.199  dholland 	uint32_t **lfs_suflags;		/* Segment use flags */
   1068   1.47     soren #ifdef _KERNEL
   1069   1.46  perseant 	struct pool lfs_clpool;		/* Pool for struct lfs_cluster */
   1070   1.46  perseant 	struct pool lfs_bpppool;	/* Pool for bpp */
   1071   1.46  perseant 	struct pool lfs_segpool;	/* Pool for struct segment */
   1072   1.61  perseant #endif /* _KERNEL */
   1073   1.55  perseant #define LFS_MAX_CLEANIND 64
   1074  1.170  dholland 	daddr_t  lfs_cleanint[LFS_MAX_CLEANIND]; /* Active cleaning intervals */
   1075  1.123        ad 	int 	 lfs_cleanind;		/* Index into intervals */
   1076   1.61  perseant 	int lfs_sleepers;		/* # procs sleeping this fs */
   1077  1.200      maya 	kcondvar_t lfs_sleeperscv;
   1078   1.75  perseant 	int lfs_pages;			/* dirty pages blaming this fs */
   1079  1.101  perseant 	lfs_bm_t *lfs_ino_bitmap;	/* Inuse inodes bitmap */
   1080  1.103  perseant 	int lfs_nowrap;			/* Suspend log wrap */
   1081  1.114  perseant 	int lfs_wrappass;		/* Allow first log wrap requester to pass */
   1082  1.114  perseant 	int lfs_wrapstatus;		/* Wrap status */
   1083  1.135  perseant 	int lfs_reclino;		/* Inode being reclaimed */
   1084  1.169  dholland 	daddr_t lfs_startseg;           /* Segment we started writing at */
   1085  1.104  perseant 	LIST_HEAD(, segdelta) lfs_segdhd;	/* List of pending trunc accounting events */
   1086  1.159  dholland 
   1087  1.159  dholland #ifdef _KERNEL
   1088  1.195  dholland 	/* The block device we're mounted on. */
   1089  1.195  dholland 	dev_t lfs_dev;
   1090  1.195  dholland 	struct vnode *lfs_devvp;
   1091  1.195  dholland 
   1092  1.159  dholland 	/* ULFS-level information */
   1093  1.199  dholland 	uint32_t um_flags;			/* ULFS flags (below) */
   1094  1.159  dholland 	u_long	um_nindir;			/* indirect ptrs per block */
   1095  1.159  dholland 	u_long	um_lognindir;			/* log2 of um_nindir */
   1096  1.159  dholland 	u_long	um_bptrtodb;			/* indir ptr to disk block */
   1097  1.159  dholland 	u_long	um_seqinc;			/* inc between seq blocks */
   1098  1.159  dholland 	int um_maxsymlinklen;
   1099  1.159  dholland 	int um_dirblksiz;
   1100  1.199  dholland 	uint64_t um_maxfilesize;
   1101  1.160  dholland 
   1102  1.160  dholland 	/* Stuff used by quota2 code, not currently operable */
   1103  1.160  dholland 	unsigned lfs_use_quota2 : 1;
   1104  1.160  dholland 	uint32_t lfs_quota_magic;
   1105  1.160  dholland 	uint8_t lfs_quota_flags;
   1106  1.160  dholland 	uint64_t lfs_quotaino[2];
   1107  1.164  dholland 
   1108  1.164  dholland 	/* Sleep address replacing &lfs_avail inside the on-disk superblock */
   1109  1.164  dholland 	/* XXX: should be replaced with a condvar */
   1110  1.164  dholland 	int lfs_availsleep;
   1111  1.164  dholland 	/* This one replaces &lfs_nextseg... all ditto */
   1112  1.203      maya 	kcondvar_t lfs_nextsegsleep;
   1113  1.195  dholland 
   1114  1.195  dholland 	/* Cleaner lwp, set on first bmapv syscall. */
   1115  1.195  dholland 	struct lwp *lfs_cleaner_thread;
   1116  1.195  dholland 
   1117  1.195  dholland 	/* Hint from cleaner, only valid if curlwp == um_cleaner_thread. */
   1118  1.195  dholland 	/* XXX change this to BLOCK_INFO after resorting this file */
   1119  1.195  dholland 	struct block_info *lfs_cleaner_hint;
   1120  1.159  dholland #endif
   1121    1.1   mycroft };
   1122    1.1   mycroft 
   1123  1.164  dholland /*
   1124    1.1   mycroft  * Structures used by lfs_bmapv and lfs_markv to communicate information
   1125    1.1   mycroft  * about inodes and data blocks.
   1126    1.1   mycroft  */
   1127    1.1   mycroft typedef struct block_info {
   1128  1.199  dholland 	uint64_t bi_inode;		/* inode # */
   1129  1.174  dholland 	int64_t	bi_lbn;			/* logical block w/in file */
   1130  1.174  dholland 	int64_t	bi_daddr;		/* disk address of block */
   1131  1.199  dholland 	uint64_t bi_segcreate;		/* origin segment create time */
   1132  1.174  dholland 	int	bi_version;		/* file version number */
   1133  1.174  dholland 	int	bi_size;		/* size of the block (if fragment) */
   1134  1.174  dholland 	void	*bi_bp;			/* data buffer */
   1135  1.174  dholland } BLOCK_INFO;
   1136  1.174  dholland 
   1137  1.174  dholland /* Compatibility for 7.0 binaries */
   1138  1.174  dholland typedef struct block_info_70 {
   1139  1.199  dholland 	uint32_t bi_inode;		/* inode # */
   1140   1.91      yamt 	int32_t	bi_lbn;			/* logical block w/in file */
   1141   1.91      yamt 	int32_t	bi_daddr;		/* disk address of block */
   1142  1.199  dholland 	uint64_t bi_segcreate;		/* origin segment create time */
   1143    1.1   mycroft 	int	bi_version;		/* file version number */
   1144    1.1   mycroft 	void	*bi_bp;			/* data buffer */
   1145   1.49  perseant 	int	bi_size;		/* size of the block (if fragment) */
   1146  1.174  dholland } BLOCK_INFO_70;
   1147   1.37  perseant 
   1148   1.37  perseant /* Compatibility for 1.5 binaries */
   1149   1.37  perseant typedef struct block_info_15 {
   1150  1.199  dholland 	uint32_t bi_inode;		/* inode # */
   1151   1.91      yamt 	int32_t	bi_lbn;			/* logical block w/in file */
   1152   1.91      yamt 	int32_t	bi_daddr;		/* disk address of block */
   1153  1.199  dholland 	uint32_t bi_segcreate;		/* origin segment create time */
   1154   1.37  perseant 	int	bi_version;		/* file version number */
   1155   1.37  perseant 	void	*bi_bp;			/* data buffer */
   1156   1.49  perseant 	int	bi_size;		/* size of the block (if fragment) */
   1157   1.37  perseant } BLOCK_INFO_15;
   1158    1.1   mycroft 
   1159  1.178  dholland /*
   1160  1.178  dholland  * 32/64-bit-clean pointer to block pointers. This points into
   1161  1.178  dholland  * already-existing storage; it is mostly used to access the block
   1162  1.178  dholland  * pointers following a FINFO.
   1163  1.178  dholland  */
   1164  1.178  dholland union lfs_blocks {
   1165  1.178  dholland 	int64_t *b64;
   1166  1.178  dholland 	int32_t *b32;
   1167  1.178  dholland };
   1168  1.178  dholland 
   1169    1.1   mycroft /* In-memory description of a segment about to be written. */
   1170    1.1   mycroft struct segment {
   1171    1.5   mycroft 	struct lfs	 *fs;		/* file system pointer */
   1172    1.1   mycroft 	struct buf	**bpp;		/* pointer to buffer array */
   1173    1.1   mycroft 	struct buf	**cbpp;		/* pointer to next available bp */
   1174    1.1   mycroft 	struct buf	**start_bpp;	/* pointer to first bp in this set */
   1175    1.5   mycroft 	struct buf	 *ibp;		/* buffer pointer to inode page */
   1176  1.180  dholland 	union lfs_dinode *idp;          /* pointer to ifile dinode */
   1177  1.178  dholland 	FINFO *fip;			/* current fileinfo pointer */
   1178    1.5   mycroft 	struct vnode	 *vp;		/* vnode being gathered */
   1179    1.3       cgd 	void	 *segsum;		/* segment summary info */
   1180  1.199  dholland 	uint32_t ninodes;		/* number of inodes in this segment */
   1181   1.50  perseant 	int32_t seg_bytes_left;		/* bytes left in segment */
   1182   1.50  perseant 	int32_t sum_bytes_left;		/* bytes left in summary block */
   1183  1.199  dholland 	uint32_t seg_number;		/* number of this segment */
   1184  1.178  dholland 	union lfs_blocks start_lbp;	/* beginning lbn for this set */
   1185    1.5   mycroft 
   1186  1.135  perseant #define SEGM_CKP	0x0001		/* doing a checkpoint */
   1187  1.135  perseant #define SEGM_CLEAN	0x0002		/* cleaner call; don't sort */
   1188  1.135  perseant #define SEGM_SYNC	0x0004		/* wait for segment */
   1189  1.135  perseant #define SEGM_PROT	0x0008		/* don't inactivate at segunlock */
   1190  1.135  perseant #define SEGM_PAGEDAEMON	0x0010		/* pagedaemon called us */
   1191  1.135  perseant #define SEGM_WRITERD	0x0020		/* LFS writed called us */
   1192  1.135  perseant #define SEGM_FORCE_CKP	0x0040		/* Force checkpoint right away */
   1193  1.135  perseant #define SEGM_RECLAIM	0x0080		/* Writing to reclaim vnode */
   1194  1.135  perseant #define SEGM_SINGLE	0x0100		/* Opportunistic writevnodes */
   1195  1.199  dholland 	uint16_t seg_flags;		/* run-time flags for this segment */
   1196  1.199  dholland 	uint32_t seg_iocount;		/* number of ios pending */
   1197   1.49  perseant 	int	  ndupino;		/* number of duplicate inodes */
   1198   1.39  perseant };
   1199   1.39  perseant 
   1200    1.1   mycroft /* Statistics Counters */
   1201   1.77  perseant struct lfs_stats {	/* Must match sysctl list in lfs_vfsops.h ! */
   1202    1.5   mycroft 	u_int	segsused;
   1203    1.5   mycroft 	u_int	psegwrites;
   1204    1.5   mycroft 	u_int	psyncwrites;
   1205    1.5   mycroft 	u_int	pcleanwrites;
   1206    1.5   mycroft 	u_int	blocktot;
   1207    1.5   mycroft 	u_int	cleanblocks;
   1208    1.5   mycroft 	u_int	ncheckpoints;
   1209    1.5   mycroft 	u_int	nwrites;
   1210    1.5   mycroft 	u_int	nsync_writes;
   1211    1.5   mycroft 	u_int	wait_exceeded;
   1212    1.5   mycroft 	u_int	write_exceeded;
   1213    1.5   mycroft 	u_int	flush_invoked;
   1214   1.11  perseant 	u_int	vflush_invoked;
   1215   1.77  perseant 	u_int	clean_inlocked;
   1216   1.77  perseant 	u_int	clean_vnlocked;
   1217   1.87  perseant 	u_int   segs_reclaimed;
   1218    1.1   mycroft };
   1219   1.51  perseant 
   1220   1.52  perseant /* Fcntls to take the place of the lfs syscalls */
   1221   1.52  perseant struct lfs_fcntl_markv {
   1222   1.51  perseant 	BLOCK_INFO *blkiov;	/* blocks to relocate */
   1223  1.173  dholland 	int blkcnt;		/* number of blocks (limited to 65536) */
   1224   1.51  perseant };
   1225   1.51  perseant 
   1226  1.129  christos #define LFCNSEGWAITALL	_FCNR_FSPRIV('L', 14, struct timeval)
   1227  1.129  christos #define LFCNSEGWAIT	_FCNR_FSPRIV('L', 15, struct timeval)
   1228  1.174  dholland #define LFCNBMAPV	_FCNRW_FSPRIV('L', 16, struct lfs_fcntl_markv)
   1229  1.174  dholland #define LFCNMARKV	_FCNRW_FSPRIV('L', 17, struct lfs_fcntl_markv)
   1230   1.54  perseant #define LFCNRECLAIM	 _FCNO_FSPRIV('L', 4)
   1231  1.109    martin 
   1232  1.112    martin struct lfs_fhandle {
   1233  1.113    martin 	char space[28];	/* FHANDLE_SIZE_COMPAT (but used from userland too) */
   1234  1.110    martin };
   1235   1.86  perseant #define LFCNREWIND       _FCNR_FSPRIV('L', 6, int)
   1236   1.86  perseant #define LFCNINVAL        _FCNR_FSPRIV('L', 7, int)
   1237   1.86  perseant #define LFCNRESIZE       _FCNR_FSPRIV('L', 8, int)
   1238  1.108  perseant #define LFCNWRAPSTOP	 _FCNR_FSPRIV('L', 9, int)
   1239  1.108  perseant #define LFCNWRAPGO	 _FCNR_FSPRIV('L', 10, int)
   1240  1.112    martin #define LFCNIFILEFH	 _FCNW_FSPRIV('L', 11, struct lfs_fhandle)
   1241  1.114  perseant #define LFCNWRAPPASS	 _FCNR_FSPRIV('L', 12, int)
   1242  1.114  perseant # define LFS_WRAP_GOING   0x0
   1243  1.114  perseant # define LFS_WRAP_WAITING 0x1
   1244  1.114  perseant #define LFCNWRAPSTATUS	 _FCNW_FSPRIV('L', 13, int)
   1245  1.130     pooka 
   1246   1.78  perseant /* Debug segment lock */
   1247   1.78  perseant #ifdef notyet
   1248   1.78  perseant # define ASSERT_SEGLOCK(fs) KASSERT(LFS_SEGLOCK_HELD(fs))
   1249   1.78  perseant # define ASSERT_NO_SEGLOCK(fs) KASSERT(!LFS_SEGLOCK_HELD(fs))
   1250   1.78  perseant # define ASSERT_DUNNO_SEGLOCK(fs)
   1251   1.78  perseant # define ASSERT_MAYBE_SEGLOCK(fs)
   1252   1.78  perseant #else /* !notyet */
   1253   1.78  perseant # define ASSERT_DUNNO_SEGLOCK(fs) \
   1254   1.78  perseant 	DLOG((DLOG_SEG, "lfs func %s seglock wrong (%d)\n", __func__, \
   1255   1.78  perseant 		LFS_SEGLOCK_HELD(fs)))
   1256   1.78  perseant # define ASSERT_SEGLOCK(fs) do {					\
   1257   1.78  perseant 	if (!LFS_SEGLOCK_HELD(fs)) {					\
   1258   1.78  perseant 		DLOG((DLOG_SEG, "lfs func %s seglock wrong (0)\n", __func__)); \
   1259   1.78  perseant 	}								\
   1260   1.78  perseant } while(0)
   1261   1.78  perseant # define ASSERT_NO_SEGLOCK(fs) do {					\
   1262   1.78  perseant 	if (LFS_SEGLOCK_HELD(fs)) {					\
   1263   1.78  perseant 		DLOG((DLOG_SEG, "lfs func %s seglock wrong (1)\n", __func__)); \
   1264   1.78  perseant 	}								\
   1265   1.78  perseant } while(0)
   1266   1.78  perseant # define ASSERT_MAYBE_SEGLOCK(x)
   1267   1.78  perseant #endif /* !notyet */
   1268   1.78  perseant 
   1269  1.145  dholland /*
   1270  1.145  dholland  * Arguments to mount LFS filesystems
   1271  1.145  dholland  */
   1272  1.145  dholland struct ulfs_args {
   1273  1.145  dholland 	char	*fspec;			/* block special device to mount */
   1274  1.145  dholland };
   1275  1.145  dholland 
   1276   1.94  christos __BEGIN_DECLS
   1277   1.94  christos void lfs_itimes(struct inode *, const struct timespec *,
   1278   1.94  christos     const struct timespec *, const struct timespec *);
   1279   1.94  christos __END_DECLS
   1280   1.94  christos 
   1281   1.42      matt #endif /* !_UFS_LFS_LFS_H_ */
   1282