cdmntsuppl man page on Tru64

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
Tru64 logo
[printable version]

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
       Causes names to be handled as recorded on the CD-ROM; that is, no  con‐
       version takes place. This is the default behavior. The -c option undoes
       the conversions performed by the -l and -m options.  Sets  the  default
       read  and  search  permissions  for  directories.   The permissions 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]

	      Represents  all  users  (user,  group, other).  Represents user,
	      group, and other, respectively. Omitting all of these parameters
	      is the same as specifying all of them.  Specifies adding, remov‐
	      ing, or assigning permission absolutely.	 Note  that  when  you
	      assign  permission absolutely, all other bits are reset.	Speci‐
	      fies 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.  Sets the default  read  and  execute
	      permissions  for	files. This option takes the same mode and has
	      the same restrictions as the -D option.  Changes the  GID	 of  a
	      file  or	directory.  The	 entries  in the file specified 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 sep‐
	      arated by a newline.  The total number of mapping	 entries  that
	      gmfile  can contain is defined in <cdfs/xcdr.h>, an include file
	      that is called into <sys/cdrom.h>.  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.  Converts uppercase characters to	lower‐
	      case.  If	 the  File Identifier contains no File Name Extension,
	      SEPARATOR 1, a dot (.), is not represented.  Causes the  Version
	      Number  and  SEPARATOR 2 of a File Identifier, a semi-colon (;),
	      not to be represented.  Sets each	 execute  (search)  permission
	      bit  for	a directory in the XSI file hierarchy to the inclusive
	      OR of the corresponding read and execute (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.  Changes the UID of a file  or  directory.  The  mapping
	      entries  in  the file specified by the umfile argument must con‐
	      form to the following syntax: UID_on_CD-ROM:{New_UID|User_Name}

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

	      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.	 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	 restricted  or	 no final XAR, this option cannot be used with
	      the -G, -s, -U, or -x option.  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
       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
       identifications,	 conversions of file names, and the setting of execute
       permissions 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 com‐
       mand'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  restricted  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 unrestricted 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) per‐
       missions 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: The command
       was successful.	The named mount_point was not found or was not	within
       the  CD-ROM  hierarchy,	or  access permission was denied.  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 priv‐
       ileges to perform the mount operation.  Too many	 mappings.   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)

								 cdmntsuppl(8)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Tru64

List of man pages available for Tru64

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