İSİM

       send - bağlantılı soket üzerinden ileti yollar
       sendto - bağlantısız soket üzerinden ileti yollar
       sendmsg - soket üzerinden bir dizi ileti yollar

BİLDİRİM

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

       ssize_t send (int sockfd, const void *buf, size_t len, int flags);

       ssize_t sendto (int sockfd, const void *buf, size_t len, int flags, const struct sockaddr
                      dest_addr, socklen_t addrlen);

       ssize_t sendmsg (int sockfd, const struct msghdr *msg, int flags);

AÇIKLAMA

       send(), sendto() ve sendmsg() sistem çağrıları bir başka sokete ileti aktarmakta
       kullanılır.

       send() çağrısı soket sadece connected (bağlantılı) durumda ise kullanılabilir (böylece
       amaçlanan alıcı biliniyor olur). send() ve write(2) arasındaki tek fark flags değişkeninin
       varlığıdır. Sıfır değeri atanmış flags değişkeni kullanan send() ile write(2) eşdeğerdir.
       Ayrıca aşağıdaki

           send(sockfd, buf, len, flags);

       çağrısı

           sendto(sockfd, buf, len, flags, NULL, 0);

       çağrısına eşdeğerdir. sockfd değişkeni, gönderen soketin dosya tanıtıcısıdır.

       Eğer sendto() bağlantılı bir soket (SOCK_STREAM, SOCK_SEQPACKET) ile kullanılırsa,
       dest_addr ve addrlen değişkenleri görmezden gelinir (eğer bunlar NULL ve 0 değilse EISCONN
       hatası dönebilir) ve eğer soket bağlanmadıysa ENOTCONN hatası döner. Bağlantısız soketle
       kullanımda, dest_addr hedefin adresini, addrlen ise hedef adresin boyutunu belirler.
       sendmsg() için hedef adres msg.msg_name ile belirtilir ve msg.msg_namelen boyutunu
       belirler.

       send() ve sendto() için, ileti buf tamponu içinde tutulur ve len uzunluktadır. sendmsg()
       için, ileti msg.msg_iov dizisindeki öğelerle gösterilir. sendmsg() çağrısı yardımcı
       verinin de yollanmasını sağlar (denetim bilgisi de denir).

       Eğer ileti ilgili protokol için bütün olarak gönderilemeyecek kadar uzunsa, EMGSIZE hatası
       döner ve ileti gönderilmez.

       send() işlevinde teslimatın yapılmadığını gösteren hiçbir belirti yoktur. Yerel olarak
       hatalar -1 dönüş değeri ile saptanır.

       İleti soketin gönderim tamponuna sığmadığında, send() eğer soket engellemesiz G/Ç kipine
       alınmadıysa engellenir. Engellemesiz kip başarısız olduğunda EAGAIN veya EWOULDBLOCK
       döner. select(2) çağrısı daha fazla veri gönderme olasılığını saptamak için
       kullanılabilir.

   flags değerleri
       flags değişkeninin değeri ya sıfırdır ya da aşağıdaki sabitlerin bit düzeyinde
       veyalanmasıyla elde edilir.

       MSG_CONFIRM (Linux 2.3.15 ve sonrası)
           Bağlantı katmanına yönlendirme sürecinin durumunu bildir: Karşı taraftan başarılı bir
           yanıt aldın. Eğer bağlantı katmanı bunu alamazsa komşusunu düzenli olarak uyarır
           (örneğin, tek noktaya ARP ile). Sadece SOCK_DGRAM ve SOCK_RAW soketleri için geçerli
           olup şimdilik sadece IPv4 ve IPv6 için gerçeklenmiştir. Ayrıntılar için arp(7)
           sayfasına bakın.

       MSG_DONTROUTE
           Paketi yollamak için geçit kullanma, doğrudan bağlı ağdaki konaklara gönder. Bu
           genellikle teşhis ve yönlendirme uygulamaları tarafından kullanılır. Bu sadece
           yönlendirme yapan protokoller için tanımlanmıştır; paket soketleri için değil.

       MSG_DONTWAIT (Linux 2.2 ve sonrası)
           Engellemesiz işlemi etkinleştirir; eğer işlem engellenirse, EAGAIN veya EWOULDBLOCK
           döner. O_NONBLOCK seçeneği tanımlanmış (fcntl(2) üzerinden F_SETFL işlemi ile) gibi
           davranır, fakat MSG_DONTWAIT çağrıya özel olmasıyla fark oluşturur. O_NONBLOCK
           seçeneği ise açık dosya tanıtıcısı içindir (open(2) sayfasına bakın), çağrı
           sürecindeki tüm evreleri ve aynı zamanda aynı açık dosyanın dosya tanıtıcılarına sahip
           diğer süreçleri de etkiler.

       MSG_EOR (Linux 2.2 ve sonrası)
           Bir kaydı sonlandırır (bu kavram SOCK_SEQPACKET türündeki soketlerdeki gibi
           destekleniyorsa).

       MSG_MORE (Linux 2.4.4 ve sonrası)
           Çağrıcının hala yollayacağı veri var. Bu seçenek TCP_CORK soket seçeneğine ait etkiyi
           TCP soketleri ile elde etmek için kullanılır (tcp(7) sayfasına bakın). Bu seçeneğin
           farkı çağrıya özel olmasıdır.

           Linux 2.6’dan itibaren, bu seçenek UDP soketleri için de desteklenmektedir. Çekirdeğe,
           sadece bu seçenek belirtilmeksizin yapılan bir çağrı ile aktarım yapılan tek bir
           verikatarına gönderilecek tüm veriyi bu seçenek kullanılarak yapılan çağrılarla
           gönderilecek şekilde paketlemesini söyler. (Ayrıca udp(7)’de açıklanan UDP_CORK soket
           seçeneğine de bakın.)

       MSG_NOSIGNAL (Linux 2.2 ve sonrası)
           Eğer akım odaklı soket karşıdan bağlantıyı kapattıysa SIGPIPE sinyali üretme. EPIPE
           hatası yine de döner. SIGPIPE sinyalini görmezden gelmek için sigaction(2) kullanımına
           benzer bir davranış sağlar, fakat MSG_NOSIGNAL çağrıya özeldir, SIG_PIPE sinyalinin
           görmezden gelinmesi sürecin tüm evrelerini etkileyen bir süreç özelliğinin atanmasına
           sebep olur.

       MSG_OOB
           Veriyi bantdışı (Out Of Band) veriyi destekleyen soketlere gönderir (örneğin
           SOCK_STREAM türü); kullanılan protokol bantdışı veriyi desteklemelidir.

   sendmsg()
       sendmsg() ile kullanılan msghdr yapısının tanımı:

           struct msghdr {
                void         *msg_name;       /* isteğe bağlı adres */
                socklen_t     msg_namelen;    /* adresin boyutu */
                struct iovec *msg_iov;        /* dağıtma/toplama dizisi */
                size_t        msg_iovlen;     /* msg_iov içindeki öğe sayısı */
                void         *msg_control;    /* yardımcı veri, aşağıya bakınız */
                size_t        msg_controllen; /* yardımcı veri tampon boyutu */
                int           msg_flags;      /* seçenekler (kullanılmıyor) */
            };

       msg_name alanı bağlantısız bir soket üzerinde verikatarı için hedef adresini belirtmekte
       kullanılır. Adresi içeren tampona göstericidir; msg_namelen alanına adresin boyutu
       atanmalıdır. Bağlantılı bir soket için, bu alanlar sırasıyla NULL ve 0 olarak
       belirtilmelidir.

       msg_iov ve msg_iovlen alanları writev(2) çağrısındaki gibi dağıtma-toplama konumlarını
       belirtir.

       msg_control ve msg_controllen kullanılarak denetim bilgisi (yardımcı bilgi)
       gönderilebilir. Çekirdeğin soket başına işleyebileceği denetim tamponunun azami boyutu
       /proc/sys/net/core/optmem_max içindeki değerle sınırlanmıştır; socket(7) sayfasına bakın.
       Yardımcı verilerin çeşitli soketlerde kullanımına ilişkin ayrıntılılı bilgi edinmek için
       unix(7) ve ip(7) sayfasına bakın.

       msg_flags alanı görmezden gelinir.

