summaryrefslogtreecommitdiffstats
path: root/sbin/newfs
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2002-08-13 13:13:20 +0000
committerru <ru@FreeBSD.org>2002-08-13 13:13:20 +0000
commit49201b1ad0f4cc6670809e238e8c746702065052 (patch)
tree28855d4ec5b838f7ad34e2a5baeaa04459e68f4a /sbin/newfs
parent92f62a6fd100c308915108ce9c2f9821d93ab4e0 (diff)
downloadFreeBSD-src-49201b1ad0f4cc6670809e238e8c746702065052.zip
FreeBSD-src-49201b1ad0f4cc6670809e238e8c746702065052.tar.gz
mdoc(7) police: Consistently name options' arguments in the SYNOPSIS and DESCRIPTION sections..
Diffstat (limited to 'sbin/newfs')
-rw-r--r--sbin/newfs/newfs.839
1 files changed, 23 insertions, 16 deletions
diff --git a/sbin/newfs/newfs.8 b/sbin/newfs/newfs.8
index 7bd4205..55d2d73 100644
--- a/sbin/newfs/newfs.8
+++ b/sbin/newfs/newfs.8
@@ -51,9 +51,9 @@
.Op Fl e Ar maxbpg
.Op Fl f Ar frag-size
.Op Fl g Ar avgfilesize
-.Op Fl h Ar avfpdir
+.Op Fl h Ar avgfpdir
.Op Fl i Ar bytes
-.Op Fl m Ar free space
+.Op Fl m Ar free-space
.Op Fl o Ar optimization
.Op Fl s Ar size
.Ar special
@@ -85,7 +85,7 @@ For backward compatibility.
.It Fl N
Cause the filesystem parameters to be printed out
without really creating the filesystem.
-.It Fl O
+.It Fl O Ar filesystem-type
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.
@@ -99,17 +99,20 @@ See
.Xr tunefs 8
for more details on how to set this option.
.It Fl b Ar block-size
-The block size of the filesystem, in bytes. It must be a power of 2. The
+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 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
+.It Fl c Ar blocks-per-cylinder-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
+.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
@@ -123,7 +126,8 @@ See
.Xr tunefs 8
for more details on how to set this option.
.It Fl f Ar frag-size
-The fragment size of the filesystem in bytes. It must be a power of two
+The fragment size of the filesystem in bytes.
+It must be a power of two
ranging in value between
.Ar blocksize Ns /8
and
@@ -133,7 +137,7 @@ The default is 2048 bytes.
The expected average file size for the filesystem.
.It Fl h Ar avgfpdir
The expected average number of files per directory on the filesystem.
-.It Fl i Ar number of bytes per inode
+.It Fl i Ar bytes
Specify the density of inodes in the filesystem.
The default is to create an inode for every
.Pq 4 * Ar frag-size
@@ -142,7 +146,7 @@ If fewer inodes are desired, a larger number should be used;
to create more inodes a smaller number should be given.
One inode is required for each distinct file, so this value effectively
specifies the average file size on the filesystem.
-.It Fl m Ar free space \&%
+.It Fl m Ar free-space
The percentage of space reserved from normal users; the minimum free
space threshold.
The default value used is
@@ -154,21 +158,24 @@ currently 8%.
See
.Xr tunefs 8
for more details on how to set this option.
-.It Fl o Ar optimization\ preference
-.Pq Ar space No or Ar time .
+.It Fl o Ar optimization
+.Cm ( space
+or
+.Cm time ) .
The filesystem can either be instructed to try to minimize the time spent
allocating blocks, or to try to minimize the space fragmentation on the disk.
If the value of minfree (see above) is less than 8%,
the default is to optimize for
-.Ar space ;
+.Cm space ;
if the value of minfree is greater than or equal to 8%,
the default is to optimize for
-.Ar time .
+.Cm time .
See
.Xr tunefs 8
for more details on how to set this option.
.It Fl s Ar size
-The size of the filesystem in sectors. This value defaults to the size of the
+The size of the filesystem in sectors.
+This value defaults to the size of the
raw partition specified in
.Ar special
(in other words,
OpenPOWER on IntegriCloud