SEND(2) Sistem Çağrıları  SEND(2)

İ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.
Yasal Uyarı
 * Özgün Belgenin Lisans ve Telif Hakkı bilgileri:
 *
 * Copyright (c) 1983, 1991 The Regents of the University of California.
 * All rights reserved.
 *
 * %%%LICENSE_START(BSD_4_CLAUSE_UCB)
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. All advertising materials mentioning features or use of this software
 *    must display the following acknowledgement:
 * This product includes software developed by the University of
 * California, Berkeley and its contributors.
 * 4. Neither the name of the University nor the names of its contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS "AS IS" AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 * %%%LICENSE_END
 *
 * Modified 1993-07-24 by Rik Faith <faith@cs.unc.edu>
 * Modified 1996-10-22 by Eric S. Raymond <esr@thyrsus.com>
 * Modified Oct 1998 by Andi Kleen
 * Modified Oct 2003 by aeb
 * Modified 2004-07-01 by mtk