GETSOCKNAME(2)      RISC/os Reference Manual       GETSOCKNAME(2)



NAME
     getsockname - get socket name

SYNOPSIS
     For -systype sysv and -systype bsd43:

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

     getsockname(s, name, namelen)
     int s;
     struct sockaddr *name;
     int *namelen;

DESCRIPTION
     getsockname returns the current name for the specified
     socket.  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).

DIAGNOSTICS
     A 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.

     [ENOBUFS]  Insufficient resources were available in the sys-
                tem to perform the operation.

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

SEE ALSO
     bind(2), socket(2).

BUGS
     Names bound to sockets in the UNIX domain are inaccessible;
     getsockname returns a zero length name.

NOTE
     When these routines are used in a program which is compiled
     in -systype sysv, they are not resolved by libc.a.  See
     intro(3-SysV) for more information.








                         Printed 1/15/91                   Page 1