НАИМЕНОВАНИЕ

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

БИБЛИОТЕКА

Стандартная библиотека языка C (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 */


    /* Further padding bytes allowing for future expansion */
};

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

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). При корректным переданном указателе эти функции всегда выполняются без ошибок.

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).

Интерфейс	Атрибут	Значение
ntp_gettime(), ntp_gettimex()	Безвредность в нитях	MT-Safe

СТАНДАРТЫ

ntp_gettime(): NTP Kernel Application Program Interface.
ntp_gettimex(): GNU.

ИСТОРИЯ

ntp_gettime(): glibc 2.1.
ntp_gettimex(): glibc 2.12.

СМОТРИТЕ ТАКЖЕ

adjtimex(2), ntp_adjtime(3), time(7)

NTP "Kernel Application Program Interface"

ПЕРЕВОД

Русский перевод этой страницы руководства разработал(и) Alex Nik <rage.iz.me@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Yuri Kozlov <yuray@komyakino.ru>, Иван Павлов <pavia00@gmail.com> и Kirill Rekhov <krekhov.dev@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.