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

int io_lseek(resmgr_context_t * ctp , io_lseek_t * msg ,

RESMGR_OCB_T * ocb )

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

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

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

Клиентская функции: lseek() , fseek() , rewinddir()

Сообщения: _IO_LSEEK

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

struct _io_lseek {

uint16_t type ;

uint16_t combine_len ;

short whence ;

uint16_t zero ;

uint64_t offset ;

};

typedef union {

struct _io_lseek i ;

uint64_t o ;

} io_lseek_t;

Описание: Обрабатывает клиентскую функцию lseek() . Отметьте, что администратору ресурса, который обрабатывает каталоги, придется также интерпретировать сообщение _IO_LSEEK для операций с каталогами. Параметры whence и offset передаются от клиентской функции lseek() . После интерпретации параметров whence и offset клиентского сообщения подпрограмма должна скорректировать у OCB параметр offset и затем возвратить новое значение offset или возвратить признак ошибки.

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

int io_mknod(resmgr_context_t * ctp , io_mknod_t * msg ,

RESMGR_HANDLE_T * handle , void * reserved )

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

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

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

Клиентская функция: mknod() , mkdir() , mkfifo()

Сообщения: _IO_CONNECT, подтип _IO_CONNECT_MKNOD

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

struct _io_connect {

// Внутренние поля (как описано выше)

uint16_t path_len ;

uint8_t extra_type ;

uint16_t extra_len ;

char path [1];

};

struct _io_connect_link_reply {

uint32_t reserved1 [2];

uint8_t eflag ;

uint8_t reserved2 [3];

uint32_t umask ;

uint16_t nentries ;

uint16_t path_len ;

};

typedef union {

struct _io_connect connect ;

struct _io_connect_link_reply link_reply ;

} io_mknod_t;

Описание: Создает новую точку входа в файловую систему. Сообщение выдается для создания файла с именем, указанным в path , и типом, закодированным в поле mode (оно из «внутренних полей» структуры struct _io_connect и здесь не показано).

Реально это используется только для клиентских функций mkfifo() и mkdir() .

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

int io_mmap(resmgr_context_t * ctp , io_mmap_t * msg ,

RESMGR_OCB_T * ocb )

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

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

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

Клиентская функция: mmap() , munmap() , mmap_device_io() , mmap_device_memory()

Сообщения: _IO_MMAP

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

struct _io_mmap {

uint16_t type ;

uint16_t combine_len ;

uint32_t prot ;

uint64_t offset ;

struct _msg_info info ;

uint32_t zero [6];

};

struct _io_mmap_reply {

uint32_t zero ;

uint32_t flags ;

uint64_t offset ;

int32_t coid ;

int32_t fd ;

};

typedef union {

struct _io_mmap i ;

struct _io_mmap_reply o ;

} io_mmap_t;

Описание: Позволяет администратору процессов применять к файлам вашего администратора ресурсов операцию mmap() . В общем случае самостоятельно программировать эту функцию не следует (используйте обработчик по умолчанию, предоставляемый iofunc_func_init() ), если только вы не хотите ее преднамеренно отключить (например, драйвер последовательного порта мог бы запросто возвратить ENOSYS, поэтому для него эта операция не имеет никакого смысла).

Данную функцию администратора ресурсов может вызвать только администратор процессов

Отметим, что побочным результатом вызова этой функции администратором процессов является создание OCB (то есть будет вызвана функция iofunc_ocb_calloc() , но для правильно спроектированного администратора ресурсов это не должно иметь никаких последствий.

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

int io_mount(resmgr_context_t * ctp , io_mount_t * msg ,