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-2001, POSIX.1-2008, SVr4, 4.4BSD (getpeername apareció por vez 1ª en 4.2BSD).

NOTAS

       For background on the socklen_t type, see accept(2).

       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
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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⟩.