NAME

cdmntsuppl - Set and get administrative CD-ROM features

SYNOPSIS

/usr/sbin/cdmntsuppl [-u owner] [-g group] [-F mode] [-D mode] [-U umfile]
[-G gmfile] [-c] [-l] [-m] [-x] [-s] mount_point

FLAGS

The -u, -g, -F, and -D options set the default owner, group and access permissions for the files and directories in a CD-ROM File System that have a restricted final Extended Attribute Record (XAR) or no final XAR. 

-u owner

Sets the owner of files and directories in a CD-ROM File System that have a restricted final Extended Attribute Record (XAR) or no final XAR. 

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

-g group

Sets the group permissions of files and directories in a CD-ROM File System that have a restricted final Extended Attribute Record (XAR) or no final XAR. 

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

-F mode

Sets the default read and execute permissions for files in a CD-ROM File System that have a restricted final Extended Attribute Record (XAR) or no final XAR.  The permissions are changed according to mode, which may be expressed−as with the chmod(1) command−either octally or symbolically. 

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

Symbolic mode is expressed using the following syntax: [a|ugo] {+|-|=} [r|x]

a

Represents all users (user, group, other). 

ugoRepresents user, group, and other, respectfully.  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|xSpecifies the type of permission, either read or execute.  Note that omitting this option is only useful when using the = option to remove all permissions. 

-D mode

Sets the default read and search permissions for directories in a CD-ROM File System that have a restricted final Extended Attribute Record (XAR) or no final XAR.  This option takes the same mode as the -F option. 

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. 

-U umfile

Changes the UID of a file or directory on a CD-ROM File System with an unrestricted XAR.  The umfile argument must conform to the following syntax: UID_on_CD-ROM:New_UID or User_Name

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

-G gmfile

Changes the GID of a file or directory on a CD-ROM File System with an unrestricted XAR.  The gmfile argument must conform to the following syntax: GID_on_CD-ROM:New_GID or Group_Name

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

The -l and -m options perform name conversions of File and Directory Identifiers on a CD-ROM, which can be undone by with the -c option.  Note that whereas the -l and -m options can be used together, the -c must only be used by itself, since it undoes the conversions the other two perform. 

-c

Causes names to be handled as recorded on the CD-ROM, that is, no conversion takes place.  This is the default.  This option undoes the conversions performed by the -l and -m 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. 

The -x and -s options set the execute (search) permissions for those directories in the CD-ROM File System hierarchy that have a unrestricted final XAR. 

-x

Sets execute (search) permissions bits for directories within the CD-ROM File System hierarchy as provided in the Permissions field in the XAR of that directory. 

-s

Each execute (search) permission bit for a directory in the XSI file hierarchy is set to the inclusive OR of the corresponding read and execute (search) bits in the XAR of that directory on the CD-ROM. 

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.  The options are designed to be used in specific combinations.  Executing the command with no options lists the current settings on the mounted CD-ROM.  When setting features, the new setting is echoed to the screen if the command completes successfully. 

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 only 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. 

EXIT VALUES

The following exit values are returned:

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 user does not have the appropriate privileges to execute the command. 

3

Too many mappings. 

4

Parameter error or bad format in the mapping file (found with the umfile and the gmfile options). 

RELATED INFORMATION

Functions: cd_defs(3), cd_idmap(3), cd_nmconv(3).