flags değerleri¶

flags değişkeninin değeri aşağıdaki değerlerin VEYAlanmasıyla elde edilir.

MSG_CMSG_CLOEXEC (sadece recvmsg() için geçerlidir, Linux 2.6.23 ve sonrası)

SCM_RIGHTS işlemi kullanılarak sağlanan UNIX alan dosya tanıtıcısını (unix(7) sayfasında açıklanmıştır) close-on-exec kipine ayarlar. Bu kip, open(2) çağrısına ait O_CLOEXEC ile aynı sebeplerden ötürü kullanışlıdır.

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_ERRQUEUE (Linux 2.2 ve sonrası)

Bu seçenek, hata kuyruğunun soket hata kuyruğundan alınmasını belirtir. Hata, protokole bağlı türden yardımcı veri olarak iletilir (IPv4 için IP_RECVERR). Kullanıcı yeteri boyutta bir tampon belirtmelidir. Daha ayrıntılı bilgi için cmsg(3) ve ip(7) sayfalarına bakın. Esas paketteki hataya sebep olan yük msg_iovec ile normal veri olarak aktarılır. Hataya sebep olan verikatarının özgün hedef adresi msg_name ile sağlanır.

sock_extended_err yapısında sağlanan hatalar:

#define SO_EE_ORIGIN_NONE    0
#define SO_EE_ORIGIN_LOCAL   1
#define SO_EE_ORIGIN_ICMP    2
#define SO_EE_ORIGIN_ICMP6   3
struct sock_extended_err
{


    uint32_t ee_errno;   /* Hata sayısı */


    uint8_t  ee_origin;  /* Hatanın kaynağı */


    uint8_t  ee_type;    /* Tür */


    uint8_t  ee_code;    /* Kod */


    uint8_t  ee_pad;     /* Dolgu */


    uint32_t ee_info;    /* Ek bilgiler */


    uint32_t ee_data;    /* Diğer veriler */


    /* Fazladan veri takip edebilir */
};
struct sockaddr *SO_EE_OFFENDER(struct sock_extended_err *);

ee_errno kuyruğa alınmış errno hata numarasını içerir. ee_origin hatanın kodda oluştuğu yeri gösterir. Diğer alanlar protokole özeldir. SOCK_EE_OFFENDER makrosu, yardımcı iletinin göstericisinden kaynaklanan hatanın kaynaklandığı ağ nesnesinin adresine bir gösterici döndürür. Eğer adres bilinmiyorsa, sockaddr yapısının sa_family alanı AF_UNSPEC içerirken yapının diğer alanları tanımsız kalır. Hataya sebep olan paket yükü normal veri olarak aktarılır.

Yerel hatalar için adres belirtilmez (bu, cmsghdr üyesi cmsg_len ile sınanabilir). Hata alımı için msghdr değişkenine MSG_ERRQUEUE atanır. Bir hata aktarıldıktan sonra, bekleyen soket hatası, hata kuyruğundaki sonraki hataya göre yeniden oluşturulur ve sonraki soket işleminde aktarılır.

MSG_OOB

Bu seçenek normalde veri akımında alınmayacak bantdışı (Out Of Band) veri alındısı isteğinde bulunur. Bazı protokoller hızlandırılmış veriyi normal veri kuyruğunun başına yerleştirir, bu yüzden bu seçenek bu tür protokollerde kullanılamaz.

MSG_PEEK

Bu seçenek alım işlemini, alım kuyruğunun başındaki veriyi kuyruktaki veriyi silmeden almasına neden olur. Bu sebepten, sonraki alım çağrısında aynı veriyi döndürür.

MSG_TRUNC (Linux 2.2 ve sonrası)

Ham (AF_PACKET), İnternet verikatarı (Linux 2.4.27/2.6.8 ve sonrası), ağ bağlantısı (Linux 2.6.22 ve sonrası) ve UNIX verikatarı (Linux 3.4 ve sonrası) soketleri için: Tampona aktarılandan büyük olsa bile, paketin veya verikatarının gerçek uzunluğunu döndürür.

İnternet akım soketleriyle kullanmak için tcp(7) sayfasına bakın.

MSG_WAITALL (Linux 2.2. ve sonrası)

Bu seçenek, tüm istekler tamamlandığında işlemin engellemesi içindir. Ancak çağrı, bir sinyal yakaladığında, bir hata veya bağlantı kopması meydana geldiğinde, alınacak kuyruktaki verinin türü alınan veri türünden farklıysa daha az veri döndürür. Bu seçeneğin verikatarı soketleri için herhangi bir etkisi yoktur.

