bionic (2) reboot.2.gz

Provided by: manpages-es_1.55-10_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)