.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) 2016 by Michael Kerrisk .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ntp_gettime 3 "15 декабря 2022 г." "Linux man\-pages 6.03" .SH ИМЯ ntp_gettime, ntp_gettimex \- возвращает параметры времени (интерфейс службы NTP) .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP .PP \fBint ntp_gettime(struct ntptimeval *\fP\fIntv\fP\fB);\fP \fBint ntp_gettimex(struct ntptimeval *\fP\fIntv\fP\fB);\fP .fi .SH ОПИСАНИЕ Эти функции возвращают информацию вызывающему через аргумент \fIntv\fP, структуру следующего вида: .PP .in +4n .EX struct ntptimeval { struct timeval time; /* Current time */ long maxerror; /* Maximum error */ long esterror; /* Estimated error */ long tai; /* TAI offset */ /* байты\-заполнители под будущее расширение */ }; .EE .in .PP Поля этой структуры имеют следующее назначение: .TP \fItime\fP Текущее время, представляется структурой \fItimeval\fP: .IP .in +4n .EX struct timeval { time_t tv_sec; /* кол\-во секунд, начиная с Эпохи */ suseconds_t tv_usec; /* кол\-во микросекунд */ }; .EE .in .TP \fImaxerror\fP Максимальная ошибка, в микросекундах. Это значение может быть инициализировано \fBntp_adjtime\fP(3), и периодически увеличивается (в Linux каждую секунду), но не переходит верхний порог (константа ядра \fBNTP_PHASE_MAX\fP, равная 16000). .TP \fIesterror\fP Расчётная ошибка, в микросекундах. Это значение может быть установлено с помощью \fBntp_adjtime\fP(3) и содержит расчётную разницу между системными часами и настоящим временем. Данное значение не используется внутри ядра. .TP \fItai\fP Смещение TAI (Atomic International Time, атомное международное время). .PP Функция \fBntp_gettime\fP() возвращает структуру \fIntptimeval\fP с заполненными полями \fItime\fP, \fImaxerror\fP и \fIesterror\fP. .PP Функция \fBntp_gettimex\fP() выполняет тоже что и \fBntp_gettime\fP() и дополнительно возвращает информацию в поле \fItai\fP. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" .\" FIXME . the info page incorrectly describes the return values. Возвращаемые значения \fBntp_gettime\fP() и \fBntp_gettimex\fP() такие же как у \fBadjtimex\fP(2). При корректным переданном указателе эти функции всегда выполняются без ошибок. .SH ВЕРСИИ Функция \fBntp_gettime\fP() доступна в glibc с версии 2.1. Функция \fBntp_gettimex\fP() доступна в glibc с версии 2.12. .SH АТРИБУТЫ Описание терминов данного раздела смотрите в \fBattributes\fP(7). .ad l .nh .TS allbox; lbx lb lb l l l. Интерфейс Атрибут Значение T{ \fBntp_gettime\fP(), \fBntp_gettimex\fP() T} Безвредность в нитях MT\-Safe .TE .hy .ad .sp 1 .SH СТАНДАРТЫ Функция \fBntp_gettime\fP() описана в интерфейсе NTP Kernel Application Program. Функция \fBntp_gettimex\fP() является расширением GNU. .SH "СМ. ТАКЖЕ" \fBadjtimex\fP(2), \fBntp_adjtime\fP(3), \fBtime\fP(7) .PP .ad l .UR http://www.slac.stanford.edu/comp/unix/\:package/\:rtems/\:src/\:ssrlApps/\:ntpNanoclock/\:api.htm NTP "Kernel Application Program Interface" .UE .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан Alex Nik , Azamat Hackimov , Dmitry Bolkhovskikh , Yuri Kozlov и Иван Павлов . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .