SEND(2)

JMÉNO
send, sendto, sendmsg - pošli zprávu do soketu

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

int send(int s, const void *msg, int len, unsigned int flags);

int sendto(int s, const void *msg, int len, unsigned int flags, const struct sockaddr *to, int tolen);

int sendmsg(int s, const struct msghdr *msg, unsigned int flags);

POPIS
Send, sendto, a sendmsg se používají k zasílání zpráv do jiných soketů. Send může být použito pouze, je-li soket spojený zatímco sendto a sendmsg mohou být použity kdykoliv. Adresa cílového soketu je zadána parametrem to a tolen specifikuje jeho velikost. Adresa zprávy je zadána v argumentu len. Je-li zpráva příliš dlouhá, aby mola být poslána atomicky, je vrácena chyba EMSGSIZE a zpráva není poslána. Funkce send neposkytuje žádnou možnost indikace správného doručení. Lokálně detekované chyby jsou indikovány návratovou hodnotou -1. Pokud není k dispozici žádné volné místo pro zprávu před jejím přenosem, send se normálně zablokuje, pokud soket není v neblokujícím módu. Volání select(2) může být použito k zjištění, je-li možno poslat další data. Parametr flags může obsahovat jednu nebo více z následujících hodnot:
    #define	MSG_OOB        0x1  /* zpracuj out-of-band data */
    #define	MSG_DONTROUTE  0x4  /* obejdi routing, použij přímé rozhraní*/
Flag MSG_OOB je použit pro posílání out-of-band dat do soketu, který to podporuje (např. SOCK_STREAM); použitý protokol musí také podporovat out-of-band data. MSG_DONTROUTE je normálně používáno pouze diagnostickými a routovacími programy. V recv(2) je obsažen popis struktury msghdr

NÁVRATOVÁ HODNOTA
Volání vrací počet poslaných znaků, nebo -1 pokud se objevila chyba.

CHYBY

EBADF
    Byl specifikován neplatný deskriptor.

ENOTSOCK
    Argument s není soket

EFAULT
    Parametr je v neplatné části adresového prostoru procesu.

EMSGSIZE
    Soket požaduje, aby tato zpráva byla poslána atomicky, ale velikost této zprávy toto znemožňuje.

EWOULDBLOCK
    Soket je označen jako neblokující a požadovaná operace by blokovala.

ENOBUFS
    Systém není schopen alokovat interní buffery. Operace může být úspěšná až budou buffery k dispozici.

ENOBUFS
    Výstupní fronta pro síťové rozhraní je zaplněna. To obvykle znamená, že rozhraní přestalo posílat, ale může to být také způsobeno občasným přetížením rozhraní.

SPLŇUJE STANDARDY
4.4BSD, SVr4 (tato volání se poprvé objevila ve 4.2BSD). SVr4 dokumentuje další chyby EINVAL, EINTR, EMSGSIZE, ENOSR, ENOMEM.

DALŠÍ INFORMACE
fcntl(2), recv(2), select(2), getsockopt(2), socket(2), write(2)