İSİM

       listen - soket üzerinde bağlantıları dinler

BİLDİRİM

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

       int listen (int sockfd, int backlog);

AÇIKLAMA

       listen sockfd ile gösterilen soketi edilgen soket olarak imler ve accept(2) ile gelen
       bağlantı isteklerini kabul edecek sokete dönüştürür.

       sockfd değişkeni SOCK_STREAM veya SOCK_SEQPACKET türünde bir soketin dosya tanıtıcısıdır.

       backlog değişkeni sockfd kuyruğunun büyüyebileceği azami uzunluğu tanımlar. Eğer kuyruk
       tam dolu olduğunda bir bağlantı isteği gelirse, istemci ECONNREFUSED hatası alabilir veya
       kullanılan protokol yeniden aktarımı destekliyorsa, bağlantı isteği görmezden gelinir,
       böylece tekrar gelen bağlantı isteği kabul edilir.

DÖNÜŞ DEĞERİ

       Başarı durumunda sıfır döner. Hata oluşursa -1 döner ve hata errno değişkenine atanır.

HATALAR

       EADDRINUSE
           Başka bir soket aynı portu dinliyor.

       EADDRINUSE
           (İ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.

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

       ENOTSOCK
           Belirtilen sockfd’nin bir soketle ilgisi yok.

       ENOTSOCK
           Soket, listen()’ı destekleyen türde değil.

UYUMLULUK

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

NOTLAR

       Bağlantıları kabul etmek için aşağıdaki adımlar uygulanır:

        1. socket(2) ile soket oluşturulur.

        2. Diğer soketlerin oluşturulan sokete bağlanabilmesi için oluşturulan soket, bind(2)
           kullanılarak yerel adres ile ilişkilendirilir.

        3. Gelen bağlantıları kabul etme isteği ve gelen bağlantılar için azami kuyruk uzunluğu
           listen() ile belirtilir.

        4. Gelen bağlantılar accept(2) ile kabul edilir.

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

       backlog değişkeninin TCP soketleri üzerindeki etkisi Linux 2.2 ile beraber değişti. Artık,
       tamamlanmamış bağlantı isteklerinin kuyruk uzunluğunu belirlemek yerine, kabul edilmeyi
       bekleyen kurulmuş soketlerin kuyruk uzunluğunu belirlemektedir. Tamamlanmamış soketler
       için azami kuyruk uzunluğu /proc/sys/net/ipv4/tcp_max_syn_backlog kullanılarak
       tanımlanabilir. Eşzamanlı çerezler (syncookies) etkinleştirildiğinde, mantıksal olarak
       azami uzunluk yoktur ve bu ayar yok sayılır. Daha fazla bilgi için tcp(7) sayfasına
       bakınız.

       backlog değeri, eğer /proc/sys/net/core/somaxonn’dan daha büyükse, bu değere düşürülür.
       Linux 5.4’ten bu yana bu dosyanın öntanımlı değeri 4096’dır; eski çekirdeklerde öntanımlı
       değer 128 idi. 2.4.15’ten önceki çekirdeklerde SOMAXCONN’a 128 değeriyle sabitlenmişti.

ÖRNEKLER

       bind(2) sayfasına bakınız.

İLGİLİ BELGELER

       accept(2), bind(2), connect(2), socket(2), socket(7).

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