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

 return
 (iofunc_open_default(ctp, msg, atoz_attrs +
 msg->connect.path[0] - 'a', extra));
 } else {
 return (ENOENT);
 }
}

my_read

В функции my_read, чтобы решить, какие операции надо выполнить, мы анализируем поле mode атрибутной записи. Если макрос S_ISDIR говорит, что это каталог, мы вызываем функцию my_read_dir; если макрос S_ISREG говорит, что это файл, мы вызываем функцию my_read_file. (Отметим, что если мы не можем разобрать, что это такое, мы возвращаем клиенту EBADF, указывая ему этим, что что-то здесь не так.)

Приведенный ниже код ничего не знает о наших специальных устройствах, да ему, собственно, и дела до них нет — он просто принимает решение на основе стандартных общеизвестных данных.

static int my_read(resmgr_context_t *ctp, io_read_t *msg,
 iofunc_ocb_t *ocb) {
 int sts;

 // Использовать вспомогательную функцию для проверки
 // корректности
 if ((sts =
 iofunc_read_verify(ctp, msg, ocb, NULL)) != EOK) {
 return (sts);
 }

 // Решить, надо ли читать «файл» или «каталог»
 if (S_ISDIR(ocb->attr->mode)) {
 return (my_read_dir(ctp, msg, ocb));
 } else if (S_ISREG(ocb->attr->mode)) {
 return (my_read_file(ctp, msg, ocb));
 } else {
 return (EBADF);
 }
}

my_read_dir

Вот тут-то все веселье и начинается. С точки зрения высокого уровня, мы выделяем буфер (он называется reply_msg), в котором собираемся разместить результат операции. Затем мы используем dp, чтобы «прогуляться» по буферу, заполняя его по ходу дела элементами struct dirent. Вспомогательная подпрограмма dirent_size применяется, чтобы определить, есть ли у нас место в буфере для еще одного элемента. Вспомогательная подпрограмма dirent_fill кладет элемент в буфер. (Отметим, что эти подпрограммы не входят в библиотеку администратора ресурсов; мы обсудим их ниже.)

На первый взгляд этот код может показаться неэффективным; мы используем функцию sprintf для создания двухбайтового имени файла (символ имени файла и признак конца строки NULL) в буфере длиной _POSIX_PATH_MAX (то есть 256) байт. Это делается для того, чтобы сделать код по возможности универсальным.

Наконец, обратите внимание, что мы используем поле offset в OCB для указания, для какого конкретного файла мы в данный момент генерируем структуру struct dirent. Это означает, что мы также должны корректировать поле offset всякий раз, когда возвращаем данные.

Возврат данных клиенту осуществляется «обычным» способом при помощи функции MsgReply. Заметьте, что поле состояния (status) функции MsgReply используется для указания числа отправленных клиенту байт.

static int my_read_dir(resmgr_context_t *ctp,
 io_read_t *msg, iofunc_ocb_t *ocb) {
 int nbytes;
 int nleft;
 struct dirent *dp;
 char *reply_msg;
 char fname[_POSIX_PATH_MAX];
// Выделить буфер для ответа
 reply_msg = calloc(1, msg->i.nbytes);
 if (reply_msg == NULL) {
 return (ENOMEM);
 }

 // Назначить выходной буфер
 dp = (struct dirent *)reply_msg;

 // Осталось «nleft» байт
 nleft = msg->i.nbytes;
 while (ocb->offset < NUM_ENTS) {
 // Создать имя файла
 sprintf(fname, "%с", ocb->offset + "a");
 // Проверить, насколько велик результат
 nbytes = dirent_size(fname);
 // Есть место?
 if (nleft - nbytes >= 0) {
 // Заполнить элемент каталога и увеличить указатель
 dp =
 dirent_fill(dp, ocb->offset + 1, ocb->offset, fname);
 // Увеличить смещение OCB
 ocb->offset++;
 // Учесть, сколько байт мы использовали
 nleft -= nbytes;
 } else {
 // Места больше нет, остановиться
 break;
 }
 }

 // Возвращаемся обратно к клиенту
 MsgReply(ctp->rcvid, (char*)dp - reply_msg, reply_msg,
 (char*)dp — reply_msg);

 // Освободить буфер
 free(reply_msg);
 // Сказать библиотеке, что мы уже ответили сами
 return (_RESMGR_NOREPLY);
}

my_read_file

В функции my_read_file мы видим код, почти аналогичный простому примеру функции чтения, который приведен выше в данном разделе. Единственная странная вещь, которую мы здесь делаем — поскольку мы знаем, что возвращается всегда только один байт данных, значит, если параметр nbytes не равен нулю, то он должен быть равен единице (и ничему другому). Таким образом, мы можем создавать данные, подлежащие возврату, непосредственным заполнением символьной переменной string. Обратите внимание, как мы используем поле inode атрибутной записи для определения, какие данные возвращать. Это обычный прием для администраторов, обслуживающих несколько ресурсов. Дополнительным трюком было бы расширить атрибутную запись (мы говорили об этом в разделе «Расширение атрибутной записи») и хранить непосредственно в ней либо сами данные, либо указатель на них.

static int my_read_file(resmgr_context_t *ctp,
 io_read_t *msg, iofunc_ocb_t *ocb) {
 int nbytes;
 int nleft;
 char string;

 // Тут нет никаких xtype...
 if ((msg->i.xtype & _IO_XTYPE_MASK) != _IO_XTYPE_NONE) (
 return (ENOSYS);
 }

 // Выяснить, сколько байт осталось...