sbin/newfs_v7fs/newfs_v7fs.8

   1 .\"     $NetBSD: newfs_v7fs.8,v 1.4 2016/09/12 05:16:04 sevan 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 September 12, 2016
  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
  75 builds a 7th Edition(V7) file system on the specified
  76 .Ar special .
  77 If it is a device, the size information will be taken from the disk label and
  78 before running
  79 .Nm
  80 the disk must be labeled using
  81 .Xr disklabel 8 ;
  82 the proper fstype is
  83 .Dq Version 7 .
  84 Otherwise, the size must be specified on the command line.
  85 V7 filesystem's block size and sector size are 512 byte.
  86 Disk address limits are 24 bit.
  87 .Pp
  88 The following arguments are supported:
  89 .Bl -tag -width XBXbyteXorderXX
  90 .It Fl B Ar byte-order
  91 Specify the metadata byte order of the file system to be created.
  92 Valid byte orders are
  93 .Sq be ,
  94 .Sq le ,
  95 and
  96 .Sq pdp .
  97 If no byte order is specified, the file system is created in host
  98 byte order.
  99 .It Fl F
 100 Create file system to a regular file (needs the
 101 .Fl s
 102 option).
 103 .It Fl n Ar inodes
 104 This specifies the number of inodes for the filesystem.
 105 If the number of inodes exceeds 65536, it is reduced to 65536.
 106 .It Fl s Ar sectors
 107 Create file system with specified number of disk sectors.
 108 .It Fl V Ar verbose
 109 This controls the amount of information written to stdout:
 110 .Bl -tag -width 3n -offset indent -compact
 111 .It 0
 112 No output.
 113 .It 1
 114 Overall size, ilist size, endian and filename length.
 115 .It 2
 116 A progress bar.
 117 .It 3
 118 .It 4
 119 More verbose message.
 120 .El
 121 The default is 3.
 122 .It Fl Z
 123 Fill 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 .Sh HISTORY
 132 A
 133 .Nm
 134 utility appeared in
 135 .Nx 6.0 .
 136 .Sh AUTHORS
 137 .Nm
 138 was written by
 139 .An UCHIYAMA Yasushi Aq Mt uch@NetBSD.org .