MAN adjtimex 2

Материал из Gentoo Linux Wiki

Перейти к: навигация, поиск


Вернуться в раздел мануалов


Это - статья, добавленная автоматически, при помощие специальной программы-робота. Пожалуйста убедитесь что статья добавлена коррекно, исправьте её если это потребуется и уберите пометку {{Bot added}}].

Содержание

[править] Имя

adjtimex - тонкая настройка часов в ядре

[править] Обзор

#include <sys/timex.h>
int adjtimex(struct timex * buf );

[править] Описание

Linux использует для подстройки часов алгоритм David L. Mills (см. RFC 1305). Системный вызов adjtimex читает и (необязательно) устанавливает параметры подстройки для этого алгоритма. В качестве аргумента используется указатель на структуру timex , по значениям в полях которой осуществяется обновление параметров ядра и в этой же структуре происходит возврат текущих значений параметров ядра. Данная структура описана так: 


struct timex {
   int modes;           /* выбор режима */
   long offset;         /* смещение по времени (usec) */
   long freq;           /* частота смещения (scaled ppm) */
   long maxerror;       /* максимальная ошибка (usec) */
   long esterror;       /* ожидаемая ошибка (usec) */
   int status;          /* команда/состояние для часов */
   long constant;       /* временная константа pll */
   long precision;      /* точность часов (usec) (только чтение) */
   long tolerance;      /* clock frequency tolerance (ppm)
                           (read only) */
   struct timeval time; /* текущее время (только чтение) */
   long tick;           /* usecs between clock ticks */
};


Поле modes определяет какие параметры, если это необходимо, устанавливаются. Значение поля может содержать комбинации

битовых масок, значения которых следующие:


  1. define ADJ_OFFSET 0x0001 /* смещение времениtime offset */
  2. define ADJ_FREQUENCY 0x0002 /* частота смещения */
  3. define ADJ_MAXERROR 0x0004 /* максимальная ошибка времени */
  4. define ADJ_ESTERROR 0x0008 /* ожидаемая ошибка времени */
  5. define ADJ_STATUS 0x0010 /* состояние часов */
  6. define ADJ_TIMECONST 0x0020 /* временная константа pll */
  7. define ADJ_TICK 0x4000 /* значение тика */
  8. define ADJ_OFFSET_SINGLESHOT 0x8001 /* old-fashioned adjtime */


Обычные пользователи могут писать в mode . только ноль. Только суперпользователь root может устанавливать любые параметры.


12v

[править] Возвращаемое значение

В случае успеха, adjtimex возвращает состояние часов:


  1. define TIME_OK 0 /* часы синхронизированы */
  2. define TIME_INS 1 /* вставлено секундный прыжок */
  3. define TIME_DEL 2 /* удалён секундный прыжок */
  4. define TIME_OOP 3 /* выполняется секундный прыжок */
  5. define TIME_WAIT 4 /* секундный прыжок осуществлён */
  6. define TIME_BAD 5 /* часы не синхронизированы */


В случае неудачи, adjtimex возвращает -1 и устанавливает errno .

[править] Ошибки

EFAULT buf не является указателем на доступную для записи область памяти.

EPERM buf.mode не ноль, а пользователь не является суперпользователем.

EINVAL Попытка установить buf.offset в значение, выходящее за диапазон от -131071 до +131071, или установить buf.status в значение отличное от перечисленных выше, или установить buf.tick в значение за пределами диапазона от

900000/ HZ до

1100000/ HZ , где HZ - это частота прерываний системного таймера.

[править] Совместимость со стандартами

adjtimex - это специфичный для Linux вызов и он не должен использоваться в программах, которые пишуться как переносимые. Существует похожий, но более общий для разных Unix систем вызов adjtime в SVr4.

[править] Смотри также

settimeofday (2)

[править] Перевод

Перевёл с английского Виктор Вислобоков <corochoone@perm.ru> 2003

[править] Комментарии к man файлу

Hey Emacs! This file is -*- nroff -*- source.

Copyright (c) 1995 Michael Chastain (mec@shell.portal.com), 15 April 1995.

This is free documentation; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of
the License, or (at your option) any later version.

The GNU General Public License's references to "object code"
and "executables" are to be interpreted as the output of any
document formatting or typesetting system, including
intermediate and printed output.

This manual is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public
License along with this manual; if not, write to the Free
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
USA.

Modified Fri Jan 31 16:11:17 1997 by Eric S. Raymond <esr@thyrsus.com>
Modified Wed Jul 30 14:25:16 1997 by Paul Slootman <paul@wurtel.demon.nl>

Дата последней коррекции перевода 08.12.2003
Перевод с английского сделал Виктор Вислобоков <corochoone@perm.ru>
http://www.linuxshare.ru/projects/trans/mans.html

Источник — «http://ru.gentoo-wiki.com/MAN_adjtimex_2»
Личные инструменты