ntp_gettime

ИМЯ

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

LIBRARY

Standard C library ( libc, -lc)

СИНТАКСИС

#include <sys/timex.h>

int ntp_gettime(struct ntptimeval *ntv);
int ntp_gettimex(struct ntptimeval *ntv);

ОПИСАНИЕ

Эти функции возвращают информацию вызывающему через аргумент ntv, структуру следующего вида:

struct ntptimeval {
    struct timeval time;    /* Current time */
    long maxerror;          /* Maximum error */
    long esterror;          /* Estimated error */
    long tai;               /* TAI offset */

    /* байты-заполнители под будущее расширение */
};

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

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"

ПЕРЕВОД

Русский перевод этой страницы руководства был сделан Alex Nik <[email protected]>, Azamat Hackimov <[email protected]>, Dmitry Bolkhovskikh <[email protected]>, Yuri Kozlov <[email protected]> и Иван Павлов <[email protected]> Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на [email protected]