HSFS(7FS)HSFS(7FS)NAMEhsfs - High Sierra & ISO 9660 CD-ROM file system
DESCRIPTION
HSFS is a file system type that allows users to access files on High
Sierra or ISO 9660 format CD-ROM disks from within the SunOS operating
system. Once mounted, a HSFS file system provides standard SunOS read-
only file system operations and semantics, meaning that you can read
and list files in a directory on a High Sierra or ISO 9660 CD-ROM and
applications can use standard UNIX system calls on these files and
directories.
This file system contains support for Rock Ridge, ISO 9660 Version 2
and Joliet extensions. These extensions provide support for file names
with a length of at least 207 bytes, but only Rock Ridge extensions
(with the exception of writability and hard links) can provide file
system semantics and file types as they are found in UFS. The presence
of Rock Ridge, ISO 9660 Version 2 and Joliet is autodetected and the
best-suitable available extension is used by the HSFS driver for file
name and attribute lookup.
If your /etc/vfstab file contains a line similar to the following:
/dev/dsk/c0t6d0s0 −/hsfs hsfs-no ro
and /hsfs exists, you can mount an HSFS file system with either of the
following commands:
mount -Fhsfs-o ro device-special directory-name
or
mount /hsfs
By default, Rock Ridge extensions are used if available, otherwise ISO
9660 Version 2, then Joliet are used. If neither extension is present
HSFS defaults to the standard capabilities of ISO 9660. Since so-
called hybrid CD-ROMs that contain multiple extensions are possible,
you can use the following mount options to deliberately disable the
search for a specific extension or to force the use of a specific
extension even if a preferable type is present:
mount -Fhsfs-o ro,nrr device-special directory-name
Mount options are:
rr—request HSFS to use Rock Ridge extensions, if present. This is the
default behavior and does not need to be explicitly specified.
nrr—disable detection and use of Rock Ridge extensions, even if
present.
vers2—request HSFS to use ISO 9660 Version 2 extensions, even if Rock
Ridge is available.
novers2—disable detection and use of ISO 9660 Version 2 extensions.
joliet—request HSFS to use Joliet extensions, even if Rock Ridge or ISO
9660 Version 2 extensions are available.
nojoliet—disable detection and use of Joliet extensions.
Files on a High Sierra or ISO 9660 CD-ROM disk have names of the form
filename.ext;version, where filename and the optional ext consist of a
sequence of uppercase alphanumeric characters (including ``_''), while
the version consists of a sequence of digits, representing the version
number of the file. HSFS converts all the uppercase characters in a
file name to lowercase, and truncates the ``;'' and version informa‐
tion. If more than one version of a file is present on the CD-ROM, only
the file with the highest version number is accessible.
Conversion of uppercase to lowercase characters may be disabled by
using the -o nomaplcase option to mount(1M). (See mount_hsfs(1M)).
If the CD-ROM contains Rock Ridge, ISO 9660 version 2 or Joliet
extensions, the file names and directory names may contain any charac‐
ter supported under UFS. The names may also be upper and/or lower case
and are case sensitive. File name lengths can be as long as those of
UFS.
Files accessed through HSFS have mode 555 (owner, group and world read‐
able and executable), uid 0 and gid 3. If a directory on the CD-ROM
has read permission, HSFS grants execute permission to the directory,
allowing it to be searched.
With Rock Ridge extensions, files and directories can have any permis‐
sions that are supported on a UFS file system. However, under all
write permissions, the file system is read-only, with EROFS returned to
any write operations.
Like High Sierra and ISO 9660 CD-ROMs, HSFS supports only regular files
and directories. A Rock Ridge CD-ROM can support regular files, direc‐
tories, and symbolic links, as well as device nodes, such as block,
character, and FIFO.
EXAMPLES
Example 1 Sample Display of File System Files
If there is a file BIG.BAR on a High Sierra or ISO 9660 format CD-ROM
it will show up as big.bar when listed on a HSFS file system.
If there are three files
BAR.BAZ;1
BAR.BAZ;2
and
BAR.BAZ;3
on a High Sierra or ISO 9660 format CD-ROM, only the file BAR.BAZ;3
will be accessible. It will be listed as bar.baz.
SEE ALSOmount(1M), mount_hsfs(1M), vfstab(4)
N. V. Phillips and Sony Corporation, System Description Compact Disc
Digital Audio, ("Red Book").
N. V. Phillips and Sony Corporation, System Description of Compact Disc
Read Only Memory, ("Yellow Book").
IR "Volume and File Structure of CD-ROM for Information Interchange",
ISO 9660:1988(E).
DIAGNOSTICS
hsfs: Warning: the file system...
does not conform to the ISO-9660 spec
The specific reason appears on the following line. You might be
attempting to mount a CD-ROM containing a different file system,
such as UFS.
hsfs: Warning: the file system...
contains a file [with an] unsupported type
The hsfs file system does not support the format of some file or
directory on the CD-ROM, for example a record structured file.
hsfs: hsnode table full, %d nodes allocated
There are not enough HSFS internal data structure elements to han‐
dle all the files currently open. This problem may be overcome by
adding a line of the form set hsfs:nhsnode=number to the /etc/sys‐
tem system configuration file and rebooting. See system(4).
WARNINGS
Do not physically eject a CD-ROM while the device is still mounted as a
HSFS file system.
Under MS-DOS (for which CD-ROMs are frequently targeted), files with no
extension may be represented either as:
filename.
or
filename
that is, with or without a trailing period. These names are not equiva‐
lent under UNIX systems. For example, the names:
BAR.
and
BAR
are not names for the same file under the UNIX system. This may cause
confusion if you are consulting documentation for CD-ROMs originally
intended for MS-DOS systems.
Use of the -o notraildot option to mount(1M) makes it optional to spec‐
ify the trailing dot. (See mount_hsfs(1M)).
NOTES
No translation of any sort is done on the contents of High Sierra or
ISO 9660 format CD-ROMs; only directory and file names are subject to
interpretation by HSFS.
Nov 1, 2006 HSFS(7FS)