Index Index for
Section 8
Index Alphabetical
listing for C
Bottom of page Bottom of
page		 

cddevsuppl(8)


NAME

  cddevsuppl - Sets and gets the major and minor numbers of a device file on
  a Rock Ridge format CD-ROM


SYNOPSIS

  /usr/sbin/cddevsuppl -m  mapfile [-c]

  /usr/sbin/cddevsuppl -u  unmapfile [-c]

  /usr/sbin/cddevsuppl [-c]


OPTIONS

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

  -m mapfile
      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.

  -u unmapfile
      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


DESCRIPTION

  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.


RESTRICTIONS

  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.


EXIT STATUS

  The following exit values are returned:

  0   Successful completion.

  1   File not found, file is not a file or directory within a CD-ROM file
      hierarchy, or access denied.

  2   Not user with appropriate privileges.

  3   Too many mappings.

  4   Parameter error or bad format in a mapping file.

  5   File is not a device file.

  6   File not previously mapped.


EXAMPLES

   1.  The following example shows the output of the cddevsuppl command when
       no CD-ROM is mounted and no files are mapped:
	    # cddevsuppl
	    #

   2.  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
	    #

   3.  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)

   4.  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)

   5.  The following example unmounts the /mnt file system and shows the
       output of the subsequent cddevsuppl command:
	    # umount /mnt
	    # cddevsuppl
	    #


SEE ALSO

  Commands: mount(8)

  Files: cdfs(4)

  Functions: cd_setdevmap(3), cd_getdevmap(3)

Index Index for
Section 8
Index Alphabetical
listing for C
Top of page Top of
page