Sous-routine reboot

Objectif

Redémarre le système.

Bibliothèque

Bibliothèque C standard (libc.a)

Syntaxe

include <sys/reboot.h>

void reboot ( HowTo,Argument)
int HowTo;
void * Argument;

Descriptif

Le sous-programme reboot redémarre ou redémarre le système à l'aide d'un IPL (procédure de chargement initial). Le démarrage est automatique et permet d'afficher /unix en mode normal, sans maintenance.

Remarque: La routine peut coredump au lieu de renvoyer EFAULT lorsqu'un pointeur non valide est transmis dans une application 64 bits appelant une interface de noyau 32 bits.

Le processus appelant doit disposer des droits d'accès superutilisateur pour pouvoir exécuter cette sous-routine avec succès.

Attention: Les utilisateurs de la sous-routine reboot ne sont pas portables. La sous-routine reboot est destinée à être utilisée uniquement par les commandes halt, rebootet shutdown .

Paramètres

Tableau 1. Paramètres
Article	Descriptif
`HowTo`	Indique l'une des valeurs suivantes: RB_SOFTIPL IPL souple. RRB_HALT Arrêt de l'opérateur ; désactivez la mise hors tension. RB_POWIPL Arrêt de l'opérateur ; désactivez la mise hors tension. Attendez une durée spécifiée, puis mettez le système sous tension.
`Argument`	Indique la durée (en secondes) d'attente entre la mise hors tension et la mise sous tension. Cette option n'est pas prise en charge sur tous les modèles. Pour plus de détails, consultez la référence technique de votre matériel.

Valeurs renvoyées

Une fois l'opération terminée, la sous-routine reboot ne renvoie pas de valeur. Si la sous-routine reboot échoue, la valeur -1 est renvoyée et la variable globale errno est définie pour indiquer l'erreur.

Codes d'erreur

La sous-routine reboot échoue si l'une des conditions suivantes est vérifiée:

Tableau 2. Codes d'erreur
Article	Descriptif
EPERM	Le processus appelant ne dispose pas des droits utilisateur root.
EINVAL	La valeur `HowTo` n'est pas valide.
EDÉFAUT	La valeur `Argument` n'est pas une adresse valide.