usr/src/man/man7fs/hsfs.7fs

   1 '\" te
   2 .\" Copyright (c) 2006, Sun Microsystems, Inc.
   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 HSFS 7FS "Nov 1, 2006"
   7 .SH NAME
   8 hsfs \- High Sierra & ISO 9660 CD-ROM file system
   9 .SH DESCRIPTION
  10 .sp
  11 .LP
  12 \fBHSFS\fR is a file system type that allows users to access files on High
  13 Sierra or  \fBISO\fR 9660 format \fBCD-ROM\fR disks from within the SunOS
  14 operating system. Once mounted, a \fBHSFS\fR file system provides standard
  15 SunOS read-only file system operations and semantics, meaning that you can read
  16 and list files in a directory on a High Sierra or \fBISO\fR 9660 \fBCD-ROM\fR
  17 and applications can use standard UNIX system calls on these files and
  18 directories.
  19 .sp
  20 .LP
  21 This file system contains support for Rock Ridge, ISO 9660 Version 2 and Joliet
  22 extensions. These extensions provide support for file names with a  length of
  23 at least 207 bytes, but only Rock Ridge extensions (with the exception of
  24 writability and hard links) can provide file system semantics and file types as
  25 they are found in UFS. The presence of Rock Ridge, ISO 9660 Version 2  and
  26 Joliet is autodetected and the best-suitable available extension is  used by
  27 the HSFS driver for file name and attribute lookup.
  28 .sp
  29 .LP
  30 If  your \fB/etc/vfstab\fR file contains a line similar to the following:
  31 .sp
  32 .in +2
  33 .nf
  34 /dev/dsk/c0t6d0s0 \(mi/hsfs hsfs \fB-no\fR ro
  35 .fi
  36 .in -2
  37
  38 .sp
  39 .LP
  40 and \fB/hsfs\fR exists, you can mount an \fBHSFS\fR file system with either of
  41 the following commands:
  42 .sp
  43 .in +2
  44 .nf
  45 mount \fB-F\fR hsfs \fB-o\fR ro \fIdevice-special\fR \fIdirectory-name\fR
  46 .fi
  47 .in -2
  48
  49 .sp
  50 .LP
  51 or
  52 .sp
  53 .in +2
  54 .nf
  55 mount /hsfs
  56 .fi
  57 .in -2
  58
  59 .sp
  60 .LP
  61 By default, Rock Ridge extensions are used if available, otherwise  ISO 9660
  62 Version 2, then Joliet are used. If neither extension is present HSFS defaults
  63 to the standard capabilities of ISO  9660. Since so-called hybrid CD-ROMs that
  64 contain multiple extensions are possible,  you can use the following mount
  65 options to deliberately disable the  search for a specific extension or to
  66 force the use of a specific extension even if a preferable type is present:
  67 .sp
  68 .in +2
  69 .nf
  70 mount \fB-F\fR hsfs \fB-o\fR ro,nrr \fIdevice-special\fR \fIdirectory-name\fR
  71 .fi
  72 .in -2
  73
  74 .sp
  75 .LP
  76 Mount options are:
  77 .sp
  78 .LP
  79 rr\(emrequest HSFS to use Rock Ridge extensions, if present. This is the
  80 default  behavior and does not need to be explicitly specified.
  81 .sp
  82 .LP
  83 nrr\(emdisable detection and use of Rock Ridge extensions, even if present.
  84 .sp
  85 .LP
  86 vers2\(emrequest HSFS to use \fIISO 9660\fR Version 2 extensions, even if Rock
  87 Ridge is available.
  88 .sp
  89 .LP
  90 novers2\(emdisable detection and use of \fIISO 9660\fR Version 2 extensions.
  91 .sp
  92 .LP
  93 joliet\(emrequest HSFS to use Joliet extensions, even if Rock Ridge or \fIISO
  94 9660\fR Version 2 extensions are available.
  95 .sp
  96 .LP
  97 nojoliet\(emdisable detection and use of Joliet extensions.
  98 .sp
  99 .LP
 100 Files on a High Sierra or \fBISO\fR 9660 \fBCD-ROM\fR disk have names of the
 101 form \fIfilename.ext;version\fR, where  \fIfilename\fR and the optional
 102 \fIext\fR consist of a sequence of uppercase alphanumeric characters (including
 103 ``_''), while the \fIversion\fR consists of a sequence of digits, representing
 104 the version number of  the file. \fBHSFS\fR converts all the uppercase
 105 characters in a file name to lowercase, and truncates the ``;'' and version
 106 information. If more than one version of a file is present on the
 107 \fBCD-ROM\fR, only the file with the highest version number is accessible.
 108 .sp
 109 .LP
 110 Conversion of uppercase to lowercase characters may be disabled by using the
 111 \fB-o\fR \fBnomaplcase\fR option to \fBmount\fR(1M). (See
 112 \fBmount_hsfs\fR(1M)).
 113 .sp
 114 .LP
 115 If the  \fBCD-ROM\fR contains Rock Ridge, ISO  9660 version 2 or Joliet
 116 extensions, the file names and directory names may contain any character
 117 supported under  \fBUFS.\fR The names may also be upper and/or lower case and
 118 are case sensitive. File name lengths can be as long as those of  \fBUFS\fR.
 119 .sp
 120 .LP
 121 Files accessed through \fBHSFS\fR have mode 555 (owner, group and world
 122 readable and executable),  uid 0 and gid 3. If a directory on the \fBCD-ROM\fR
 123 has read permission, \fBHSFS\fR grants execute permission to the directory,
 124 allowing it to be searched.
 125 .sp
 126 .LP
 127 With Rock Ridge extensions, files and directories can have any permissions that
 128 are supported on a  \fBUFS\fR file system. However, under all write
 129 permissions, the file system is read-only, with \fBEROFS\fR returned to any
 130 write operations.
 131 .sp
 132 .LP
 133 Like High Sierra and \fBISO\fR 9660 \fBCD-ROMs\fR, HSFS supports only regular
 134 files and directories. A Rock Ridge \fBCD-ROM\fR can support regular files,
 135 directories, and symbolic links, as well as device nodes, such as block,
 136 character, and FIFO.
 137 .SH EXAMPLES
 138 .LP
 139 \fBExample 1 \fRSample Display of File System Files
 140 .sp
 141 .LP
 142 If there is a file \fBBIG.BAR\fR on a High Sierra or \fBISO\fR 9660 format
 143 \fBCD-ROM\fR it will show up as \fBbig.bar\fR when listed on a \fBHSFS\fR file
 144 system.
 145
 146 .sp
 147 .LP
 148 If there are three files
 149
 150 .sp
 151 .in +2
 152 .nf
 153 \fBBAR.BAZ;1\fR
 154 .fi
 155 .in -2
 156
 157 .sp
 158 .in +2
 159 .nf
 160 \fBBAR.BAZ;2\fR
 161 .fi
 162 .in -2
 163
 164 .sp
 165 .LP
 166 and
 167
 168 .sp
 169 .in +2
 170 .nf
 171 \fBBAR.BAZ;3\fR
 172 .fi
 173 .in -2
 174
 175 .sp
 176 .LP
 177 on a High Sierra or \fBISO\fR 9660 format \fBCD-ROM,\fR only the file
 178 \fBBAR.BAZ;3\fR will be accessible. It will be listed as \fBbar.baz\fR.
 179
 180 .SH SEE ALSO
 181 .sp
 182 .LP
 183 \fBmount\fR(1M), \fBmount_hsfs\fR(1M), \fBvfstab\fR(4)
 184 .sp
 185 .LP
 186 N. V. Phillips and Sony Corporation, \fISystem Description Compact Disc Digital
 187 Audio\fR, ("Red Book").
 188 .sp
 189 .LP
 190 N. V. Phillips and Sony Corporation, \fISystem Description of Compact Disc Read
 191 Only Memory\fR, ("Yellow Book").
 192 .sp
 193 .LP
 194 IR "Volume and File Structure of CD-ROM for Information Interchange", ISO
 195 9660:1988(E).
 196 .SH DIAGNOSTICS
 197 .sp
 198 .ne 2
 199 .na
 200 \fBhsfs: Warning: the file system... \fR
 201 .ad
 202 .br
 203 .na
 204 \fBdoes not conform to the ISO-9660 spec\fR
 205 .ad
 206 .sp .6
 207 .RS 4n
 208 The specific reason appears on the following line. You might be attempting to
 209 mount a \fBCD-ROM\fR containing a different file system, such as \fBUFS\fR.
 210 .RE
 211
 212 .sp
 213 .ne 2
 214 .na
 215 \fBhsfs: Warning: the file system... \fR
 216 .ad
 217 .br
 218 .na
 219 \fBcontains a file [with an] unsupported type\fR
 220 .ad
 221 .sp .6
 222 .RS 4n
 223 The \fBhsfs\fR file system does not support the format of some file or
 224 directory on the \fBCD-ROM,\fR for example a record structured file.
 225 .RE
 226
 227 .sp
 228 .ne 2
 229 .na
 230 \fBhsfs: hsnode table full, %d nodes allocated\fR
 231 .ad
 232 .sp .6
 233 .RS 4n
 234 There are not enough \fBHSFS\fR internal data structure elements to handle all
 235 the files currently open.  This problem may be overcome by adding a line of the
 236 form \fBset hsfs:nhsnode=\fR\fInumber\fR to the \fB/etc/system\fR system
 237 configuration file and rebooting.  See \fBsystem\fR(4).
 238 .RE
 239
 240 .SH WARNINGS
 241 .sp
 242 .LP
 243 Do not physically eject a \fBCD-ROM\fR while the device is still mounted as a
 244 \fBHSFS\fR file system.
 245 .sp
 246 .LP
 247 Under \fBMS-DOS\fR (for which \fBCD-ROMs\fR are frequently targeted), files
 248 with no extension may be represented either as:
 249 .sp
 250 .in +2
 251 .nf
 252 \fIfilename.\fR
 253 .fi
 254 .in -2
 255
 256 .sp
 257 .LP
 258 or
 259 .sp
 260 .in +2
 261 .nf
 262 \fIfilename\fR
 263 .fi
 264 .in -2
 265
 266 .sp
 267 .LP
 268 that is, with or without a trailing period. These names are not equivalent
 269 under UNIX systems. For example, the names:
 270 .sp
 271 .in +2
 272 .nf
 273 \fBBAR.\fR
 274 .fi
 275 .in -2
 276
 277 .sp
 278 .LP
 279 and
 280 .sp
 281 .in +2
 282 .nf
 283 \fBBAR\fR
 284 .fi
 285 .in -2
 286
 287 .sp
 288 .LP
 289 are not names for the same file under the UNIX system. This may cause confusion
 290 if you are consulting documentation for \fBCD-ROMs\fR originally intended for
 291 \fBMS-DOS\fR systems.
 292 .sp
 293 .LP
 294 Use of the \fB-o\fR \fBnotraildot\fR option to \fBmount\fR(1M) makes it
 295 optional to specify the trailing dot. (See \fBmount_hsfs\fR(1M)).
 296 .SH NOTES
 297 .sp
 298 .LP
 299 No translation of any sort is done on the contents of High Sierra or \fBISO\fR
 300 9660 format \fBCD-ROMs\fR; only directory and file names are subject to
 301 interpretation by \fBHSFS.\fR