UADMIN(2)

НАЗВАНИЕ
uadmin - административные действия

СИНТАКСИС

        #include <sys/uadmin.h>

        

        int uadmin (cmd, fcn, mdep)

        int cmd, fcn, mdep;

ОПИСАНИЕ
Системный вызов uadmin обеспечивает выполнение базовых административных функций. Он тесно связан с системными администраторскими процедурами и не предназначен для широкого использования. Аргумент mdep введен для реализации машинно-зависимых действий и здесь не описывается.

Эффект работы системного вызова uadmin определяется значением аргумента cmd, которое должно быть одним из следующих:

A_SHUTDOWN

Система завершает работу. Все пользовательские процессы терминируются, буфера выталкиваются и корневая файловая система размонтируется. Последующие действия определяются значением аргумента fcn; на разных машинах выполняются разные действия в силу разных аппаратных возможностей. Самым разумным является перезапуск системы путем передачи управления программе загрузки, хранящейся в ПЗУ.

A_REBOOT

Система немедленно останавливается без каких-либо действий. Как и в предыдущем случае, дальнейшие действия определяются значением аргумента fcn.

A_REMOUNT

Корневая файловая система вновь монтируется после того, как она была зафиксирована. Это может быть сделано только в процессе загрузки.

Системный вызов uadmin завершается неудачей, если:

[EPERM]

Соответствующий процессу действующий идентификатор пользователя не является идентификатором суперпользователя.

ДИАГНОСТИКА
При успешном завершении в зависимости от значения cmd возвращаются следующие значения:

A_SHUTDOWN Никогда не происходит возврата.
A_REBOOT Никогда не происходит возврата.
A_REMOUNT 0.

В противном случае возвращается -1, а переменной errno присваивается код ошибки.