DÖNÜŞ DEĞERİ

       Başarı durumunda bu çağrılar gönderilen baytların sayısını döndürür. Hata durumunda, -1
       döner ve hata errno değişkenine atanır.

HATALAR

       Soket katmanı tarafından üretilen bazı standart hatalar vardır. Ayrıca, kullanılan
       protokol modülleri tarafından üretilen ve döndürülen hatalar da olabilir; bilgi için
       bunlarla ilgili kılavuz sayfalarına bakın.

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

           (UDP soketleri için) Ağ/yayın adresine veri yollanmak için girişimde bulunulmuş ancak
           adres tek nokta için.

       EAGAIN veya EWOULDBLOCK
           Soket engellemesiz olarak işaretlenmiş ama talep edilen işlem soketi engelleyecek.
           POSIX.1-2001 her iki hatanın da döndürülmesine izin verir ve bu sabitlerin aynı
           değerde olmasını gerektirmez, bu bakımdan taşınabilir uygulamalar her iki seçeneği de
           sınamalıdır.

       EAGAIN
           (İnternet alanı verikatarı 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.

       EALREADY
           Başka bir Hızlı Açma işlemde.

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

       ECONNRESET
           Bağlantı karşıdan sıfırlandı.

       EDESTADDRREQ
           Soket bağlantılı kipte değil ve karşı adres atanmamış.

       EFAULT
           Belirtilen kullanıcı adres uzayı geçersiz.

       EINTR
           Veri gönderilmeden önce bir sinyal alınmış; signal(7) sayfasına bakın.

       EINVAL
           Belirtilen değer geçersiz.

       EISCONN
           Bağlantılı kipteki soket zaten bağlı ancak bir alıcı belirtilmiş. (Ya bu hata döner ya
           da belirtilen alıcı dikkate alınmaz.)

       EMSGSIZE
           Soket türü iletinin bütün olarak gönderilmesini gerektiriyor ancak iletinin boyutu
           bunu imkansız kılıyor.

       ENOBUFS
           Ağ arabiriminin çıktı kuyruğu dolu. Bu, genellikle arabirimin göndermeyi durdurduğunu
           gösterir, ancak geçici bir tıkanıklıktan ötürü de olabilir. (Normalde bu durum
           Linux’ta olmaz. Aygıtın kuyruğu taşarsa paketler sessizce düşürülür.)

       ENOMEM
           Yeterli bellek yok.

       ENOTCONN
           Soket bağlantısız ve bir hedef belirtilmemiş.

       ENOTSOCK
           Belirtilen sockfd’nin bir soketle ilgisi yok.

       EOPNOTSUPP
           flags değişkenindeki bazı bitler soket türüyle uyumsuz.

       EPIPE
           Bağlantı yönelimli sokette yerel uç kapatılmış. Bu durumda, MSG_NOSIGNAL atanmamışsa
           işlem ayrıca SIGPIPE sinyalini de alır.

UYUMLULUK

       4.4BSD, SVr4, POSIX.1-2001. Bu arayüzler ilk defa 4.2BSD ile ortaya çıktı.

       POSIX.1-2001 sadece MSG_OOB ve MSG_EOR seçeneklerini açıklar. POSIX.1-2008 MSG_NOSIGNAL’e
       bir belirtim ekler. MSG_CONFIRM seçeneği ise Linux eklentisidir.

EK BİLGİ

       POSIX.1-2001’e göre, msghdr yapısının msg_controllen alanı socklen_t türünden, msg_iovlen
       alanı ise int türünde olmalıdır, fakat glibc ikisine de size_t türünü atar.

       Tek çağrıda çok sayıda verikatarı iletmek için kullanılan Linux’a özgü sistem çağrısı
       hakkında bilgi edinmek için sendmmsg(2) sayfasına bakın.

HATALAR

       Linux, ENOTCONN yerine EPIPE döndürebilir.

ÖRNEKLER

       sendto() kullanım örneği getaddrinfo(3) sayfasında verilmiştir.

İLGİLİ BELGELER

       fcntl(2), getsockopt(2), recv(2), select(2), sendfile(2), sendmmsg(2), shutdown(2),
       socket(2), write(2), cmsg(3), ip(7), ipv6(7), socket(7), tcp(7), udp(7), unix(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.