getpeername(2)                System Calls Manual               getpeername(2)

NOMBRE
       getpeername - obtiene el nombre del conector en el otro extremo

BIBLIOTECA
       Biblioteca Estandar C (libc, -lc)

SINOPSIS
       #include <sys/socket.h>

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

DESCRIPCION
       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 exito 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 valido.

       EFAULT El parametro addr apunta a memoria que no esta en una zona
              valida del espacio de direcciones del proceso.

       EINVAL addrlen es invalido (por ejemplo: tiene valor negativo).

       ENOBUFS
              Insuficientes recursos disponibles para realizar la operacion.

       ENOTCONN
              El conector no esta conectado.

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

ESTANDARES
       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).

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

TRADUCCION
       La traduccion al espanol de esta pagina del manual fue creada por
       Gerardo Aburruzaga Garcia <gerardo.aburruzaga@uca.es>, Juan Piernas
       <piernas@ditec.um.es> y Marcos Fouces <marcos@debian.org>

       Esta traduccion es documentacion 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 algun error en la traduccion de esta pagina del manual,
       envie un correo electronico a <debian-l10n-spanish@lists.debian.org>.

Paginas de manual de Linux 6.06 31 Octubre 2023                 getpeername(2)