Source-Changes-HG archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[src/trunk]: src/share/man/man5 update "struct fs" description to reflect rea...



details:   https://anonhg.NetBSD.org/src/rev/674921ba30aa
branches:  trunk
changeset: 513256:674921ba30aa
user:      lukem <lukem%NetBSD.org@localhost>
date:      Fri Jul 27 01:18:33 2001 +0000

description:
update "struct fs" description to reflect reality

diffstat:

 share/man/man5/fs.5 |  151 +++++++++++++++++++++++++++------------------------
 1 files changed, 79 insertions(+), 72 deletions(-)

diffs (197 lines):

diff -r 83f84ecad04e -r 674921ba30aa share/man/man5/fs.5
--- a/share/man/man5/fs.5       Fri Jul 27 01:03:34 2001 +0000
+++ b/share/man/man5/fs.5       Fri Jul 27 01:18:33 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: fs.5,v 1.9 1999/03/17 20:19:45 garbled Exp $
+.\"    $NetBSD: fs.5,v 1.10 2001/07/27 01:18:33 lukem Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -33,7 +33,7 @@
 .\"
 .\"     @(#)fs.5       8.2 (Berkeley) 4/19/94
 .\"
-.Dd April 19, 1994
+.Dd July 27, 2001
 .Dt FS 5
 .Os
 .Sh NAME
@@ -41,14 +41,14 @@
 .Nm inode
 .Nd format of file system volume
 .Sh SYNOPSIS
-.Fd #include <sys/types.h>
+.Fd #include <sys/param.h>
 .Fd #include <ufs/ffs/fs.h>
 .Fd #include <ufs/ufs/inode.h>
 .Sh DESCRIPTION
 The files
-.Aq Pa fs.h
+.Aq Pa ufs/ffs/fs.h
 and
-.Aq Pa inode.h
+.Aq Pa ufs/ufs/inode.h
 declare several structures, defined variables and macros
 which are used to create and manage the underlying format of
 file system objects on random access devices (disks).