recvfrom()¶

recvfrom() gelen iletiyi buf tamponuna yerleştirir. Çağrıcı tamponun boyutunu len değişkeni ile belirtmelidir.

Eğer src_addr NULL değilse ve ilgili protokol iletinin kaynak adresini sağlıyorsa src_addr tampon içine yerleştirilen kaynak adrese göstericidir. Bu durumda, addrlen hem aktarılan değere hem de dönen sonuca göstericidir. addrlen, çağrıdan önce src_addr ile ilişkilendirilmiş tamponun boyutuna gösterici olmalıdır. İşlev döndüğünde, addrlen, kaynak adresin gerçek boyutunu gösterecek şekilde güncellenir. Sağlanan tampon çok küçükse döndürülen adres kırpılır; bu durumda, addrlen çağrıdan önceki boyuttan daha büyük bir değer döndürür.

Eğer çağrıcı kaynak adresiyle ilgilenmiyorsa src_addr ve addrlen değişkenlerinde NULL aktarmalıdır.

recv()¶

recv() çağrısı normalde connected (bağlantılı) soketlerle kullanılır (connect(2) sayfasına bakın). Bu çağrı:

recvfrom(fd, buf, len, flags, NULL, 0);

recvmsg()¶

recvmsg(), msghdr yapısını kullanarak doğrudan sağlanan değişken sayısını azaltır. Bu yapı, <sys/socket.h> içerisinde şu şekilde tanımlanmıştır:

struct iovec {         /* Dağıtma/toplama dizisinin öğeleri */


    void  *iov_base;              /* Başlangıç adresi */


    size_t iov_len;               /* Aktarılacak bayt saysı */
};

struct msghdr {


    void         *msg_name;       /* İsteğe bağlı adres */


    socklen_t     msg_namelen;    /* Adresin boyutu */


   struct iovec *msg_iov;         /* Dağıtma/toplama dizisi */


    size_t        msg_iovlen;     /* msg_iov dizisinin öğe sayısı*/


    void         *msg_control;    /* Yardımcı veri tamponu, aşağıya bakın*/


    size_t        msg_controllen; /* Yardımcı veri tampon boyutu */


    int           msg_flags;      /* Alınan iletideki seçenekler */
};

readv(2) sayfasında açıklandığı üzere, msg_iov ve msg_iovlen alanları dağıtma-toplama konumlarını belirler.

msg_controllen uzunluğundaki msg_control alanı, diğer protokollere ait denetim iletileri veya çeşitli yardımcı verilere göstericidir. recvmsg() çağrıldığında, msg_controllen msg_control içindeki kullanılabilir tamponun boyutunu içermelidir; başarılı bir çağrıda denetim ileti dizisinin boyutunu içerir.

İletinin yapısı:

struct cmsghdr {


    size_t cmsg_len;    /* Başlıkla beraber verinin bayt sayısı


                           (POSIX’de veri türü socklen_t’dir) */


    int    cmsg_level;  /* Kaynak protokol */


    int    cmsg_type;   /* Protokole özgü tür */
/* devamında,


    unsigned char cmsg_data[];  */
};

Örnek olarak, Linux bu yardımcı veri mekanizmasını genişletilmiş hataları, IP seçeneklerini veya UNIX alan soketleri üzerinden dosya tanıtıcılarını aktarmak için kullanır. Yardımcı verinin diğer çeşitli soket alanlarında kullanımına ilişkin ayrıntılı bilgi için unix(7) ve ip(7) sayfalarına bakın.

msghdr yapısına ait msg_flags alanı, recvmsg() dönüdüğünde şu sabitler için sınanabilir:

MSG_EOR

Döndürülen verilerin bir kaydı tamamladığını yani kayıt sonunu (End Of Record) belirtir (genellikle SOCK_SEQPACKET türündeki soketlerle kullanılır).

MSG_TRUNC

Verikatarının sağlanan tampondan daha uzun olmasından dolayı kalan kısmın atılacağını belirtir.

MSG_CTRUNC

Yardımcı veri için tampondaki boşluğun az olmasından dolayı denetim verisinin atılacağını belirtir.

MSG_OOB

Hızlandırılmış veya bantdışı (Out Of Band) veri alındığını belirtir.

MSG_ERRQUEUE

Bir veri alınmadığını ancak soket hata kuyruğundaki genişletilmiş bir hatanın alındığını belirtir.