getpeername(3N)                                      getpeername(3N)


       NAME
             getpeername - get name of connected peer

       SYNOPSIS
             cc [options] file -lsocket -lnsl
             #include <sys/types.h>
             #include <sys/socket.h>
             int getpeername(int s, struct sockaddr *name, size_t *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.

          Files
             /usr/lib/locale/locale/LC_MESSAGES/uxns1

          Return Values
             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.

       REFERENCES
             accept(3N), bind(3N), getsockname(3N), socket(3N)

       NOTICES
             The type of address structure passed to accept depends on the
             address family.  UNIX domain sockets (address family AF_UNIX)
             require a sockaddr_un structure as defined in sys/un.h;
             Internet domain sockets (address family AF_INET) require a


                           Copyright 1994 Novell, Inc.               Page 1

      getpeername(3N)                                      getpeername(3N)


            sockaddr_in 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 caddr_t in the call to
            getpeername and pass the size of the structure in the namelen
            argument.










































                          Copyright 1994 Novell, Inc.               Page 2