Разыменование дескрипторов
Разыменование дескриптора – это операция, при которой программа-клиент отправляет программе-серверу дескриптор, а программа-сервер получает указатель на контекст передачи ресурса, маску прав отправленного дескриптора и предка отправленного программой-клиентом дескриптора, которым программа-сервер уже владеет. Разыменование выполняется, когда программа-клиент, вызывая методы работы с ресурсом (например, чтения, записи, закрытия доступа), передает программе-серверу дескриптор, который был получен от этой программы-сервера при открытии доступа к ресурсу.
Разыменование дескрипторов требует выполнения тех же условий и использует те же механизмы и типы данных, что и передача дескрипторов. Сценарий разыменования дескриптора включает следующие шаги:
- Программа-клиент упаковывает дескриптор в поле структуры запросов
*_reqтипаnk_handle_desc_t. - Программа-клиент вызывает интерфейсный метод для отправки дескриптора программе-серверу с целью выполнения действий с ресурсом. Этот метод выполняет системный вызов
Call(). - Программа-сервер принимает запрос, выполняя системный вызов
Recv(). - Диспетчер на стороне программы-сервера вызывает метод, который соответствует запросу. Этот метод проверяет, что выполнена именно операция разыменования, а не передача дескриптора. Затем вызванный метод опционально проверяет, что права доступа разыменованного дескриптора (который отправлен программой-клиентом) разрешают запрашиваемые действия с ресурсом, и извлекает указатель на контекст передачи ресурса из поля структуры запросов
*_reqтипаnk_handle_desc_t.
Для выполнения проверок программа-сервер использует функции nk_is_handle_dereferenced() и nk_get_badge_op(), которые объявлены в заголовочном файле nk/types.h.
types.h (фрагмент)
/**
* Функция возвращает отличное от нуля значение, если
* дескриптор в транспортном контейнере дескриптора
* desc получен в результате операции разыменования
* дескриптора. Функция возвращает нуль, если дескриптор
* в транспортном контейнере дескриптора desc получен
* в результате операции передачи дескриптора.
*/
static inline
nk_bool_t nk_is_handle_dereferenced(const nk_handle_desc_t *desc)
/**
* Функция извлекает указатель на контекст передачи ресурса
* badge из транспортного контейнера дескриптора desc,
* если в маске прав, которая помещена в транспортном
* контейнере дескриптора desc, установлены флаги operation.
* В случае успеха функция возвращает NK_EOK, иначе возвращает код ошибки.
*/
static inline
nk_err_t nk_get_badge_op(const nk_handle_desc_t *desc,
nk_rights_t operation,
nk_badge_t *badge)
В общем случае программе-серверу не требуется дескриптор, который получен в результате разыменования, поскольку программа-сервер, как правило, сохраняет дескрипторы, которыми владеет, например, в составе контекстов пользовательских ресурсов. Но при необходимости программа-сервер может извлечь этот дескриптор из транспортного контейнера дескриптора.