getpeername(2)                                           getpeername(2)

  getpeername()

  NAME

    getpeername() - get name of connected peer

  SYNOPSIS

    #include 

    int getpeername (int s, struct sockaddr *name, int *namelen)

  DESCRIPTION

    The getpeername(2) function returns the name of the peer connected to
    socket s. The namelen parameter should be initialized to indicate the
    amount of space pointed to by name. On return it contains the actual size
    of the name returned (in bytes). The name is truncated if the buffer
    provided is too small.

  RETURN VALUES

    If the call succeeds, it returns 0.

    If the call fails, it returns -1 and sets errno to indicate the error.

  ERRORS

    The call succeeds unless:

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

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

    [ENOTCONN]
        The socket is not connected.

    [ENOBUFS]
        Insufficient resources were available in the system to perform the
        operation.

    [EFAULT]
        The name parameter points to memory not in a valid part of the process
        address space.

  SEE ALSO

    accept(2)

    bind(2)

    socket(2)

    getsockname(2)

  USAGE NOTES

    The getpeername function is thread safe.

    The getpeername function is async-signal safe.