NTP_GETTIME(3)

ИМЯ
ntp_gettime, ntp_gettimex - возвращает параметры времени (интерфейс службы NTP)

ОБЗОР
#include <sys/timex.h>

int ntp_gettime(struct ntptimeval *ntv);

int ntp_gettimex(struct ntptimeval *ntv);

ОПИСАНИЕ
Эти функции возвращают информацию вызывающему через аргумент ntv, структуру следующего вида:

    struct ntptimeval {
        struct timeval time;        /* текущее время */
        long int maxerror;          /* максимальная ошибка */
        long int esterror;          /* расчётная ошибка */
        long int tai;               /* смещение TAI */
        /* байты-заполнители под будущее расширение */
    };

Поля этой структуры имеют следующее назначение:

time
    Текущее время, представляется структурой timeval:

        struct timeval {
            time_t      tv_sec;   /* кол-во секунд, начиная с Эпохи */
            suseconds_t tv_usec;  /* кол-во микросекунд */
        };

maxerror
    Максимальная ошибка, в микросекундах. Это значение может быть инициализировано ntp_adjtime(3), и периодически увеличивается (в Linux каждую секунду), но не переходит верхний порог (константа ядра NTP_PHASE_MAX, равная 16000).

esterror
    Расчётная ошибка, в микросекундах. Это значение может быть установлено с помощью ntp_adjtime(3) и содержит расчётную разницу между системными часами и настоящим временем. Данное значение не используется внутри ядра.

tai Смещение TAI (Atomic International Time, атомное международное время).

Функция ntp_gettime() возвращает структуру ntptimeval с заполненными полями time, maxerror и esterror.

Функция ntp_gettimex() выполняет тоже что и ntp_gettime() и дополнительно возвращает информацию в поле tai.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Возвращаемые значения ntp_gettime() и ntp_gettimex() такие же как у adjtimex(2). При корректным переданном указателе эти функции всегда выполняются без ошибок.

ВЕРСИИ
Функция ntp_gettime() доступна в glibc с версии 2.1. Функция ntp_gettimex() доступна в glibc с версии 2.12.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
ntp_gettime(), ntp_gettimex() | Безвредность в нитях | MT-Safe

СООТВЕТСТВИЕ СТАНДАРТАМ
Функция ntp_gettime() описана в интерфейсе NTP Kernel Application Program. Функция ntp_gettimex() является расширением GNU.

СМОТРИТЕ ТАКЖЕ
adjtimex(2) ntp_adjtime(3), time(7)

NTP "Kernel Application Program Interface" (http://www.slac.stanford.edu/comp/unix/package/rtems/src/ssrlApps/ntpNanoclock/api.htm)