Sets the process's effective user ID.

    This function is supported on OpenVMS Integrity servers and
    Alpha only.

    Format

      #include  <unistd.h>

      int seteuid  (uid_t euid);

1 - Argument

 euid

    The value to which you want the effective user ID set.

2 - Description

    If the process has the IMPERSONATE privilege, the seteuid
    function sets the process's effective user ID.

    An unprivileged process can set the effective user ID only if the
    euid argument is equal to either the real, effective, or saved
    user ID of the process.

    This function requires that long (32-bit) UID/GID support be
    enabled. See 32-Bit UID and GID Macro (Integrity servers, Alpha)
    for more information.

    See also getuid to know how UIC is represented.

3 - Return Values

    0                  Successful completion.
    -1                 Indicates an error. The function sets errno to
                       one of the following values:

                       o  EINVAL - The value of the euid argument is
                          invalid and not supported.

                       o  EPERM - The process does not have the
                          IMPERSONATE privilege, and euid does not
                          match the real user ID or the saved set-
                          user-ID.