@@ -75,86 +75,93 @@
 .Bd -literal
 #define        FS_MAGIC 0x011954
 struct fs {
-       struct  fs *fs_link;    /* linked list of file systems */
-       struct  fs *fs_rlink;   /*     used for incore super blocks */
-       daddr_t fs_sblkno;      /* addr of super-block in filesys */
-       daddr_t fs_cblkno;      /* offset of cyl-block in filesys */
-       daddr_t fs_iblkno;      /* offset of inode-blocks in filesys */
-       daddr_t fs_dblkno;      /* offset of first data after cg */
-       long    fs_cgoffset;    /* cylinder group offset in cylinder */
-       long    fs_cgmask;      /* used to calc mod fs_ntrak */
-       time_t  fs_time;        /* last time written */
-       long    fs_size;        /* number of blocks in fs */
-       long    fs_dsize;       /* number of data blocks in fs */
-       long    fs_ncg; /* number of cylinder groups */
-       long    fs_bsize;       /* size of basic blocks in fs */
-       long    fs_fsize;       /* size of frag blocks in fs */
-       long    fs_frag;        /* number of frags in a block in fs */
+       int32_t  fs_firstfield; /* historic file system linked list, */
+       int32_t  fs_unused_1;   /*     used for incore super blocks */
+       ufs_daddr_t fs_sblkno;  /* addr of super-block in filesys */
+       ufs_daddr_t fs_cblkno;  /* offset of cyl-block in filesys */
+       ufs_daddr_t fs_iblkno;  /* offset of inode-blocks in filesys */
+       ufs_daddr_t fs_dblkno;  /* offset of first data after cg */
+       int32_t  fs_cgoffset;   /* cylinder group offset in cylinder */
+       int32_t  fs_cgmask;     /* used to calc mod fs_ntrak */
+       int32_t  fs_time;       /* last time written */
+       int32_t  fs_size;       /* number of blocks in fs */
+       int32_t  fs_dsize;      /* number of data blocks in fs */
+       int32_t  fs_ncg;        /* number of cylinder groups */
+       int32_t  fs_bsize;      /* size of basic blocks in fs */
+       int32_t  fs_fsize;      /* size of frag blocks in fs */
+       int32_t  fs_frag;       /* number of frags in a block in fs */
 /* these are configuration parameters */
-       long    fs_minfree;     /* minimum percentage of free blocks */
-       long    fs_rotdelay;    /* num of ms for optimal next block */
-       long    fs_rps; /* disk revolutions per second */
+       int32_t  fs_minfree;    /* minimum percentage of free blocks */
+       int32_t  fs_rotdelay;   /* num of ms for optimal next block */
+       int32_t  fs_rps;        /* disk revolutions per second */
 /* these fields can be computed from the others */
-       long    fs_bmask;       /* ``blkoff'' calc of blk offsets */
-       long    fs_fmask;       /* ``fragoff'' calc of frag offsets */
-       long    fs_bshift;      /* ``lblkno'' calc of logical blkno */
-       long    fs_fshift;      /* ``numfrags'' calc number of frags */
+       int32_t  fs_bmask;      /* ``blkoff'' calc of blk offsets */
+       int32_t  fs_fmask;      /* ``fragoff'' calc of frag offsets */
+       int32_t  fs_bshift;     /* ``lblkno'' calc of logical blkno */
+       int32_t  fs_fshift;     /* ``numfrags'' calc number of frags */
 /* these are configuration parameters */
-       long    fs_maxcontig;   /* max number of contiguous blks */
-       long    fs_maxbpg;      /* max number of blks per cyl group */
+       int32_t  fs_maxcontig;  /* max number of contiguous blks */
+       int32_t  fs_maxbpg;     /* max number of blks per cyl group */
 /* these fields can be computed from the others */
-       long    fs_fragshift;   /* block to frag shift */
-       long    fs_fsbtodb;     /* fsbtodb and dbtofsb shift constant */
-       long    fs_sbsize;      /* actual size of super block */
-       long    fs_csmask;      /* csum block offset */
-       long    fs_csshift;     /* csum block number */
-       long    fs_nindir;      /* value of NINDIR */
-       long    fs_inopb;       /* value of INOPB */
-       long    fs_nspf;        /* value of NSPF */
+       int32_t  fs_fragshift;  /* block to frag shift */
+       int32_t  fs_fsbtodb;    /* fsbtodb and dbtofsb shift constant */
+       int32_t  fs_sbsize;     /* actual size of super block */
+       int32_t  fs_csmask;     /* csum block offset */
+       int32_t  fs_csshift;    /* csum block number */
+       int32_t  fs_nindir;     /* value of NINDIR */
+       int32_t  fs_inopb;      /* value of INOPB */
+       int32_t  fs_nspf;       /* value of NSPF */
 /* yet another configuration parameter */
-       long    fs_optim;       /* optimization preference, see below */
+       int32_t  fs_optim;      /* optimization preference, see below */
 /* these fields are derived from the hardware */
-       long    fs_npsect;      /* # sectors/track including spares */
-       long    fs_interleave;  /* hardware sector interleave */
-       long    fs_trackskew;   /* sector 0 skew, per track */
-       long    fs_headswitch;  /* head switch time, usec */
-       long    fs_trkseek;     /* track-to-track seek, usec */
+       int32_t  fs_npsect;     /* # sectors/track including spares */
+       int32_t  fs_interleave; /* hardware sector interleave */
+       int32_t  fs_trackskew;  /* sector 0 skew, per track */
+       int32_t  fs_headswitch; /* head switch time, usec (UNUSED) */
+       int32_t  fs_trkseek;    /* track-to-track seek, usec (UNUSED) */
 /* sizes determined by number of cylinder groups and their sizes */
-       daddr_t fs_csaddr;      /* blk addr of cyl grp summary area */
-       long    fs_cssize;      /* size of cyl grp summary area */
-       long    fs_cgsize;      /* cylinder group size */
+       ufs_daddr_t  fs_csaddr; /* blk addr of cyl grp summary area */
+       int32_t  fs_cssize;     /* size of cyl grp summary area */
+       int32_t  fs_cgsize;     /* cylinder group size */
 /* these fields are derived from the hardware */
-       long    fs_ntrak;       /* tracks per cylinder */
-       long    fs_nsect;       /* sectors per track */
-       long    fs_spc;         /* sectors per cylinder */
+       int32_t  fs_ntrak;      /* tracks per cylinder */
+       int32_t  fs_nsect;      /* sectors per track */
+       int32_t  fs_spc;        /* sectors per cylinder */
 /* this comes from the disk driver partitioning */
-       long    fs_ncyl;        /* cylinders in file system */
+       int32_t  fs_ncyl;       /* cylinders in file system */
 /* these fields can be computed from the others */
-       long    fs_cpg; /* cylinders per group */
-       long    fs_ipg; /* inodes per group */
-       long    fs_fpg; /* blocks per group * fs_frag */
+       int32_t  fs_cpg;        /* cylinders per group */
+       int32_t  fs_ipg;        /* inodes per group */
+       int32_t  fs_fpg;        /* blocks per group * fs_frag */
 /* this data must be re-computed after crashes */
-       struct  csum fs_cstotal;        /* cylinder summary information */
+       struct  csum fs_cstotal; /* cylinder summary information */
 /* these fields are cleared at mount time */
-       char    fs_fmod;        /* super block modified flag */
-       char    fs_clean;       /* file system is clean flag */
-       char    fs_ronly;       /* mounted read-only flag */
-       char    fs_flags;       /* currently unused flag */
-       char    fs_fsmnt[MAXMNTLEN];    /* name mounted on */
+       int8_t   fs_fmod;       /* super block modified flag */
+       int8_t   fs_clean;      /* file system is clean flag */
+       int8_t   fs_ronly;      /* mounted read-only flag */
+       int8_t   fs_flags;      /* see FS_ flags below */
+       u_char   fs_fsmnt[MAXMNTLEN];   /* name mounted on */
 /* these fields retain the current block allocation info */
-       long    fs_cgrotor;     /* last cg searched */
-       struct  csum *fs_csp[MAXCSBUFS]; /* list of fs_cs info buffers */
-       long    fs_cpc; /* cyl per cycle in postbl */
-       short   fs_opostbl[16][8];      /* old rotation block list head */
-       long    fs_sparecon[56];        /* reserved for future constants */
-       quad    fs_qbmask;      /* ~fs_bmask - for use with quad size */
-       quad    fs_qfmask;      /* ~fs_fmask - for use with quad size */
-       long    fs_postblformat; /* format of positional layout tables */
-       long    fs_nrpos;       /* number of rotational positions */
-       long    fs_postbloff;   /* (short) rotation block list head */
-       long    fs_rotbloff;    /* (u_char) blocks for each rotation */
-       long    fs_magic;       /* magic number */
-       u_char  fs_space[1];    /* list of blocks for each rotation */
+       int32_t  fs_cgrotor;            /* last cg searched */
+       struct  csum *fs_csp[MAXCSBUFS];/* list of fs_cs info buffers */
+       int32_t  *fs_maxcluster;        /* max cluster in each cyl group */
+       int32_t  fs_cpc;                /* cyl per cycle in postbl */
+       int16_t  fs_opostbl[16][8];     /* old rotation block list head */
+       int32_t  fs_sparecon[49];       /* reserved for future constants */
+       int32_t  fs_fscktime;           /* last time fsck(8)ed */
+       int32_t  fs_contigsumsize;      /* size of cluster summary array */ 
+       int32_t  fs_maxsymlinklen;      /* max len of internal symlink */
+       int32_t  fs_inodefmt;           /* format of on-disk inodes */
+       u_int64_t fs_maxfilesize;       /* maximum file size */
+       int64_t  fs_qbmask;     /* ~fs_bmask - for use with quad size */
+       int64_t  fs_qfmask;     /* ~fs_fmask - for use with quad size */
+       int32_t  fs_state;      /* validate fs_clean field (UNUSED) */
+       int32_t  fs_postblformat;  /* format of positional layout tables */
+       int32_t  fs_nrpos;      /* number of rotational positions */
+       int32_t  fs_postbloff;  /* (u_int16) rotation block list head */
+       int32_t  fs_rotbloff;   /* (u_int8) blocks for each rotation */
+       int32_t  fs_magic;      /* magic number */
+       u_int8_t fs_space[1];   /* list of blocks for each rotation */
 /* actually longer */
 };
 .Ed



Home | Main Index | Thread Index | Old Index