C 언어에서 초와 나노초로 지정한 시간 동안 실행을 멈춘다.

인수와 옵션의 의미

nanosleep()은 상대 대기 요청과 중단 시 남은 시간을 받을 주소를 받는다.
clock_nanosleep()은 시계와 flags도 받고 TIMER_ABSTIME으로 절대 마감 시각을 지정할 수 있다.
clock_nanosleep()은 오류 번호 자체를 반환하는 점이 다르다.
sleep()은 초 단위이며 시그널로 중단되면 남은 초를 반환한다.
EINTR 재시도와 주기 드리프트 정책을 구분한다.

호출 흐름 예제

아래는 함수가 쓰이는 지점을 보여 주는 부분 코드다.
파일 번호와 소켓과 공유 객체 등은 설명에 맞게 먼저 준비해야 한다.
선언만 복사해 새 C 파일 전체가 완성되는 예제는 아니다.

struct timespec delay = {.tv_sec = 0, .tv_nsec = 100000000};
struct timespec remaining;
int rc = nanosleep(&delay, &remaining);

100000000나노초는 0.1초다.
스케줄링 때문에 요청 시간보다 늦게 깨어날 수 있으며 실시간 정확도를 보장하는 타이머가 아니다.

#include <time.h>

int nanosleep(const struct timespec *req, struct timespec * rem);

반환값과 실패 처리

정상 대기 완료는 0, 중단이나 오류는 -1이다.
시그널 중단은 errno의 EINTR로 구분한다.

시그널로 중단되면 rem에 남은 시간이 들어갈 수 있다.
반복 주기마다 상대 대기를 누적하면 오차가 쌓이므로 일정 주기 작업은 절대 시각 대기도 비교한다.

참고: nanosleep — Linux man-pages