Linux Certif

Toute la documentation sur la certification Linux LPI

Rechercher une page de manuel

reboot

NAZWA

reboot - prze³adowanie systemu lub w³±czenie/wy³±czenie Ctrl-Alt-Del

SK£ADNIA

Wywo³ania systemowe pod bibliotek± libc4 i libc5 s± identyczne, a od wersji j±dra 2.1.30 istniej± symboliczne nazwy LINUX_REBOOT_* dla sta³ych oraz czwarty parametr wywo³ania:

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

int reboot(int magic, int magic2, int flag, void *arg);

Pod glibc niektóre sta³e dosta³y nazy RB_*, a wywo³anie biblioteczne jest jednoargumentow± funkcj± wywo³uj±c± 3-argumentow± funkcjê systemow±:

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

int reboot(int flag);

OPIS

Wywo³anie reboot() prze³adowuje system albo w³±cza lub wy³±cza kombinacjê klawiszy odpowiedzialn± za prze³adowanie systemu (nazywan± w skrócie CAD od domy¶lnej kombinacji Ctrl-Alt-Del, któr± mo¿na zmieniæ przy pomocy loadkeys(1)).

To wywo³anie systemowe siê nie powiedzie (z kodem EINVAL), chyba ¿e magic wynosi LINUX_REBOOT_MAGIC1 (czyli 0xfee1dead) i magic2 jest równe LINUX_REBOOT_MAGIC2 (czyli 672274793). Jednak¿e magic2 mo¿e przyjmowaæ dodatkowe warto¶ci: od wersji 2.1.17 - LINUX_REBOOT_MAGIC2A (czyli 85072278), od wersji 2.1.97 - LINUX_REBOOT_MAGIC2B (czyli 369367448), a od wersji 2.5.71 równie¿ LINUX_REBOOT_MAGIC2C (czyli 537993216). (Te szesnastkowe warto¶ci powy¿szych sta³ych maj± znaczenie). Parametr flag mo¿e przyjmowaæ nastêpuj±ce warto¶ci:

LINUX_REBOOT_CMD_RESTART

(RB_AUTOBOOT, 0x1234567). Wypisywane jest komunikat "Restarting system.", a natychmiast po tym nastêpuje prze³adowanie systemu. Je¿eli nie wywo³ano wcze¶niej sync(2), niezapisane dane zostan± utracone.

LINUX_REBOOT_CMD_HALT

(RB_HALT_SYSTEM, 0xcdef0123; od wersji 1.1.76). Wypisywane jest komuniat "System halted.", a system jest zarzymywany. Kontrola jest przekazywana do monitora ROM, je¿eli istnieje. Je¿eli nie wywo³ano wcze¶niej sync(2), niezapisane dane zostan± utracone.

LINUX_REBOOT_CMD_POWER_OFF

(0x4321fedc; od wersji 2.1.30). Wypisywany jest komunikat "Power down.", system jest zatrzymywany i je¿eli jest to mo¿liwe, zasilanie jest od³±czane. Je¿eli nie wywo³ano wcze¶niej sync(2), niezapisane dane zostan± utracone.

LINUX_REBOOT_CMD_RESTART2

(0xa1b2c3d4; od wersji 2.1.30). Wypisywany jest komunikat "Restarting system with command '%s'" i natychmiast po nim system jest prze³adowywany (u¿ywaj±c polecenia podanego w argumencie arg) . Je¿eli nie wywo³ano wcze¶niej sync(2), niezapisane dane zostan± utracone.

LINUX_REBOOT_CMD_CAD_ON

(RB_ENABLE_CAD, 0x89abcdef). CAD jest w³±czony, co oznacza, ¿e naci¶niêcie klawiszy CAD wywo³a od razu akcjê skojarzon± z LINUX_REBOOT_CMD_RESTART.

LINUX_REBOOT_CMD_CAD_OFF

(RB_DISABLE_CAD, 0). CAD jest wy³±czony, co oznacza, ¿e naci¶niêcie kombinacji klawiszy CAD wy¶le procesowi init (procesowi nr 1) sygna³ SIGINT i ten proces zdecyduje, jak± akcjê wykonaæ (byæ mo¿e: zabicie wszystkich procesów, sync, restart).

Tylko administrator mo¿e u¿ywaæ tej funkcji.

Dok³adny wynik powy¿szych akcji zale¿y od architektury komputera. Obecnie (2.1.122) dodatkowy parametr nie ma ¿adnego znaczenia dla architektury i386, jednak¿e typ restartowania systemu mo¿e byæ okre¶lony w argumentach linii poleceñ j±dra ("reboot=...") jako restart albo ciep³y, albo zimny oraz albo twardy, albo przez BIOS.

WARTO¦Æ ZWRACANA

W przypadku powodzenia zwracane jest zero. W razie wyst±pienia b³êdu zwracane jest -1 i ustawiana jest odpowiednia warto¶æ zmiennej errno.

B£ÊDY

EFAULT

Problem pobierania danych z przestrzeni u¿ytkownika w wypadku wywo³ania LINUX_REBOOT_CMD_RESTART2.

EINVAL

Niepoprawne liczby magiczne lub parametr flag.

EPERM

Proces wywo³uj±cy nie ma odpowiednich uprawnieñ, aby wywo³aæ reboot(); wymagane jest posiadanie przywileju CAP_SYS_BOOT.

ZGODNE Z

Funkcja reboot() jest specyficzna dla Linuksa i nie powinna byæ u¿ywana w programach, które maj± dzia³aæ pod ró¿nymi systemami.

ZOBACZ TAK¯E

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