VMS Help
System Services, $PERSONA CREATE (Alpha and Integrity servers)
*Conan The Librarian
|
On Alpha and Integrity server systems, creates a persona that can
be assumed using the $PERSONA_ASSUME service.
Format
SYS$PERSONA_CREATE persona ,[usrnam] ,[flags], [usrpro],
[itmlst]
C Prototype
int sys$persona_create (unsigned int *persona, void *usrnam,
unsigned int flags, unsigned int
*usrpro, unsigned int *itmlst);
persona
OpenVMS usage:persona
type: longword (unsigned)
access: write only
mechanism: by reference
Address of a longword into which the persona identification
handle is written.
usrnam
OpenVMS usage:char_string
type: character-coded text string
access: read only
mechanism: by descriptor-fixed-length descriptor
Name of the user to be impersonated. The usrnam argument is
the address of a descriptor pointing to a character string
containing the user name. The string can contain a maximum of
32 alphanumeric characters.
flags
OpenVMS usage:mask_longword
type: longword (unsigned)
access: read only
mechanism: by value
The $ISSDEF macro defines these codes:
o ISS$V_CREATE_AUTHPRIV - This bit is used to create a persona
with the privilege fields set to the authorized privileges of
the specified user.
o ISS$V_CREATE_DEFPRIV - This bit is used for backward
compatibility with the previous implementation of personae.
This bit is accepted but not processed, as it describes the
default behavior of the service.
o ISS$V_NOACCESS - Tells $PERSONA_CREATE not to access the
SYSUAF file. Only valid in exec or kernel mode.
usrpro
OpenVMS usage:char_string
type: opaque byte stream
access: read only
mechanism: by descriptor
Buffer containing an encoded security profile. The usrpro
argument is the address of a descriptor pointing to a buffer
that contains encoded security profile data. This profile can be
created by calling the SYS$CREATE_USER_PROFILE system service.
itmlst
OpenVMS usage:item_list_3
type: longword
access: read only
mechanism: by reference
Attributes describing modifications to the security profile. The
itmlst argument is the address of an item_list defining changes
to be made to the specified user profile.