FLAGS

Causes names to be handled as recorded on the
CD-ROM; that is, no conversion takes place.
This is the default behavior.
The -c flag undoes the conversions
performed by the -l and -m flags.
Sets the default read and search permissions for directories.
The permissions are changed according to mode, which may be
expressed (as with the chmod command) either
octally or symbolically.

Octal mode consists of a 4-digit octal number
constructed from the sum (logical-OR) of the following:

0400

read by owner

0100

execute by owner

0040

read by group

0010

execute by group

0004

read by others

0001

execute by others

Symbolic mode is expressed using the following syntax:

[a|ugo] {+|-|=} [r|x]
Represents all users (user, group, other).
Represents user, group, and other, respectively.
Omitting all of these
parameters is the same as specifying all of them.
Specifies adding, removing, or assigning permission
absolutely. Note that when you assign permission absolutely,
all other bits are reset.
Specifies the type of permission, either read or execute.
Note that omitting this option is useful only when using
the = option to remove all permissions.

The -D flag is used for files and directories that
have a restricted or no final XAR and therefore cannot be
used with the -G, -s, -U, or -x flags.
Sets the default read and execute permissions for files.
This flag takes the same mode and has the same
restrictions as the -D flag.
Changes the GID of a file or directory.
The entries in the file specified by the gmfile
argument must conform to the following syntax:

GID_on_CD-ROM:{New_GID|Group_Name}

If there is more than one mapping entry, each entry
must be separated by a newline. The total number of mapping
entries that gmfile can contain is defined in cdfs/xcdr.h,
an include file that is called into sys/cdrom.h.
Sets the group permissions of files
and directories.

The group parameter can be either a decimal GID
or a group name found in the Group Database.

The -g flag applies only to files and directories with
a restricted or no final XAR and therefore cannot be used with
the G, s, U, or x flags.
Converts uppercase characters to lowercase.
If the File Identifier contains no File Name Extension,
SEPARATOR 1, a dot (.), is not represented.
Causes the Version Number and SEPARATOR 2 of a File Identifier,
a semi-colon (;), not to be represented.
Sets each execute (search) permission bit for a directory in the XSI file
hierarchy to the inclusive OR of the corresponding read and
execute (search) bits in the XAR of that directory on the CD-ROM.

The -s flag cannot be specified with the -D,
-F, -g, -u, or -x flag.
Changes the UID of a file or directory.
The mapping entries in the file specified by the
umfile argument must conform to the following syntax:

UID_on_CD-ROM:{New_UID|User_Name}

If there is more than one mapping entry, each entry
must be separated by a newline. The total number of entries that
umfile can contain is defined in cdfs/xcdr.h,
an include file that is called into sys/cdrom.h.

Because the -U flag applies only to files and directories with
an unrestricted XAR, this flag cannot be used with the -D, -F,
-g, or -u flag.
Sets the owner of files and directories.

The owner parameter can be either a decimal UID
or a login name found in the User Database.

Because the -u flag applies only to files and directories
with a restricted or no final XAR, this flag cannot be used with
the -G, -s, -U, or -x flag.
Sets execute (search) permission bits for directories within the
CD-ROM file system hierarchy
as provided in the Permissions field in the XAR of that
directory.

The -x flag cannot be used with the -D, -F,
-g, -s, or -u flag.

PARAMETERS

Specifies the mount point of the CD-ROM file system being accessed.

DESCRIPTION

The cdmntsuppl command sets up administrative CD-ROM features,
such as default ownership and access permissions, mapping of user and
group identifications, conversions of file names,
and the setting of execute permissions for directories.

Setting CD-ROM features is restricted to users with
the appropriate privileges.
Note that you must be superuser to change administrative features;
to read the current settings, you must have read permission on the
mount point of the selected CD-ROM file system.
This command is intended to be used to set CD-ROM features
directly after the CD-ROM is
mounted and before its files and directories are accessed.
Attempting to use this function to set CD-ROM features
after files or directories on the CD-ROM have been accessed
may produce unpredictable results.

Executing the command with no flags lists the current settings on the
mounted CD-ROM.

When the command includes flags to set features,
the new setting is echoed to the screen if the
command completes successfully.
The command's flags are designed to be used in specific combinations,
as described in the following list:
The -l and -m flags perform name conversions of File and
Directory Identifiers on a CD-ROM, which can be undone with the
-c flag.
Note that whereas the -l and -m flags can be used
together, the -c must be used only by itself,
since it undoes the conversions the other two perform.
The -u, -g, -F, and -D
flags set the default owner, group, and access permissions for the
files and directories that have a restricted
final Extended Attribute Record (XAR) or no final XAR.
The -U and -G flags are used to change user and group
ownership on a CD-ROM file system with an unrestricted XAR.
Note that the ISO 9660 standard does not permit a
UID or GID of zero to appear in an unrestricted XAR.
Placing a zero value in a UID or GID of an unrestricted XAR
may result in unpredictable behavior.
The -x and -s flags, which are mutually
exclusive, set the execute (search) permissions
for those directories in the CD-ROM file system hierarchy
that have a unrestricted final XAR.

EXIT VALUES

The cdmntsuppl command returns the following exit values:
The command was successful.
The named mount_point was not found or was not within the
CD-ROM hierarchy, or access permission was denied.
The mount() system call that was executed by the command
returned an error.
One cause of this error is that the user
did not have the appropriate privileges
to perform the mount operation.
Too many mappings.
Parameter error or bad format in the mapping file
(file specified by the umfile or gmfile parameters).