aboutsummaryrefslogtreecommitdiff
path: root/init/init.c
diff options
context:
space:
mode:
Diffstat (limited to 'init/init.c')
-rw-r--r--init/init.c231
1 files changed, 231 insertions, 0 deletions
diff --git a/init/init.c b/init/init.c
index 5c0d11402..340731b8b 100644
--- a/init/init.c
+++ b/init/init.c
@@ -9,6 +9,237 @@
9 * Licensed under GPLv2 or later, see file LICENSE in this source tree. 9 * Licensed under GPLv2 or later, see file LICENSE in this source tree.
10 */ 10 */
11 11
12//applet:IF_INIT(APPLET(init, _BB_DIR_SBIN, _BB_SUID_DROP))
13//applet:IF_FEATURE_INITRD(APPLET_ODDNAME(linuxrc, init, _BB_DIR_ROOT, _BB_SUID_DROP, linuxrc))
14
15//kbuild:lib-$(CONFIG_INIT) += init.o
16
17//config:config INIT
18//config: bool "init"
19//config: default y
20//config: select FEATURE_SYSLOG
21//config: help
22//config: init is the first program run when the system boots.
23//config:
24//config:config FEATURE_USE_INITTAB
25//config: bool "Support reading an inittab file"
26//config: default y
27//config: depends on INIT
28//config: help
29//config: Allow init to read an inittab file when the system boot.
30//config:
31//config:config FEATURE_KILL_REMOVED
32//config: bool "Support killing processes that have been removed from inittab"
33//config: default n
34//config: depends on FEATURE_USE_INITTAB
35//config: help
36//config: When respawn entries are removed from inittab and a SIGHUP is
37//config: sent to init, this option will make init kill the processes
38//config: that have been removed.
39//config:
40//config:config FEATURE_KILL_DELAY
41//config: int "How long to wait between TERM and KILL (0 - send TERM only)" if FEATURE_KILL_REMOVED
42//config: range 0 1024
43//config: default 0
44//config: depends on FEATURE_KILL_REMOVED
45//config: help
46//config: With nonzero setting, init sends TERM, forks, child waits N
47//config: seconds, sends KILL and exits. Setting it too high is unwise
48//config: (child will hang around for too long and could actually kill
49//config: the wrong process!)
50//config:
51//config:config FEATURE_INIT_SCTTY
52//config: bool "Run commands with leading dash with controlling tty"
53//config: default y
54//config: depends on INIT
55//config: help
56//config: If this option is enabled, init will try to give a controlling
57//config: tty to any command which has leading hyphen (often it's "-/bin/sh").
58//config: More precisely, init will do "ioctl(STDIN_FILENO, TIOCSCTTY, 0)".
59//config: If device attached to STDIN_FILENO can be a ctty but is not yet
60//config: a ctty for other session, it will become this process' ctty.
61//config: This is not the traditional init behavour, but is often what you want
62//config: in an embedded system where the console is only accessed during
63//config: development or for maintenance.
64//config: NB: using cttyhack applet may work better.
65//config:
66//config:config FEATURE_INIT_SYSLOG
67//config: bool "Enable init to write to syslog"
68//config: default y
69//config: depends on INIT
70//config:
71//config:config FEATURE_EXTRA_QUIET
72//config: bool "Be _extra_ quiet on boot"
73//config: default y
74//config: depends on INIT
75//config: help
76//config: Prevent init from logging some messages to the console during boot.
77//config:
78//config:config FEATURE_INIT_COREDUMPS
79//config: bool "Support dumping core for child processes (debugging only)"
80//config: default y
81//config: depends on INIT
82//config: help
83//config: If this option is enabled and the file /.init_enable_core
84//config: exists, then init will call setrlimit() to allow unlimited
85//config: core file sizes. If this option is disabled, processes
86//config: will not generate any core files.
87//config:
88//config:config FEATURE_INITRD
89//config: bool "Support running init from within an initrd (not initramfs)"
90//config: default y
91//config: depends on INIT
92//config: help
93//config: Legacy support for running init under the old-style initrd. Allows
94//config: the name linuxrc to act as init, and it doesn't assume init is PID 1.
95//config:
96//config: This does not apply to initramfs, which runs /init as PID 1 and
97//config: requires no special support.
98//config:
99//config:config INIT_TERMINAL_TYPE
100//config: string "Initial terminal type"
101//config: default "linux"
102//config: depends on INIT
103//config: help
104//config: This is the initial value set by init for the TERM environment
105//config: variable. This variable is used by programs which make use of
106//config: extended terminal capabilities.
107//config:
108//config: Note that on Linux, init attempts to detect serial terminal and
109//config: sets TERM to "vt102" if one is found.
110
111//usage:#define init_trivial_usage
112//usage: ""
113//usage:#define init_full_usage "\n\n"
114//usage: "Init is the parent of all processes"
115//usage:
116//usage:#define init_notes_usage
117//usage: "This version of init is designed to be run only by the kernel.\n"
118//usage: "\n"
119//usage: "BusyBox init doesn't support multiple runlevels. The runlevels field of\n"
120//usage: "the /etc/inittab file is completely ignored by BusyBox init. If you want\n"
121//usage: "runlevels, use sysvinit.\n"
122//usage: "\n"
123//usage: "BusyBox init works just fine without an inittab. If no inittab is found,\n"
124//usage: "it has the following default behavior:\n"
125//usage: "\n"
126//usage: " ::sysinit:/etc/init.d/rcS\n"
127//usage: " ::askfirst:/bin/sh\n"
128//usage: " ::ctrlaltdel:/sbin/reboot\n"
129//usage: " ::shutdown:/sbin/swapoff -a\n"
130//usage: " ::shutdown:/bin/umount -a -r\n"
131//usage: " ::restart:/sbin/init\n"
132//usage: "\n"
133//usage: "if it detects that /dev/console is _not_ a serial console, it will also run:\n"
134//usage: "\n"
135//usage: " tty2::askfirst:/bin/sh\n"
136//usage: " tty3::askfirst:/bin/sh\n"
137//usage: " tty4::askfirst:/bin/sh\n"
138//usage: "\n"
139//usage: "If you choose to use an /etc/inittab file, the inittab entry format is as follows:\n"
140//usage: "\n"
141//usage: " <id>:<runlevels>:<action>:<process>\n"
142//usage: "\n"
143//usage: " <id>:\n"
144//usage: "\n"
145//usage: " WARNING: This field has a non-traditional meaning for BusyBox init!\n"
146//usage: " The id field is used by BusyBox init to specify the controlling tty for\n"
147//usage: " the specified process to run on. The contents of this field are\n"
148//usage: " appended to \"/dev/\" and used as-is. There is no need for this field to\n"
149//usage: " be unique, although if it isn't you may have strange results. If this\n"
150//usage: " field is left blank, the controlling tty is set to the console. Also\n"
151//usage: " note that if BusyBox detects that a serial console is in use, then only\n"
152//usage: " entries whose controlling tty is either the serial console or /dev/null\n"
153//usage: " will be run. BusyBox init does nothing with utmp. We don't need no\n"
154//usage: " stinkin' utmp.\n"
155//usage: "\n"
156//usage: " <runlevels>:\n"
157//usage: "\n"
158//usage: " The runlevels field is completely ignored.\n"
159//usage: "\n"
160//usage: " <action>:\n"
161//usage: "\n"
162//usage: " Valid actions include: sysinit, respawn, askfirst, wait,\n"
163//usage: " once, restart, ctrlaltdel, and shutdown.\n"
164//usage: "\n"
165//usage: " The available actions can be classified into two groups: actions\n"
166//usage: " that are run only once, and actions that are re-run when the specified\n"
167//usage: " process exits.\n"
168//usage: "\n"
169//usage: " Run only-once actions:\n"
170//usage: "\n"
171//usage: " 'sysinit' is the first item run on boot. init waits until all\n"
172//usage: " sysinit actions are completed before continuing. Following the\n"
173//usage: " completion of all sysinit actions, all 'wait' actions are run.\n"
174//usage: " 'wait' actions, like 'sysinit' actions, cause init to wait until\n"
175//usage: " the specified task completes. 'once' actions are asynchronous,\n"
176//usage: " therefore, init does not wait for them to complete. 'restart' is\n"
177//usage: " the action taken to restart the init process. By default this should\n"
178//usage: " simply run /sbin/init, but can be a script which runs pivot_root or it\n"
179//usage: " can do all sorts of other interesting things. The 'ctrlaltdel' init\n"
180//usage: " actions are run when the system detects that someone on the system\n"
181//usage: " console has pressed the CTRL-ALT-DEL key combination. Typically one\n"
182//usage: " wants to run 'reboot' at this point to cause the system to reboot.\n"
183//usage: " Finally the 'shutdown' action specifies the actions to taken when\n"
184//usage: " init is told to reboot. Unmounting filesystems and disabling swap\n"
185//usage: " is a very good here.\n"
186//usage: "\n"
187//usage: " Run repeatedly actions:\n"
188//usage: "\n"
189//usage: " 'respawn' actions are run after the 'once' actions. When a process\n"
190//usage: " started with a 'respawn' action exits, init automatically restarts\n"
191//usage: " it. Unlike sysvinit, BusyBox init does not stop processes from\n"
192//usage: " respawning out of control. The 'askfirst' actions acts just like\n"
193//usage: " respawn, except that before running the specified process it\n"
194//usage: " displays the line \"Please press Enter to activate this console.\"\n"
195//usage: " and then waits for the user to press enter before starting the\n"
196//usage: " specified process.\n"
197//usage: "\n"
198//usage: " Unrecognized actions (like initdefault) will cause init to emit an\n"
199//usage: " error message, and then go along with its business. All actions are\n"
200//usage: " run in the order they appear in /etc/inittab.\n"
201//usage: "\n"
202//usage: " <process>:\n"
203//usage: "\n"
204//usage: " Specifies the process to be executed and its command line.\n"
205//usage: "\n"
206//usage: "Example /etc/inittab file:\n"
207//usage: "\n"
208//usage: " # This is run first except when booting in single-user mode\n"
209//usage: " #\n"
210//usage: " ::sysinit:/etc/init.d/rcS\n"
211//usage: " \n"
212//usage: " # /bin/sh invocations on selected ttys\n"
213//usage: " #\n"
214//usage: " # Start an \"askfirst\" shell on the console (whatever that may be)\n"
215//usage: " ::askfirst:-/bin/sh\n"
216//usage: " # Start an \"askfirst\" shell on /dev/tty2-4\n"
217//usage: " tty2::askfirst:-/bin/sh\n"
218//usage: " tty3::askfirst:-/bin/sh\n"
219//usage: " tty4::askfirst:-/bin/sh\n"
220//usage: " \n"
221//usage: " # /sbin/getty invocations for selected ttys\n"
222//usage: " #\n"
223//usage: " tty4::respawn:/sbin/getty 38400 tty4\n"
224//usage: " tty5::respawn:/sbin/getty 38400 tty5\n"
225//usage: " \n"
226//usage: " \n"
227//usage: " # Example of how to put a getty on a serial line (for a terminal)\n"
228//usage: " #\n"
229//usage: " #::respawn:/sbin/getty -L ttyS0 9600 vt100\n"
230//usage: " #::respawn:/sbin/getty -L ttyS1 9600 vt100\n"
231//usage: " #\n"
232//usage: " # Example how to put a getty on a modem line\n"
233//usage: " #::respawn:/sbin/getty 57600 ttyS2\n"
234//usage: " \n"
235//usage: " # Stuff to do when restarting the init process\n"
236//usage: " ::restart:/sbin/init\n"
237//usage: " \n"
238//usage: " # Stuff to do before rebooting\n"
239//usage: " ::ctrlaltdel:/sbin/reboot\n"
240//usage: " ::shutdown:/bin/umount -a -r\n"
241//usage: " ::shutdown:/sbin/swapoff -a\n"
242
12#include "libbb.h" 243#include "libbb.h"
13#include <syslog.h> 244#include <syslog.h>
14#include <paths.h> 245#include <paths.h>