cddevsuppl man page on DigitalUNIX

Printed from http://www.polarhome.com/service/man/?qf=cddevsuppl&af=0&tf=2&of=DigitalUNIX

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
       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.  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	 sepa‐
	      rated  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

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 dis‐
       plays 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	speci‐
       fied in unmapfile and displays the device file and the major/minor num‐
       bers 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 dis‐
       played. Note: The mapping table is cleared after a mount or umount com‐
       mand.

       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  success‐
       fully.	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  spe‐
       cial 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 envi‐
       ronment.

EXIT STATUS
       The following exit values are returned:	Successful  completion.	  File
       not found, file is not a file or directory within a CD-ROM file hierar‐
       chy, 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.

EXAMPLES
       The following example shows the output of the cddevsuppl	 command  when
       no  CD-ROM  is mounted and no files are mapped: # cddevsuppl # The fol‐
       lowing 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 previ‐
       ous 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: # cdde‐
       vsuppl	-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 #

SEE ALSO
       Commands: mount(8)

       Files: cdfs(4)

       Functions: cd_setdevmap(3), cd_getdevmap(3)

								 cddevsuppl(8)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net