posix_spawnattr_getpartid()

Получить идентификаторы партиций, установленные в объекте posix_spawnattr_t

Прототип:

#include <posix_spawnattr.h>
                                       
int posix_spawnattr_getpartid( const posix_spawnattr_t *_Restrict attrp,
                               int *num,
                               partlist_info_t plist_info[] );

Аргументы:

attrp

Объект атрибутов файла порожденного процесса.

num

Номер указателя на элементы, которые могут содержаться в списках партиций.

plist_info

Информационные элементы списка партиций.

Библиотека:

libc

Описание:

При вызове необходимо предоставить хранилище для возвращаемых функций partlist_info_t. Указатель num инициализируется вызывающей стороной количеством элементов partlist_info_t, для которых есть место в plist_info.

При возвращении значение num будет установлено следующим образом:

• Если фактическое количество записей меньше или равно количеству записей, для которого было выделено место вызывающей стороной, тогда фактическое число будет записано, а указатель num будет установлен на фактическое количество записей.

• Если фактическое количество записей больше, чем число записей, для которого было выделено место вызывающей стороной с помощью указателя num, тогда записи с номером указателя num будут заполнены, а в num будет установлено значение равное отрицательному числу оставшихся записей, которые не подходят.

  Например, если при вызове предоставлено место для 4 записей и устанавливлено, что *num == 4, а в объекте posix_spawnattr_t есть 6 записей, то 4 записи помещаются в структуру, а в num будет установлено значение -2. Если вызывающий объект устанавливает *num == 0, то можно впоследствии определить количество записей и выделить достаточно места для извлечения всех этих записей.

---

При вызове типы идентификаторов партиций можно различить с помощью макроса PART_TYPE(), определенного в <part.h>. Эта функция является расширением posix_spawnattr_t ЗОСРВ «Нейтрино».

---

Возвращаемое значение:

EINVAL

Было задано недопустимое значение параметра.

EOK

Успешное завершение.

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования

Точка остановки потока

Нет

Обработчик прерываний

Да

Обработчик сигналов

Да

В потоке

Да

Тематические ссылки:

posix_spawn(), posix_spawn_file_actions_addclose(), posix_spawn_file_actions_adddup2(), posix_spawn_file_actions_addopen(), posix_spawn_file_actions_destroy(), posix_spawn_file_actions_init(), posix_spawnattr_addpartid(), posix_spawnattr_addpartition(), posix_spawnattr_destroy(), posix_spawnattr_getcred(), posix_spawnattr_getflags(), posix_spawnattr_getnode(), posix_spawnattr_getpgroup(), posix_spawnattr_getrunmask(), posix_spawnattr_getschedparam(), posix_spawnattr_getschedpolicy(), posix_spawnattr_getsigdefault(), posix_spawnattr_getsigignore(), posix_spawnattr_getsigmask(), posix_spawnattr_getstackmax(), posix_spawnattr_getxflags(), posix_spawnattr_init(), posix_spawnattr_setcred(), posix_spawnattr_setflags(), posix_spawnattr_setnode(), posix_spawnattr_setpgroup(), posix_spawnattr_setschedparam(), posix_spawnattr_setrunmask(), posix_spawnattr_setschedpolicy(), posix_spawnattr_setsigdefault(), posix_spawnattr_setsigignore(), posix_spawnattr_setsigmask(), posix_spawnattr_setstackmax(), posix_spawnattr_setxflags(), posix_spawnp()

Предыдущий раздел: Описание API системной библиотеки