REBOOT
Section : Manuel du programmeur Linux (
2)
Mise à jour de la version anglaise : 11 février 2008
Index
Menu principal
NOM
reboot - Redémarrer la machine, ou activer/désactiver Ctrl-Alt-Suppr
SYNOPSIS
/* 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
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,
LINUX_REBOOT_MAGIC2B
(valant 369367448) depuis la version 2.1.97 et
LINUX_REBOOT_MAGIC2C
(valant 537993216) depuis la version 2.5.71.
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 aq%saq » 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
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
- 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É
reboot()
est spécifique à Linux et ne doit pas être employé
dans des programmes destinés à être portables.
VOIR AUSSI
sync(2),
bootparam(7),
capabilities(7),
ctrlaltdel(8),
halt(8),
reboot(8)
TRADUCTION
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 17 juillet 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.
Index
- NOM
-
- SYNOPSIS
-
- DESCRIPTION
-
- VALEUR RENVOYÉE
-
- ERREURS
-
- CONFORMITÉ
-
- VOIR AUSSI
-
- TRADUCTION
-
Dernière mise à jour : 17 juillet 2008