getpeername(3N)                  UNIX System V                  getpeername(3N)


NAME
      getpeername - get name of connected peer

SYNOPSIS
      int getpeername(int s, caddrt name, int *namelen);

DESCRIPTION
      getpeername returns the name of the peer connected to socket s.  The int
      pointed to by 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 VALUE
      0 is returned if the call succeeds, -1 if it fails.

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.

      ENOMEM              There was insufficient user memory for the operation
                          to complete.

      ENOSR               There were insufficient STREAMS resources available
                          for the operation to complete.

SEE ALSO
      accept(3N), bind(3N), getsockname(3N), socket(3N).

NOTES
      The type of address structure passed to accept depends on the address
      family.  UNIX domain sockets (address family AFUNIX) require a
      socketaddrun structure as defined in sys/un.h; Internet domain sockets
      (address family AFINET) require a sockaddrin structure as defined in
      netinet/in.h.  Other address families may require other structures.  Use
      the structure appropriate to the address family; cast the structure
      address to a generic caddrt in the call to getpeername and pass the size
      of the structure in the namelen argument.

      See ``The Sockets Interface'' section in the Programmer's Guide:
      Networking Interfaces for details.








10/89                                                                    Page 1