'\" te
.\"  Copyright (c) 2000 Sun Microsystems, Inc. All Rights Reserved.
.TH mkfs_udfs 1M "17 Nov 2000" "SunOS 5.11" "System Administration Commands"
.SH NAME
mkfs_udfs \- construct a udfs file system
.SH SYNOPSIS
.LP
.nf
\fBmkfs\fR \fB-F udfs\fR [\fIgeneric_options\fR] [\fB-o\fR \fIspecific_options\fR] \fIraw_device_file\fR 
     [\fIsize\fR]
.fi

.SH DESCRIPTION
.sp
.LP
This is the universal disk format file system (\fBudfs\fR) -specific module of the \fBmkfs\fR command. \fBmkfs\fR constructs a \fBudfs\fR file system with a root directory. 
.SH OPTIONS
.sp
.LP
See \fBmkfs\fR(1M) for the list of supported \fIgeneric_options\fR.
.sp
.LP
The following options are supported: 
.sp
.ne 2
.mk
.na
\fB\fB-o\fR \fIspecific_options\fR\fR
.ad
.RS 23n
.rt  
Specify a \fBudfs\fR-specific option. Specify \fBudfs\fR file system specific options in a comma-separated list with no intervening spaces. If invalid options are specified, a warning message is printed and the invalid options are ignored. 
.sp
The following \fIspecific_options\fR are available:
.sp
.ne 2
.mk
.na
\fBN\fR
.ad
.RS 16n
.rt  
Print the file system parameters without actually creating the file system.
.RE

.sp
.ne 2
.mk
.na
\fBlabel=\fIstring\fR\fR
.ad
.RS 16n
.rt  
Specify the label to be written into the volume header structures. Specify \fIstring\fR as the name of the label. If \fIstring\fR is not specified, a default \fIstring\fR is generated in the form of \fB*NoLabel*\fR.
.RE

.RE

.SH OPERANDS
.sp
.LP
The following operands are supported: 
.sp
.ne 2
.mk
.na
\fB\fIraw_device_file\fR\fR
.ad
.RS 19n
.rt  
 Specify the disk partition on which to write.
.RE

.sp
.ne 2
.mk
.na
\fB\fIsize\fR\fR
.ad
.RS 19n
.rt  
Specify the number of 512-byte blocks in the file system.
.RE

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Availabilitysystem/file-system/udfs
.TE

.SH SEE ALSO
.sp
.LP
\fBfsck\fR(1M),\fBmkfs\fR(1M), \fBattributes\fR(5)
.SH DIAGNOSTICS
.sp
.in +2
.nf
not currently a valid file system
.fi
.in -2
.sp

.sp
.LP
The specified device does not contain a valid \fBudfs\fR file system.
.sp
.in +2
.nf
Invalid size: larger than the partition size
.fi
.in -2
.sp

.sp
.LP
Number of blocks given as parameter to create the file system is larger than the size of the device specified.
.sp
.in +2
.nf
is mounted can't mkfs
.fi
.in -2
.sp

.sp
.LP
Device is in use, cannot create file system when the device is in use.
.sp
.in +2
.nf
preposterous size
.fi
.in -2
.sp

.sp
.LP
Negative size parameter provided is invalid.
.sp
.in +2
.nf
sector size must be between 512, 8192 bytes
.fi
.in -2
.sp

.sp
.LP
Sector size given is not in the valid range.
.sp
.in +2
.nf
Volume integrity sequence descriptors too long
File set descriptor too long. 
.fi
.in -2
.sp

.sp
.LP
Not enough space to create volume integrity sequence or file set descriptor.
.sp
.in +2
.nf
mkfs: argument out of range
.fi
.in -2
.sp

.sp
.LP
One of the arguments is out of range.
.sp
.in +2
.nf
mkfs: bad numeric arg
.fi
.in -2
.sp

.sp
.LP
One of the arguments is potentially a bad numeric.
.SH NOTES
.sp
.LP
You can use \fBlofiadm\fR to create a file that appears to a \fBmkfs\fR command (for example, \fBmkfs_pcfs\fR or \fBmkfs_ufs\fR) as a raw device. You can then use a \fBmkfs\fR command to create a file system on that device. See \fBlofiadm\fR(1M) for examples of creating a UFS and a PC (FAT) file system on a device created by \fBlofiadm\fR.