GETPEERNAME
Section: System Calls (2)
索引
jman
BSD mandoc
索引
名称
getpeername
- 接続されたピア (通信相手) の名前の取得
索引
ライブラリ
Lb libc
索引
書式
In sys/types.h
In sys/socket.h
Ft int
Fn getpeername int s struct sockaddr * restrict name socklen_t * restrict namelen
索引
解説
Fn getpeername
システムコールは、ソケット
Fa s
に接続されたピア (通信相手) の名前を返します。
Fa namelen
引数には、
Fa name
が指す空間の大きさを示す値を入れておく必要があります。
戻る時に、これには返された名前の
実際のサイズ (バイト単位) が入れられます。
準備されたバッファが小さすぎる場合、名前は切り捨てられます。
索引
戻り値
Rv -std getpeername
索引
エラー
以降の場合を除いて呼び出しは処理に成功します:
- Bq Er EBADF
-
引数
Fa s
が有効な記述子ではありません。
- Bq Er ECONNRESET
-
接続がピアによってリセットされました。
- Bq Er ENOTSOCK
-
引数
Fa s
はソケットではなくファイルです。
- Bq Er ENOTCONN
-
ソケットが接続されていません。
- Bq Er ENOBUFS
-
操作を実行するための十分なリソースがシステムにありません。
- Bq Er EFAULT
-
Fa name
パラメータは、プロセスのアドレス空間の有効な領域の範囲外を指しています。
索引
関連項目
accept(2),
bind(2),
getsockname(2),
socket(2)
索引
歴史
Fn getpeername
システムコールは
BSD 4.2
で登場しました。
索引
Index
- 名称
-
- ライブラリ
-
- 書式
-
- 解説
-
- 戻り値
-
- エラー
-
- 関連項目
-
- 歴史
-
Time: 07:06:26 GMT, January 12, 2009