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

   1 '\" te
   2 .\"  Copyright 1989 AT&T Copyright (c) 2008, 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_HSFS 1M "May 29, 2008"
   7 .SH NAME
   8 mount_hsfs \- mount hsfs file systems
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBmount\fR \fB-F\fR hsfs [\fIgeneric_options\fR]
  13      [\fB-o\fR \fIFSType-specific_options\fR] [\fB-O\fR ] \fIspecial\fR | \fImount_point\fR
  14 .fi
  15
  16 .LP
  17 .nf
  18 \fBmount\fR \fB-F\fR hsfs [\fIgeneric_options\fR]
  19      [\fB-o\fR \fIFSType-specific_options\fR] [\fB-O\fR] \fIspecial\fR \fImount_point\fR
  20 .fi
  21
  22 .SH DESCRIPTION
  23 .sp
  24 .LP
  25 \fBmount\fR attaches an ISO 9660 filesystem (the High Sierra  file system,
  26 \fBhsfs\fR,  is  a  draft predecessor to ISO 9660, so the name reflects the
  27 filesystem's history) to  the  file  system hierarchy at the \fImount_point\fR,
  28 which is the pathname of a directory. If \fImount_point\fR has any contents
  29 prior to the mount operation, these are hidden until the file system is
  30 unmounted.
  31 .sp
  32 .LP
  33 If  \fBmount\fR is invoked with  \fIspecial\fR or  \fImount_point\fR as the
  34 only arguments,  \fBmount\fR will search  \fB/etc/vfstab\fR to fill in the
  35 missing arguments, including the  \fIFSType-specific_options\fR; see
  36 \fBmount\fR(1M) for more details.
  37 .sp
  38 .LP
  39 The \fBhsfs\fR file system supports direct mounting of files containing the
  40 file system as well as block devices. See \fBmount\fR(1M) and
  41 \fBlofiadm\fR(1M).
  42 .sp
  43 .LP
  44 A file system conforming to ISO 9660 can contain extensions that allow it to
  45 overcome limitations of the original ISO 9660:1988 (version 1) standard. The
  46 following types of extensions are supported by \fBhsfs\fR:
  47 .sp
  48 .ne 2
  49 .na
  50 \fBRock Ridge extensions\fR
  51 .ad
  52 .sp .6
  53 .RS 4n
  54 This is the preferred type of extension as it allows file attributes, name
  55 length, and types equivalent to those on other UNIX-style filesystems. Example
  56 of supported features are device special files, POSIX permissions, symbolic
  57 links, and filenames of up to 255 bytes in length. Rock Ridge  extensions also
  58 remove the ISO9660:1988 restriction on  maximum nesting depth for directories
  59 (eight levels). \fBhsfs\fR  automatically detects the presence of Rock Ridge
  60 extensions and uses them, unless mount options are specified to disable the use
  61 of Rock Ridge or to use a different extension.
  62 .RE
  63
  64 .sp
  65 .ne 2
  66 .na
  67 \fBISO9660:1999 (version 2) extensions\fR
  68 .ad
  69 .sp .6
  70 .RS 4n
  71 The first version of ISO9660, released in 1988, supported  only uppercase ASCII
  72 filenames of no more than 31 characters in length. ISO9660 version 2, released
  73 in 1999,  provides an extension that allows filenames of at least 207 bytes
  74 that can use UTF-8 characters and removes the limitation on the nesting depth
  75 for directories. Unlike Rock Ridge, it does not provide support  for UNIX-style
  76 file types and file attributes. \fBhsfs\fR automatically detects this extension
  77 and will use it for filename lookup if no Rock Ridge extensions are found on
  78 the media.
  79 .RE
  80
  81 .sp
  82 .ne 2
  83 .na
  84 \fBJoliet extensions\fR
  85 .ad
  86 .sp .6
  87 .RS 4n
  88 The Joliet extension was devised by Microsoft to allow Unicode (UCS-2) long
  89 filenames with CDROM-based media. It allows filename lengths of up to 110
  90 Unicode characters and does not support UNIX-style file types and attributes.
  91 \fBhsfs\fR falls back to using Joliet if such an extension is present and
  92 neither Rock Ridge nor ISO9660 version 2 extensions are found.
  93 .sp
  94 If filenames are longer than the 64 UCS-2 characters officially allowed by
  95 Microsoft (that is, 110 Unicode  characters), they can translate to up to 330
  96 UTF-8 octets. Filenames that translate to more than 255 UTF-8 octets will be
  97 truncated.
  98 .RE
  99
 100 .SH OPTIONS
 101 .sp
 102 .ne 2
 103 .na
 104 \fB\fIgeneric_options\fR\fR
 105 .ad
 106 .sp .6
 107 .RS 4n
 108 See \fBmount\fR(1M) for the list of supported options.
 109 .RE
 110
 111 .sp
 112 .ne 2
 113 .na
 114 \fB\fB-o\fR\fR
 115 .ad
 116 .sp .6
 117 .RS 4n
 118 Specify  \fBhsfs\fR file system specific options.  If invalid options are
 119 specified, a warning message is printed and the invalid options are ignored.
 120 The following options are available:
 121 .sp
 122 .ne 2
 123 .na
 124 \fB\fBglobal\fR |  \fBnoglobal\fR\fR
 125 .ad
 126 .sp .6
 127 .RS 4n
 128 If \fBglobal\fR is specified and supported on the file system, and the system
 129 in question is part of a cluster, the file system will be globally visible on
 130 all nodes of the cluster. If \fBnoglobal\fR is specified, the mount will not be
 131 globally visible. The default behavior is \fBnoglobal\fR.
 132 .RE
 133
 134 .sp
 135 .ne 2
 136 .na
 137 \fB\fBro\fR\fR
 138 .ad
 139 .sp .6
 140 .RS 4n
 141 Mount the file system read-only.  This option is required.
 142 .RE
 143
 144 .sp
 145 .ne 2
 146 .na
 147 \fB\fBrr\fR | \fBnrr\fR\fR
 148 .ad
 149 .sp .6
 150 .RS 4n
 151 Enable (\fBrr\fR) or disable (\fBnrr\fR) the use of Rock Ridge. \fBrr\fR is the
 152 default and need not be specified. If you use \fBnrr\fR and Rock Ridge
 153 extensions are present in the file system, ignore them and search for other
 154 available extensions or fall back to plain ISO9660.
 155 .RE
 156
 157 .sp
 158 .ne 2
 159 .na
 160 \fB\fBvers2\fR | \fBnovers2\fR\fR
 161 .ad
 162 .sp .6
 163 .RS 4n
 164 Enable or disable the use of ISO9660 version 2  extensions. If \fBvers2\fR is
 165 specified and ISO9660 version 2 extensions are available, \fBhsfs\fR will use
 166 ISO9660  version 2 even if the file system contains the preferred Rock Ridge
 167 extensions as well. If \fBnovers2\fR is specified, it will fall back to using
 168 either Joliet extensions or plain ISO9660 even if ISO9660 version 2 extensions
 169 are available.
 170 .RE
 171
 172 .sp
 173 .ne 2
 174 .na
 175 \fB\fBjoliet\fR | \fBnojoliet\fR\fR
 176 .ad
 177 .sp .6
 178 .RS 4n
 179 Enable or disable the use of Joliet extensions. If \fBjoliet\fR is specified
 180 and Joliet extensions are available, \fBhsfs\fR  will use them even if the file
 181 system contains the preferred Rock Ridge and/or ISO9660 version 2 extensions.
 182 If \fBnojoliet\fR is specified, it will fall back to using plain ISO9660.
 183 .RE
 184
 185 .sp
 186 .ne 2
 187 .na
 188 \fB\fBnotraildot\fR\fR
 189 .ad
 190 .sp .6
 191 .RS 4n
 192 File names on High Sierra file systems consist of a proper name and an
 193 extension separated by a '.' (dot) character.  By default, the separating dot
 194 is always considered part of the file's name for all file access operations,
 195 even if there is no extension present. Specifying  \fBnotraildot\fR makes it
 196 optional to specify the trailing dot to access a file whose name lacks an
 197 extension.
 198 .sp
 199 \fBExceptions:\fR This option is effective only on file systems for which Rock
 200 Ridge, ISO9660 version 2 or Joliet extensions are not active, either because
 201 they are not present on the CD-ROM, or they have been deliberately disabled via
 202 the \fBnrr\fR, \fBnovers2\fR and \fBnojoliet\fR option. If either extension is
 203 active, \fBhsfs\fR quietly ignores this option.
 204 .RE
 205
 206 .sp
 207 .ne 2
 208 .na
 209 \fB\fBnomaplcase\fR\fR
 210 .ad
 211 .sp .6
 212 .RS 4n
 213 File names on High Sierra/ISO9660 CD-ROMs with no extensions present should be
 214 uppercase characters only. By default,  \fBhsfs\fR maps file names read from a
 215 \fBnon-Rock Ridge\fR disk to all lowercase characters. \fBnomaplcase\fR turns
 216 off this mapping. The exceptions for  \fBnotraildot\fR discussed above apply to
 217 \fBnomaplcase\fR.
 218 .RE
 219
 220 .RE
 221
 222 .sp
 223 .ne 2
 224 .na
 225 \fB\fB-O\fR\fR
 226 .ad
 227 .sp .6
 228 .RS 4n
 229 Overlay mount.  Allow the file system to be mounted over an existing mount
 230 point, making the underlying file system inaccessible.  If a mount is attempted
 231 on a preexisting mount point without setting this flag, the mount will fail,
 232 producing the error: \f(CWdevice busy\fR.
 233 .RE
 234
 235 .SH EXAMPLES
 236 .LP
 237 \fBExample 1 \fRMounting and Unmounting a DVD Image Directly
 238 .sp
 239 .LP
 240 The following commands mount and unmount a DVD image.
 241
 242 .sp
 243 .in +2
 244 .nf
 245 # \fBmount -F hsfs /images/solaris.iso /mnt/solaris-image\fR
 246 # \fBumount /mnt/solaris-image\fR
 247 .fi
 248 .in -2
 249 .sp
 250
 251 .SH FILES
 252 .sp
 253 .ne 2
 254 .na
 255 \fB\fB/etc/mnttab\fR\fR
 256 .ad
 257 .sp .6
 258 .RS 4n
 259 table of mounted file systems
 260 .RE
 261
 262 .sp
 263 .ne 2
 264 .na
 265 \fB\fB/etc/vfstab\fR\fR
 266 .ad
 267 .sp .6
 268 .RS 4n
 269 list of default parameters for each file system
 270 .RE
 271
 272 .SH SEE ALSO
 273 .sp
 274 .LP
 275 \fBlofiadm\fR(1M), \fBmount\fR(1M), \fBmountall\fR(1M), \fBmount\fR(2),
 276 \fBmnttab\fR(4), \fBvfstab\fR(4), \fBattributes\fR(5)
 277 .SH NOTES
 278 .sp
 279 .LP
 280 If the directory on which a file system is to be mounted is a symbolic link,
 281 the file system is mounted on the directory to which the symbolic link refers,
 282 rather than on top of the symbolic link itself.