getsockname(2)
_________________________________________________________________
getsockname System Call
Get socket name.
_________________________________________________________________
SYNTAX
#include <socket.h>
int getsockname (s, name, namelen)
int s;
struct sockaddr * name;
int * namelen;
PARAMETERS
s File descriptor of socket whose name is requested.
name Structure to receive the socket name.
namelen On input contains the number of bytes available
for the name; updated to indicate the number of
bytes returned.
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).
ACCESS CONTROL
None. (See domain specific information (unix_ipc(6) and
inet(3N)) for restrictions per domain .)
RETURN VALUE
0 Completed successfully.
-1 An error occurred. Errno is set to indicate the
error.
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
getsockname(2)
EXCEPTIONS
Errno may be set to one of the following error codes:
EBADF The argument <s> is not an active valid
descriptor.
ENOTSOCK The argument <s> is not a file of type S_IFSOCK
(socket special).
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, or the
<namelen> parameter is < 0.
SEE ALSO
The related manual sections: bind(2), socket(2),
unix_ipc(6),
inet(3N).
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)