書式

#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);

説明

システムコール send(), sendto(), sendmsg() は、もう一方のソケットへメッセージを転送するのに使用される。

send() は、ソケットが 接続された (connected) 状態にある場合にのみ使用できる (つまり、どの相手に送信するかは既知である)。 send() と write(2) の違いは、引き数に flags があるかどうかだけである。 引き数 flags にフラグが指定されない場合、 send() は write(2) と等価である。 また、

    send(sockfd, buf, len, flags);

は以下と等価である。

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

引き数 sockfd は、データを送信するパケットのファイル・ディスクリプタである。

sendto() は、接続型 (connection-mode) のソケット (SOCK_STREAM, SOCK_SEQPACKET) で 使用された場合、引き数 dest_addr と addrlen は無視される (各々の引き数が NULL と 0 でない場合は EISCONN エラーも返される)。 また、ソケットが実際には接続されていなかった時には ENOTCONN エラーが返される。 接続型のソケット以外で使用された場合は、接続先のアドレスは dest_addr で与えられ、そのサイズは addrlen で指定される。 sendmsg() では、接続先のアドレスは msg.msg_name で与えられ、そのサイズは msg.msg_namelen で指定される。

send() と sendto() では、メッセージは buf に格納されており、その長さは len であると解釈される。 sendmsg() では、メッセージは 配列 msg.msg_iov の各要素が指す位置に格納されている。 sendmsg() では、補助データ (制御情報とも呼ばれる) を送信することもできる。

メッセージ長が長過ぎるために、そのソケットが使用するプロトコルでは、 メッセージをソケットに渡されたままの形で送信することができない場合、 EMSGSIZE エラーが返され、そのメッセージは転送されない。

send() では、配送の失敗の通知は明示的に行われる。 ローカル側でエラーが検出された場合は、返り値 -1 として通知される。

メッセージがソケットの送信バッファに入れることができない場合、 send() は通常は停止 (block) する (ソケットが非停止 (nonblocking) I/O モード でない場合)。非停止モードの場合にはエラー EAGAIN か EWOULDBLOCK で失敗する。 いつデータをさらに送信できるようになるかを知るために、 select(2) コールを使用することができる。

flags 引き数は、以下のフラグの (0 個以上の) ビット単位の論理和を とったものを指定する。

MSG_CONFIRM (Linux 2.3.15 以降)

転送処理に進展があった、つまり相手側から成功の応答を受けたことをリンク層に 知らせる。リンク層がこの通知を受け取らなかった場合には、通常どおり (ユニキャスト ARP を使うなどの方法で) 近傍 (neighbor) の再検索を行う。 SOCK_DGRAM と SOCK_RAW のソケットに対してのみ有効で、現在のところ IPv4 と IPv6 のみ実装されている。 詳しくは arp(7) 参照のこと。

MSG_DONTROUTE

パケットを送り出すのにゲートウェイを使用せず、 直接接続されているネットワーク上のホストだけに送る。 通常、このフラグは診断 (diagnostic) やルーティング・プログラムに よってのみ使用される。このフラグは、経路制御が行われるプロトコルファミリー に対してのみ定義されている。パケットソケットには定義されていない。

MSG_DONTWAIT (Linux 2.2 以降)

非停止 (nonblocking) 操作を有効にする。操作が停止されるような場合には EAGAIN か EWOULDBLOCK を返すようにする (fcntl(2) の F_SETFL で O_NONBLOCK フラグを指定することによっても有効にできる)。

MSG_EOR (Linux 2.2 以降)

レコードの終了を指示する (SOCK_SEQPACKET のようにこの概念に対応しているソケット種別のときに有効)。

MSG_MORE (Linux 2.4.4 以降)

呼び出し元にさらに送るデータがあることを示す。 このフラグは TCP ソケットとともに使用され、 TCP_CORK ソケットオプションと同じ効果が得られる (tcp(7) を参照)。 TCP_CORK との違いは、このフラグを使うと呼び出し単位で この機能を有効にできる点である。

Linux 2.6 以降では、このフラグは UDP ソケットでもサポートされており、 このフラグ付きで送信された全てのデータを一つのデータグラムにまとめて 送信することを、カーネルに知らせる。まとめられたデータグラムは、 このフラグを指定せずにこのシステムコールが実行された際に初めて送信される (udp(7) に記載されているソケットオプション UDP_CORK も参照)。

MSG_NOSIGNAL (Linux 2.2 以降)

ストリーム指向のソケットで相手側が接続を切断した時に、エラーとして SIGPIPE を送信しないように要求する。この場合でも EPIPE は返される。

MSG_OOB

帯域外 (out-of-band) データをサポートするソケット (例えば SOCK_STREAM) で 帯域外 データを送る。下位プロトコルも 帯域外 データをサポートしている必要がある。

msghdr 構造体の内容は以下の通り。 各フィールドの正確な記述については recv(2) と以下の説明を参照すること。

struct msghdr {
    void         *msg_name;       /* 追加のアドレス */
    socklen_t     msg_namelen;    /* アドレスのサイズ */
    struct iovec *msg_iov;        /* scatter/gather 配列 */
    size_t        msg_iovlen;     /* msg_iov の要素数 */
    void         *msg_control;    /* 補助データ (後述) */
    size_t        msg_controllen; /* 補助データバッファ長 */
    int           msg_flags;      /* 受信メッセージのフラグ */
};

msg_control と msg_controllen メンバーを使用して制御情報を送信することができる。 カーネルが処理できる制御バッファのソケットあたりの最大長は、 /proc/sys/net/core/optmem_max の値に制限されている。 socket(7) を参照。

返り値

成功した場合、これらのシステムコールは送信されたバイト数を返す。 エラーの場合、 -1 を返し、 errno を適切に設定にする。

準拠

4.4BSD, SVr4, POSIX.1-2001. (これらの関数コールは 4.2BSD で最初に登場した)。

POSIX.1-2001 には、 MSG_OOB と MSG_EOR フラグだけが記載されている。 POSIX.1-2008 では MSG_NOSIGNAL が規格に追加されている。 MSG_CONFIRM フラグは Linux での拡張である。

注意

上記のプロトタイプは Single UNIX Specification に従っている。 glibc2 も同様である。 flags 引き数は 4.x BSD では int であり、 libc4 と libc5 では unsigned int である。 len 引き数は 4.x BSD と libc4 では int であり、 libc5 では size_t である。 addrlen 引き数は 4.x BSD と libc4 と libc5 では int である。 accept(2) も参照すること。

POSIX.1-2001 では、構造体 msghdr のフィールド msg_controllen は socklen_t 型であるべきだとされているが、 現在の glibc では size_t 型である。

sendmmsg(2) には、一度の呼び出しでの複数のデータグラムの送信に使用できる Linux 固有の システムコールに関する情報が書かれている。

例

sendto() の利用例が getaddrinfo(3) に記載されている。

この文書について

この man ページは Linux man-pages プロジェクトのリリース 3.65 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。