cddevsuppl(1M) cddevsuppl(1M)
NAME
cddevsuppl - set or get major and minor numbers of a CD-ROM
device file
SYNOPSIS
cddevsuppl [-m mapfile | -u unmapfile] [-c]
DESCRIPTION
cddevsuppl sets or gets the major and minor number of any or
all of the device files so the appropriate device on the host
system is accessed. The major and minor number of a device
file on a CD-ROM are assigned by the CD-ROM publisher during
manufacturing. These values may not match the major and minor
numbers assigned to the physical devices on the host system.
Only a privileged user can set the major/minor number
assignments of a device file.
Mappings should be established before affected device files
are used. Any device files that are in use and have their
mappings changed by the cddevsuppl utility will continue to
use the previous mappings until they are closed.
With no options cddevsuppl returns the current major/minor
number assignments of all of the device files on the mounted
CD-ROM.
Options
The following options are available:
-m mapfile
Sets the major and minor number for the device files,
as specified in mapfile. mapfile has one entry for
each device file to be set. CD_MAXDMAP specifies the
maximum number of device mappings that mapfile may
contain. Each field in mapfile is separated by white
space (tab, space), and each entry is separated by a
new line. Anything beyond the third field on a line is
considered to be a comment. The format for an entry in
mapfile is:
device_file_path new_major_number new_minor_number
-u unmapfile
Unsets the major and minor number assignment for the
device files specified in unmapfile. (The default
major/minor number assignments for the device file as
recorded on the CD-ROM are then used.) The unmapfile
Copyright 1994 Novell, Inc. Page 1
cddevsuppl(1M) cddevsuppl(1M)
file has one entry for each device file assignment.
Each entry is separated by a new line. Anything beyond
the first field on a line is considered to be a
comment.
The format for an entry in unmapfile is:
device_file_path
-c Causes cddevsuppl to continue processing file entries
even if an error occurs for an individual entry. The
default action is to stop processing. The -c option is
used with the -m mapfile or -u unmapfile options.
An error message for the specific device file is printed
to standard error.
Exit Codes
If the -m option successfully completes, the new major/minor
number settings are output to standard error.
If the -u option successfully completes, the major/minor
numbers for the device files recorded on the CD-ROM are
displayed.
cddevsuppl exits with one of the following values:
0 Successful completion
1 File is not found.
1 File is not a file or directory within a CD-ROM file
hierarchy.
1 Access is denied.
2 Not a user with appropriate privileges. The user must
have read/write permission for the device file to change
the major/minor settings of the device file and must have
read permission to see the settings.
3 Too many assignments
4 Parameter error.
Copyright 1994 Novell, Inc. Page 2
cddevsuppl(1M) cddevsuppl(1M)
4 Bad format in mapfile or unmapfile.
5 File is not a device file.
6 A device file listed in unmapfile (specified with the -u
option) was not previously set.
USAGE
The -m mapfile and -u unmapfile options are mutually
exclusive.
When the CD-ROM is unmounted, any new major and minor number
assignments are voided.
If the major and minor number settings of a device file are
reset, previous settings are overridden.
The maximum number of device files per CD-ROM that can be
reset is defined in the header file sys/cdrom.h.
REFERENCES
cdsuf(1M), cd_setdevmap(3X), cd_suf(3X), environ(5)
Rock Ridge Interchange Protocol from Rock Ridge Technical
Working Group
Copyright 1994 Novell, Inc. Page 3