GETSOCKNAME

Section: Linux Programmer's Manual (2)
Updated: 24 July 1993
Index Return to Main Contents
 

NAME

getsockname - get socket name  

SYNOPSIS

int getsockname(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).  

RETURN VALUE

On success, zero is returned. On error, -1 is returned, and errno is set appropriately. A 0 is returned if the call succeeds, -1 if it fails.  

ERRORS

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 system to perform the operation.
EFAULT
The name parameter points to memory not in a valid part of the process address space.
 

HISTORY

The getsockname function call appeared in BSD 4.2.  

BUGS

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

SEE ALSO

bind(2), socket(2)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
HISTORY
BUGS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 12:24:51 GMT, March 22, 2025