adjtime(3) - wariua/manpages-ko GitHub Wiki

adjtime - 시스템 클럭 동기화를 위해 시간을 정정하기

#include <sys/time.h>

int adjtime(const struct timeval *delta, struct timeval *olddelta);

glibc 기능 확인 매크로 요건 (feature_test_macros(7) 참고):

adjtime():

glibc 2.19부터:

_DEFAULT_SOURCE

glibc 2.19 및 이전:

_BSD_SOURCE

adjtime() 함수는 (gettimeofday(2)가 반환하는) 시스템 클럭을 서서히 조정한다. 클럭 시간을 조정할 양을 delta가 가리키는 구조체로 지정한다. 그 구조체는 다음 형태이다.

struct timeval {
    time_t      tv_sec;     /* 초 */
    suseconds_t tv_usec;    /* 마이크로초 */
};

delta의 조정치가 양수이면 조정이 완료될 때까지 시스템 클럭 속도를 어떤 작은 비율만큼 올린다. (즉 매초마다 클럭 값에 작은 양의 시간을 더한다.) delta의 조정치가 음수이면 비슷한 방식으로 클럭 속도를 내린다.

앞선 adjtime() 호출의 클럭 조정이 이미 진행 중인 상태에서 adjtime() 호출이 이뤄지면서 뒤쪽 호출의 delta가 NULL이 아닌 경우에는 앞선 조정이 중단된다. 하지만 그 조정 중 이미 완료된 부분을 되돌리지는 않는다.

olddelta가 NULL이 아니면 가리키는 버퍼를 이용해 앞선 조정에서 아직 완료되지 않고 남은 시간 양을 반환한다.

성공 시 adjtime()은 0을 반환한다. 실패 시 -1을 반환하며 오류를 나타내도록 errno를 설정한다.

EINVAL

delta의 조정치가 허용 범위 밖이다.

EPERM

호출자에게 시간을 조정할 만한 특권이 없다. 리눅스에서는 CAP_SYS_TIME 역능이 필요하다.

이 절에서 사용하는 용어들에 대한 설명은 attributes(7)를 보라.

4.3BSD, 시스템 V.

adjtime()을 통해 클럭에 하는 조정은 클럭이 항상 단조 증가하게 하는 방식으로 이뤄진다. adjtime()을 써서 조정을 하면 시스템 시간이 앞이나 뒤로 갑자기 건너뛸 때 특정 응용들(가령 make(1))에 발생할 수 있는 문제들이 방지된다.

adjtime()은 시스템 시간을 약간 조정하는 데 쓰기 위한 것이다. 대부분의 시스템에서는 delta에 지정할 수 있는 조정치에 제한을 둔다. glibc 구현에서는 delta가 (INT_MAX / 1000000 - 2) 이하이고 (INT_MIN / 1000000 + 2) 이상이어야 한다. (i386에서 각각 2145초 및 -2145초이다.)

오래된 버그로 인해 delta를 NULL로 지정한 경우에 남아 있는 클럭 조정치에 대한 유효한 정보를 olddelta로 전혀 반환하지 않는다. (이 경우에 원래 adjtime()은 남아 있는 클럭 조정치를 변경 없이 반환해야 한다.) glibc 2.8 및 이후와 리눅스 커널 2.6.26 및 이후를 쓰는 시스템에서는 이 버그가 수정돼 있다.

adjtimex(2), gettimeofday(2), time(7)

2017-09-15