LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man2 / reboot.2

diff --git a/original/man2/reboot.2 b/original/man2/reboot.2
index b25d62c..4aa784d 100644 (file)
--- a/original/man2/reboot.2
+++ b/original/man2/reboot.2
@@ -25,7 +25,7 @@
 .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com>
 .\"     Added notes on capability requirements
 .\"
 .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com>
 .\"     Added notes on capability requirements
 .\"

-.TH REBOOT 2 2010-10-31 "Linux" "Linux Programmer's Manual"
+.TH REBOOT 2 2015-02-01 "Linux" "Linux Programmer's Manual"

 .SH NAME
 reboot \- reboot or enable/disable Ctrl-Alt-Del
 .SH SYNOPSIS
 .SH NAME
 reboot \- reboot or enable/disable Ctrl-Alt-Del
 .SH SYNOPSIS


@@ -77,15 +77,17 @@ and since 2.1.97 also
 and since 2.5.71 also
 .B LINUX_REBOOT_MAGIC2C
 (that is, 537993216)
 and since 2.5.71 also
 .B LINUX_REBOOT_MAGIC2C
 (that is, 537993216)

-are permitted as value for
+are permitted as values for

 .IR magic2 .
 (The hexadecimal values of these constants are meaningful.)
 .IR magic2 .
 (The hexadecimal values of these constants are meaningful.)

+

 The
 .I cmd
 argument can have the following values:
 .TP
 .B LINUX_REBOOT_CMD_CAD_OFF
 The
 .I cmd
 argument can have the following values:
 .TP
 .B LINUX_REBOOT_CMD_CAD_OFF

-(RB_DISABLE_CAD, 0).
+.RB ( RB_DISABLE_CAD ,
+0).

 CAD is disabled.
 This means that the CAD keystroke will cause a
 .B SIGINT
 CAD is disabled.
 This means that the CAD keystroke will cause a
 .B SIGINT


@@ -94,28 +96,33 @@ sent to init (process 1), whereupon this process may decide upon a
 proper action (maybe: kill all processes, sync, reboot).
 .TP
 .B LINUX_REBOOT_CMD_CAD_ON
 proper action (maybe: kill all processes, sync, reboot).
 .TP
 .B LINUX_REBOOT_CMD_CAD_ON

-(RB_ENABLE_CAD, 0x89abcdef).
+.RB ( RB_ENABLE_CAD ,
+0x89abcdef).

 CAD is enabled.
 This means that the CAD keystroke will immediately cause
 the action associated with
 .BR LINUX_REBOOT_CMD_RESTART .
 .TP
 .B LINUX_REBOOT_CMD_HALT
 CAD is enabled.
 This means that the CAD keystroke will immediately cause
 the action associated with
 .BR LINUX_REBOOT_CMD_RESTART .
 .TP
 .B LINUX_REBOOT_CMD_HALT

-(RB_HALT_SYSTEM, 0xcdef0123; since 1.1.76).
+.RB ( RB_HALT_SYSTEM ,
+0xcdef0123; since Linux 1.1.76).

 The message "System halted." is printed, and the system is halted.
 Control is given to the ROM monitor, if there is one.
 If not preceded by a
 .BR sync (2),
 data will be lost.
 .TP
 The message "System halted." is printed, and the system is halted.
 Control is given to the ROM monitor, if there is one.
 If not preceded by a
 .BR sync (2),
 data will be lost.
 .TP

-.BR LINUX_REBOOT_CMD_KEXEC " (since Linux 2.6.13)"
+.BR LINUX_REBOOT_CMD_KEXEC
+.RB ( RB_KEXEC ,
+0x45584543, since Linux 2.6.13).

 Execute a kernel that has been loaded earlier with
 .BR kexec_load (2).
 This option is available only if the kernel was configured with
 .BR CONFIG_KEXEC .
 .TP
 .B LINUX_REBOOT_CMD_POWER_OFF
 Execute a kernel that has been loaded earlier with
 .BR kexec_load (2).
 This option is available only if the kernel was configured with
 .BR CONFIG_KEXEC .
 .TP
 .B LINUX_REBOOT_CMD_POWER_OFF

