TCPIP$UCP_HELP.HLB  —  CREATE  CONTAINER
    Creates a UNIX file system with:

    o  An empty OpenVMS style root directory

    o  An empty local directory that corresponds to the UNIX root
       directory

    o  A container file in the OpenVMS style root directory

    Applies to: NFS server

    Format

      CREATE CONTAINER  device:directory

                        [ /HOST=host ]

                        [ /[NO]LOG ]

                        [ /OWNER=[uic] ]

                        [ /ROOT_MODE=n ]

                        [ /SIZE=option=value ]

                        [ /UID=n ]

                        [ /USER_NAME=vms_user_name ]

1  –  Restrictions

    Requires:

    o  Read and write access to the specified device and directory.

    o  SYSPRV or BYPASS privilege.

2  –  Parameters

 device:directory

 CONTAINER command)
    Required.

    Device and directory of the UNIX container.

3  –  Qualifiers

3.1    /HOST

       /HOST=host

    Required. Default: None.

    If the proxy database has multiple entries with the same user
    name and UID, the NFS server selects the entry specified with
    this qualifier.

3.2    /LOG

       /LOG
       /NOLOG

    Optional. Default: Displays host, UID, GID, and user name.

    Displays a full description of the specified proxy database
    record for you to determine ownership (see /USER_NAME).

3.3    /OWNER

       /OWNER=[uic]

    Optional. Default: UIC in the selected proxy record.

    OpenVMS ownership of the container file directory and container
    file.

    (The other files in this directory are owned by the OpenVMS users
    whose proxy database entries correspond to the UNIX owner UIDs of
    the individual files.)

3.4    /ROOT_MODE

       /ROOT_MODE=n

    Optional. Default: 755 (provides the following protection for
    owner, group, and world rwx-rx-rx).

    UNIX protection of the default container files: root directory,
    bit map, and superblock.

    Specify octal values in the following order: for user, for group,
    for others. The values are:

    o  0 - No access

    o  1 - Execute access

    o  2 - Write access

    o  3 - Write and execute access

    o  4 - Read access

    o  5 - Read and execute access

    o  6 - Read and write access

    o  7 - Read, write, and execute access

    For example, /ROOT_MODE=751 provides:

    User      Read, write, and     7     rwx
              execute access
    Group     Read and execute     5     rx
              access
    Other     Execute access       1     x

3.5    /SIZE

       /SIZE=option=value

    Optional. Default: /SIZE=(INITIAL=8917,EXTEND=160,MAXIMUM=0).

    Specifies the following file size attributes:

    o  INITIAL

       Specifies the initial size, in OpenVMS blocks, of the
       container. Maximum value: 8917.

    o  EXTEND

       When an extension is necessary, specifies the number of blocks
       by which the container is extended. Maximum value: 8192.

                                      NOTE

          Using large values might impact system performance and
          disk usage. In most cases, the default is sufficient.

    o  MAXIMUM

       Specifies the maximum size of the container.

       If the value is zero, the size of the container file can
       increase without limits.

3.6    /UID

       /UID=n

    Optional. Default: UID in the selected proxy record.

    Specifies the owner of the UNIX container root directory.

3.7    /USER_NAME

       /USER_NAME=vms_user_name

    Required.

    Specifies the user name of the owner of the container file
    system. The user name must be in the proxy database. The
    specified user becomes the owner of the internal root directory
    of the container.

4  –  Examples

    1.TCPIP> CREATE CONTAINER DUCK$4:[DUCKLING] /HOST=MALLARD -
      _TCPIP> /OWNER=[300,12] /ROOT_MODE=755 /UID=7015 -
      _TCPIP> /USER_NAME=G_JONES

      Creates container directory DUCK$4:[DUCKLING]. The local
      OpenVMS owner is [300,12]. Remote users see the root directory
      as owned by UID 7015. The root directory is writable only by
      UID 7015; it is readable and executable by all others. Before
      you execute this command, user G_JONES should have both an
      OpenVMS account with UIC [300,12] and an incoming proxy record
      specifying UID 7015 on host MALLARD.
Close Help