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

 RESMGR_OCB_T *ocb)

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

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

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

Клиентская функция: chmod, fchmod

Сообщения: _IO_CHMOD

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

struct _io_chmod {
 uint16_t type;
 uint16_t combine_len;
 mode_t mode;
};

typedef union {
 struct _io_chmod i;
} io_chmod_t;

Описание: Отвечает за изменение режима доступа к ресурсу, указанному в переданном ей параметре ocb, в значение, содержащееся в поле сообщения mode.

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

io_chown

int io_chown(resmgr_context_t *ctp, io_chown_t *msg,
 RESMGR_OCB_T *ocb)

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

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

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

Клиентская функция: chown, fchown

Сообщения: _IO_CHOWN

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

struct _io_chown {
 uint16_t type;
 uint16_t combine_len;
 int32_t gid;
 int32_t uid;
};

typedef union {
 struct _io_chown i;
} io_chown_t;

Описание: Ответственна за изменение полей идентификатора пользователя и группы для ресурса, указанному в переданном ей параметре ocb, соответственно в значения uid и gid. Отметим, что чтобы узнать, позволяет ли данная файловая система выполнять chown кому-либо, кроме суперпользователя (root), надо проверить запись точки монтирования на предмет флага IOFUNC_PC_CHOWN_RESTRICTED, а также поле flags в OCB.

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

io_close_dup

int io_close_dup(resmgr_context_t *ctp, io_close_t *msg,
 RESMGR_OCB_T *ocb)

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

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

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

Клиентская функция. close, fclose

Сообщения: _IO_CLOSE_DUP

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

struct _io_close {
 uint16_t type;
 uint16_t combine_len;
};

typedef union {
 struct _io_close i;
} io_close_t;

Описание: Это реальный обработчик клиентских вызовов close и fclose. Отметим, что вам почти никогда не придется переназначать эту функцию; оставляйте в таблице функций ввода/вывода значение iofunc_close_dup_default. Причиной этому служит то, что базовый уровень библиотеки отслеживает число сообщений open, dup и close, выданных по каждому OCB, и синтезирует вызов io_close_ocb (см. ниже) после получения для данного OCB последнего сообщения close. Отметим, что идентификаторы отправителей, расположенные в ctp->rcvid, могут и не совпадать с переданными функции io_open; однако, совпадение по меньшей мере одного идентификатора гарантируется. «Лишние» идентификаторы отправителей являются результатом (возможно, внутренних) вызовов типа dup.

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

io_close_ocb

int io_close_ocb(resmgr_context_t *ctp, void* reserved,
 RESMGR_OCB_T *ocb)

Классификация: Функция ввода/вывода (синтезируется библиотекой)

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

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

Клиентская функция: Нет (синтезируется библиотекой)

Сообщения: Нет (синтезируется библиотекой)

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

// Синтезируется библиотекой
struct _io_close {
 uint16_t type;
 uint16_t combine_len;
};

typedef union {
 struct _io_close i;
} io_close_t;

Описание: Это функция, которая синтезируется базовым уровнем библиотеки, когда для некоего OCB получено последнее сообщение close. Это то самое место, где вам следует «подчистить» все перед уничтожением OCB. Отметим, что идентификатор отправителя в ctp->rcvid есть нуль (0), потому что данная функция синтезируется библиотекой и не обязательно соответствует какому-либо конкретному сообщению.