-(0x4321fedc; since 2.1.30).
+.RB ( RB_POWER_OFF ,
+0x4321fedc; since Linux 2.1.30).

 The message "Power down." is printed, the system is stopped,
 and all power is removed from the system, if possible.
 If not preceded by a
 The message "Power down." is printed, the system is stopped,
 and all power is removed from the system, if possible.
 If not preceded by a


@@ -123,7 +130,8 @@ If not preceded by a
 data will be lost.
 .TP
 .B LINUX_REBOOT_CMD_RESTART
 data will be lost.
 .TP
 .B LINUX_REBOOT_CMD_RESTART

-(RB_AUTOBOOT, 0x1234567).
+.RB ( RB_AUTOBOOT ,
+0x1234567).

 The message "Restarting system." is printed, and a default
 restart is performed immediately.
 If not preceded by a
 The message "Restarting system." is printed, and a default
 restart is performed immediately.
 If not preceded by a


@@ -131,7 +139,7 @@ If not preceded by a
 data will be lost.
 .TP
 .B LINUX_REBOOT_CMD_RESTART2
 data will be lost.
 .TP
 .B LINUX_REBOOT_CMD_RESTART2

-(0xa1b2c3d4; since 2.1.30).
+(0xa1b2c3d4; since Linux 2.1.30).

 The message "Restarting system with command \(aq%s\(aq" is printed,
 and a restart (using the command string given in
 .IR arg )
 The message "Restarting system with command \(aq%s\(aq" is printed,
 and a restart (using the command string given in
 .IR arg )


@@ -139,6 +147,13 @@ is performed immediately.
 If not preceded by a
 .BR sync (2),
 data will be lost.
 If not preceded by a
 .BR sync (2),
 data will be lost.

+.TP
+.BR LINUX_REBOOT_CMD_SW_SUSPEND
+.RB ( RB_SW_SUSPEND ,
+0xd000fce1; since Linux 2.5.18).
+The system is suspended (hibernated) to disk.
+This option is available only if the kernel was configured with
+.BR CONFIG_HIBERNATION .

 .LP
 Only the superuser may call
 .BR reboot ().
 .LP
 Only the superuser may call
 .BR reboot ().


@@ -148,6 +163,27 @@ For the i386 architecture, the additional argument does not do
 anything at present (2.1.122), but the type of reboot can be
 determined by kernel command-line arguments ("reboot=...") to be
 either warm or cold, and either hard or through the BIOS.
 anything at present (2.1.122), but the type of reboot can be
 determined by kernel command-line arguments ("reboot=...") to be
 either warm or cold, and either hard or through the BIOS.

+.SS Behavior inside PID namespaces
+.\" commit cf3f89214ef6a33fad60856bc5ffd7bb2fc4709b
+.\" see also commit 923c7538236564c46ee80c253a416705321f13e3
+Since Linux 3.4, when
+.BR reboot ()
+is called from a PID namespace (see
+.BR pid_namespaces (7))
+other than the initial PID namespace,
+the effect of the call is to send a signal to the namespace "init" process.
+.BR LINUX_REBOOT_CMD_RESTART
+and
+.BR LINUX_REBOOT_CMD_RESTART2
+cause a
+.BR SIGHUP
+signal to be sent.
+.BR LINUX_REBOOT_CMD_POWER_OFF
+and
+.BR LINUX_REBOOT_CMD_HALT
+cause a
+.B SIGINT
+signal to be sent.

 .SH RETURN VALUE
 For the values of
 .I cmd
 .SH RETURN VALUE
 For the values of
 .I cmd


@@ -181,9 +217,19 @@ capability is required.
 is Linux-specific,
 and should not be used in programs intended to be portable.
 .SH SEE ALSO
 is Linux-specific,
 and should not be used in programs intended to be portable.
 .SH SEE ALSO

+.BR kexec_load (2),

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

+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.