usr/src/man/man1m/mkfs_udfs.1m

   1 '\" te
   2 .\"  Copyright (c) 2000 Sun Microsystems, Inc. All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH MKFS_UDFS 1M "Nov 17, 2000"
   7 .SH NAME
   8 mkfs_udfs \- construct a udfs file system
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBmkfs\fR \fB-F udfs\fR [\fIgeneric_options\fR] [\fB-o\fR \fIspecific_options\fR] \fIraw_device_file\fR
  13      [\fIsize\fR]
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 This is the universal disk format file system (\fBudfs\fR) -specific module of
  20 the \fBmkfs\fR command. \fBmkfs\fR constructs a \fBudfs\fR file system with a
  21 root directory.
  22 .SH OPTIONS
  23 .sp
  24 .LP
  25 See \fBmkfs\fR(1M) for the list of supported \fIgeneric_options\fR.
  26 .sp
  27 .LP
  28 The following options are supported:
  29 .sp
  30 .ne 2
  31 .na
  32 \fB\fB-o\fR \fIspecific_options\fR\fR
  33 .ad
  34 .RS 23n
  35 Specify a \fBudfs\fR-specific option. Specify \fBudfs\fR file system specific
  36 options in a comma-separated list with no intervening spaces. If invalid
  37 options are specified, a warning message is printed and the invalid options are
  38 ignored.
  39 .sp
  40 The following \fIspecific_options\fR are available:
  41 .sp
  42 .ne 2
  43 .na
  44 \fBN\fR
  45 .ad
  46 .RS 16n
  47 Print the file system parameters without actually creating the file system.
  48 .RE
  49
  50 .sp
  51 .ne 2
  52 .na
  53 \fBlabel=\fIstring\fR\fR
  54 .ad
  55 .RS 16n
  56 Specify the label to be written into the volume header structures. Specify
  57 \fIstring\fR as the name of the label. If \fIstring\fR is not specified, a
  58 default \fIstring\fR is generated in the form of \fB*NoLabel*\fR.
  59 .RE
  60
  61 .RE
  62
  63 .SH OPERANDS
  64 .sp
  65 .LP
  66 The following operands are supported:
  67 .sp
  68 .ne 2
  69 .na
  70 \fB\fIraw_device_file\fR\fR
  71 .ad
  72 .RS 19n
  73  Specify the disk partition on which to write.
  74 .RE
  75
  76 .sp
  77 .ne 2
  78 .na
  79 \fB\fIsize\fR\fR
  80 .ad
  81 .RS 19n
  82 Specify the number of 512-byte blocks in the file system.
  83 .RE
  84
  85 .SH SEE ALSO
  86 .sp
  87 .LP
  88 \fBfsck\fR(1M),\fBmkfs\fR(1M), \fBattributes\fR(5)
  89 .SH DIAGNOSTICS
  90 .sp
  91 .in +2
  92 .nf
  93 not currently a valid file system
  94 .fi
  95 .in -2
  96 .sp
  97
  98 .sp
  99 .LP
 100 The specified device does not contain a valid \fBudfs\fR file system.
 101 .sp
 102 .in +2
 103 .nf
 104 Invalid size: larger than the partition size
 105 .fi
 106 .in -2
 107 .sp
 108
 109 .sp
 110 .LP
 111 Number of blocks given as parameter to create the file system is larger than
 112 the size of the device specified.
 113 .sp
 114 .in +2
 115 .nf
 116 is mounted can't mkfs
 117 .fi
 118 .in -2
 119 .sp
 120
 121 .sp
 122 .LP
 123 Device is in use, cannot create file system when the device is in use.
 124 .sp
 125 .in +2
 126 .nf
 127 preposterous size
 128 .fi
 129 .in -2
 130 .sp
 131
 132 .sp
 133 .LP
 134 Negative size parameter provided is invalid.
 135 .sp
 136 .in +2
 137 .nf
 138 sector size must be between 512, 8192 bytes
 139 .fi
 140 .in -2
 141 .sp
 142
 143 .sp
 144 .LP
 145 Sector size given is not in the valid range.
 146 .sp
 147 .in +2
 148 .nf
 149 Volume integrity sequence descriptors too long
 150 File set descriptor too long.
 151 .fi
 152 .in -2
 153 .sp
 154
 155 .sp
 156 .LP
 157 Not enough space to create volume integrity sequence or file set descriptor.
 158 .sp
 159 .in +2
 160 .nf
 161 mkfs: argument out of range
 162 .fi
 163 .in -2
 164 .sp
 165
 166 .sp
 167 .LP
 168 One of the arguments is out of range.
 169 .sp
 170 .in +2
 171 .nf
 172 mkfs: bad numeric arg
 173 .fi
 174 .in -2
 175 .sp
 176
 177 .sp
 178 .LP
 179 One of the arguments is potentially a bad numeric.
 180 .SH NOTES
 181 .sp
 182 .LP
 183 You can use \fBlofiadm\fR to create a file that appears to a \fBmkfs\fR command
 184 (for example, \fBmkfs_pcfs\fR or \fBmkfs_ufs\fR) as a raw device. You can then
 185 use a \fBmkfs\fR command to create a file system on that device. See
 186 \fBlofiadm\fR(1M) for examples of creating a UFS and a PC (FAT) file system on
 187 a device created by \fBlofiadm\fR.