seteuid(2)                       DG/UX 5.4.2                      seteuid(2)


NAME
       seteuid - set the effective user id of the current process

SYNOPSIS
       #include <sys/types.h>
       pidt seteuid(gidt euid);

   where:
       euid   An effective user identifier

DESCRIPTION
       If the effective-user-id of the calling process is superuser,
       effective-user-id is set to euid.

       If the effective-user-id of the calling process is not superuser, but
       its real-user-id or its effective-user-id or its saved-user-id is
       equal to euid, the effective-user-id is set to euid.

ACCESS CONTROL
       See the description above.

RETURN VALUE
       Upon successful completion, the function seteuid returns zero.
       Otherwise, it returns -1 and sets errno to indicate an error.

DIAGNOSTICS
       Under the following conditions, the function seteuid fails and sets
       errno to:

       EPERM     An attempt was made to set the effective-user-id to a value
                 not permitted by the access control restrictions described
                 above.

       EINVAL    The supplied value of euid was negative or greater than the
                 maximum allowable user id.

SEE ALSO
       getuid(2), geteuid(2), getgid(2), setuid(2), setgid(2),  setregid(2),
       setreuid(2).


















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