Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

bind(2)

socket(2)

getsockname(2)

GETPEERNAME(2)

NAME

getpeername − get name of connected peer

USAGE

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

DESCRIPTION

Getpeername returns the name of the peer connected to socket s. The namelen parameter should be initialized to indicate the amount of space name points to.  On return, it contains the actual size of the name returned (in bytes). 

RETURN VALUE

A successful call returns zero.  A failed call returns -1 and sets errno as indicated below. 

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. 

[ENOBUFS] Insufficient system resources were available. 

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

RELATED INFORMATION

bind(2), socket(2), getsockname(2)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026