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

       adjtime - корректировка времени для синхронизации с системными часами

БИБЛИОТЕКА

       Стандартная библиотека языка C (libc, -lc)

ОБЗОР

       #include <sys/time.h>

       int adjtime(const struct timeval *delta, struct timeval *olddelta);

   Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

       adjtime():
           Начиная с glibc 2.19:
               _DEFAULT_SOURCE
           В версии glibc 2.19 и более ранних:
               _BSD_SOURCE

ОПИСАНИЕ

       Функция  adjtime()  постепенно  подстраивает  системные  часы  (значение  которых можно получить функцией
       gettimeofday(2)). Количество времени, на которое будут подстроены часы, указано в структуре,  на  которую
       указывает delta. Данная структура имеет следующий формат:

           struct timeval {
               time_t      tv_sec;     /* секунды */
               suseconds_t tv_usec;    /* микросекунды */
           };

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

       Если  подстройка системных часов по adjtime() уже производится во время второго вызова adjtime(), и delta
       второго вызова не равна NULL, то более ранняя подстройка останавливается, однако  уже  завершённая  часть
       подстройки не отменяется.

       Если  значение  olddelta  не  равно  NULL, то буфер, на который оно указывает, будет содержать количество
       оставшегося после предыдущей незавершенной подстройки времени.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

       При успешном выполнении adjtime() возвращает 0. При  ошибке  возвращается  -1,  errno  устанавливается  в
       соответствующее значение.

ОШИБКИ

       EINVAL Подстройка в delta находится вне разрешённого диапазона.

       EPERM  Вызывающий  не  обладает  нужными привилегиями для подстройки времени. В Linux для этого требуется
              мандат CAP_SYS_TIME.

АТРИБУТЫ

       Описание терминов данного раздела смотрите в attributes(7).
       ┌─────────────────────────────────────────────────────────────────────┬──────────────────────┬──────────┐
       │ Интерфейс                                                           │ Атрибут              │ Значение │
       ├─────────────────────────────────────────────────────────────────────┼──────────────────────┼──────────┤
       │ adjtime()                                                           │ Безвредность в нитях │ MT-Safe  │
       └─────────────────────────────────────────────────────────────────────┴──────────────────────┴──────────┘

СТАНДАРТЫ

       Отсутствуют.

ИСТОРИЯ

       4.3BSD, System V.

ПРИМЕЧАНИЯ

       The adjustment that adjtime()  makes to the clock is carried out in such  a  manner  that  the  clock  is
       always monotonically increasing.  Using adjtime()  to adjust the time prevents the problems that could be
       caused for certain applications (e.g., make(1))  by abrupt positive or negative jumps in the system time.

       Функция  adjtime()  предназначена  для  использования  подстроек  системных  часов  малыми  значениями. В
       большинстве систем есть ограничение для времени подстройки, которое можно указывать в delta. В реализации
       glibc значение delta должно быть меньше либо равно (INT_MAX / 1000000 - 2) и больше либо равно (INT_MIN /
       1000000 + 2) (для i386 эти значения равны -2145 и 2145 секунд, соответственно).

ОШИБКИ

       Была застарелая ошибка, при который если delta была определена как  NULL,  то  информация  по  предыдущей
       подстройке  в  olddelta не возвращалась (в данном случае adjtime() должна возвращать последнюю подстройку
       часов без изменений). Эта ошибка была исправлена в системах с glibc 2.8 и выше и  ядром  Linux  2.6.26  и
       выше.

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

       adjtimex(2), gettimeofday(2), time(7)

ПЕРЕВОД

       Русский  перевод  этой страницы руководства разработал(и) Dmitry Bolkhovskikh <d20052005@yandex.ru>, Yuri
       Kozlov <yuray@komyakino.ru> и 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 г.                                       adjtime(3)