closesocket

closesocket 함수는 윈도우즈 소켓 시스템에 할당된 socket과 관련된 리소스를 해제 하는 함수입니다.

int closesocket (
    SOCKET s
);

 

Parameters

s
[입력] 닫을 소켓의 기술자(descriptor)

 

Remarks

프로그램이 소켓을 더 이상 사용하지 않을 경우 closesocket 함수를 호출하여 소켓 기술자와 관련된 자원을 반납 할 수 있습니다. closesocket 함수가 반환된 후에 소켓 기술자는 더 이상 유효하지 않게 됩니다. 즉, 닫혀진 소켓 기술자에 대해 소켓 함수가 호출될 경우 에러가 발생 할 것입니다.

비동기적으로 전송/수신 연산을 하는 함수 (오버랩 소켓에 사용되는 WSASend/WSASendTo/WSARecv/WSARecvFrom)들은 closesocket 함수에 의해서 취소됩니다. 이러한 오버랩 연산을 하는 것들은 WSA_OPERATION_ABORTED 라는 에러상태로 실패하게 되는 거죠.

어플리케이션에서 socket 함수로 윈도우즈 소켓을 얻었다면, 반드시 closesocket 함수를 호출 해서 할당 되었던 소켓 리소스를 반환 해야 합니다.

closesocket 함수의 체계(함수가 바로 리턴되는냐 마느냐)는 SO_LINGER 과, SO_DONTLINGER 와 같은 소켓 옵션에 의해서 영향을 받습니다. 아래의 표는 이러한 것들을 요약한 것입니다. 소켓 옵션에 대해 더 자세히 알고 싶으면, getsockopt 부분과 setsockopt 부분을 참고 하시면 됩니다.

          옵션      타임아웃간격            닫힘유형             닫힘대기
 SO_DONTLINGER    상관없음(이론상)    우아(graceful)한 닫힘          대기하지 않음
    SO_LINGER             0       경직된(Hard) 닫힘          대기하지 않음
    SO_LINGER          0 이아님    우아(graceful)한 닫힘              대기 함

만약 SO_LINGER 가 타임아웃 간격을 0으로 셋팅한다면 (즉, LINGER 구조체의 l_onoff 멤버가 0이 아니고, l_linger 가 0인경우), closesocket 함수는 아직 보내지지 않은 데이터가 큐에 남아있더라도 블록킹 상태로 빠지지 않습니다. 이러한 것은 "경직된(hard)" 또는 "중단된(abortive)" 닫힘(close) 라고 합니다. 이러한 경우 소켓의 가상 회로망이 즉시 리셋 되므로 전송되지 않은 데이터는 손실되게 됩니다. 연결의 원격 종단에서 recv 함수가 시도될 경우 WSAECONNRESET 에러를 반환합니다.

만약 SO_LINGER 가 블록킹(동기) 소켓에서 타임아웃 간격을 0 이 아닌 값으로 셋팅한다면, closesocket 함수는 타임아웃 되는시간동안 남아있는 데이터를 보낼 때 까지 소켓은 블록킹 상태가 됩니다. 이러한 호출을 우아한 단절(graceful disconnect) 이라고 합니다. 만약 모든 데이터를 보내기 전에 타임아웃 시간을 모두다 소비한다면, 윈도우즈 소켓은 closesocket 함수가 리턴하기전에 접속을 종료하게 됩니다.

비동기(넌블럭킹) 소켓에서 0이 아닌 타임아웃 간격을 가진 SO_LINGER를 설정하는 것은 좋은 방식이 아닙니다. 이러한 경우에 closesocket 함수는 닫힘 연산이 즉시 완료될 수 없다면, 에러와 함께 WSAEWOULDBLOCK 에러코드를 발생할 것입니다. closesocket 함수가 WSAEWOULDBLOCK 에러코드를 내면서 실패할 경우 소켓 핸들은 여전히 올바를 핸들이되고 접속해제는 완벽하게 이루어지지 않습니다. 어플리케이션은 소켓을 닫기위해서 다시 closesocket을 호출해야만 합니다. 만약 SO_DONTLINGER 가 LINGER 구조체의 멤버중 l_onoff 멤버를 0으로 셋팅하여 스트림 소켓에 셋팅 되었다면, 함수는 바로 리턴되고, 소켓이 블록킹 이건 아니건 간에 WSAEWOULDBLOCK 에러코드를 발생하지 않습니다. 하지만, 기본적이 소켓이 닫히기 전에 전송을 위해서 큐에 저장된 데이터는 보내졌을 것입니다.(참~ 무책임한 말이져 ㅠㅠ)  이러한 방식 또한 우아한 단절(graceful disconnect)이라고 합니다. 이러한 방식은 가장 기본적인 동작이죠, SO_DONTLINGER 는 기본치로 셋팅 되어 있습니다.

Note : 접속상태에서 데이터가 보내졌는지 수신되었는지 확인 하려면, 어플리케이션은 closesocket함수를 호출하기전에 shutdown 함수를 호출해야 합니다. (더많은 정보를 얻고자 한다면, Graceful shutdown, linger option and socket closure 요기를 참고하세요)

closesocket 함수의 동작에 대해서 요약 해 보았습니다.

Windows CE: Windows CE 프로그래밍 에서는 WSAEINTR 에러코드를 지원되지 않습니다.

IrSocket 에서의 구현:

Return Values

에러가 없을 경우 closesocket 함수는 0을 리턴합니다. 에러가 발생 했을 경우 SOCKET_ERROR 에러코드를 리턴합니다. 그리고 WSAGetLastError 함수를 호출해서 특정한 에러코드를 받을 수 있습니다.

 

Error Codes

WSANOTINITIALISED

이 함수를 사용하기 전에 성공적인 WSAStartup 함수의 호출이 없었습니다.
WSAENETDOWN

네트웍 서브 시스템에 에러가 발생했습니다.
WSAENOTSOCK 기술자(descriptor)가 소켓 기술자가 아닙니다.
WSAEINPROGRESS

블럭킹 윈속 v1.1 이 현재 진행 중이거나, 서비스 프로바이더가 콜백 함수를 여전히 처리하고 있습니다.
WSAEINTR 블럭킹 윈속 v1.1 이 WSACancelBlockingCall 함수에서 취소되었습니다
WSAEWOULDBLOCK 비동기 소켓이고, SO_LINGER 가 0이 아닌 타임아웃 간격으로 셋팅되어 있는 경우

 

QuickInfo

Windows NT : 사용가능
Windows : 사용가능
Windows CE : 버젼 1.0 그리고 그이후의 버젼에서 사용가능
Header :
          Win16/32 : winsock.h
          Win32-II : winsock2.h
Import Library :
          Win16 : winsock.lib
          Win32 : wsock32.lib
          Win32-II : ws2_32.lib

See Also

overview, accept, ioctlsocket, setsockopt, socket, WSAAsyncSelect, WSADuplicateSocket