diff options
Diffstat (limited to 'sbin/newfs/newfs.8')
| -rw-r--r-- | sbin/newfs/newfs.8 | 38 |
1 files changed, 21 insertions, 17 deletions
diff --git a/sbin/newfs/newfs.8 b/sbin/newfs/newfs.8 index 9ca6337..c20fe15 100644 --- a/sbin/newfs/newfs.8 +++ b/sbin/newfs/newfs.8 @@ -32,7 +32,7 @@ .\" @(#)newfs.8 8.6 (Berkeley) 5/3/95 .\" $FreeBSD$ .\" -.Dd May 29, 2001 +.Dd May 18, 2002 .Dt NEWFS 8 .Os .Sh NAME @@ -40,12 +40,14 @@ .Nd construct a new filesystem .Sh SYNOPSIS .Nm -.Op Fl NOU +.Op Fl NU +.Op Fl O Ar filesystem-type .Op Fl S Ar sector-size .Op Fl T Ar disktype .Op Fl a Ar maxcontig .Op Fl b Ar block-size -.Op Fl c Ar cylinders +.Op Fl c Ar blocks-per-cylinder-group +.Op Fl d Ar max-extent-size .Op Fl e Ar maxbpg .Op Fl f Ar frag-size .Op Fl g Ar avgfilesize @@ -54,7 +56,6 @@ .Op Fl m Ar free space .Op Fl o Ar optimization .Op Fl s Ar size -.Op Fl u Ar sectors .Ar special .Sh DESCRIPTION .Nm Newfs @@ -82,12 +83,16 @@ For backward compatibility. .It Fl N Cause the filesystem parameters to be printed out without really creating the filesystem. +.It Fl O +Use 1 to specify that a UFS1 format filesystem be built; +use 2 to specify that a UFS2 format filesystem be built. +The default is UFS1 format, but will eventually be changed to UFS2. .It Fl U Enables soft updates on the new filesystem. .It Fl a Ar maxcontig Specify the maximum number of contiguous blocks that will be laid out before forcing a rotational delay. -The default value is 1. +The default value is 16. See .Xr tunefs 8 for more details on how to set this option. @@ -96,12 +101,17 @@ The block size of the filesystem, in bytes. It must be a power of 2. The default size is 16384 bytes, and the smallest allowable size is 4096 bytes. The optimal block:fragment ratio is 8:1. Other ratios are possible, but are not recommended, -and may produce unpredictable results. -.It Fl c Ar #cylinders/group -The number of cylinders per cylinder group in a filesystem. The default +and may produce poor results. +.It Fl c Ar number of blocks per cylinders group +The number of blocks per cylinder group in a filesystem. The default is to compute the maximum allowed by the other parameters. This value is dependent on a number of other parameters, in particular the block size and the number of bytes per inode. +.It Fl d Ar max extent size +The filesystem may choose to store large files using extents. +This parameter specifies the largest extent size that may be used. +It is presently limited to its default value which is 16 times +the filesystem blocksize. .It Fl e Ar maxbpg Indicate the maximum number of blocks any single file can allocate out of a cylinder group before it is forced to begin @@ -178,11 +188,6 @@ to find the alternate superblocks if the standard superblock is lost. .Bl -tag -width indent .It Fl S Ar sector-size The size of a sector in bytes (almost never anything but 512). -.It Fl u Ar sectors/cylinders -The number of sectors per cylinder available for data allocation by the file -system. -The default is 4096. -If zero is specified, the value from the disklabel will be used. .El .Sh EXAMPLES .Dl newfs /dev/ad3s1a @@ -191,13 +196,12 @@ Creates a new ufs filesystem on .Pa ad3s1a . .Nm will use a block size of 16384 bytes, a fragment size of 2048 bytes -and the largest possible number of cylinders per group. +and the largest possible number of blocks per cylinders group. These values tend to produce better performance for most applications than the historical defaults (8192 byte block size and 1024 byte fragment size). -This large fragment size -may lead to large amounts of wasted space -on filesystems that contain a large number of small files. +This large fragment size may lead to much wasted space +on filesystems that contain many small files. .Sh SEE ALSO .Xr fdformat 1 , .Xr disktab 5 , |
