/sys$common/syshlp/helplib.hlb DCE_SECURITY, Admin Intro, rgy_edit, pgo_commands, adopt  *Conan The Librarian (sorry for the slow response - running on an old VAX)

   adopt uuid principal_name [-u unix_number] [ -f fullname] [-q quota]
   adopt uuid group_name [-f fullname] [-nl]
   adopt uuid organization_name [-f fullname]

   Creates a principal, group, or organization for the specified UUID.

   The principal, group, or organization is created to adopt an orphan
   object.  Orphans are registry objects that cannot be accessed
   because 1) they are owned by UUIDs that are not associated with a
   principal or group and 2) no other principal, group, or organization
   has access rights to the orphaned object.  UUIDs are associated with
   all registry objects when the object is created.  When the registry
   object is deleted, the association between the object and the UUID
   is also deleted.

   The principal_name, group_name, or organization_name you specify
   must be unique in the registry as it must be when you create a
   principal, group, or organization using the add subcommand.  Except
   for the manner in which it is created, the principal, group, or
   organization created by the adopt subcommand is no different from
   any other principal, group, or organization.  The uuid option
   specifies the UUID number to be assigned to the principal, group, or
   organization. The UUID supplied must be the one that owns the
   orphaned object. Specify the uuid in RPC print string format as 8
   hexadecimal digits, a hyphen; 4 hexadecimal digits, a hyphen; 4
   hexadecimal digits, a hyphen; 4 hexadecimal digits, a hyphen; and 12
   hexadecimal digits.  The format follows:

               nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn

   For cell principals only, the -u option specifies the UNIX number to
   be associated with the cell name.  If you do not enter this option,
   the next sequential UNIX number is supplied as a default. For all
   principals other than cells, the UNIX number is extracted from
   information embedded in the principal's UUID and cannot be specified
   here.

   For principals, the -q option specifies the principal's object
   creation quota.  If you do not enter the option, the object creation
   quota is set to "unlimited."

   For groups, the -nl option turns off the project list inclusion
   property so that groups are not included in project lists.  If you
   do not enter this option, the group is included in project lists.

   For principals, groups, and organizations, the -f option supplies
   the object's fullname.  If you do not enter the -f option, fullname
   defaults to blank.

   An error occurs if you specify a name or UNIX number that is already
   defined within the same domain of the database.

   Note that in the current implementation of the DCE, UNIX numbers are
   embedded in UUID numbers. If you try to create a group or
   organization to adopt an orphaned object and fail, it could be
   because the embedded UNIX number is invalid because it does not fall
   within the range of valid UNIX numbers set for the cell as a registry
   property.  If this is the case, you must reset the range of valid UNIX
   numbers to include the UNIX number embedded in the UUID and then try
   again to adopt the object.