User manual - デバイス制御ライブラリリファレンスマニュアル(2014年10月10日)

301
17.2.11 net_listen
接続を待ちます。
int net_listen (
int socket ,
int backlog
)
パラメータ
socket
ソケット番号を指定します。
backlog
接続待ちキューの深さを指定します。
0 から BSDAPI_BACKLOG_MAX までの範囲で指定してください。範囲外の値が指定された場合は、
エラーを返さず範囲内の値に補正されます。
ここで設定された数だけ、接続処理が保留されます。例えば 3 に設定した場合、同時に 5 箇所から
TCPSYN を受けると以下のように処理されます。
最初の TCPSYN ：接続処理し、後述する net_accept関数
を呼ぶことで接続が確立します。
2-4 番目の 3 つの
TCPSYN
：接続処理は行いますが、確立状態に移行せず、接続確立待ち状態として
保持されます。
5 番目の TCPSYN ：何も返送しません。その TCPSYN を無視します。
戻り値
正常終了した場合は、ソケット番号を返します。
エラーの場合は、-1 を返します。エラーの詳細は、net_getsockerr関数で取得してください。
説明
ソケットを TCP 着信待ち状態にします。