Print this page
11622 clean up rarer mandoc lint warnings
*** 5,15 ****
.\" 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]
.TH PCFS 7FS "Nov 6, 2007"
.SH NAME
pcfs \- FAT formatted file system
.SH SYNOPSIS
- .LP
.nf
#include <sys/param.h>
#include <sys/mount.h>
#include <sys/fs/pc_fs.h>
--- 5,14 ----
*** 18,29 ****
\fB"pcfs", NULL, 0,\fR \fBchar *\fR\fIoptptr\fR,
\fBint\fR \fIoptlen\fR);
.fi
.SH DESCRIPTION
- .sp
- .LP
\fBpcfs\fR is a file system type that enables direct access to files on
\fBFAT\fR formatted disks from within the SunOS operating system.
.sp
.LP
Once mounted, \fBpcfs\fR provides standard SunOS file operations and semantics.
--- 17,26 ----
*** 74,85 ****
.sp
.LP
The FAT filesystem doesn't support multiple links. As a result, the link count
for all files and directories in \fBpcfs\fR is hard-coded as "1."
.SS "Mounting File Systems"
- .sp
- .LP
Use the following command to mount \fBpcfs\fR from diskette:
.sp
.in +2
.nf
mount \fB-F\fR pcfs \fIdevice-special\fR \fIdirectory-name\fR
--- 71,80 ----
*** 210,221 ****
.fi
.in -2
.sp
.SS "Conventions"
- .sp
- .LP
Files and directories created through \fBpcfs\fR must comply with either the
\fBFAT\fR short file name convention or the long file name convention
introduced with Windows 95. The \fBFAT\fR short file name convention is of the
form \fIfilename\fR[.\fIext\fR], where \fIfilename\fR generally consists of
from one to eight upper-case characters, while the optional \fIext\fR consists
--- 205,214 ----
*** 258,269 ****
.LP
To format a diskette or a \fBPCMCIA\fR pseudo-floppy memory card in \fBFAT\fR
format in the SunOS system, use either the \fBfdformat\fR \fB-d\fR or the
\fBDOS\fR \fBFORMAT\fR command.
.SS "Boot Partitions"
- .sp
- .LP
On x86 systems, hard drives may contain an \fBfdisk\fR partition reserved for
the Solaris boot utilities. These partitions are special instances of
\fBpcfs\fR. You can mount an x86 boot partition with the command:
.sp
.in +2
--- 251,260 ----
*** 305,315 ****
.sp
.LP
All files on a boot partition are owned by super-user. Only the super-user may
create, delete, or modify files on a boot partition.
.SH EXAMPLES
- .LP
\fBExample 1 \fRSample Displays of File Names
.sp
.LP
If you copy a file \fBfinancial.data\fR from a UNIX file system to \fBpcfs\fR,
it displays as \fBfinancial.data\fR in \fBpcfs\fR, but may show up as
--- 296,305 ----
*** 318,328 ****
.sp
.LP
The following are legal long file names. They are also \fBillegal\fR short file
names:
- .br
.in +2
\fBtest.sh.orig\fR
.in -2
.br
.in +2
--- 308,317 ----
*** 334,344 ****
.in -2
.sp
.LP
Other systems that do not support long file names may see:
- .br
.in +2
\fBTESTSH~1.ORI\fR
.in -2
.br
.in +2
--- 323,332 ----
*** 352,362 ****
.LP
The short file name is generated from the initial characters of the long file
name, so differentiate names in the first few characters. For example, these
names:
- .br
.in +2
\fBWorkReport.January.Data\fR
.in -2
.br
.in +2
--- 340,349 ----
*** 368,378 ****
.in -2
.sp
.LP
result in these short names, which are not distinguishable:
- .br
.in +2
\fBWORKRE~1.DAT\fR
.in -2
.br
.in +2
--- 355,364 ----
*** 384,394 ****
.in -2
.sp
.LP
These names, however:
- .br
.in +2
\fBJanuary.WorkReport.Data\fR
.in -2
.br
.in +2
--- 370,379 ----
*** 400,410 ****
.in -2
.sp
.LP
result in the more descriptive short names:
- .br
.in +2
\fBJANUAR~1.DAT\fR
.in -2
.br
.in +2
--- 385,394 ----
*** 413,423 ****
.br
.in +2
\fBMARCHW~1.DAT\fR
.in -2
.SH FILES
- .sp
.ne 2
.na
\fB\fB/usr/lib/fs/pcfs/mount\fR\fR
.ad
.RS 26n
--- 397,406 ----
*** 432,455 ****
.RS 26n
32-bit kernel module
.RE
.SH ENVIRONMENT VARIABLES
- .sp
- .LP
See \fBenviron\fR(5) for descriptions of the following environment variables
for the current locale setting: LANG, LC_ALL, LC_CTYPE, and LC_COLLATE.
.SH SEE ALSO
- .sp
- .LP
\fBchgrp\fR(1), \fBchown\fR(1), \fBdos2unix\fR(1), \fBeject\fR(1),
\fBfdformat\fR(1), \fBunix2dos\fR(1), \fBvolcheck\fR(1), \fBmount\fR(1M),
\fBmount_pcfs\fR(1M), \fBumount\fR(1M), \fBctime\fR(3C), \fBvfstab\fR(4),
\fBenviron\fR(5), \fBpcmem\fR(7D)
.SH WARNINGS
- .sp
- .LP
Do not physically eject a \fBFAT\fR floppy while the device is mounted as
\fBpcfs\fR. If Volume Management is managing a device, use the \fBeject\fR(1)
command before physically removing media.
.sp
.LP
--- 415,432 ----
*** 460,471 ****
Because \fBpcfs\fR has no provision for handling owner-IDs or group-IDs on
files, \fBchown\fR(1) or \fBchgrp\fR(1) may generate various errors. This is a
limitation of \fBpcfs\fR, but it should not cause problems other than error
messages.
.SH NOTES
- .sp
- .LP
Only the following characters are allowed in \fBpcfs\fR short file names and
extensions:
.br
.in +2
\fB0-9\fR
--- 437,446 ----
*** 506,515 ****
locales. In the same context, when new file names with non-ASCII characters are
created, \fBpcfs\fR expects that such file names are in UTF-8. This feature
increases the interoperability of \fBpcfs\fR on Solaris with other operating
systems.
.SH BUGS
- .sp
- .LP
\fBpcfs\fR should handle the disk change condition in the same way that
\fBDOS\fR does, so you do not need to unmount the file system to change
floppies.
--- 481,488 ----