JMÉNO

       getpeername - vrať adresu vzdáleného konce soketu

KNIHOVNA

       Standardní knihovna C (libc, -lc)

POUŽITÍ

       #include <sys/socket.h>

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

POPIS

       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.

NÁVRATOVÉ HODNOTY

       On  success,  zero is returned. On error, -1 is returned, and errno is set to indicate the
       error.

CHYBOVÉ STAVY

       EBADF  Argument sockfd není platným deskriptorem.

       EFAULT Argument addr ukazuje na paměť v neplatné části adresového prostoru procesu.

       EINVAL addrlen je neplatné (například záporné číslo).

       ENOBUFS
              Nedostatek systémových zdrojů k provedení operace.

       ENOTCONN
              Soket není spojen.

       ENOTSOCK
              The file descriptor sockfd does not refer to a socket.

STANDARDY

       POSIX.1-2008.

HISTORIE

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

POZNÁMKY

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

DALŠÍ INFORMACE

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

PŘEKLAD

       Překlad této příručky do češtiny vytvořili Pavel Heimlich <tropikhajma@gmail.com>

       Tento překlad je bezplatná dokumentace; Přečtěte si GNU General Public License  Version  3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ nebo novější ohledně podmínek autorských práv.
       Neexistuje ŽÁDNÁ ODPOVĚDNOST.

       Pokud narazíte na nějaké  chyby  v  překladu  této  příručky,  pošlete  e-mail  na  adresu
       ⟨translation-team-cs@lists.sourceforge.net⟩.