1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
.\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein. The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified by Michael Haardt (u31b3hs@pool.informatik.rwth-aachen.de)
.\"
.\" Tue Jul 6 22:36:09 MDT 1993 (dminer@nyx.cs.du.edu)
.\" Made this clearer...
.\" Modified Sat Jul 24 00:16:05 1993 by Rik Faith (faith@cs.unc.edu)
.\"
.\" Traduction 13/10/1996 par Christophe Blaess (ccb@club-internet.fr)
.\" Mise a Jour 8/04/97
.\" maj 09/04/99 LDP-man-pages 1.22
.TH REBOOT 2 "9 Avril 1999" "Linux" "Manuel du programmeur Linux"
.SH NOM
reboot \- Redmarrer la machine, ou activer/dsactiver Ctrl-Alt-Suppr.
.SH SYNOPSIS
Avec libc4 et libc5, la fonction de bibliothque et l'appel systme sont
identiques, et depuis la version 2.1.30 du noyau, il existe des
noms symboliques LINUX_REBOOT_* pour les constantes et un quatrime
argument l'appel :
.sp
.B #include <unistd.h>
.br
.B #include <linux/reboot.h>
.sp
.BI "int reboot (int " magic ", int " magic2 ", int " flag ", void *" arg );
.sp
Avec glibc, certaines des constantes concernes ont des noms symboliques
RB_*, et la fonction de bibliothque est une coquille 1 argument
encapsulant l'appel systme 3 arguments :
.sp
.B #include <unistd.h>
.br
.B #include <sys/reboot.h>
.sp
.BI "int reboot (int " flag );
.SH DESCRIPTION
.B reboot
fait redmarrer le systme, ou active/dsactive la squence de
touches de redmarrage (Ctrl-Alt-Suppr par dfaut mais cela peut
tre modifi en utilisant
.BR loadkeys (1)). Ces touches sont abbrvies CAD pour Ctrl-Alt-Del.
.PP
Cet appel-systme chouera (avec EINVAL) sauf si
.I magic
vaut LINUX_REBOOT_MAGIC1 (c'est dire 0xfee1dead) et si
.I magic2
vaut LINUX_REBOOT_MAGIC2 (qui est 672274793).
Toutefois, sont galement autorises pour
.I magic2
les valeurs LINUX_REBOOT_MAGIC2A
(qui vaut 85072278) depuis la version 2.1.17 du noyau et
LINUX_REBOOT_MAGIC2B (valant 369367448) depuis la version 2.1.97.
Les valeurs hxadcimales de ces constantes ont un sens.
L'argument
.I flag
peut prendre l'une des valeurs suivantes :
.TP
.B LINUX_REBOOT_CMD_RESTART
(RB_AUTOBOOT, 0x1234567).
Le message
`Restarting system.' est affich et un redmarrage
est initialis immdiatement.
Si cet appel n'est pas prcd par un
.BR sync (2),
des donnes seront perdues.
.TP
.B LINUX_REBOOT_CMD_HALT
(RB_HALT_SYSTEM, 0xcdef0123; depuis 1.1.76).
Le message
`System halted.' est affich et le systme est arrt.
Le contrle est transmis au moniteur en ROM s'il y en a un.
Si cet appel n'est pas prcd par un
.BR sync (2),
des donnes seront perdues.
.TP
.B LINUX_REBOOT_CMD_POWER_OFF
(0x4321fedc; depuis 2.1.30).
Le message
`Power down.' est affich, et tout le systme est mis
hors-tension si possible.
Si cet appel n'est pas prcd par un
.BR sync (2),
des donnes seront perdues.
.TP
.B LINUX_REBOOT_CMD_RESTART2
(0xa1b2c3d4; depuis 2.1.30).
Le message `Restarting system with command '%s'' est affich
et un redmarrage (en utilisant la chaine de commande fournie dans
.IR arg )
est enclench immdiatement.
Si cet appel n'est pas prcd par un
.BR sync (2),
des donnes seront perdues.
.TP
.B LINUX_REBOOT_CMD_CAD_ON
(RB_ENABLE_CAD, 0x89abcdef).
Les touches de redmarrage Ctrl-Alt-Suppr sont autorise.
Ceci signifie que la frappe de ces touches dclenchera l'action
associe LINUX_REBOOT_CMD_RESTART immdiatement.
.TP
.B LINUX_REBOOT_CMD_CAD_OFF
(RB_DISABLE_CAD, 0).
Les touches de redmarrage Ctrl-Alt-Suppr sont dsactives.
Ceci signifie que la frappe de ces touches enverra un signal SIGINT
au processus 1 (init). Celui-ci pourra alors dcider de l'action
approprie enclencher (gnralement tuer tous les processus,
dmonter la plupart des systmes de fichiers, sync, et redmarrer).
.LP
Evidemment, seul le Super-User peut utiliser cette fonction
.LP
L'effet exact des actions dcrites ci-dessus dpend de l'architecture.
Pour les i386, l'argument supplmentaire ne sert rien ce jour (2.1.22),
mais le type de redmarrage peut tre slectionn par un argument
en ligne de commande du noyau (`reboot=...') afin d'tre un
redmarrage chaud, froid, matriel ou par le bios.
.SH "VALEUR RENVOYE"
.BR reboot
renvoie 0 s'il russit, ou \-1 s'il choue, auquel cas
.I errno
contient le code d'erreur.
.SH ERREURS
.TP 0.8i
.B EINVAL
Mauvais nombres \fImagiques\fP ou mauvaise valeur de \fIflag\fP.
.TP
.B EPERM
.BR reboot
a t invoqu par un utilisateur normal (pas le Super-User).
.SH "CONFORMIT"
.B reboot
est spcifique Linux et ne doit pas tre employ dans des programmes
conus pour tre portables
.SH "VOIR AUSSI"
.BR sync "(2), " bootparam "(7), " ctrlaltdel "(8), " halt "(8), " reboot (8)
.SH TRADUCTION
Christophe Blaess, 1997.
|
