shutdown
Section: System Calls (2)
Updated: 2025-10-29
Index
JM Home Page
roff page
名前
shutdown - 全二重接続の一部を閉じる
ライブラリ
標準 C ライブラリ (libc,~-lc)
書式
#include <sys/socket.h>
int shutdown(int sockfd, int how);
説明
shutdown() は、 sockfd に関連づけられているソケットによる全二重接続 (full-duplex connection)
の一部または全てを閉じる。 how が SHUT_RD ならば、それ以降の受信を禁止する。 how が SHUT_WR
ならば、それ以降の送信を禁止する。 how が SHUT_RDWR ならば、それ以降の送受信を禁止する。
返り値
On success, zero is returned. On error, -1 is returned, and errno is set
to indicate the error.
エラー
- EBADF
-
sockfd が有効なファイルディスクリプターでない。
- EINVAL
-
how に無効な値が指定された (バグが参照)。
- ENOTCONN
-
指定されたソケットは接続されていない。
- ENOTSOCK
-
ファイルディスクリプター sockfd がソケットを参照していない。
標準規格
POSIX.1-2024.
歴史
POSIX.1-2001, 4.4BSD (4.2BSD で初めて登場した)。
注意
SHUT_RD, SHUT_WR, SHUT_RDWR の各定数 (それぞれ 0, 1, 2 の値を持つ) は
glibc-2.1.91 以降、 <sys/socket.h> で定義されている。
バグ
Checks for the validity of how are done in domain-specific code, and
before Linux 3.7 not all domains performed these checks. Most notably, UNIX
domain sockets simply ignored invalid values. This problem was fixed for
UNIX domain sockets in Linux 3.7.
関連項目
close(2), connect(2), socket(2), socket(7)
Index
- 名前
-
- ライブラリ
-
- 書式
-
- 説明
-
- 返り値
-
- エラー
-
- 標準規格
-
- 歴史
-
- 注意
-
- バグ
-
- 関連項目
-
This document was created by
man2html,
using the manual pages.