ИМЯ

       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 <rage.iz.me@gmail.com>, Azamat Hackimov
       <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Yuri Kozlov <yuray@komyakino.ru>
       и Иван Павлов <pavia00@gmail.com>

       Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3
       или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

       Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо
       на man-pages-ru-talks@lists.sourceforge.net.

Linux man-pages 6.03                           15 декабря 2022 г.                                 ntp_gettime(3)