'\"macro stdmacro
.if n .pH g1m.newfs @(#)newfs	40.5 of 8/10/89
.\" @(#)newfs.8 1.3 88/10/17 SMI; from UCB 4.3 BSD
'\"macro stdmacro
.\" Copyright (c) 1983 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved.
.\"
.nr X
.if \nX=0 .ds x} newfs 1M "BSD Compatibility Package" "\&"
.if \nX=1 .ds x} newfs 1M "BSD Compatibility Package"
.if \nX=2 .ds x} newfs 1M "" "\&"
.if \nX=3 .ds x} newfs "" "" "\&"
.TH \*(x}
.SH NAME
\f4newfs\f1 \- construct a new file system
.SH SYNOPSIS
\f4/usr/ucb/newfs\f1
[
\f4\-nNv\f1
] [
.I mkfs-options
]
.I block-special-file
.SH DESCRIPTION
.P
\f4newfs\f1
is a \(lqfriendly\(rq front-end to the
\f4mkfs\f1(1M)
program.
On Sun systems, the disk type is
determined by reading the disk label for the specified
.IR block-special-file .
.P
.I block-special-file
is the name of a block special device residing in
\f4/dev\f1.
If you want to make a file system on
\f4sd0\f1,
you can specify
\f4sd0\f1
\f4rsd0\f1
or
\f4/dev/rsd0\f1;
if you only specify
\f4sd0\f1,
\f4newfs\f1
will find the proper device.
.P
\f4newfs\f1
then calculates the appropriate parameters to use in
calling
\f4mkfs\f1,
builds the file system by forking
\f4mkfs\f1
and, if the file system is a root partition, installs
the necessary bootstrap programs in its initial 16 sectors.
.SH OPTIONS
.TP
\f4\-n\f1
Do not install the bootstrap programs.
.TP
\f4\-N\f1
Print out the file system parameters
without actually creating the file system.
.TP
\f4\-v\f1
Verbose.
\f4newfs\f1
prints out its actions, including the parameters passed to
\f4mkfs\f1.
.TP
.I mkfs-options
Options that override the default parameters passed to
\f4mkfs\f1(1M)
are:
.RS
.TP
\f4\-b \f2block-size\f1
The block size of the file system in bytes.
.TP
\f4\-c \f2#cylinders/group\f1
The number of cylinders per cylinder group in a file system.
The default value used is 16.
.TP
\f4\-d \f2rotdelay\f1
This specifies the expected time (in milliseconds)
to service a transfer completion
interrupt and initiate a new transfer on the same disk.
It is used to decide how much rotational spacing to
place between successive blocks in a file.
.TP
\f4\-f \f2frag-size\f1
The fragment size of the file system in bytes.
.TP
\f4\-i \f2bytes/inode\f1
This specifies the density of inodes in the file system.
The default is to create an inode for each 2048 bytes of data space.
If fewer inodes are desired, a larger number should be used;
to create more inodes a smaller number should be given.
.TP
\f4\-m \f2free-space%\f1
The percentage of space reserved from normal users;
the minimum free space threshold.
The default value used is 10%.
.TP
\f4\-o \f2optimization\f1
\f1(\f4space\f1
or
\f4time\f1).
The file system 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 minimum free space threshold (as specified by the
\f4\-m\f1
option) is less than 10%,
the default is to optimize for space;
if the minimum free space threshold is greater than or
equal to 10%, the default is to optimize for time.
.TP
\f4\-r \f2revolutions/minute\f1
The speed of the disk in revolutions per minute (normally 3600).
.TP
\f4\-s \f2size\f1
The size of the file system in sectors.
.br
.ne 8
.TP
\f4\-t \f2#tracks/cylinder\f1
The number of tracks per cylinders on the disk.
.RE
.SH FILES
.PD 0
.TP 16
\f4/usr/mdec\f1
for boot strapping programs
.TP
\f4/dev\f1
.PD
.SH "SEE ALSO"
\f4fsck\fP(1M),
\f4mkfs\fP(1M),
\f4tunefs\fP(1M),
\f4fs\fP(4)
in the \f2System Administrator's Reference Manual\f1.
