Rechercher une page de manuel
reboot
Langue: fr
Version: 27 mai 2004 (mandriva - 01/05/08)
Section: 2 (Appels système)
NOM
reboot - Redémarrer la machine, ou activer/désactiver Ctrl-Alt-SupprSYNOPSIS
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 flag, void *arg);
Avec 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 flag);
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 et LINUX_REBOOT_MAGIC2B (valant 369367448) depuis la version 2.1.97. Les valeurs hexadécimales de ces constantes ont un sens. L'argument flag 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ée. 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 utiliser cette fonction
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
reboot() renvoie 0 s'il réussit, ou -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 flag.
- 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 conçus pour être portablesVOIR 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 28 novembre 2007.
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.
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre