reboot   Début   Suivant   Sommaire   Préc.page.lue   Accueil
Section: Manuel du programmeur Linux (2)
Updated: 11 février 2008
Sommaire  



NOM   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
reboot - Redémarrer la machine, ou activer/désactiver Ctrl-Alt-Suppr  



SYNOPSIS   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
/* Avec libc4 et libc5, la fonction de bibliothèque et l'appel système
   sont identiques, et depuis la version 2.1.30 du noyau,
   il existe des noms symboliques LINUX_REBOOT_* pour les constantes
   et un quatrième argument à l'appel : */

#include <unistd.h>
#include <linux/reboot.h>

int reboot (int magic, int magic2, int cmd, void *arg);

/* Avec la glibc, certaines des constantes concernées ont des noms
   symboliques RB_*, et la fonction de bibliothèque est une coquille
   à 1 argument encapsulant l'appel système à 3 arguments : */

#include <unistd.h>
#include <sys/reboot.h>

int reboot (int cmd);  




DESCRIPTION   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
L'appel système reboot() fait redémarrer le système, ou active/désactive la séquence de touches de redémarrage (Ctrl-Alt-Suppr par défaut mais cela peut être modifié en utilisant loadkeys(1)). Ces touches sont abrégées en CAD pour Ctrl-Alt-Del.

Cet appel système échouera (avec EINVAL) sauf si magic vaut LINUX_REBOOT_MAGIC1 (c'est-à-dire 0xfee1dead) et si magic2 vaut LINUX_REBOOT_MAGIC2 (qui est 672274793). Toutefois, sont également autorisées pour magic2 les valeurs LINUX_REBOOT_MAGIC2A (qui vaut 85072278) depuis la version 2.1.17 du noyau et LINUX_REBOOT_MAGIC2B (valant 369367448) depuis la version 2.1.97. Les valeurs hexadécimales de ces constantes ont un sens. L'argument cmd peut prendre l'une des valeurs suivantes :

LINUX_REBOOT_CMD_RESTART
(RB_AUTOBOOT, 0x1234567). Le message « Restarting system. » est affiché et un redémarrage est initialisé immédiatement. Si cet appel n'est pas précédé par un sync(2), des données seront perdues.
LINUX_REBOOT_CMD_HALT
(RB_HALT_SYSTEM, 0xcdef0123; depuis 1.1.76). Le message « System halted. » est affiché et le système est arrêté. Le contrôle est transmis au moniteur en ROM s'il y en a un. Si cet appel n'est pas précédé par un sync(2), des données seront perdues.
LINUX_REBOOT_CMD_POWER_OFF
(0x4321fedc; depuis 2.1.30). Le message « Power down. » est affiché, et tout le système est mis hors-tension si possible. Si cet appel n'est pas précédé par un sync(2), des données seront perdues.
LINUX_REBOOT_CMD_RESTART2
(0xa1b2c3d4; depuis 2.1.30). Le message « Restarting system with command '%s' » est affiché et un redémarrage (en utilisant la chaîne de commande fournie dans arg) est enclenché immédiatement. Si cet appel n'est pas précédé par un sync(2), des données seront perdues.
LINUX_REBOOT_CMD_CAD_ON
(RB_ENABLE_CAD, 0x89abcdef). Les touches de redémarrage Ctrl-Alt-Suppr sont autorisées. Ceci signifie que la frappe de ces touches déclenchera l'action associée à LINUX_REBOOT_CMD_RESTART immédiatement.
LINUX_REBOOT_CMD_CAD_OFF
(RB_DISABLE_CAD, 0). Les touches de redémarrage Ctrl-Alt-Suppr sont désactivées. Ceci signifie que la frappe de ces touches enverra un signal SIGINT au processus 1 (init). Celui-ci pourra alors décider de l'action appropriée à enclencher (généralement tuer tous les processus, démonter la plupart des systèmes de fichiers, sync, et redémarrer).

Évidemment, seul le superutilisateur peut appeler reboot().

L'effet exact des actions décrites ci-dessus dépend de l'architecture. Pour les i386, l'argument supplémentaire ne sert à rien à ce jour (2.1.22), mais le type de redémarrage peut être sélectionné par un argument en ligne de commande du noyau (« reboot=... ») afin d'être un redémarrage à chaud, à froid, matériel ou par le bios.  




VALEUR RENVOYÉE   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
Pour les valeurs de cmd qui arrêtent ou redémarrent le système, un appel réussi à reboot() ne revient pas. Pour les autres valeurs de cmd, reboot() renvoie 0 s'il réussit. Dans tous les cas de figure reboot() renvoie -1 s'il échoue, auquel cas errno contient le code d'erreur.  



ERREURS   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
EFAULT
Problème lors de la récupération de données espace utilisateur sous LINUX_REBOOT_CMD_RESTART2.
EINVAL
Mauvais nombres magiques ou mauvaise valeur de cmd.
EPERM
Le processus appelant n'a pas les privilèges suffisants pour invoquer reboot() ; la capacité CAP_SYS_BOOT est nécessaire.
 



CONFORMITÉ   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
reboot() est spécifique à Linux et ne doit pas être employé dans des programmes conçus pour être portables  



VOIR AUSSI   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil
sync(2), bootparam(7), capabilities(7), ctrlaltdel(8), halt(8), reboot(8)  



TRADUCTION   Début   Précédent   Suivant   Sommaire   Préc.page.lue   Accueil

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 13 octobre 1996 et révisée le 23 avril 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 reboot ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.


 



Sommaire   Début   Suivant   Sommaire   Préc.page.lue   Accueil
NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
CONFORMITÉ
VOIR AUSSI
TRADUCTION

Table des mots clés   Début   Suivant   Sommaire   Préc.page.lue   Accueil
EFAULTERREURS
EINVALERREURS
EPERMERREURS
LINUX_REBOOT_CMD_CAD_OFFDESCRIPTION
LINUX_REBOOT_CMD_CAD_ONDESCRIPTION
LINUX_REBOOT_CMD_HALTDESCRIPTION
LINUX_REBOOT_CMD_POWER_OFFDESCRIPTION
LINUX_REBOOT_CMD_RESTARTDESCRIPTION
LINUX_REBOOT_CMD_RESTART2DESCRIPTION



Ce document a été créé par man2html suivi de man2html.pl, le 17/10/2008 17:49:23, en utilisant les pages de 'man'.
 

Valid HTML 4.01 Transitional