cdmntsuppl - Sets and gets administrative CD-ROM features
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
Causes names to be handled as recorded on the CD-ROM; that
is, no conversion 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, 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 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 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 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 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 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 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 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.
Specifies the mount point of the CD-ROM file system being
accessed.
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 command'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) permissions for
those directories in the CD-ROM file system hierarchy that
have a unrestricted final XAR.
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).
Functions: mount(2), cd_defs(3), cd_idmap(3), cd_nmconv(3)
cdmntsuppl(8)
[ Back ] |
