cddevsuppl - Sets and gets the major and minor numbers of
a device file on a Rock Ridge format CD-ROM
/usr/sbin/cddevsuppl -m mapfile [-c]
/usr/sbin/cddevsuppl -u unmapfile [-c]
/usr/sbin/cddevsuppl [-c]
Directs cddevsuppl to continue processing the device file
mappings if an error is returned for a specific device
file mapping. An error message for that specific device
file will be printed to standard error. The default action
is to stop processing when an error has occurred. This
option is useful only when used in combination with the -m
mapfile or -u unmapfile options. Maps the major and minor
numbers for device files. The mappings are specified in
mapfile. This text file has one entry for each device file
mapping in the format: device_file_path new_major
new_minor
The device_file_path field is the full pathname of
the file on the CD-ROM, and the new_major and
new_minor fields are integers. The fields are separated
by white space. The entries are separated by
newlines. Anything beyond the third field is
ignored. The following is an example of mapfile:
/mnt/dev/ttys4 8 2050 /mnt/dev/zero 38 0
The maximum number of mappings for a Rock Ridge
compact disk is defined in the header file
<sys/cdrom.h>. If a device file is mapped again,
the previous device file mapping for the device
file is overridden. Unmaps the major and minor
numbers for device files. The mappings are specified
in unmapfile. This text file has one entry for
each device file mapping in the format:
device_file_path
The device_file_path field is the full pathname of
the file on the CD-ROM. The entries are separated
by newlines. Anything beyond the first field is
ignored. The following is an example of mapfile:
/mnt/dev/zero
The cddevsuppl command is used to map and unmap the major
and minor numbers of a device file on a mounted Rock Ridge
format CD-ROM. The -m mapfile option maps the major and
minor number of device files and displays the new setting,
if the mapping is successful. This option is used to add
new mappings or to change existing mappings, in case the
major and minor numbers of the device files are incorrect.
The -u unmapfile option removes the existing mappings for
files specified in unmapfile and displays the device file
and the major/minor numbers as recorded on the CD-ROM.
If no options are used, the cddevsuppl command displays
the existing device file mappings. If the mapping table is
empty, nothing is displayed. Note: The mapping table is
cleared after a mount or umount command.
If you want to open a device file on a CD-ROM, the dev
option must be specified in the mount command. See
mount(8) for more information.
Only the superuser can change administrative CD-ROM features
successfully. To read the current device file mappings,
the user must have read permission on the device
file.
Mappings should be established before affected device
files are used. If the command is applied for device file
mappings when device files have already been opened, the
effect of this command on these files is undefined.
Only existing devices files on the CD-ROM can be mapped.
These files are indicated by the mode: b (block special
file) or c (character special file). Use the ls -l command
to display the file modes..
If you access device files on a CD-ROM that are mapped to
inappropriate major and minor numbers, undefined results
can occur.
The device file mappings for a mounted CD-ROM are eliminated
when the CD-ROM is unmounted.
The cddevsuppl(8) command is not supported in a TruCluster
Server environment.
The following exit values are returned: Successful completion.
File not found, file is not a file or directory
within a CD-ROM file hierarchy, or access denied. Not
user with appropriate privileges. Too many mappings.
Parameter error or bad format in a mapping file. File is
not a device file. File not previously mapped.
The following example shows the output of the cddevsuppl
command when no CD-ROM is mounted and no files are mapped:
# cddevsuppl # The following example shows the output of
the cddevsuppl command after a CD-ROM file system has been
mounted: # /usr/sbin/mount -t cdfs -o noversion,rrip,dev
/dev/disk/cdrom0c /mnt # cddevsuppl # The following example
maps the major and minor numbers of files mounted in
the previous example and specified in mapfile. Note: If
you want, you can issue an ls -l command before and after
the cddevsuppl command to verify that the major and minor
numbers have changed. # cddevsuppl -m /tmp/mapfile
/mnt/dev/ttys4: (8,2050) /mnt/dev/zero: (38,0) The following
example unmaps the major and minor numbers of the file
specified in unmapfile file and shows the result of the
subsequent cddevsuppl command: # cddevsuppl -u /tmp/unmapfile
/mnt/dev/zero: (1,5) # cddevsuppl /mnt/dev/ttys4:
(8,2050) The following example unmounts the /mnt file system
and shows the output of the subsequent cddevsuppl command:
# umount /mnt # cddevsuppl #
Commands: mount(8)
Files: cdfs(4)
Functions: cd_setdevmap(3), cd_getdevmap(3)
cddevsuppl(8)
[ Back ] | 