NOMBRE

       getpeername - obtiene el nombre del conector en el otro extremo

BIBLIOTECA

       Biblioteca Estándar C (libc, -lc)

SINOPSIS

       #include <sys/socket.h>

       int getpeername(int sockfd, struct sockaddr *restrict addr,
                       socklen_t *restrict addrlen);

DESCRIPCIÓN

       getpeername()   returns  the address of the peer connected to the socket sockfd, in the buffer pointed to
       by addr.  The addrlen argument should be initialized to indicate the amount of space pointed to by  addr.
       On  return  it  contains  the  actual size of the name returned (in bytes).  The name is truncated if the
       buffer provided is too small.

       The returned address is truncated if the buffer provided is too small; in this case, addrlen will  return
       a value greater than was supplied to the call.

VALOR DEVUELTO

       En  caso de éxito se devuelve cero. En caso de error se devuelve -1, y errno se configura para indicar el
       error.

ERRORES

       EBADF  El argumento sockfd no es un descriptor de archivo válido.

       EFAULT El parámetro addr apunta a memoria que no está en una zona válida del espacio de  direcciones  del
              proceso.

       EINVAL addrlen es inválido (por ejemplo: tiene valor negativo).

       ENOBUFS
              Insuficientes recursos disponibles para realizar la operación.

       ENOTCONN
              El conector no está conectado.

       ENOTSOCK
              El descriptor de archivo sockfd no se refiere a un conector.

ESTÁNDARES

       POSIX.1-2008.

HISTORIAL

       POSIX.1-2001, SVr4, 4.4BSD (first appeared in 4.2BSD).

NOTAS

       For  stream  sockets,  once  a  connect(2)   has been performed, either socket can call getpeername()  to
       obtain the address of the peer socket.  On the other hand, datagram sockets are connectionless.   Calling
       connect(2)   on  a datagram socket merely sets the peer address for outgoing datagrams sent with write(2)
       or recv(2).  The caller of connect(2)  can use getpeername()  to obtain the peer address that it  earlier
       set  for  the socket.  However, the peer socket is unaware of this information, and calling getpeername()
       on the peer socket will return no useful information (unless a connect(2)  call was also executed on  the
       peer).   Note  also  that  the  receiver  of  a  datagram can obtain the address of the sender when using
       recvfrom(2).

VÉASE TAMBIÉN

       accept(2), bind(2), getsockname(2), ip(7), socket(7), unix(7)

TRADUCCIÓN

       La  traducción  al  español  de  esta  página  del  manual  fue  creada  por  Gerardo  Aburruzaga  García
       <gerardo.aburruzaga@uca.es>, Juan Piernas <piernas@ditec.um.es> y Marcos Fouces <marcos@debian.org>

       Esta  traducción  es  documentación  libre;  lea  la GNU General Public License Version 3 o posterior con
       respecto a las condiciones de copyright.  No existe NINGUNA RESPONSABILIDAD.

       Si encuentra algún error en la traducción de esta página  del  manual,  envíe  un  correo  electrónico  a
       debian-l10n-spanish@lists.debian.org.

Páginas de Manual de Linux 6.9.1                   2 Mayo 2024                                    getpeername(2)