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

       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 или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

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

Справочные страницы Linux 6.9.1                   2 мая 2024 г.                                   ntp_gettime(3)