unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



cdmntsuppl(8)							cdmntsuppl(8)



NAME

  cdmntsuppl - Sets and	gets administrative CD-ROM features

SYNOPSIS

  To get current settings for features on the mounted CD-ROM:

  /usr/sbin/cdmntsuppl mount_point

  To set features for files and	directories that have a	restricted final
  Extended Attribute Record (XAR) or no	final XAR:

  /usr/sbin/cdmntsuppl [-u owner] [-g group] [-F mode] [-D mode] [-c  |	[-l]
  [-m]]	mount_point

  To set features for files and	directories that have an unrestricted XAR:

  /usr/sbin/cdmntsuppl [-U umfile] [-G gmfile] [-c  | [-l] [-m]] [-x  |	-s]
  mount_point

OPTIONS

  -c  Causes names to be handled as recorded on	the CD-ROM; that is, no
      conversion takes place. This is the default behavior. The	-c option
      undoes the conversions performed by the -l and -m	options.

  -D mode
      Sets the default read and	search permissions for directories.  The per-
      missions are changed according to	mode, which may	be expressed (as with
      the chmod	command) either	octally	or symbolically.

      Octal mode consists of a 4-digit octal number constructed	from the sum
      (logical-OR) of the following:


      0400   read by owner
      0100   execute by	owner
      0040   read by group
      0010   execute by	group
      0004   read by others
      0001   execute by	others

      Symbolic mode is expressed using the following syntax:

      [a | ugo]	{ + | -	| = } [r | x]



      a	      Represents all users (user, group, other).

      ugo     Represents user, group, and other, respectively. Omitting	all
	      of these parameters is the same as specifying all	of them.

      +|-|=   Specifies	adding,	removing, or assigning permission absolutely.
	      Note that	when you assign	permission absolutely, all other bits
	      are reset.

      r|x     Specifies	the type of permission,	either read or execute.	 Note
	      that omitting this option	is useful only when using the =
	      option to	remove all permissions.

      The -D option is used for	files and directories that have	a restricted
      or no final XAR and therefore cannot be used with	the -G,	-s, -U,	or -x
      options.

  -F mode
      Sets the default read and	execute	permissions for	files. This option
      takes the	same mode and has the same restrictions	as the -D option.

  -G gmfile
      Changes the GID of a file	or directory. The entries in the file speci-
      fied by the gmfile argument must conform to the following	syntax:

      GID_on_CD-ROM:{New_GID|Group_Name}

      If there is more than one	mapping	entry, each entry must be separated
      by a newline.  The total number of mapping entries that gmfile can con-
      tain is defined in <&lt;cdfs/xcdr.h>&gt;,	an include file	that is	called into
      <&lt;sys/cdrom.h>&gt;.

  -g group
      Sets the group permissions of files and directories.

      The group	parameter can be either	a decimal GID or a group name found
      in the Group Database.

      The -g option applies only to files and directories with a restricted
      or no final XAR and therefore cannot be used with	the G, s, U, or	x
      options.

  -l  Converts uppercase characters to lowercase. If the File Identifier con-
      tains no File Name Extension, SEPARATOR 1, a dot (.), is not
      represented.

  -m  Causes the Version Number	and SEPARATOR 2	of a File Identifier, a
      semi-colon (;), not to be	represented.

  -s  Sets each	execute	(search) permission bit	for a directory	in the XSI
      file hierarchy to	the inclusive OR of the	corresponding read and exe-
      cute (search) bits in the	XAR of that directory on the CD-ROM.

      The -s option cannot be specified	with the -D, -F, -g, -u, or -x
      option.

  -U umfile
      Changes the UID of a file	or directory. The mapping entries in the file
      specified	by the umfile argument must conform to the following syntax:

      UID_on_CD-ROM:{New_UID|User_Name}

      If there is more than one	mapping	entry, each entry must be separated
      by a newline.  The total number of entries that umfile can contain is
      defined in <&lt;cdfs/xcdr.h>&gt;,	an include file	that is	called into
      <&lt;sys/cdrom.h>&gt;.

      Because the -U option applies only to files and directories with an
      unrestricted XAR,	this option cannot be used with	the -D,	-F, -g,	or -u
      option.

  -u owner
      Sets the owner of	files and directories.

      The owner	parameter can be either	a decimal UID or a login name found
      in the User Database.

      Because the -u option applies only to files and directories with a res-
      tricted or no final XAR, this option cannot be used with the -G, -s,
      -U, or -x	option.

  -x  Sets execute (search) permission bits for	directories within the CD-ROM
      file system hierarchy as provided	in the Permissions field in the	XAR
      of that directory.

      The -x option cannot be used with	the -D,	-F, -g,	-s, or -u option.

OPERANDS

  mount_point
      Specifies	the mount point	of the CD-ROM file system being	accessed.

DESCRIPTION

  The cdmntsuppl command sets up administrative	CD-ROM features, such as
  default ownership and	access permissions, mapping of user and	group iden-
  tifications, conversions of file names, and the setting of execute permis-
  sions	for directories.

  Setting CD-ROM features is restricted	to users with the appropriate
  privileges. Note that	you must be superuser to change	administrative
  features; to read the	current	settings, you must have	read permission	on
  the mount point of the selected CD-ROM file system. This command is
  intended to be used to set CD-ROM features directly after the	CD-ROM is
  mounted and before its files and directories are accessed. Attempting	to
  use this function to set CD-ROM features after files or directories on the
  CD-ROM have been accessed may	produce	unpredictable results.

  Executing the	command	with no	options	lists the current settings on the
  mounted CD-ROM.

  When the command includes options to set features, the new setting is
  echoed to the	screen if the command completes	successfully. The command's
  options are designed to be used in specific combinations, as described in
  the following	list:

    +  The -l and -m options perform name conversions of File and Directory
       Identifiers on a	CD-ROM,	which can be undone with the -c	option.	Note
       that whereas the	-l and -m options can be used together,	the -c must
       be used only by itself, since it	undoes the conversions the other two
       perform.

    +  The -u, -g, -F, and -D options set the default owner, group, and
       access permissions for the files	and directories	that have a res-
       tricted final Extended Attribute	Record (XAR) or	no final XAR.

    +  The -U and -G options are used to change	user and group ownership on a
       CD-ROM file system with an unrestricted XAR. Note that the ISO 9660
       standard	does not permit	a UID or GID of	zero to	appear in an unres-
       tricted XAR. Placing a zero value in a UID or GID of an unrestricted
       XAR may result in unpredictable behavior.

    +  The -x and -s options, which are	mutually exclusive, set	the execute
       (search)	permissions for	those directories in the CD-ROM	file system
       hierarchy that have a unrestricted final	XAR.


EXIT STATUS

  The cdmntsuppl command returns the following exit values:

  0   The command was successful.

  1   The named	mount_point was	not found or was not within the	CD-ROM
      hierarchy, or access permission was denied.

  2   The mount() system call that was executed	by the command returned	an
      error. One cause of this error is	that the user did not have the
      appropriate privileges to	perform	the mount operation.

  3   Too many mappings.

  4   Parameter	error or bad format in the mapping file	(file specified	by
      the umfile or gmfile parameters).

SEE ALSO

  Functions: mount(2), cd_defs(3), cd_idmap(3),	cd_nmconv(3)