ИМЯ

       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" ⟨http://www.slac.stanford.edu/comp/unix/
       package/rtems/src/ssrlApps/ntpNanoclock/api.htm⟩

ПЕРЕВОД

       Русский перевод этой страницы руководства был сделан 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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ или более позднюю, чтобы
       узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

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