.\" -*- coding: UTF-8 -*- .\" Copyright 1983-1991, The Regents of the University of California. .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: BSD-4-Clause-UC .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getpeername 2 "17 Mayo 2025" "Páginas de Manual de Linux 6.15" .SH NOMBRE getpeername \- obtiene el nombre del conector en el otro extremo .SH BIBLIOTECA Biblioteca Estándar C (\fIlibc\fP,\ \fI\-lc\fP) .SH SINOPSIS .nf \fB#include \fP .P \fBint getpeername(int \fP\fIsockfd\fP\fB, struct sockaddr *restrict \fP\fIaddr\fP\fB,\fP \fB socklen_t *restrict \fP\fIaddrlen\fP\fB);\fP .fi .SH DESCRIPCIÓN \fBgetpeername\fP() retornará la dirección del par conectado al socket \fIsockfd\fP, en el búfer que apunta \fIaddr\fP. El argumento \fIaddrlen\fP debe inicializarse para indicar la cantidad de espacio apuntado por \fIaddr\fP. Al devolver, contiene el tamaño real del nombre devuelto (en bytes). El nombre se trunca si el búfer proporcionado es demasiado pequeño. .P La dirección devuelta se trunca si el tamaño del búfer indicado es demasiado pequeño; en este caso, \fIaddrlen\fP devolverá un valor mayor que el proporcionado a la llamada. .SH "VALOR DEVUELTO" En caso de éxito se devuelve cero. En caso de error se devuelve \-1, y \fIerrno\fP se configura para indicar el error. .SH ERRORES .TP \fBEBADF\fP El argumento \fIsockfd\fP no es un descriptor de archivo válido. .TP \fBEFAULT\fP El parámetro \fIaddr\fP apunta a memoria que no está en una zona válida del espacio de direcciones del proceso. .TP \fBEINVAL\fP \fIaddrlen\fP es inválido (por ejemplo: tiene valor negativo). .TP \fBENOBUFS\fP Insuficientes recursos disponibles para realizar la operación. .TP \fBENOTCONN\fP El conector no está conectado. .TP \fBENOTSOCK\fP El descriptor de archivo \fIsockfd\fP no se refiere a un conector. .SH ESTÁNDARES POSIX.1\-2008. .SH HISTORIAL POSIX.1\-2001, SVr4, 4.4BSD (apareció por primera vez en 4.2BSD). .SH NOTAS Para los sockets de flujo, una vez ejecutada una instrucción \fBconnect\fP(2), cualquiera de los sockets puede llamar a \fBgetpeername\fP() para obtener la dirección del socket parejo. Por otro lado, los sockets de datagrama no requieren conexión. Llamar a \fBconnect\fP(2) en un socket de datagrama simplemente establece la dirección del par para los datagramas salientes enviados con \fBwrite\fP(2) o \fBrecv\fP(2). Quien llama a \fBconnect\fP(2) puede usar \fBgetpeername\fP() para obtener la dirección del par que previamente estableció para el socket. Sin embargo, el socket del par no dispone de esta información e invocar a \fBgetpeername\fP() en él no devolverá información útil (a menos que también se haya ejecutado una llamada a \fBconnect\fP(2) en el par). Tenga en cuenta también que el receptor de un datagrama puede obtener la dirección del emisor al usar \fBrecvfrom\fP(2). .SH "VÉASE TAMBIÉN" \fBaccept\fP(2), \fBbind\fP(2), \fBgetsockname\fP(2), \fBip\fP(7), \fBsocket\fP(7), \fBunix\fP(7) .PP .SH TRADUCCIÓN La traducción al español de esta página del manual fue creada por Gerardo Aburruzaga García , Juan Piernas y Marcos Fouces . .PP Esta traducción es documentación libre; lea la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. .PP Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a .MT debian-l10n-spanish@lists.debian.org .ME .