İSİM

       connect - soket üzerinde bağlantı oluşturur

BİLDİRİM

       #include <sys/types.h>          /* NOTLAR’a bakın */
       #include <sys/socket.h>

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

AÇIKLAMA

       connect() sistem çağrısı, sockfd ile belirtilen soketi addr ile belirtilen adrese bağlar.
       addrlen ile addr boyutu belirlenir. addr içindeki adresin biçimi, sockfd soketinin adres
       uzayı tarafından belirlenir; daha ayrıntılılı bilgi için socket(2) sayfasına bakılabilir.

       Eğer soket sockfd SOCK_DGRAM türünden ise, addr, verilerin gönderildiği ve alındığı
       öntanımlı adres olur. Eğer soket SOCK_STREAM veya SOCK_SEQPACKET türünden ise, sistem
       çağrısı, addr ile ilişkilendirilen soketle bağlantı kurmaya çalışır.

       Bazı protokol soketleri (örneğin UNIX alanı akım soketleri) sadece bir kere başarıyla
       connect() yapabilir.

       Bazı protokol soketleri (örneğin UNIX ve İnternet alanları içerisindeki veri soketleri)
       bağlantılarını değiştirmek için connect()’i çok kez kullanabilir.

       Bazı protokol soketleri (örneğin UNIX ve İnternet alanları içerisindeki TCP ve veri
       soketleri) sockaddr’in sa_family üyesi AF_UNSPEC olarak ayarlanmış bir adrese bağlanarak
       ilişkiyi çözebilir; sonrasında, soket bir başka adrese bağlanabilir. (AF_UNSPEC Linux’da,
       çekirdek 2.2’den itibaren desteklenmektedir.)

DÖNÜŞ DEĞERİ

       Bağlantı veya ilişkilendirme bşarılı ise sıfır döner. Hata durumunda -1 dönder ve hata
       errno değişkenine atanır.

HATALAR

       Aşağıdaki hatalar genel soketler içindir. Diğer alanların özelinde başka hata kodları
       olabilir.

       EACCES
           Dosya yoluna göre tanınan UNIX alan soketleri için: soket dosyası için yazma izni veya
           dosya yolundaki bir dizin için arama izni reddedilmiş. (Ayrıca path_resolution(7)
           sayfasına bakın.)

       EACCES, EPERM
           Kullanıcı, soket için yayın bayrağını etkinleştirmeden yayın adresine bağlanmaya
           çalışmış ya da yerel güvenlik duvarı kuralı yüzünden bağlantı isteği başarılı olmamış.

           SElinux protokolü bağlantıyı reddederse de EACCES dönebilir (örneğin, HTTP vekilinin
           sadece HTTP sunucularıyla birleştirilmiş portlara bağlanabileceğine dair bir protokol
           varsa, ve vekil başka bir porta bağlanmaya çalıştıysa).

       EADDRINUSE
           Yerel adres kullanımda.

       EADDRNOTAVAIL
           (İnternet alanı soketleri için) sockfd ile belirtilen soket, önceden bir adres ile
           ilişkilendirilmemiş ve soketi geçici bir portla ilişkilendirmeye çalışırken geçici
           port aralığındaki tüm portların kullanımda olduğu anlaşılmış. ip(7) sayfasındaki
           /proc/sys/net/ipv4/ip_local_port_range ile ilgili açıklamaya bakınız.

       EAFNOSUPPORT
           Belirtilen adresin sa_family alanındaki adres ailesi doğru değil.

       EAGAIN
           Engellemesiz UNIX alan soketler için, soket engellemesiz ve bağlantı hemen
           tamamlanamıyor. Diğer soket aileleri için, yönledirme önbelleğinde yeterli girdi yok.

       EALREADY
           Soket engellemesiz ve bir önceki bağlantı girişimi tamamlanamamış.

       EBADF
           Belirtilen sockfd uygun bir açık dosya tanıtıcısı değil.

       ECONNREFUSED
           Aktarım soketi üzerinde connect(), dinleme yapmayan bir adrese yapılmış.

       EFAULT
           Soket adres yapısı, kullanıcı adres uzayının dışında.

       EINPROGRESS
           Soket engellemesiz ve bağlantı hemen tamamlanamıyor. (Başarısız UNIX alan soketleri
           bunun yerine EAGAIN ile döner.) select(2) veya poll(2) ile soketi yazmak için seçerek
           bağlantıyı tamamlamak mümkündür. select(2) yazılabilirliği gösterdikten sonra,
           getsockopt(2) kullanarak SOL_SOCKET seviyesinde SO_ERROR ayarını okuyup connect()’in
           başarılı olduğu (SO_ERROR sıfır olur) veya olmadığı (SO_ERROR burada listelenen bir
           hata kodu olur ve hatanın sebebini açıklar) belirlenir.

       EINTR
           Sistem çağrısı bir sinyal ile kesilmiş; signal(7) sayfasına bakın.

       EISCONN
           Soket zaten bağlı.

       ENETUNREACH
           Ağa ulaşılamıyor.

       ENOTSOCK
           Belirtilen sockfd’nin bir soketle ilgisi yok.

       EPROTOTYPE
           Soket türü istenilen iletişim protokolünü desteklemiyor. Bu hata, örneğin UNIX alan
           veri soketini aktarım soketine bağlamaya çalışıldığında oluşabilir.

       ETIMEDOUT
           Bağlama girişimi sırasında zaman aşımı. Sunucu yeni bağlantıları kabul edemeyecek
           kadar yoğun olabilir. Sunucuda eşzamanlı çerezler etkinleştirildiğinde IP soketleri
           için zaman aşımı çok uzun olabilir.

UYUMLULUK

       POSIX.1-2001, POSIX.1-2008, SVr4, 4.4BSD (connect() ilk defa 4.2BSD ile ortaya çıktı).

NOTLAR

       POSIX.1’de, <sys/types.h> dahil edilmeyi gerektirmez ve yine bu başlık dosyası Linux’da da
       gerekmez. Fakat bazı tarihsel (BSD) uygulamalardan ötürü bu başlık dosyasının olması
       gerekir ve uygulamaların taşınabilirliği için dahil edilmesi akıllıca olacaktır.

       socklen_t’nin arka planı için accept(2) sayfasına bakın.

       Eğer connect() başarılı olmazsa, soketin durumu belirtilmemiş olarak kabul edilir.
       Taşınabilir uygulamalar tekrar bağlanmak için soketi kapatmalı ve yeni bir tane
       oluşturmalıdır.

ÖRNEKLER

       connect()’in örnek kullanımı getaddrinfo(3) sayfasında verilmiştir.

İLGİLİ BELGELER

       accept(2), bind(2), getsockname(2), listen(2), socket(2), path_resolution(7), selinux(8)

ÇEVİREN

       © 2022 Fatih Koçer
       Bu çeviri özgür yazılımdır: Yasaların izin verdiği ölçüde HİÇBİR GARANTİ YOKTUR.
       Lütfen, çeviri ile ilgili bildirimde bulunmak veya çeviri yapmak için
       https://github.com/TLBP/manpages-tr/issues adresinde "New Issue" düğmesine tıklayıp yeni
       bir konu açınız ve isteğinizi belirtiniz.