Provided by:
manpages-es_1.55-8_all 
NOMBRE
getpeername - obtiene el nombre del conector en el otro extremo
SINOPSIS
#include <sys/socket.h>
int getpeername(int s, struct sockaddr *nombre, socklen_t *longinom);
DESCRIPCIÓN
Getpeername devuelve el nombre de la pareja conectada al conector s.
El parámetro longinom debería inicializarse de forma que indicara la
cantidad de espacio a la que apuntara nombre. Al regresar la función,
contendrá el tamaño real del nombre devuelto (en bytes). El nombre se
trunca si el búfer provisto es demasiado pequeño.
VALOR DEVUELTO
En caso de éxito, se devuelve cero. En caso de error, se devuelve -1 y
se pone en errno un valor apropiado.
ERRORES
EBADF El argumento s no es un descriptor válido.
ENOTSOCK
El argumento s es un fichero, no un conector.
ENOTCONN
El conector no está conectado.
ENOBUFS
No había en el sistema suficientes recursos como para efectuarse
la operación.
EFAULT El parámetro nombre apunta a memoria que no está en una zona
válida del espacio de direcciones del proceso.
CONFORME A
SVr4, 4.4BSD (la llamada al sistema getpeername apareció por vez 1ª en
4.2BSD).
NOTA
El tercer argumento de getpeername es en realidad un entero (y esto es
lo que tienen BSD 4.*, libc4 y libc5). Cierta confusión en POSIX dio
como resultado el actual socklen_t. El estándar propuesto todavía no
ha sido adoptado pero glibc2 ya lo sigue y también tiene socklen_t. Vea
también accept(2).
VÉASE TAMBIÉN
accept(2), bind(2), getsockname(2)