 |
Index for
Section 8 |
|
 |
Alphabetical
listing for C |
|
 |
Bottom of
page |
|
cdmntsuppl(8)
NAME
cdmntsuppl - 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
-c 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.
-D mode
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]
a Represents all users (user, group, other).
ugo 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.
r|x 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.
-F mode
Sets the default read and execute permissions for files. This option
takes the same mode and has the same restrictions as the -D option.
-G gmfile
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>.
-g group
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.
-l Converts uppercase characters to lowercase. If the File Identifier
contains no File Name Extension, SEPARATOR 1, a dot (.), is not
represented.
-m Causes the Version Number and SEPARATOR 2 of a File Identifier, a
semi-colon (;), not to be represented.
-s 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.
-U umfile
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.
-u owner
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.
-x 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
mount_point
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 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.
EXIT STATUS
The cdmntsuppl command returns the following exit values:
0 The command was successful.
1 The named mount_point was not found or was not within the CD-ROM
hierarchy, or access permission was denied.
2 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.
3 Too many mappings.
4 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)
|
Index for
Section 8 |
|
|
Alphabetical
listing for C |
|
 |
Top of
page |
|