uadmin(2) uadmin(2)
NAME
uadmin - Verwaltungsfunktionen
SYNTAX
#include <sys/uadmin.h>
int uadmin(int cmd, int fcn, void *mdep);
BESCHREIBUNG
uadmin() ermöglicht die Steuerung für die grundlegenden Verwaltungs-
funktionen. Dieser Systemaufruf ist eng mit den Systemverwaltungspro-
zeduren verbunden und nicht für den allgemeinen Gebrauch bestimmt. Das
Argument mdep ist für maschinenabhängigen Gebrauch vorgesehen und an
dieser Stelle nicht erklärt.
Folgende Steuerfunktionen, die in cmd angegeben werden, stehen zur
Verfügung:
ASHUTDOWN Das System wird abgeschaltet. Alle Benutzerprozesse wer-
den abgebrochen, der Pufferspeicher wird entleert und
das Root-Dateisystem wird ausgehängt. Die nach Abschal-
ten des Systems auszuführende Maßnahme wird durch fcn
angegeben. Die Funktionen sind generisch; die jeweiligen
Hardware-Möglichkeiten sind bei den verschiedenen Gerä-
ten unterschiedlich.
ADHALT Prozessor anhalten.
ADBOOT System mit der Datei /stand/unix neuladen.
ADIBOOT Interaktives Neuladen; der Benutzer wird zur
Eingabe des Systemnamens aufgefordert.
AREBOOT Das System stoppt sofort ohne Ausführen einer weiteren
Verarbeitung. Die als nächstes auszuführende Maßnahme
wird wie oben durch fcn angegeben.
AREMOUNT Das Root-Dateisystem wird nach erfolgter Reparatur wie-
der eingehängt. Dies sollte nur während des Systemstart-
vorgangs benutzt werden.
FEHLER
Die folgende Beschreibung der Fehlercodes ist funktionsspezifisch.
Eine allgemeingültige Beschreibung finden Sie in introprm2(2) bzw. in
errno(5).
uadmin() ist erfolglos, wenn der nachstehende Punkt wahr ist:
EPERM Die effektive Benutzernummer ist nicht die des Systemverwal-
ters.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
uadmin(2) uadmin(2)
ERGEBNIS
Nach erfolgreicher Beendigung hängt der jeweils zurückgegebene Wert
wie folgt von cmd ab:
ASHUTDOWN kehrt nie zurück
AREBOOT kehrt nie zurück
AREMOUNT 0
Andernfalls wird -1 zurückgegeben, und errno wird zur Anzeige des Feh-
lers gesetzt.
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98