Unix Man (Справочное руководство)

         

UADMIN(2)


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 присваивается код ошибки.



Содержание раздела