Ubuntu Manpage: connect - inicjalizacja połączenia poprzez gniazdo

nazwa
składnia
opis
wartość zwracana
błędy
zgodne z
uwaga
usterki
zobacz także
informacje o tłumaczeniu

NAZWA

       connect - inicjalizacja połączenia poprzez gniazdo

SKŁADNIA

       #include <sys/types.h>
       #include <sys/socket.h>

       int connect(int sockfd, const struct sockaddr *serv_addr, socklen_t addrlen);

OPIS

        Uwaga! To tłumaczenie może być nieaktualne!

       Deskryptor  sockfd  musi  odnosić się do gniazda.  Jeśli gniazdo jest typu SOCK_DGRAM, to adres serv_addr
       jest adresem, do którego domyślnie przesyłane są datagramy i jedynym  adresem,  z  którego  datagramy  są
       odbierane.  Jeśli  gniazdo  jest  typu  SOCK_STREAM  lub  SOCK_SEQPACKET,  to ta funkcja próbuje nawiązać
       połączenie z innym gniazdem. Inne gniazdo jest  podane  jako  serv_addr,  co  jest  adresem  (o  długości
       addrlen)   w  przestrzeni  komunikacyjnej  gniazda.  Każda  z  przestrzeni  komunikacyjnych  interpretuje
       serv_addr, po swojemu.

       Ogólnie, gniazda strumieniowe (dla protokołów połączeniowych) mogą pomyślnie wykonać connect  tylko  raz;
       gniazda datagramowe (dla protokołów bezpołączeniowych) mogą używać connect wielokrotnie do zmiany swojego
       przypisania. Gniazda datagramowe mogą zniszczyć powiązanie przez łączenie się z adresem,  w  którym  pole
       sa_family struktury sockaddr ma wartość AF_UNSPEC.

WARTOŚĆ ZWRACANA

       Jeśli  połączenie  lub  przywiązanie  uda  się,  zwracane  jest  zero.  Przy  błędzie, zwracane jest -1 i
       odpowiednio ustawiane errno.

BŁĘDY

Następujące błędy to jedynie ogólne błędy gniazd. Mogą występować również inne, specyficzne dla domeny
kody błędów.

EBADF Deskryptor nie jest prawidłowym indeksem tablicy deskryptorów.

EFAULT Adres struktura gniazda znajduje się poza przestrzenią adresową użytkownika.

ENOTSOCK
Deskryptor nie jest związany z gniazdem.

EISCONN
Gniazdo już jest połączone.

ECONNREFUSED
Żaden serwer nie nasłuchuje na zdalnym adresie.

ETIMEDOUT
Przeterminowanie próby połączenia. Serwer może być zbyt zajęty, aby przyjmować nowe połączenia.
Dla gniazd IP czas przeterminowania może być bardzo długi, gdy na serwerze włączone są
"syncookies".

ENETUNREACH
Sieć jest nieosiągalna.

EADDRINUSE
Adres lokalny już jest wykorzystywany.

EINPROGRESS
Gniazdo jest nieblokujące, a połączenie nie może zostać zrealizowane natychmiast. Jest możliwe
wykonanie select(2) lub poll(2) w celu dokończenia poprzez wybranie gniazda do zapisu. Po tym,
jak select wskaże zapisywalność, należy użyć getsockopt(2), aby odczytać opcję SO_ERROR z poziomu
SOL_SOCKET w celu określenia, czy connect zakończyło się pomyślnie (SO_ERROR będzie zerem) lub
niepomyślnie (SO_ERROR będzie jednym ze typowych, wymienionych powyżej kodów błędów,
wyjaśniających przyczynę błędu).

EALREADY
Gniazdo jest nieblokujące, a poprzednia próba połączenia nie została zakończona. EAGAIN Brak
wolnych portów lokalnych, lub brak wpisów w buforze marszrutowym. Dla PF_INET w opisie sysctl
net.ipv4.ip_local_port_range w ip(7) opisano, jak zwiększyć liczbę portów lokalnych.

EAFNOSUPPORT
Przekazany adres miał prawidłowej rodziny adresów w swoim polu sa_family.

EACCES, EPERM
Użytkownik próbował podłączyć się do adresu rozgłoszeniowego (broadcast) bez włączonego znacznika
"broadcast" dla gniazda lub też połączenie nie udało się z powodu lokalnej reguły firewalla.

ZGODNE Z

       SVr4, 4.4BSD (funkcja connect pojawiła się pierwotnie w BSD 4.2). SVr4 dokumentuje dodatkowe błędy ogólne
       EADDRNOTAVAIL, EINVAL, EAFNOSUPPORT, EALREADY,  EINTR,  EPROTOTYPE  i  ENOSR.   Dokumentuje  także  wiele
       dodatkowych błędów tutaj nieopisanych.

UWAGA

       Trzeci  argument  connect  jest  w  rzeczywistości typu int (i tak jest w BSD 4.*, libc4 i libc5).  Pewne
       zamieszanie w POSIX doprowadziło jego zmiany na obecny socklen_t.  Szkic  standardu  nie  został  jeszcze
       przyjęty, ale glibc2 już jest z nim zgodne i zawiera również socklen_t. Zobacz także accept(2).

USTERKI

       Rozłączanie gniazda poprzez wywołanie connect z adresem AF_UNSPEC nie jest jeszcze wspierane.

ZOBACZ TAKŻE

       accept(2), bind(2), listen(2), socket(2), getsockname(2)

INFORMACJE O TŁUMACZENIU

       Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia Manuali i może nie być aktualne.
       W razie zauważenia różnic między powyższym opisem a rzeczywistym  zachowaniem  opisywanego  programu  lub
       funkcji, prosimy o zapoznanie się z oryginalną (angielską) wersją strony podręcznika za pomocą polecenia:

              man --locale=C 2 connect

       Prosimy   o   pomoc   w   aktualizacji   stron   man  -  więcej  informacji  można  znaleźć  pod  adresem
       http://sourceforge.net/projects/manpages-pl/.