mount_cdfs(1M)


mount_cdfs -- mount cdfs filesystem

Synopsis

mount [-F cdfs] [generic_options] -r [-o cdfs_options]
[special|mount_point]
mount [-F cdfs] [generic_options] -r [-o cdfs_options]
special mount_point

Description

The mount command attaches the cdfs filesystem to the filesystem hierarchy at the location specified by mount_point, which must already exist and must be a directory. If mount_point already has contents prior to the mount operation, the contents remain hidden until the cdfs filesystem is unmounted. The generic_options are the options supported by the generic mount command (see the generic mount(1M) command for information about these options). The cdfs-specific options affect the mode of operation of the CDROM and are used to set default values.

The CDROM media may or may not have values set for items such as the User ID (UID), Group ID (GID), permissions, etc. If a value is not recorded on the CDROM, a default value is assigned by the software. The default value is either taken from the /etc/conf/pack.d/cdfs/space.c file, or from the value specified with the -o option of the mount command.

Once the media is mounted, a default value can only be changed by using the cddevsuppl(1M) or cdmntsuppl(1M) commands, or by unmounting (or remounting) the media and specifying the desired values using the -o option.

cdfs-specific options

-F cdfs
Specifies the cdfs filesystem type. (Required)

-r
Mounts the filesystem as read-only. This option or the -o ro option is required.

-o
Specifies the cdfs-specific options in a comma-separated list of options from the list below. The default values that are set when the CDROM is mounted include suid, susp, and rrip, and the values defined in the /etc/conf/pack.d/cdfs/space.c file.

The following are the cdfs_options to -o:

ro
Mounts the resource read-only. This option or the -r option are required.

suid | nosuid
Allows or disallows execution of Setuid programs. The default is suid.

susp | nosusp
Enables/disables the processing of all System Use Sharing Protocol (SUSP) compliant extensions to the ISO-9660/High-Sierra specification. The SUSP defines a mechanism for which the System Use Area of a Directory Record may be shared by multiple independent organizations, for example, Rock Ridge Interchange Protocol (RRIP). The nosusp flag prevents the processing of all SUSP-compliant extensions, even if recorded on the media.

rrip | norrip
Enables/disables the processing of all the Rock Ridge Interchange Protocol (RRIP) extensions to the ISO-9660/High-Sierra specification. The RRIP is a SUSP-compliant set of extensions that provide POSIX file semantics within the context of an ISO-9660/High-Sierra file-system. The rrip flag requires that the susp flag also be set. The norrip flag prevents the processing of all RRIP extensions even if recorded on the media.

noextend
Disallows the processing of all extensions to the ISO-9660/High-Sierra specification (SUSP and non-SUSP alike), even if recorded on the media. Currently, noextend is equivalent to nosusp, norrip. However, noextend will apply to future ISO-9660/High-Sierra extensions.

lsectsz=<value>
Defines the logical sector size of the media, as defined by the ISO-9660 and/or the High Sierra specifications. If not specified, the system will automatically determine the logical sector size of the media. The user need not specify this option. However, if specified, the value must exactly match the media being mounted.

uid=owner
Defines the default UID to be used for the files and/or directories that do not have a UID recorded on the CDROM. owner is a numeric UID value or a user name. See the cdmntsuppl(1M) command for more information.

gid=group
Defines the default GID to be used for the files and/or directories that do not have a GID recorded on the CDROM. group is a numeric GID value or a group name. See the cdmntsuppl(1M) command in the X/Open CD-ROM Support Component Preliminary Specification for more information.

fperm=mode
Defines the default file permissions to be used for the files that do not have permissions recorded on the CDROM. The value mode is an absolute value (a 4-digit octal), or symbolic value. See the chmod(1) and cdmntsuppl(1M) commands.

dperm=mode
Defines the default directory permissions to be used for the directories that do not have permissions recorded on the CDROM. The value mode is an absolute value (a 4-digit octal), or symbolic value. See the chmod(1) and cdmntsuppl(1M) commands.

uidmap=filename
Sets User ID mappings. The UID and user names associated with a file or directory on the CDROM might not be valid on the host system. The uidmap function maps the CDROM UIDs to valid host system UIDs.

Entries in filename are specified as the value recorded on the CDROM, colon (:), followed by the UID or user name as found in the user database. Multiple entries are separated by new lines.

For example, filename may contain the entries:

   1500:418 
   1006:stanley 
The first entry maps the UID of 1500 (on the CDROM) to a UID of 418. The second entry maps the UID of 1006 (on the CDROM) to the user named stanley. See the cdmntsuppl(1M) command.

The maximum number of mappings allowed is defined in sys/cdrom.h.

gidmap=filename
Sets Group ID mappings. The GID and group names associated with a file or directory on the CDROM might not be valid on the host system. The gidmap function maps the CDROM GIDs to valid host system GIDs.

Entries in filename are specified as the value recorded on CDROM, colon (:), followed by the GID or group name as found in the group database. Multiple entries are separated by new lines. See the cdmntsuppl(1M) command.

The maximum number of mappings allowed is defined in sys/cdrom.h.

nmconv=a
Sets the filename conversion mode for the ISO-9660/High-Sierra file and directory names recorded on the CDROM. The nmconv option lets you specify how the file and directory names are seen by the user on the host system. Non-ISO-9660 and non-High-Sierra names are not converted.

a is some combination of the following:

c
Names are not converted; the names used are the ones recorded on the CDROM.

l
Converts upper case letters to lower case.

m
Suppresses the version number and the separator (;). See the cdmntsuppl(1M) page for more information.

dsearch=b
Defines how the directory's search permissions (the execute bit) are to be determined. b is one of the following:

x
Search permission is granted only if the user has execute permissions (as recorded on the CDROM or using the dperm option above). See the cdmntsuppl(1M) command for more information.

s
Search permission is granted only if the user has read or execute permissions (as recorded on the CDROM or using the dperm option above). See the cdmntsuppl(1M) command for more information.

devmap=filename
Maps the CDROM major and minor numbers assigned to device nodes to valid host system major and minor numbers. The value for filename is a file that contains one entry for each device file in the form:
   device_file_path  new_major  new_minor 
Fields are separated by white space (tabs or spaces) and entries are separated by a new line. Anything beyond the third field in a line is treated as a comment. See the cddevsuppl(1M) command for more information.

Exit codes

The mount command exits with one of the following values:

0
Successful completion.

1
The mount point or device file specified does not exist.

1
Device does not contain a CDROM filesystem.

1
Access is denied.

2
Only a privileged user can change any settings.

3
Too many user, group, or file mappings. The sys/cdrom.h header file defines the maximum number of mappings allowed. (See the devmap, gidmap, and uidmap options.)

4
Parameter error.

4
Bad format in filename (used when setting/resetting the UID, GID and major/minor numbers).

5
The filename specified with the devmap option is not a device file.

Examples

For example, the command line:

mount -F cdfs -r -o nosuid,dperm=544,nmconv=l

mounts cdfs read-only (required), disallows setuid, sets the default directory permissions to 544 (read/execute for owner, read for group and others), and converts upper case filenames to lower case.

References

cddevsuppl(1M), cd_idmap(3X), cdmntsuppl(1M) cd_nmconv(3X) cd_setdevmap(3X), chmod(1), generic mount(1M)

The X/Open CD-ROM Support Component Preliminary Specification.

Notices

Only a privileged user can mount filesystems.
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.