man/rc.eselect.5


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
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175

.TH "ESELECT" "5" "April 2005" "Gentoo Linux" "eselect"
.SH "NAME"
rc.eselect \- Runlevel configuration module
.SH "SYNOPSIS"
\fBeselect rc\fR [\fBhelp\fR|\fBusage\fR]
.br
\fBeselect rc\fR \fBadd\fR \fIscript\fR [\fIrunlevel\fR [\fIrunlevel\fR ...]]
.br
\fBeselect rc\fR \fBdelete\fR \fIscript\fR [\fIrunlevel\fR [\fIrunlevel\fR ...]]
.br
\fBeselect rc\fR \fBlist\fR [\fIrunlevel\fR]
.br
\fBeselect rc\fR \fBpause\fR \fIscript\fR [\fIscript\fR [\fIscript\fR ...]]
.br
\fBeselect rc\fR \fBrestart\fR \fIscript\fR [\fIscript\fR [\fIscript\fR ...]]
.br
\fBeselect rc\fR \fBshow\fR
.br
\fBeselect rc\fR \fBstart\fR \fIscript\fR [\fIscript\fR [\fIscript\fR ...]]
.br
\fBeselect rc\fR \fBstop\fR \fIscript\fR [\fIscript\fR [\fIscript\fR ...]]
.SH "DESCRIPTION"
\fBeselect\fR is Gentoo's configuration and management tool. It features
modules that care for the individual administrative tasks.
.SH "ACTION: ADD"
\fBeselect rc add\fR \fIscript\fR [\fIrunlevel\fR [\fIrunlevel\fR ...]]
.br
Add \fIscript\fR to given \fIrunlevels\fR. If no \fIrunlevel\fR is given,
this action will add \fIscript\fR to the \fBdefault\fR runlevel.

phi ~ # eselect rc add local default nonetwork notexisting
.br
Adding local to following runlevels
  default                   [done]
  nonetwork                 [skipped]
  notexisting               [invalid]

The result\-tags are as following
.TP
\fB[done]\fR
.br
\fIscript\fR succesfully added to \fIrunlevel\fR
.TP
\fB[failed]\fR
\fIscript\fR couldnot be added to \fIrunlevel\fR
.TP
\fB[skipped]\fR
\fIscript\fR already part of \fIrunlevel\fR
.TP
\fB[invalid]\fR
\fIrunlevel\fR is not existing
.SH "ACTION: DELETE"
\fBeselect rc delete\fR \fIscript\fR [\fIrunlevel\fR [\fIrunlevel\fR ...]]
.br
Delete \fIscript\fR from given \fIrunlevels\fR. If no \fIrunlevel\fR is given,
this action will delete \fIscript\fR from the \fBdefault\fR runlevel.

phi ~ # eselect rc delete local nonetwork notexisting
.br
Deleting local from following runlevels
  nonetwork                 [done]
  notexisting               [invalid]

The result\-tags are as following
.TP
\fB[done]\fR
.br
\fIscript\fR succesfully deleted from \fIrunlevel\fR
.TP
\fB[failed]\fR
\fIscript\fR could not be deleted from \fIrunlevel\fR
.TP
\fB[skipped]\fR
\fIscript\fR not part of \fIrunlevel\fR
.TP
\fB[invalid]\fR
\fIrunlevel\fR is not existing
.SH "ACTION: LIST"
\fBeselect rc list\fR [\fIrunlevel\fR]
.br
Displays an ordered list of init scripts that belong to \fIrunlevel\fR. In case that
\fIrunlevel\fR is given, this action will list all scripts from /etc/init.d/.

phi / # eselect rc list default
Init scripts to be started by runlevel default
  cupsd
  local
  metalog
  net.eth0
  netmount
  powernowd
  sshd
  vixie\-cron
  xdm
  xfs
.SH "ACTION: PAUSE"
\fBeselect rc pause\fR \fIscript\fR [\fIscript\fR ...]
.br
Pauses the given set of init scripts.

phi / # eselect rc pause net.eth0
.br
 * Stopping eth0
 *   Bringing down eth0
 *     Shutting down eth0 ...
.SH "ACTION: RESTART"
\fBeselect rc restart\fR \fIscript\fR [\fIscript\fR ...]
.br
Restarts the given set of init scripts.

phi / # eselect rc restart sshd
.br
Restarting init script
 * ERROR:  "local" has not yet been started.
 * Stopping sshd ...                                                      [ ok ]
.SH "ACTION: SHOW"
\fBeselect rc show\fR
.br
Shows the current runlevel's init script and lists them together with their status.

phi / # eselect rc show
.br
Status of init scripts in runlevel default
  cupsd                     [started]
  local                     [started]
  metalog                   [started]
  net.eth0                  [started]
  netmount                  [started]
  powernowd                 [started]
  sshd                      [stopped]
  vixie\-cron                [started]
  xdm                       [started]

The status flags are as following

.TP
\fB[started]\fR
\fIscript\fR has been successfully run.
.TP
\fB[stopping]\fR
\fIscript\fR stop has been ordered, but it has not ceased yet.
.TP
\fB[stopped]\fR
\fIscript\fR has manually been stopped.
.TP
\fB[failed]\fR
One or more commands in \fIscript\fR have not succeeded.
.TP
\fB[broken]\fR
\fIscript\fR has a syntax error.

.SH "ACTION: START"
\fBeselect rc start\fR \fIscript\fR [\fIscript\fR ...]
.br
Starts the given set of init scripts manually, regardless of the current runlevel.

phi / # eselect rc start local sshd
.br
Restarting init script
 * Starting local ...                                                    [ ok ]
 * WARNING:  "sshd" has already been started.
.SH "ACTION: STOP"
\fBeselect rc restart\fR \fIscript\fR [\fIscript\fR ...]
.br
Restarts the given set of init scripts.

phi / # eselect rc restart sshd
.br
Restarting init script
 * ERROR:  "local" has not yet been started.
 * Stopping sshd ...                                                      [ ok ]
.SH "AUTHOR"
Danny van Dyk <kugelfang@gentoo.org>
.SH "REVISION"
$Id$