cdmntsuppl(8)cdmntsuppl(8)NAMEcdmntsuppl - Sets and gets administrative CD-ROM features
SYNOPSIS
To get current settings for features on the mounted CD-ROM:
/usr/sbin/cdmntsuppl mount_point
To set features for files and directories that have a restricted final
Extended Attribute Record (XAR) or no final XAR: /usr/sbin/cdmntsuppl
[-u owner] [-g group] [-F mode] [-D mode] [-c | [-l] [-m]] mount_point
To set features for files and directories that have an unrestricted
XAR: /usr/sbin/cdmntsuppl [-U umfile] [-G gmfile] [-c | [-l] [-m]] [-x
| -s] mount_point
OPTIONS
Causes names to be handled as recorded on the CD-ROM; that is, no con‐
version takes place. This is the default behavior. The -c option undoes
the conversions performed by the -l and -m options. 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, remov‐
ing, or assigning permission absolutely. Note that when you
assign permission absolutely, all other bits are reset. Speci‐
fies 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 option 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 options. Sets the default read and execute
permissions for files. This option takes the same mode and has
the same restrictions as the -D option. 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 sep‐
arated 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 option 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 options. Converts uppercase characters to lower‐
case. 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 option cannot be specified with the -D, -F, -g, -u, or -x
option. Changes the UID of a file or directory. The mapping
entries in the file specified by the umfile argument must con‐
form to the following syntax: UID_on_CD-ROM:{New_UID|User_Name}
If there is more than one mapping entry, each entry must be sep‐
arated 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 option applies only to files and directories with
an unrestricted XAR, this option cannot be used with the -D, -F,
-g, or -u option. 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 option applies only to files and directories with
a restricted or no final XAR, this option cannot be used with
the -G, -s, -U, or -x option. 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 option cannot be used with the -D, -F, -g, -s, or -u
option.
OPERANDS
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 options lists the current settings on the
mounted CD-ROM.
When the command includes options to set features, the new setting is
echoed to the screen if the command completes successfully. The com‐
mand's options are designed to be used in specific combinations, as
described in the following list: The -l and -m options perform name
conversions of File and Directory Identifiers on a CD-ROM, which can be
undone with the -c option. Note that whereas the -l and -m options 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 options
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 options 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 options, which are mutually exclusive, set the execute (search) per‐
missions for those directories in the CD-ROM file system hierarchy that
have a unrestricted final XAR.
EXIT STATUS
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 priv‐
ileges 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).
SEE ALSO
Functions: mount(2), cd_defs(3), cd_idmap(3), cd_nmconv(3)cdmntsuppl(8)