rtc

ИМЯ

СИНТАКСИС

#include <linux/rtc.h>

int ioctl(fd, RTC_request, param);

ОПИСАНИЕ

RTC и системные часы

Назначение RTC

•

при каждом обновлении часов (т.е. раз в секунду);

•

через периодические интервалы с частотой, значение которой может быть любой степенью 2 в диапазоне от 2 Гц до 8192 Гц;

•

по достижению указанного времени будильника.

_ioctl(2)">81_ioctl(2)">Интерфейс ioctl(2)

RTC_RD_TIME

Получить время RTC в виде следующей структуры:

struct rtc_time {
    int tm_sec;
    int tm_min;
    int tm_hour;
    int tm_mday;
    int tm_mon;
    int tm_year;
    int tm_wday;     /* не используется */
    int tm_yday;     /* не используется */
    int tm_isdst;    /* не используется */
};
    

Поля структуры имеют те же значения и диапазоны что и у структуры tm, описанной в gmtime(3). Указатель на эту структуру должен передаваться в третьем аргументе ioctl(2).

RTC_SET_TIME

Установить время RTC в значение, заданное в структуре rtc_time, на которую указывает третий аргумент ioctl(2). Для установки времени RTC процесс должен иметь права (т.е., мандат CAP_SYS_TIME).

RTC_ALM_READ, RTC_ALM_SET

Получить и установить время будильника, если он поддерживается RTC. Прерывание будильника должно быть включено или выключено отдельно с помощью запросов RTC_AIE_ON, RTC_AIE_OFF. Третий аргумент ioctl(2) является указателем на структуру rtc_time. В структуре используются только поля tm_sec, tm_min и tm_hour.

RTC_IRQP_READ, RTC_IRQP_SET

Получить и установить частоту периодических прерываний, если они поддерживаются RTC. Периодическое прерывание должно быть включено или выключено отдельно с помощью запросов RTC_PIE_ON, RTC_PIE_OFF. Третий аргумент ioctl(2) имеет тип unsigned long * или unsigned long, соответственно. Значение задаёт частоту прерываний в секунду. Можно указывать частоты кратны степени 2 в диапазоне от 2 до 8192. Только привилегированный процесс (т.е., имеющий мандат CAP_SYS_RESOURCE) может устанавливать частоты выше значения, указанного в /proc/sys/dev/rtc/max-user-freq. (По умолчанию в этом файле содержится значение 64.)

RTC_AIE_ON, RTC_AIE_OFF

Включить или выключить прерывание от будильника, если RTC поддерживает будильники. Третий аргумент ioctl(2) игнорируется.

RTC_UIE_ON, RTC_UIE_OFF

Включить или выключить прерывание при каждом обновлении часов, если RTC поддерживает создание прерываний один раз в секунду. Третий аргумент ioctl(2) игнорируется.

RTC_PIE_ON, RTC_PIE_OFF

Включить или выключить периодическое прерывание, если RTC поддерживает периодические прерывания. Третий аргумент ioctl(2) игнорируется. Только привилегированный процесс (т.е., имеющий мандат CAP_SYS_RESOURCE) может устанавливать частоты выше значения, указанного в /proc/sys/dev/rtc/max-user-freq.

RTC_EPOCH_READ, RTC_EPOCH_SET

В многих RTC год кодируется в 8-битном регистре, значение которого может учитываться как 8-битное двоичное число или как число в двоично-десятичном коде (BCD). В обоих случаях, число учитывается относительно начала эпохи RTC. Эпоха RTC на большинстве систем начинается с 1900 года, но на Alpha и MIPS также она может начинаться с 1952, 1980 или 2000 года, в зависимости от значения годового регистра RTC. С некоторыми RTC эти операции можно использовать для чтения или установки эпохи RTC, соответственно. Третий аргумент ioctl(2) имеет тип unsigned long * или unsigned long, соответственно, а возвращаемое значение (или назначаемое) является эпохой. Чтобы установить эпоху RTC процесс должен быть привилегированным (т.е., иметь мандат CAP_SYS_TIME).

RTC_WKALM_RD, RTC_WKALM_SET

Некоторые RTC поддерживают более универсальный интерфейс будильника, в котором эти ioctl используются для чтения и записи времени будильника RTC (соответственно) с помощью структуры:

struct rtc_wkalrm {
    unsigned char enabled;
    unsigned char pending;
    struct rtc_time time;
};

Флаг enabled используется для включения или отключения прерывания будильника, или для чтения его текущего состояния; когда совершаются данные вызовы RTC_AIE_ON и RTC_AIE_OFF не используются. Флаг pending используется RTC_WKALM_RD для сообщения об ожидающем прерывании (хотя это практически бесполезно в Linux, за исключением RTC, управляемого микропрограммой EFI). Поле time используется RTC_ALM_READ и RTC_ALM_SET, но поля tm_mday, tm_mon и tm_year также учитываются. Указатель на эту структуру должен передаваться в третьем аргументе ioctl(2).

ФАЙЛЫ

/dev/rtc, /dev/rtc0, /dev/rtc1, и тд.

Файлы специального символьного устройства RTC.

/proc/driver/rtc

состояние (первого) RTC.

ЗАМЕЧАНИЯ

СМ. ТАКЖЕ

ПЕРЕВОД