2 .\" Copyright (c) 2003, 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_PCFS 8 "Dec 1, 2003"
8 mkfs_pcfs \- construct a FAT file system
12 \fBmkfs\fR \fB-F\fR pcfs [\fIgeneric_options\fR] [\fB-o\fR \fIFSType_specific_options\fR] \fIraw_device_file\fR
18 The \fBpcfs\fR-specific module of \fBmkfs\fR constructs a File Allocation Table
19 (\fBFAT\fR) on removable media (diskette, JAZ disk, ZIP disk, PCMCIA card), a
20 hard disk, or a file (see NOTES). \fBFAT\fRs are the standard \fBMS-DOS\fR and
21 Windows file system format. Note that you can use \fBfdformat\fR(1) to
22 construct a FAT file system only on a diskette or PCMCIA card.
25 \fBmkfs\fR for \fBpcfs\fR determines an appropriate \fBFAT\fR size for the
26 medium, then it installs an initial boot sector and an empty \fBFAT\fR. A
27 sector size of 512 bytes is used. \fBmkfs\fR for \fBpcfs\fR can also install
28 the initial file in the file system (see the \fBpcfs\fR-specific \fB-o i\fR
29 option). This first file can optionally be marked as read-only, system, and/or
33 If you want to construct a FAT with \fBmkfs\fR for \fBpcfs\fR on a medium that
34 is not formatted, you must first perform a low-level format on the medium with
35 \fBfdformat\fR(1) or \fBformat\fR(8). Non-diskette media must also be
36 partitioned with the \fBfdisk\fR(8) utility. Note that all existing data on
37 the diskette or disk partition, if any, is destroyed when a new \fBFAT\fR is
41 \fIgeneric_options\fR are supported by the generic \fBmkfs\fR command. See
42 \fBmkfs\fR(8) for a description of these options.
45 \fIraw_device_file\fR indicates the device on which to write unless the \fB-o
46 N\fR option has been specified, or if the \fB-V\fR or \fB-m\fR generic options
47 are passed from the generic \fBmkfs\fR module.
51 See \fBmkfs\fR(8) for the list of supported generic options.
54 The following options are supported:
58 \fB\fB-o\fR \fIFSType_specific_options\fR\fR
61 Specify \fBpcfs\fR file system-specific options in a comma-separated list with
62 no intervening spaces. If invalid options are specified, a warning message is
63 printed and the invalid options are ignored.
70 Label the media with volume label. The volume label is restricted to 11
77 \fBB=\fIfilename\fR\fR
80 Install \fIfilename\fR as the boot loader in the file system's boot sector. If
81 you don't specify a boot loader, an \fBMS-DOS\fR boot loader is installed. The
82 \fBMS-DOS\fR boot loader requires specific \fBMS-DOS\fR system files to make
83 the diskette bootable. See \fBNOTES\fR for more information.
92 The size of a \fBFAT\fR entry. Currently, 12, 16, and 32 are valid values. The
93 default is 12 for diskettes, 16 for larger media.
102 Mark the first file installed as a hidden file. The \fB-i\fR option must also
112 Set the number of hidden sectors to \fIn\fR. This is the number of sectors on
113 the physical disk preceding the start of the volume (which is the boot sector
114 itself). This defaults to 0 for diskettes or a computed valued (based on the
115 fdisk table) for disks. This option may be used only in conjunction with the
116 \fBnofdisk\fR option.
122 \fBi=\fIfilename\fR\fR
125 Install \fIfilename\fR as the initial file in the new file system. The initial
126 file's contents are guaranteed to occupy consecutive clusters at the start of
127 the files area. When creating bootable media, a boot program should be
128 specified as the initial file.
137 Do not attempt to find an \fBfdisk\fR table on the medium. Instead rely on the
138 \fBsize\fR option for determining the partition size. By default, the created
139 \fBFAT\fR is 16 bits and begins at the first sector of the device. This
140 origination sector can be modified with the hidden option (\fB-h\fR).
149 The number of sectors per track on the disk. If not specified, the value is
150 determined by using a \fBdkio\fR(7I) ioctl to get the disk geometry, or (for
151 diskette) from the results of an \fBFDIOGCHAR\fR ioctl.
160 The number of tracks per cylinder on the disk. If not specified, the value is
161 determined by using a \fBdkio\fR(7I) ioctl to get the disk geometry, or (for
162 diskette) from the results of an \fBFDIOGCHAR\fR ioctl.
171 No execution mode. Print normal output, but do not actually write the file
172 system to the medium. This is most useful when used in conjunction with the
182 Mark the first file installed as read-only. The \fB-i\fR option must also be
189 \fBreserve=\fIn\fR\fR
192 Set the number of reserved sectors to \fIn\fR. This is the number of sectors in
193 the volume, preceding the start of the first \fBFAT\fR, including the boot
194 sector. The value should always be at least 1, and the default value is exactly
204 Mark the first file installed as a system file. The \fB-i\fR option must also
214 The number of sectors in the file system. If not specified, the value is
215 determined from the size of the partition given in the fdisk table or (for
216 diskette) by way of computation using the \fBFDIOGCHAR\fR ioctl.
225 The size of the allocation unit for space within the file system, expressed as
226 a number of sectors. The default value depends on the \fBFAT\fR entry size and
227 the size of the file system.
236 Verbose output. Describe, in detail, operations being performed.
245 \fB\fIraw_device_file\fR\fR
248 The device on which to build the \fBFAT\fR. The device name for a diskette must
249 be specified as \fB/dev/rdiskette0\fR for the first diskette drive, or
250 \fB/dev/rdiskette1\fR for a second diskette drive. For non-diskette media, a
251 disk device name must be qualified with a suffix to indicate the proper
252 partition. For example, in the name \fB/dev/rdsk/c0t0d0p0:c\fR, the \fB:c\fR
253 suffix indicates that the first partition on the disk should receive the new
256 For a file, \fIraw_device_file\fR is the block device name returned by
263 The media in these examples must be formatted before running \fBmkfs\fR for
264 \fBpcfs\fR. See DESCRIPTION for more details.
266 \fBExample 1 \fRCreating a FAT File System on a Diskette
269 The following command creates a \fBFAT\fR file system on a diskette:
274 mkfs -F pcfs /dev/rdiskette
280 \fBExample 2 \fRCreating a FAT File System on a Disk
283 The following command creates a \fBFAT\fR file system on the second fdisk
284 partition of a disk attached to an x86 based system:
289 mkfs -F pcfs /dev/rdsk/c0d0p0:d
295 \fBExample 3 \fRCreating a FAT File System on a ZIP Disk
298 The following command creates a \fBFAT\fR file system on a ZIP disk located on
299 a SPARC based system:
304 mkfs -F pcfs /dev/rdsk/c0t4d0s2:c
310 \fBExample 4 \fRCreating a FAT File System on a JAZ Disk
313 The following command creates a \fBFAT\fR file system on a JAZ disk located on
314 a SPARC based system and overrides the sectors/track and tracks/cylinder values
315 obtained from the device's controller:
320 mkfs -F pcfs -o nsect=32,ntrack=64 /dev/rdsk/c0t3d0s2:c
328 See \fBattributes\fR(5) for descriptions of the following attributes:
336 ATTRIBUTE TYPE ATTRIBUTE VALUE
338 Interface Stability Stable
344 \fBfdformat\fR(1), \fBfdisk\fR(8), \fBformat\fR(8), \fBlofiadm\fR(8),
345 \fBmkfs\fR(8), \fBattributes\fR(5), \fBfd\fR(7D), \fBdkio\fR(7I),
350 The default \fBMS-DOS\fR boot loader, which is installed by default if \fB-o
351 B\fR is not specified, requires specific \fBMS-DOS\fR system files to make the
352 diskette bootable. These \fBMS-DOS\fR files are not installed when you format a
353 diskette with \fBmkfs\fR for \fBpcfs\fR, which makes a diskette formatted this
354 way not bootable. Trying to boot from it on an x86 based system will result in
355 the following message:
359 Non-System disk or disk error
360 Replace and strike any key when ready
367 You must format a diskette with the \fBDOS\fR \fBformat\fR command to install
368 the specific \fBMS-DOS\fR system files required by the default boot loader.
371 You can use \fBlofiadm\fR to create a file that appears to a \fBmkfs\fR command
372 (for example, \fBmkfs_pcfs\fR or \fBmkfs_ufs\fR) as a raw device. You can then
373 use a \fBmkfs\fR command to create a file system on that device. See
374 \fBlofiadm\fR(8) for examples of creating a UFS and a PC (FAT) file system on
375 a device created by \fBlofiadm\fR.