Loading

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 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);

       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 '%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).

       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 rend pas la main. Pour les autres valeurs de
       cmd,  0 est renvoyé en cas de succès. Dans tous les cas, -1 est renvoyé
       en cas d’échec, et errno est positionnée en conséquence.

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 devrait pas être employé dans des
       programmes destinés à être portables

VOIR AUSSI

       sync(2),   bootparam(7),   capabilities(7),   ctrlaltdel(8),   halt(8),
       reboot(8)

COLOPHON

       Cette page fait partie de  la  publication  3.23  du  projet  man-pages
       Linux.  Une description du projet et des instructions pour signaler des
       anomalies      peuvent      être       trouvées       à       l’adresse
       http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Cette  page  de  manuel  a  été  traduite et mise à jour par Christophe
       Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis  par
       Alain  Portal  <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
       disposition sur http://manpagesfr.free.fr/.

       Les mises à jour et corrections de la version présente dans Debian sont
       directement gérées par Julien Cristau <jcristau@debian.org> et l’équipe
       francophone de traduction de Debian.

       Veuillez  signaler  toute  erreur   de   traduction   en   écrivant   à
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de  ce  document
       en utilisant la commande « man -L C <section> <page_de_man> ».