dg_setauthid(2) — DG/UX R4.11MU05



dg_setauthid(2)          DG/UX B2 Security R4.12MU02         dg_setauthid(2)


NAME
       dgsetauthid - set the authentication ID of the calling process

SYNOPSIS
       #include <sys/dgtparms.h>

       int  dgsetauthid (authidt authid);

   where:
       authid  The value to which the calling process's authentication ID is
               to be set.

DESCRIPTION
       The dgsetauthid system call sets the authentication ID of the
       calling process to authid if and only if its current authentication
       ID is zero and the process has appropriate privilege.

       The value of authid must always be greater than zero and less than or
       equal to MAXUID.

ACCESS CONTROL
       The authentication ID of the calling process must be 0 and the
       process must have appropriate privilege.

RETURN VALUE
       0      Successful completion

       -1     An error occurred.  errno is set to indicate the error.

ERRORS
       Errno may be set to one of the following error codes:

       EPERM   The request violates the access control restrictions
               described above.

       EINVAL  The supplied value of authid was less than or equal to zero
               or greater than MAXUID.

SEE ALSO
       dggetauthid(2).


Licensed material--property of copyright holder(s)
Museum
