summaryrefslogtreecommitdiff
path: root/usr/src/man/man7fs/hsfs.7fs
diff options
context:
space:
mode:
Diffstat (limited to 'usr/src/man/man7fs/hsfs.7fs')
-rw-r--r--usr/src/man/man7fs/hsfs.7fs253
1 files changed, 0 insertions, 253 deletions
diff --git a/usr/src/man/man7fs/hsfs.7fs b/usr/src/man/man7fs/hsfs.7fs
deleted file mode 100644
index 61a137082f..0000000000
--- a/usr/src/man/man7fs/hsfs.7fs
+++ /dev/null
@@ -1,253 +0,0 @@
-.\"
-.\" Copyright (c) 2006, Sun Microsystems, Inc.
-.\" Copyright 2021 Oxide Computer Company
-.\"
-.\" 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.
-.\"
-.\" 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.
-.\"
-.\" 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]
-.\"
-.Dd November 1, 2006
-.Dt HSFS 7FS
-.Os
-.Sh NAME
-.Nm hsfs
-.Nd High Sierra & ISO 9660 CD-ROM file system
-.Sh DESCRIPTION
-.Nm
-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
-.Nm
-file system provides standard 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.
-.Pp
-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
-.Pq 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.
-.Pp
-If your
-.Pa /etc/vfstab
-file contains a line similar to the following:
-.Bd -literal
-/dev/dsk/c0t6d0s0 - /hsfs hsfs - no ro
-.Ed
-.Pp
-and
-.Pa /hsfs
-exists, you can mount an
-.Nm
-file system with either of the following commands:
-.Bd -literal -offset indent
-mount -F hsfs -o ro device-special directory-name
-.Ed
-or
-.Bd -literal -offset indent
-mount /hsfs
-.Ed
-.Pp
-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:
-.Bd -literal
-mount -F hsfs -o ro,nrr device-special directory-name
-.Ed
-.Pp
-Mount options are:
-.Bl -tag -width Ds
-.It rr
-Request HSFS to use Rock Ridge extensions, if present.
-This is the default behavior and does not need to be explicitly specified.
-.It nrr
-Disable detection and use of Rock Ridge extensions, even if present.
-.It vers2
-Request HSFS to use ISO 9660 Version 2 extensions, even if Rock Ridge is
-available.
-.It novers2
-Disable detection and use of ISO 9660 Version 2 extensions.
-.It joliet
-Request HSFS to use Joliet extensions, even if Rock Ridge or ISO 9660 Version 2
-extensions are available.
-.It nojoliet
-Disable detection and use of Joliet extensions.
-.El
-.Pp
-Files on a High Sierra or ISO 9660 CD-ROM disk have names of the form
-.Pa filename.ext;versio ,
-where
-.Fa filename
-and the optional
-.Fa ext
-consist of a sequence of uppercase alphanumeric characters
-.Po
-including
-.Sq _
-.Pc ,
-while the
-.Fa version
-consists of a sequence of digits, representing the version number of the file.
-.Nm
-converts all the uppercase characters in a file name to lowercase, and truncates
-the
-.Sq ;
-and version information.
-If more than one version of a file is present on the CD-ROM, only the file with
-the highest version number is accessible.
-.Pp
-Conversion of uppercase to lowercase characters may be disabled by using the
-.Fl o
-.Ar nomaplcase
-option to
-.Xr mount 1M .
-See
-.Xr mount_hsfs 1M .
-.Pp
-If the CD-ROM contains Rock Ridge, ISO 9660 version 2 or Joliet extensions, the
-file names and directory names may contain any character supported under
-.Xr UFS 7FS .
-The names may also be upper and/or lower case and are case sensitive.
-File name lengths can be as long as those of
-.Xr UFS 7FS .
-.Pp
-Files accessed through
-.Nm
-have mode 555
-.Pq owner, group and world readable and executable ,
-uid 0 and gid 3. If a directory on the CD-ROM has read permission,
-.Nm
-grants execute permission to the directory, allowing it to be searched.
-.Pp
-With Rock Ridge extensions, files and directories can have any permissions that
-are supported on a
-.Xr UFS 7FS
-file system.
-However, under all write permissions, the file system is read-only, with
-.Er EROFS
-returned to any write operations.
-.Pp
-Like High Sierra and ISO 9660 CD-ROMs, HSFS supports only regular files and
-directories.
-A Rock Ridge CD-ROM can support regular files, directories, and symbolic links,
-as well as device nodes, such as block, character, and FIFO.
-.Sh EXAMPLES
-.Sy Example 1
-Sample Display of File System Files
-.Pp
-If there is a file
-.Pa BIG.BAR
-on a High Sierra or ISO 9660 format CD-ROM it will show up as
-.Pa big.bar
-when listed on a
-.Nm
-file system.
-.Pp
-If there are three files
-Pa BAR.BAZ;1 ,
-Pa BBAR.BAZ;2 ,
-and
-.Pa BAR.BAZ;3
-on a High Sierra or ISO 9660 format CD-ROM, only the file
-.Pa BAR.BAZ;3
-will be accessible.
-It will be listed as
-.Pa bar.baz .
-.Sh DIAGNOSTICS
-.Bl -tag -width Ds
-.It "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
-.Xr UFS 7FS
-.It "hsfs: Warning: the file system... contains a file [with an] unsupported"
-type"
-The
-.Nm
-file system does not support the format of some file or directory on the CD-ROM,
-for example a record structured file.
-.It "hsfs: hsnode table full, %d nodes allocated"
-There are not enough
-.Nm
-internal data structure elements to handle all the files currently open.
-This problem may be overcome by adding a line of the form
-.Ql set hsfs:nhsnode=number
-to the
-.Pa /etc/system
-system configuration file and rebooting.
-See
-.Xr system 4 .
-.El
-.Sh SEE ALSO
-.Xr mount 1M ,
-.Xr mount_hsfs 1M ,
-.Xr vfstab 4
-.Pp
-.Rs
-.%A N. V. Phillips
-.%A Sony Corporation
-.%T System Description Compact Disc Digital Audio, ("Red Book")
-.Re
-.Rs
-.%A N. V. Phillips
-.%A Sony Corporation
-.%T System Description of Compact Disc Read Only Memory, ("Yellow Book")
-.Re
-.Rs
-.%T Volume and File Structure of CD-ROM for Information Interchange
-.%N ISO 9660:1988(E)
-.Re
-.Sh WARNINGS
-Do not physically eject a CD-ROM while the device is still mounted as a
-.Nm
-file system.
-.Pp
-Under MS-DOS
-.Pq for which CD-ROMs are frequently targeted ,
-files with no extension may be represented either as:
-.Pa filename\&.
-or
-.Pa filename
-that is, with or without a trailing period.
-These names are not equivalent under UNIX systems.
-For example, the names:
-.Pa BAR\&.
-and
-.Pa 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.
-.Pp
-Use of the
-.Fl o
-.Ar notraildot
-option to
-.Xr mount 1M
-makes it optional to specify the trailing dot.
-See
-.Xr mount_hsfs 1M .
-.Sh 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
-.Nm .