GETPEERNAME(2)

명칭
getpeername - 접속된 피어 (통신 상대)의 이름의 취득

프로그램 라이브러리
libc

서식
<sys/types.h> <sys/socket.h> int getpeername(int s, struct sockaddr *name, socklen_t *namelen)

해설
getpeername() (은)는, 소켓 s 에 접속된 피어 (통신 상대)의 이름을 돌려줍니다. namelen 파라미터에는, name 하지만 가리키는 공간의 양을 나타내는 값을 넣어 둘 필요가 있습니다. 돌아올 때에, 이것에는 돌려주어진 이름의 실제의 사이즈 (바이트 단위)가 넣을 수 있습니다. 준비된 버퍼가 너무 작은 경우, 이름은 잘라 버릴 수 있습니다.

반환값

에러
이후의 경우를 제외해 호출은 처리에 성공합니다.

[EBADF]
    인수 s 하지만 유효한 기술자가 아닙니다.

[ECONNRESET]
    접속이 피어에 의해 리셋트 되었습니다.

[ENOTSOCK]
    인수 s (은)는 소켓은 아니고 파일입니다.

[ENOTCONN]
    소켓이 접속되고 있지 않습니다.

[ENOBUFS]
    조작을 실행하기 위한 충분한 리소스가 시스템에 없습니다.

[EFAULT]
    name 파라미터는, 프로세스의 address 공간의 유효한 area의 범위외를 가리키고 있습니다.

관련 항목
accept(2), bind(2), getsockname(2), socket(2)

역사
getpeername() 함수는 4.2BSD 그리고 등장했습니다.