xref: /original-bsd/sbin/newlfs/newlfs.8 (revision 5bcf8549)
1.\" Copyright (c) 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)newlfs.8	8.1 (Berkeley) 06/19/93
7.\"
8.Dd
9.Dt NEWLFS 8
10.Os BSD 4.4
11.Sh NAME
12.Nm newlfs
13.Nd construct a new LFS file system
14.Sh SYNOPSIS
15.Nm newlfs
16.Fl L
17.Op Ar newlfs-options
18.Ar special
19.Sh DESCRIPTION
20.Nm Newlfs
21builds a log-structured file system on the specified special
22device basing its defaults on the information in the disk label.
23(Before running
24.Nm newlfs
25the disk must be labeled using
26.Xr disklabel 8 .)
27.Pp
28The following options define the general layout policies.
29.Bl -tag -width Fl
30.It Fl B
31The logical segment size of the file system in bytes.
32.It Fl b Ar block-size
33The block size of the file system in bytes.
34.It Fl L
35Create a log-structured file system (LFS).
36This flag is currently required.
37.It Fl m Ar free space \&%
38The percentage of space reserved from normal users; the minimum
39free space threshold.  The default value used is 10%.
40See
41.Xr tunefs 8
42for more details on how to set this option.
43.It Fl s Ar size
44The size of the file system in sectors.
45.El
46.Sh SEE ALSO
47.Xr disktab 5 ,
48.Xr fs 5 ,
49.Xr dumplfs 8 ,
50.Xr disklabel 8 ,
51.Xr diskpart 8 ,
52.Xr tunefs 8
53.Rs
54.%A M. McKusick
55.%A W. Joy
56.%A S. Leffler
57.%A R. Fabry
58.%T A Fast File System for UNIX ,
59.%J ACM Transactions on Computer Systems 2
60.%V 3
61.%P pp 181-197
62.%D August 1984
63.%O (reprinted in the BSD System Manager's Manual)
64.Re
65.Sh HISTORY
66The
67.Nm
68command appeared in
69.Bx 4.4 .
70