MirBSD manpage: getpeereid(2)

GETPEEREID(2)              BSD Programmer's Manual               GETPEEREID(2)

NAME

     getpeereid - get effective user and group identification of locally-
     connected peer

SYNOPSIS

     #include <sys/types.h>
     #include <sys/socket.h>

     int
     getpeereid(int s, uid_t *euid, gid_t *egid);

DESCRIPTION

     getpeereid() returns the effective user ID and group ID of the peer con-
     nected to a UNIX domain socket (see unix(4)). The argument s must be of
     type SOCK_STREAM.

     One common use is for UNIX domain servers to determine the credentials of
     clients that have connected to it.

     getpeereid() takes three parameters:

     •   s contains the file descriptor of the socket whose peer credentials
         should be looked up.

     •   euid points to a uid_t variable into which the effective user ID for
         the connected peer will be stored.

     •   egid points to a gid_t variable into which the effective group ID for
         the connected peer will be stored.

RETURN VALUES

     If the call succeeds, a 0 is returned and euid and egid are set to the
     effective user ID and group ID of the connected peer. Otherwise, errno is
     set and a value of -1 is returned.

ERRORS

     On failure, errno is set to one of the following:

     [EBADF]       The argument s is not a valid descriptor.

     [ENOTSOCK]    The argument s is a file, not a socket.

     [EOPNOTSUPP]  The socket is not in the UNIX domain.

     [ENOTCONN]    The socket is not connected.

     [ENOBUFS]     Insufficient resources were available in the system to per-
                   form the operation.

     [EFAULT]      The euid or egid parameters point to memory not in a valid
                   part of the process address space.

SEE ALSO

     accept(2), bind(2), getpeername(2), getsockname(2), socket(2), unix(4)

HISTORY

     The getpeereid() function call appeared in OpenBSD 3.0.

MirBSD #10-current              June 26, 2001                                1