Введение в QNX/Neutrino 2. Руководство по программированию приложений реального времени в QNX Realtime Platform

 RESMGR_OCB_T *ocb)

Классификация: Функция ввода/вывода

Обработчик по умолчанию: Нет

Вспомогательные функции: iofunc_space_verify

Клиентская функция: chsize, fcntl, ftruncate, ltrunc

Сообщение _IO_SPACE

Структура данных:

struct _io_space {
 uint16_t type;
 uint16_t combine_len;
 uint16_t subtype;
 short whence;
 uint64_t start;
 uint64_t len;
};

typedef union {
 struct _io_space i;
 uint64_t o;
} io_space_t;

Описание: Эта функция применяется для выделения или освобождения занимаемого ресурсом пространства. Параметр subtype («подтип») указывает на то, следует ли это пространство выделить (если равен F_ALLOCSP) или освободить (если равен F_FREESP). Комбинация параметров whence («откуда») и start («начало») указывает, где следует начать выделение/ освобождение; элемент len указывает размер операции.

Возвращает: Число байтов (размер ресурса), посредством вспомогательного макроса _RESMGR_STATUS.

io_stat

int io_stat(resmgr_context_t *ctp, io_stat_t *msg,
 RESMGR_OCB_T *ocb)

Классификация: Функция ввода/вывода

Обработчик по умолчанию: iofunc_stat_default

Вспомогательные функции: iofunc_stat

Клиентская функция: stat, lstat, fstat

Сообщения: _IO_STAT

Структура данных:

struct _io_stat {
 uint16_t type;
 uint16_t combine_len;
 uint32_t zero;
};

typedef union (
 struct _io_stat i;
 struct stat o;
} io_stat_t;

Описание: Обрабатывает сообщение, запрашивающее информацию о ресурсе, связанном с переданным OCB. Заметьте, что атрибутная запись содержит всю информацию, необходимую для выполнения запроса stat. Вспомогательная функция iofunc_stat заполняет структуру struct stat, базированную на атрибутной записи. Эта вспомогательная функция также изменяет сохраненные элементы dev/rdev так, чтобы они были уникальны с точки зрения единичного узла (это используется для выполнения вызовов stat в отношении файлов по сети). Писать этот обработчик самостоятельно особого смысла нет.

Возвращает: Код завершения, при помощи вспомогательного макроса _RESMGR_STATUS, и структуру struct stat — в ответном сообщении.

io_sync

int io_sync(resmgr_context_t *ctp, io_sync_t *msg,
 RESMGR_OCB_T *ocb)

Классификация: Функция ввода/вывода

Обработчик по умолчанию: iofunc_sync_default

Вспомогательные функции: iofunc_sync_verify, iofunc_sync

Клиентская функция: fsync, fdatasync

Сообщения: _IO_SYNC

Структура данных:

struct _io_sync {
 uint16_t type;
 uint16_t сombine_len;
 uint32_t flag;
};

typedef union {
 struct _io_sync i;
} io_sync_t;

Описание: Это точка входа команды flush (синхронизация носителя информации с буферами — например, диска с дисковым кэшем — прим. ред.). Вспомогательная функция iofunc_sync принимает поле flag входного сообщения и возвращает одно из следующих значений, которые указывают, какие действия ваш администратор ресурсов должен выполнить:

• 0 — не делать ничего;

• O_SYNC — все, что связано с файлом (включая содержимое файла, элементы каталогов, индексные дескрипторы (inodes), и т.д.) должно присутствовать на носителе и должно быть восстанавливаемым с него.

• O_DSYNC — присутствовать на носителе и быть восстанавливаемыми с него должны только данные файла.

Отметим, что эта функция будет вызываться только в том случае, если вы согласились поддерживать функцию sync, установив соответствующий флаг в записи точки монтирования.

Возвращает: Код завершения, при помощи вспомогательного макроса _RESMGR_STATUS.

io_umount

int io_umount(resmgr_context_t *ctp, void *msg,
 RESMGR_OCB_T *ocb)

Данная функция зарезервирована QSSL для будущего использования. Вам следует инициализировать таблицу функций ввода/вывода, используя iofunc_func_init, и не изменять данную точку входа.