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

   1 '\" te
   2 .\"  Based on mount_hsfs(1M), which is Copyright 1989 AT&T Copyright (c) 2006 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 MOUNT_PCFS 1M "May 12, 2008"
   7 .SH NAME
   8 mount_pcfs \- mount pcfs file systems
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBmount\fR \fB-F\fR pcfs [\fIgeneric_options\fR]
  13      [\fB-o\fR \fIFSType-specific_options\fR] \fIspecial\fR | \fImount_point\fR
  14 .fi
  15
  16 .LP
  17 .nf
  18 \fBmount\fR \fB-F\fR pcfs [\fIgeneric_options\fR]
  19      [\fB-o\fR \fIFSType-specific_options\fR] \fIspecial\fR \fImount_point\fR
  20 .fi
  21
  22 .SH DESCRIPTION
  23 .sp
  24 .LP
  25 \fBmount\fR attaches an \fBMS-DOS\fR file system (\fBpcfs\fR) to the file
  26 system hierarchy at the \fImount_point\fR, which is the pathname of a
  27 directory. If \fImount_point\fR has any contents prior to the \fBmount\fR
  28 operation, these are hidden until the file system is unmounted.
  29 .sp
  30 .LP
  31 The \fBpcfs\fR file system supports direct mounting of files containing the
  32 file system as well as block devices. See \fBmount\fR(1M) and
  33 \fBlofiadm\fR(1M).
  34 .sp
  35 .LP
  36 If \fBmount\fR is invoked with \fIspecial\fR or \fImount_point\fR as the only
  37 arguments, \fBmount\fR will search \fB/etc/vfstab\fR to fill in the missing
  38 arguments, including the \fIFSType-specific_options\fR; see \fBmount\fR(1M) for
  39 more details.
  40 .sp
  41 .LP
  42 The \fIspecial\fR argument can be one of two special device file types:
  43 .RS +4
  44 .TP
  45 .ie t \(bu
  46 .el o
  47 A floppy disk, such as \fB/dev/diskette0\fR or \fB/dev/diskette1\fR.
  48 .RE
  49 .RS +4
  50 .TP
  51 .ie t \(bu
  52 .el o
  53 A DOS logical drive on a hard disk expressed as
  54 \fIdevice-name\fR\fB:\fR\fIlogical-drive\fR , where \fIdevice-name\fR specifies
  55 the special block device-file for the whole disk and \fIlogical-drive\fR is
  56 either a drive letter (c through z) or a drive number (1 through 24). Examples
  57 are \fB/dev/dsk/c0t0d0p0:\fR\fIc\fR and \fB/dev/dsk/c0t0d0p0:\fR\fI1\fR.
  58 .RE
  59 .sp
  60 .LP
  61 The \fIspecial\fR device file type must have a formatted \fBMS-DOS\fR file
  62 system with either a 12-bit, 16-bit, or 32-bit File Allocation Table.
  63 .SH OPTIONS
  64 .sp
  65 .ne 2
  66 .na
  67 \fB\fIgeneric_options\fR\fR
  68 .ad
  69 .sp .6
  70 .RS 4n
  71 See \fBmount\fR(1M) for the list of supported options.
  72 .RE
  73
  74 .sp
  75 .ne 2
  76 .na
  77 \fB\fB-o\fR\fR
  78 .ad
  79 .sp .6
  80 .RS 4n
  81 Specify \fBpcfs\fR file system-specific options. The following options are
  82 supported:
  83 .sp
  84 .ne 2
  85 .na
  86 \fB\fBclamptime\fR | \fBnoclamptime\fR\fR
  87 .ad
  88 .sp .6
  89 .RS 4n
  90 File timestamps in \fBpcfs\fR cover a range between January 1st 1980 and
  91 December 31st 2127. This is not equal to the range of \fBtime_t\fR on Unix for
  92 either 32-bit or 64-bit applications. In particular, 32-bit applications fail
  93 with \fBEOVERFLOW\fR errors on the \fBstat\fR(2) system call when timestamps
  94 beyond the range of 32-bit \fBtime_t\fR are encountered. In order to prevent
  95 such spurious failures, \fBpcfs\fR by default clamps timestamps to the common
  96 subset of possible \fBpcfs\fR timestamps and the range available to 32-bit
  97 applications in Unix. The \fBclamptime\fR mount option therefore is active by
  98 default. If you want access to the full range of possible timestamps on
  99 \fBpcfs\fR, mount the file system with the \fBnoclamptime\fR mount option. Note
 100 that if \fBnoclamptime\fR is used, only 64-bit applications will have access to
 101 timestamps beyond January 19th 2038, 03:14:06 UTC; 32-bit applications will
 102 encounter \fBEOVERFLOW\fR errors.
 103 .RE
 104
 105 .sp
 106 .ne 2
 107 .na
 108 \fB\fBfoldcase\fR | \fBnofoldcase\fR\fR
 109 .ad
 110 .sp .6
 111 .RS 4n
 112 Force uppercase characters in filenames to lowercase when reading them from the
 113 filesystem. This is for compatibility with the previous behavior of \fBpcfs\fR.
 114 The default is \fBnofoldcase\fR.
 115 .RE
 116
 117 .sp
 118 .ne 2
 119 .na
 120 \fB\fBhidden\fR | \fBnohidden\fR\fR
 121 .ad
 122 .sp .6
 123 .RS 4n
 124 Allow or disallow listing of files with hidden or system bits set. Option
 125 \fBhidden\fR is the default. When \fBnohidden\fR is effect, hidden and system
 126 files are neither visible nor accessible. Note that PCFS in previous releases
 127 of the Solaris operating system used the \fBnohidden\fR option as the default.
 128 .RE
 129
 130 .sp
 131 .ne 2
 132 .na
 133 \fB\fBatime\fR | \fBnoatime\fR\fR
 134 .ad
 135 .sp .6
 136 .RS 4n
 137 Enable or disable write access timestamps on DOS-formatted media. Default for
 138 fixed disks is \fBatime\fR, while for removable media \fBnoatime\fR is used.
 139 The latter default is so that writes to flash-based media ("memory sticks") can
 140 be minimized, to prolong lifetime.
 141 .RE
 142
 143 .sp
 144 .ne 2
 145 .na
 146 \fB\fBtimezone=\fItimezone\fR\fR\fR
 147 .ad
 148 .sp .6
 149 .RS 4n
 150 Timestamps on DOS-formatted media are recorded in the local time of the
 151 recording system. This can cause confusion when accessing removable media in
 152 which the recording and receiving system use different time zones. Use this
 153 option to force media timestamps to be interpreted for a specific time zone.
 154 The \fBmount_pcfs\fR command converts the given time zone name into a numerical
 155 offset that is passed to the \fBpcfs\fR kernel module, using the same rules as
 156 described in \fBenviron\fR(5) for the \fBTZ\fR environment variable. By
 157 default, the \fBtimezone\fR value is taken from the \fBTZ\fR environment
 158 variable.
 159 .RE
 160
 161 .RE
 162
 163 .SH FILES
 164 .sp
 165 .ne 2
 166 .na
 167 \fB\fB/etc/mnttab\fR\fR
 168 .ad
 169 .sp .6
 170 .RS 4n
 171 table of mounted file systems
 172 .RE
 173
 174 .sp
 175 .ne 2
 176 .na
 177 \fB\fB/etc/vfstab\fR\fR
 178 .ad
 179 .sp .6
 180 .RS 4n
 181 list of default parameters for each file system
 182 .RE
 183
 184 .SH SEE ALSO
 185 .sp
 186 .LP
 187 \fBlofiadm\fR(1M), \fBmount\fR(1M), \fBmountall\fR(1M), \fBmount\fR(2),
 188 \fBstat\fR(2), \fBtime\fR(2), \fBmnttab\fR(4), \fBvfstab\fR(4), \fBattributes
 189 \fR(5), \fBenviron\fR(5), \fBpcfs\fR(7FS)
 190 .SH NOTES
 191 .sp
 192 .LP
 193 If the directory on which a file system is to be mounted is a symbolic link,
 194 the file system is mounted on the directory to which the symbolic link refers,
 195 rather than on top of the symbolic link itself.