CDMNTSUPPL(8) BSD CDMNTSUPPL(8)
NAME
cdmntsuppl - set and get administrative CDROM features
SYNTAX
cdmntsuppl [-u owner] [-g group] [-F mode] [-D mode]
[-U umfile] [-G gmfile] [-c] [-l] [-m] [-x] [-s]
mount-point
DESCRIPTION
This command sets up administrative CDROM features such as default
ownership and access permissions, mapping of user and group
identifications, conversion of file names, and setting of execute
permissions for directories. Each combination of options may be used,
including no option at all. If cdmntsuppl is executed without any option,
it lists the current settings.
OPTIONS
The options -u, -g, -F and -D may be used to set the default owner, group
and/or default access permissions to be associated with those files and
directories in a CDROM file system that do have a restricted final XAR,
or no final XAR. This is useful in situations where files are supplied
with a restricted final XAR, or no final XAR, but access that's specific
to one user or group (other than the default at mount time) is required,
or where the default access permissions (being read and execute
permission for user, group and others) for files and directories are
inappropriate.
-u owner The operand owner may be either a decimal
user ID or a user name found in a User Database.
-u group The operand group may be either a decimal
group ID or a group name found in a Group Database.
-F mode This option is used to set the default permissions
for files. The permissions are changed according to
mode, which may be absolute or specific. An
absolute mode is a four-octal-digit number constructed
from the logical-or (sum) of the following modes:
0400 read by owner
0100 execute by owner
0040 read by group
0010 execute by group
0004 read by others
0001 execute by others
A symbolic mode has the form:
[who] op [permission]
The who part is a combination of the letters
u (user), g (group) and o (other).
The letter a stands for u, g, or o,
which is the default if who is omitted.
The argument op can be +, to add permission
to the file's mode, -, to take away permission,
or =, to assign permission absolutely (all other
bits will be reset).
The argument permission is any combination of the
letters r (read) and x (execute); u,
g, or o indicate that permission is to
be taken from the current mode. Omitting permission is
only useful with = to take away all permissions.
-D mode This option is used to set the default permissions
for directories in the same fashion as for the option -F.
Execute permission will be interpreted as search permission.
The options -U and -G may be used when a CDROM file system
has been supplied with undesirable User/Group IDs associated with files
and directories. These undesirable IDs may be transformed to more
appropriate numbers. Files and directories with default IDs are not
subject to this mapping (see options -u and -g above). Since an
owner and group identification of zero (in case of a restricted final
Xar) indicates that there is no owner and group specified, the default
IDs are applied and therefore a mapping of the ID zero is not
possible.
-U umfile,
-G gmfile These options need a file (umfile/gmfile) as operand,
which must contain pairs. Each pair must be provided
using the following syntax: value as on CDROM,
colon, numeric ID or User/Group name as found in
User/Group databases. Pairs must be separated by a
newline character. The maximum number of mappings is
defined in the header file <sys/cdrom.h>.
The -c, -l and -m options establish/de-establish a specific name
conversion of File/Directory Identifiers on a CDROM. Name conversion
is a desirable feature to represent File/Directory Identifiers in a way
that is in accordance to common practice in X/OPEN compliant
systems. The options -l and -m may be used in conjunction with each other.
The option -c may not be used in conjunction with the options -l or -m.
-c This option causes names to be handled as recorded on
CDROM (i.e., no conversion takes place). This option is the
default after initialization.
-l Uppercase characters in Identifiers are converted to lowercase.
If the File Identifier contains no File Name Extension, the
SEPARATOR 1 (".") is not represented.
-m The Version Number and the SEPARATOR 2 (";") of a File
Identifier are not represented.
The -x and -s options determine the setting of the execute (search)
permission bits for those directories in the CDROM file hierarchy
that have a non-restricted final XAR.
-x The execute permission bits for directories within the
CDROM file hierarchy are set as provided in the Permissions
field of the XAR of that directory.
-s The execute permission bits for directories in the XSI file
hierarchy are set if the read and execute bits are set in
the XAR of that directory on the CDROM.
OPERANDS
The operand mount-point is the name of the mount-point of the CDROM file
system.
STDIN
Not used.
INPUT FILES
The input files are text files.
ENVIRONMENT VARIABLES
No environment variables affect the execution of cdmntsuppl. Note that
LC_CTYPE will not be used for filename conversion.
STDOUT
If no options are used the current settings are listed on standard
output. In the case of setting features the new setting is listed if the
command completed successfully.
STDERR
Used only for diagnostic messages.
OUTPUT FILES
None.
EXIT STATUS
The following exit values are returned:
0 successful completion.
1 mount-point not found, mount-point is not within
a CDROM file hierarchy, or access permission denied.
2 not user with appropriate permissions.
3 too many mappings.
4 parameter error or bad format in a mapping file (umfile/gmfile).
CONSEQUENCES OF ERRORS
None.
APPLICATION USAGE
Only a user with appropriate privileges may change administrative
privileges successfully. To read the current settings the user must have
read permission on the mount-point of that CDROM file system. In case of
setting CDROM features this command is intended to be used only directly
after the mounting of the CDROM before any access to the CDROM is done.
If the command is applied for setting features when files or directories
have already been opened the effect of this command on these files and
directories is undefined.
NOTES
The Domain implementation of the CD file system currently ignores
protections and Group and User IDs.