Provided by: manpages-es_1.55-9_all bug

NOMBRE

       reboot - rearranca o habilita/inhabilita Ctrl-Alt-Supr

SINOPSIS

       Para libc4 y libc5 la función de biblioteca y la llamada al sistema son
       idénticas, y  desde  la  versión  2.1.30  del  núcleo  existen  nombres
       simbólicos  LINUX_REBOOT_*  para  las  constantes y un cuarto argumento
       para la llamada:

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

       int reboot (int magico, int otro_magico, int flag, void *arg);

       Bajo glibc se han asignado nombres simbólicos RB_*  a  algunas  de  las
       contantes involucradas y la función de biblioteca es un envoltorio de 1
       argumento de la llamada al sistema de 3 argumentos:

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

       int reboot (int flag);

DESCRIPCIÓN

       La  llamada  reboot  rearranca  el  sistema  o  habilita/inhabilita  la
       pulsación de rearranque (abreviada CAS, ya que por defecto es Ctrl-Alt-
       Supr; se puede cambiar usando loadkeys(1)).

       Esta llamada al sistema fallará (con EINVAL) a  menos  que  magico  sea
       igual  a  LINUX_REBOOT_MAGIC1  (esto  es, 0xfee1dead) y otro_magico sea
       igual a LINUX_REBOOT_MAGIC2 (o sea, 672274793).  Sin  embargo,  también
       se  permiten como valores de otro_magico LINUX_REBOOT_MAGIC2A (esto es,
       85072278) desde la versión 2.1.17  y  LINUX_REBOOT_MAGIC2B  (es  decir,
       369367448)  desde  la  versión  2.1.97.   (Los valores hexadecimales de
       estas constantes no tienen sentido.)  El argumento flag puede tener los
       siguientes valores:

       LINUX_REBOOT_CMD_RESTART
              (RB_AUTOBOOT,  0x1234567).   Se  muestra  el mensaje ‘Restarting
              system.’ y se realiza inmediatamente un rearranque por  defecto.
              Si no se precede por una llamada a sync(2) se perderán datos.

       LINUX_REBOOT_CMD_HALT
              (RB_HALT_SYSTEM,  0xcdef0123;  desde  la  versión  1.1.76).   Se
              muestra el mensaje ‘System halted.’ y se detiene el sistema.  El
              control  se  cede al monitor en ROM, si existe alguno.  Si no se
              precede por una llamada a sync(2) se perderán datos.

       LINUX_REBOOT_CMD_POWER_OFF
              (0x4321fedc; desde la versión 2.1.30).  Se  muestra  el  mensaje
              ‘Power  down.’,  se detiene el sistema y se apaga el sistema, si
              es posible.  Si no se precede  por  una  llamada  a  sync(2)  se
              perderán datos.

       LINUX_REBOOT_CMD_RESTART2
              (0xa1b2c3d4;  desde  la  versión 2.1.30).  Se muestra el mensaje
              ‘Restarting   system   with   command   ’%s’’   y   se   realiza
              inmediatamente  un rearranque (usando la cadena de orden dada en
              arg).  Si no se precede por una llamada a  sync(2)  se  perderán
              datos.

       LINUX_REBOOT_CMD_CAD_ON
              (RB_ENABLE_CAD,  0x89abcdef).   Se  habilita  la  combinación de
              teclas CAS.  Esto significa  que  una  pulsación  CAS  producirá
              inmediatamente la acción asociada a LINUX_REBOOT_CMD_RESTART.

       LINUX_REBOOT_CMD_CAD_OFF
              (RB_DISABLE_CAD,  0).   Se  inhabilita  la combinación de teclas
              CAS.  Esto significa que una pulsación CAS producirá el envío de
              la  señal  SIGINT  a init (el proceso 1), y como consecuencia de
              esto este proceso puede decidir una  acción  apropiada  (quizás,
              matar todos los procesos, llamar a sync y reiniciar).

       Sólo el súperusuario puede utilizar esta función.

       El efecto exacto de las acciones anteriores depende de la arquitectura.
       Para la arquitectura i386, el argumento adicional no hace nada  por  el
       momento  (2.1.122),  pero  el  tipo  de  rearranque se puede determinar
       mediante argumentos en la línea de órdenes  del  núcleo  (‘Reboot=...’)
       para  que sea bien ‘en caliente’, bien ‘en frio’, y bien hardware, bien
       a través de la BIOS.

VALOR DEVUELTO

       En caso de éxito, se devuelve 0. En caso de error, se devuelve -1 y  se
       pone un valor apropiado en errno.

ERRORES

       EINVAL Números mágicos o flag incorrectos.

       EPERM  Un usuario distinto de root intenta llamar a reboot.

CONFORME A

       reboot  es  específico de Linux y no debería emplearse en programas que
       se pretendan transportables.

FALLOS

       En un sistema basado en glibc, los parámetros magico y  otro_magico  no
       existen. Sólo existe el parámetro flag.

VÉASE TAMBIÉN

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