xref: /minix/sbin/newfs_v7fs/newfs_v7fs.8 (revision 0a6a1f1d)
1.\"	$NetBSD: newfs_v7fs.8,v 1.3 2011/08/10 11:31:49 uch Exp $
2.\"
3.\" Copyright (c) 2011 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by UCHIYAMA Yasushi.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE.
29.\"
30.\" Copyright (c) 1993
31.\"	The Regents of the University of California.  All rights reserved.
32.\"
33.\" Redistribution and use in source and binary forms, with or without
34.\" modification, are permitted provided that the following conditions
35.\" are met:
36.\" 1. Redistributions of source code must retain the above copyright
37.\"    notice, this list of conditions and the following disclaimer.
38.\" 2. Redistributions in binary form must reproduce the above copyright
39.\"    notice, this list of conditions and the following disclaimer in the
40.\"    documentation and/or other materials provided with the distribution.
41.\" 3. Neither the name of the University nor the names of its contributors
42.\"    may be used to endorse or promote products derived from this software
43.\"    without specific prior written permission.
44.\"
45.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
46.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
47.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
48.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
49.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
50.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
51.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
52.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
53.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
54.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
55.\" SUCH DAMAGE.
56.\"
57.\"     @(#)newlfs.8	8.1 (Berkeley) 6/19/93
58.\"
59.Dd April 29, 2011
60.Dt NEWFS_V7FS 8
61.Os
62.Sh NAME
63.Nm newfs_v7fs
64.Nd construct a new 7th Edition(V7) File System
65.Sh SYNOPSIS
66.Nm
67.Op Fl FZ
68.Op Fl B Ar byte-order
69.Op Fl n Ar inodes
70.Op Fl s Ar sectors
71.Op Fl V Ar verbose
72.Ar special
73.Sh DESCRIPTION
74.Nm
75builds a 7th Edition(V7) file system on the specified
76.Ar special .
77If it is a device, the size information will be taken from the disk label and
78before running
79.Nm
80the disk must be labeled using
81.Xr disklabel 8 ;
82the proper fstype is
83.Dq Version 7 .
84Otherwise, the size must be specified on the command line.
85V7 filesystem's block size and sector size are 512 byte.
86Disk address limits are 24 bit.
87.Pp
88The following arguments are supported:
89.Bl -tag -width XBXbyteXorderXX
90.It Fl B Ar byte-order
91Specify the metadata byte order of the file system to be created.
92Valid byte orders are
93.Sq be ,
94.Sq le ,
95and
96.Sq pdp .
97If no byte order is specified, the file system is created in host
98byte order.
99.It Fl F
100Create file system to a regular file (needs the
101.Fl s
102option).
103.It Fl n Ar inodes
104This specifies the number of inodes for the filesystem.
105If the number of inodes exceeds 65536, it is reduced to 65536.
106.It Fl s Ar sectors
107Create file system with specified number of disk sectors.
108.It Fl V Ar verbose
109This controls the amount of information written to stdout:
110.Bl -tag -width 3n -offset indent -compact
111.It 0
112No output.
113.It 1
114Overall size, ilist size, endian and filename length.
115.It 2
116A progress bar.
117.It 3
118.It 4
119More verbose message.
120.El
121The default is 3.
122.It Fl Z
123Fill file with zeroes instead of creating a sparse file.
124.El
125.Sh SEE ALSO
126.Xr disklabel 5 ,
127.Xr disktab 5 ,
128.\" .Xr fs 5 ,
129.Xr disklabel 8 ,
130.Xr diskpart 8
131