unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



cddevsuppl(8)							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	mes-
      sage 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 <&lt;sys/cdrom.h>&gt;.	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 map-
  pings	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 permis-
  sion 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 unde-
  fined.

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

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 out-
       put of the subsequent cddevsuppl	command:
	    # umount /mnt
	    # cddevsuppl
	    #



SEE ALSO

  Commands: mount(8)

  Files: cdfs(4)

  Functions: cd_setdevmap(3), cd_getdevmap(3)