hexedit: fixes to "goto address" code
[oweals/busybox.git] / init / init.c
1 /* vi: set sw=4 ts=4: */
2 /*
3  * Mini init implementation for busybox
4  *
5  * Copyright (C) 1995, 1996 by Bruce Perens <bruce@pixar.com>.
6  * Copyright (C) 1999-2004 by Erik Andersen <andersen@codepoet.org>
7  * Adjusted by so many folks, it's impossible to keep track.
8  *
9  * Licensed under GPLv2 or later, see file LICENSE in this source tree.
10  */
11
12 //config:config INIT
13 //config:       bool "init (9.3 kb)"
14 //config:       default y
15 //config:       select FEATURE_SYSLOG
16 //config:       help
17 //config:       init is the first program run when the system boots.
18 //config:
19 //config:config LINUXRC
20 //config:       bool "linuxrc: support running init from initrd (not initramfs)"
21 //config:       default y
22 //config:       select FEATURE_SYSLOG
23 //config:       help
24 //config:       Legacy support for running init under the old-style initrd. Allows
25 //config:       the name linuxrc to act as init, and it doesn't assume init is PID 1.
26 //config:
27 //config:       This does not apply to initramfs, which runs /init as PID 1 and
28 //config:       requires no special support.
29 //config:
30 //config:config FEATURE_USE_INITTAB
31 //config:       bool "Support reading an inittab file"
32 //config:       default y
33 //config:       depends on INIT || LINUXRC
34 //config:       help
35 //config:       Allow init to read an inittab file when the system boot.
36 //config:
37 //config:config FEATURE_KILL_REMOVED
38 //config:       bool "Support killing processes that have been removed from inittab"
39 //config:       default n
40 //config:       depends on FEATURE_USE_INITTAB
41 //config:       help
42 //config:       When respawn entries are removed from inittab and a SIGHUP is
43 //config:       sent to init, this option will make init kill the processes
44 //config:       that have been removed.
45 //config:
46 //config:config FEATURE_KILL_DELAY
47 //config:       int "How long to wait between TERM and KILL (0 - send TERM only)" if FEATURE_KILL_REMOVED
48 //config:       range 0 1024
49 //config:       default 0
50 //config:       depends on FEATURE_KILL_REMOVED
51 //config:       help
52 //config:       With nonzero setting, init sends TERM, forks, child waits N
53 //config:       seconds, sends KILL and exits. Setting it too high is unwise
54 //config:       (child will hang around for too long and could actually kill
55 //config:       the wrong process!)
56 //config:
57 //config:config FEATURE_INIT_SCTTY
58 //config:       bool "Run commands with leading dash with controlling tty"
59 //config:       default y
60 //config:       depends on INIT || LINUXRC
61 //config:       help
62 //config:       If this option is enabled, init will try to give a controlling
63 //config:       tty to any command which has leading hyphen (often it's "-/bin/sh").
64 //config:       More precisely, init will do "ioctl(STDIN_FILENO, TIOCSCTTY, 0)".
65 //config:       If device attached to STDIN_FILENO can be a ctty but is not yet
66 //config:       a ctty for other session, it will become this process' ctty.
67 //config:       This is not the traditional init behavour, but is often what you want
68 //config:       in an embedded system where the console is only accessed during
69 //config:       development or for maintenance.
70 //config:       NB: using cttyhack applet may work better.
71 //config:
72 //config:config FEATURE_INIT_SYSLOG
73 //config:       bool "Enable init to write to syslog"
74 //config:       default y
75 //config:       depends on INIT || LINUXRC
76 //config:       help
77 //config:       If selected, some init messages are sent to syslog.
78 //config:       Otherwise, they are sent to VT #5 if linux virtual tty is detected
79 //config:       (if not, no separate logging is done).
80 //config:
81 //config:config FEATURE_INIT_QUIET
82 //config:       bool "Be quiet on boot (no 'init started:' message)"
83 //config:       default y
84 //config:       depends on INIT || LINUXRC
85 //config:
86 //config:config FEATURE_INIT_COREDUMPS
87 //config:       bool "Support dumping core for child processes (debugging only)"
88 //config:       default n       # not Y because this is a debug option
89 //config:       depends on INIT || LINUXRC
90 //config:       help
91 //config:       If this option is enabled and the file /.init_enable_core
92 //config:       exists, then init will call setrlimit() to allow unlimited
93 //config:       core file sizes. If this option is disabled, processes
94 //config:       will not generate any core files.
95 //config:
96 //config:config INIT_TERMINAL_TYPE
97 //config:       string "Initial terminal type"
98 //config:       default "linux"
99 //config:       depends on INIT || LINUXRC
100 //config:       help
101 //config:       This is the initial value set by init for the TERM environment
102 //config:       variable. This variable is used by programs which make use of
103 //config:       extended terminal capabilities.
104 //config:
105 //config:       Note that on Linux, init attempts to detect serial terminal and
106 //config:       sets TERM to "vt102" if one is found.
107 //config:
108 //config:config FEATURE_INIT_MODIFY_CMDLINE
109 //config:       bool "Clear init's command line"
110 //config:       default y
111 //config:       depends on INIT || LINUXRC
112 //config:       help
113 //config:       When launched as PID 1 and after parsing its arguments, init
114 //config:       wipes all the arguments but argv[0] and rewrites argv[0] to
115 //config:       contain only "init", so that its command line appears solely as
116 //config:       "init" in tools such as ps.
117 //config:       If this option is set to Y, init will keep its original behavior,
118 //config:       otherwise, all the arguments including argv[0] will be preserved,
119 //config:       be they parsed or ignored by init.
120 //config:       The original command-line used to launch init can then be
121 //config:       retrieved in /proc/1/cmdline on Linux, for example.
122
123 //applet:IF_INIT(APPLET(init, BB_DIR_SBIN, BB_SUID_DROP))
124 //applet:IF_LINUXRC(APPLET_ODDNAME(linuxrc, init, BB_DIR_ROOT, BB_SUID_DROP, linuxrc))
125
126 //kbuild:lib-$(CONFIG_INIT) += init.o
127 //kbuild:lib-$(CONFIG_LINUXRC) += init.o
128
129 #define DEBUG_SEGV_HANDLER 0
130
131 #include "libbb.h"
132 #include <syslog.h>
133 #include <sys/resource.h>
134 #ifdef __linux__
135 # include <linux/vt.h>
136 # include <sys/sysinfo.h>
137 #endif
138 #include "reboot.h" /* reboot() constants */
139
140 #if DEBUG_SEGV_HANDLER
141 # undef _GNU_SOURCE
142 # define _GNU_SOURCE 1
143 # undef __USE_GNU
144 # define __USE_GNU 1
145 # include <execinfo.h>
146 # include <sys/ucontext.h>
147 #endif
148
149 /* Used only for sanitizing purposes in set_sane_term() below. On systems where
150  * the baud rate is stored in a separate field, we can safely disable them. */
151 #ifndef CBAUD
152 # define CBAUD 0
153 # define CBAUDEX 0
154 #endif
155
156 /* Was a CONFIG_xxx option. A lot of people were building
157  * not fully functional init by switching it on! */
158 #define DEBUG_INIT 0
159
160 #define CONSOLE_NAME_SIZE 32
161
162 /* Default sysinit script. */
163 #ifndef INIT_SCRIPT
164 # define INIT_SCRIPT  "/etc/init.d/rcS"
165 #endif
166
167 /* Each type of actions can appear many times. They will be
168  * handled in order. RESTART is an exception, only 1st is used.
169  */
170 /* Start these actions first and wait for completion */
171 #define SYSINIT     0x01
172 /* Start these after SYSINIT and wait for completion */
173 #define WAIT        0x02
174 /* Start these after WAIT and *dont* wait for completion */
175 #define ONCE        0x04
176 /*
177  * NB: while SYSINIT/WAIT/ONCE are being processed,
178  * SIGHUP ("reread /etc/inittab") will be processed only after
179  * each group of actions. If new inittab adds, say, a SYSINIT action,
180  * it will not be run, since init is already "past SYSINIT stage".
181  */
182 /* Start these after ONCE are started, restart on exit */
183 #define RESPAWN     0x08
184 /* Like RESPAWN, but wait for <Enter> to be pressed on tty */
185 #define ASKFIRST    0x10
186 /*
187  * Start these on SIGINT, and wait for completion.
188  * Then go back to respawning RESPAWN and ASKFIRST actions.
189  * NB: kernel sends SIGINT to us if Ctrl-Alt-Del was pressed.
190  */
191 #define CTRLALTDEL  0x20
192 /*
193  * Start these before killing all processes in preparation for
194  * running RESTART actions or doing low-level halt/reboot/poweroff
195  * (initiated by SIGUSR1/SIGTERM/SIGUSR2).
196  * Wait for completion before proceeding.
197  */
198 #define SHUTDOWN    0x40
199 /*
200  * exec() on SIGQUIT. SHUTDOWN actions are started and waited for,
201  * then all processes are killed, then init exec's 1st RESTART action,
202  * replacing itself by it. If no RESTART action specified,
203  * SIGQUIT has no effect.
204  */
205 #define RESTART     0x80
206
207
208 /* A linked list of init_actions, to be read from inittab */
209 struct init_action {
210         struct init_action *next;
211         pid_t pid;
212         uint8_t action_type;
213         char terminal[CONSOLE_NAME_SIZE];
214         char command[1];
215 };
216
217 static struct init_action *init_action_list = NULL;
218
219 #if !ENABLE_FEATURE_INIT_SYSLOG
220 static const char *log_console = VC_5;
221 #endif
222
223 enum {
224         L_LOG = 0x1,
225         L_CONSOLE = 0x2,
226 };
227
228 /* Print a message to the specified device.
229  * "where" may be bitwise-or'd from L_LOG | L_CONSOLE
230  * NB: careful, we can be called after vfork!
231  */
232 #define dbg_message(...) do { if (DEBUG_INIT) message(__VA_ARGS__); } while (0)
233 static void message(int where, const char *fmt, ...)
234         __attribute__ ((format(printf, 2, 3)));
235 static void message(int where, const char *fmt, ...)
236 {
237         va_list arguments;
238         unsigned l;
239         char msg[128];
240
241         msg[0] = '\r';
242         va_start(arguments, fmt);
243         l = 1 + vsnprintf(msg + 1, sizeof(msg) - 2, fmt, arguments);
244         if (l > sizeof(msg) - 2)
245                 l = sizeof(msg) - 2;
246         va_end(arguments);
247
248 #if ENABLE_FEATURE_INIT_SYSLOG
249         msg[l] = '\0';
250         if (where & L_LOG) {
251                 /* Log the message to syslogd */
252                 openlog(applet_name, 0, LOG_DAEMON);
253                 /* don't print "\r" */
254                 syslog(LOG_INFO, "%s", msg + 1);
255                 closelog();
256         }
257         msg[l++] = '\n';
258         msg[l] = '\0';
259 #else
260         msg[l++] = '\n';
261         msg[l] = '\0';
262         if (where & L_LOG) {
263                 /* Take full control of the log tty, and never close it.
264                  * It's mine, all mine!  Muhahahaha! */
265                 static int log_fd = -1;
266
267                 if (log_fd < 0) {
268                         log_fd = STDERR_FILENO;
269                         if (log_console) {
270                                 log_fd = device_open(log_console, O_WRONLY | O_NONBLOCK | O_NOCTTY);
271                                 if (log_fd < 0) {
272                                         bb_error_msg("can't log to %s", log_console);
273                                         where = L_CONSOLE;
274                                 } else {
275                                         close_on_exec_on(log_fd);
276                                 }
277                         }
278                 }
279                 full_write(log_fd, msg, l);
280                 if (log_fd == STDERR_FILENO)
281                         return; /* don't print dup messages */
282         }
283 #endif
284
285         if (where & L_CONSOLE) {
286                 /* Send console messages to console so people will see them. */
287                 full_write(STDERR_FILENO, msg, l);
288         }
289 }
290
291 static void console_init(void)
292 {
293 #ifdef VT_OPENQRY
294         int vtno;
295 #endif
296         char *s;
297
298         s = getenv("CONSOLE");
299         if (!s)
300                 s = getenv("console");
301 #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
302         /* BSD people say their kernels do not open fd 0,1,2; they need this: */
303         if (!s)
304                 s = (char*)"/dev/console";
305 #endif
306         if (s) {
307                 int fd = open(s, O_RDWR | O_NONBLOCK | O_NOCTTY);
308                 if (fd >= 0) {
309                         dup2(fd, STDIN_FILENO);
310                         dup2(fd, STDOUT_FILENO);
311                         xmove_fd(fd, STDERR_FILENO);
312                 }
313                 dbg_message(L_LOG, "console='%s'", s);
314         } else {
315                 /* Make sure fd 0,1,2 are not closed
316                  * (so that they won't be used by future opens) */
317                 bb_sanitize_stdio();
318 // Users report problems
319 //              /* Make sure init can't be blocked by writing to stderr */
320 //              fcntl(STDERR_FILENO, F_SETFL, fcntl(STDERR_FILENO, F_GETFL) | O_NONBLOCK);
321         }
322
323         s = getenv("TERM");
324 #ifdef VT_OPENQRY
325         if (ioctl(STDIN_FILENO, VT_OPENQRY, &vtno) != 0) {
326                 /* Not a linux terminal, probably serial console.
327                  * Force the TERM setting to vt102
328                  * if TERM is set to linux (the default) */
329                 if (!s || strcmp(s, "linux") == 0)
330                         putenv((char*)"TERM=vt102");
331 # if !ENABLE_FEATURE_INIT_SYSLOG
332                 log_console = NULL;
333 # endif
334         } else
335 #endif
336         if (!s)
337                 putenv((char*)"TERM=" CONFIG_INIT_TERMINAL_TYPE);
338 }
339
340 /* Set terminal settings to reasonable defaults.
341  * NB: careful, we can be called after vfork! */
342 static void set_sane_term(void)
343 {
344         struct termios tty;
345
346         tcgetattr(STDIN_FILENO, &tty);
347
348         /* set control chars */
349         tty.c_cc[VINTR] = 3;    /* C-c */
350         tty.c_cc[VQUIT] = 28;   /* C-\ */
351         tty.c_cc[VERASE] = 127; /* C-? */
352         tty.c_cc[VKILL] = 21;   /* C-u */
353         tty.c_cc[VEOF] = 4;     /* C-d */
354         tty.c_cc[VSTART] = 17;  /* C-q */
355         tty.c_cc[VSTOP] = 19;   /* C-s */
356         tty.c_cc[VSUSP] = 26;   /* C-z */
357
358 #ifdef __linux__
359         /* use line discipline 0 */
360         tty.c_line = 0;
361 #endif
362
363         /* Make it be sane */
364 #ifndef CRTSCTS
365 # define CRTSCTS 0
366 #endif
367         /* added CRTSCTS to fix Debian bug 528560 */
368         tty.c_cflag &= CBAUD | CBAUDEX | CSIZE | CSTOPB | PARENB | PARODD | CRTSCTS;
369         tty.c_cflag |= CREAD | HUPCL | CLOCAL;
370
371         /* input modes */
372         tty.c_iflag = ICRNL | IXON | IXOFF;
373
374         /* output modes */
375         tty.c_oflag = OPOST | ONLCR;
376
377         /* local modes */
378         tty.c_lflag = ISIG | ICANON | ECHO | ECHOE | ECHOK | ECHOCTL | ECHOKE | IEXTEN;
379
380         tcsetattr_stdin_TCSANOW(&tty);
381 }
382
383 /* Open the new terminal device.
384  * NB: careful, we can be called after vfork! */
385 static int open_stdio_to_tty(const char* tty_name)
386 {
387         /* empty tty_name means "use init's tty", else... */
388         if (tty_name[0]) {
389                 int fd;
390
391                 close(STDIN_FILENO);
392                 /* fd can be only < 0 or 0: */
393                 fd = device_open(tty_name, O_RDWR);
394                 if (fd) {
395                         message(L_LOG | L_CONSOLE, "can't open %s: %s",
396                                 tty_name, strerror(errno));
397                         return 0; /* failure */
398                 }
399                 dup2(STDIN_FILENO, STDOUT_FILENO);
400                 dup2(STDIN_FILENO, STDERR_FILENO);
401         }
402         set_sane_term();
403         return 1; /* success */
404 }
405
406 static void reset_sighandlers_and_unblock_sigs(void)
407 {
408         bb_signals(0
409                 + (1 << SIGUSR1)
410                 + (1 << SIGUSR2)
411                 + (1 << SIGTERM)
412                 + (1 << SIGQUIT)
413                 + (1 << SIGINT)
414                 + (1 << SIGHUP)
415                 + (1 << SIGTSTP)
416                 + (1 << SIGSTOP)
417                 , SIG_DFL);
418         sigprocmask_allsigs(SIG_UNBLOCK);
419 }
420
421 /* Wrapper around exec:
422  * Takes string.
423  * If chars like '>' detected, execs '[-]/bin/sh -c "exec ......."'.
424  * Otherwise splits words on whitespace, deals with leading dash,
425  * and uses plain exec().
426  * NB: careful, we can be called after vfork!
427  */
428 static void init_exec(const char *command)
429 {
430         /* +8 allows to write VLA sizes below more efficiently: */
431         unsigned command_size = strlen(command) + 8;
432         /* strlen(command) + strlen("exec ")+1: */
433         char buf[command_size];
434         /* strlen(command) / 2 + 4: */
435         char *cmd[command_size / 2];
436         int dash;
437
438         dash = (command[0] == '-' /* maybe? && command[1] == '/' */);
439         command += dash;
440
441         /* See if any special /bin/sh requiring characters are present */
442         if (strpbrk(command, "~`!$^&*()=|\\{}[];\"'<>?") != NULL) {
443                 sprintf(buf, "exec %s", command); /* excluding "-" */
444                 /* NB: LIBBB_DEFAULT_LOGIN_SHELL define has leading dash */
445                 cmd[0] = (char*)(LIBBB_DEFAULT_LOGIN_SHELL + !dash);
446                 cmd[1] = (char*)"-c";
447                 cmd[2] = buf;
448                 cmd[3] = NULL;
449                 command = LIBBB_DEFAULT_LOGIN_SHELL + 1;
450         } else {
451                 /* Convert command (char*) into cmd (char**, one word per string) */
452                 char *word, *next;
453                 int i = 0;
454                 next = strcpy(buf, command - dash); /* command including "-" */
455                 command = next + dash;
456                 while ((word = strsep(&next, " \t")) != NULL) {
457                         if (*word != '\0') { /* not two spaces/tabs together? */
458                                 cmd[i] = word;
459                                 i++;
460                         }
461                 }
462                 cmd[i] = NULL;
463         }
464         /* If we saw leading "-", it is interactive shell.
465          * Try harder to give it a controlling tty.
466          */
467         if (ENABLE_FEATURE_INIT_SCTTY && dash) {
468                 /* _Attempt_ to make stdin a controlling tty. */
469                 ioctl(STDIN_FILENO, TIOCSCTTY, 0 /*only try, don't steal*/);
470         }
471         /* Here command never contains the dash, cmd[0] might */
472         BB_EXECVP(command, cmd);
473         message(L_LOG | L_CONSOLE, "can't run '%s': %s", command, strerror(errno));
474         /* returns if execvp fails */
475 }
476
477 /* Used only by run_actions */
478 static pid_t run(const struct init_action *a)
479 {
480         pid_t pid;
481
482         /* Careful: don't be affected by a signal in vforked child */
483         sigprocmask_allsigs(SIG_BLOCK);
484         if (BB_MMU && (a->action_type & ASKFIRST))
485                 pid = fork();
486         else
487                 pid = vfork();
488         if (pid < 0)
489                 message(L_LOG | L_CONSOLE, "can't fork");
490         if (pid) {
491                 sigprocmask_allsigs(SIG_UNBLOCK);
492                 return pid; /* Parent or error */
493         }
494
495         /* Child */
496
497         /* Reset signal handlers that were set by the parent process */
498         reset_sighandlers_and_unblock_sigs();
499
500         /* Create a new session and make ourself the process group leader */
501         setsid();
502
503         /* Open the new terminal device */
504         if (!open_stdio_to_tty(a->terminal))
505                 _exit(EXIT_FAILURE);
506
507         /* NB: on NOMMU we can't wait for input in child, so
508          * "askfirst" will work the same as "respawn". */
509         if (BB_MMU && (a->action_type & ASKFIRST)) {
510                 static const char press_enter[] ALIGN1 =
511 #ifdef CUSTOMIZED_BANNER
512 #include CUSTOMIZED_BANNER
513 #endif
514                         "\nPlease press Enter to activate this console. ";
515                 char c;
516                 /*
517                  * Save memory by not exec-ing anything large (like a shell)
518                  * before the user wants it. This is critical if swap is not
519                  * enabled and the system has low memory. Generally this will
520                  * be run on the second virtual console, and the first will
521                  * be allowed to start a shell or whatever an init script
522                  * specifies.
523                  */
524                 dbg_message(L_LOG, "waiting for enter to start '%s'"
525                                         "(pid %d, tty '%s')\n",
526                                 a->command, getpid(), a->terminal);
527                 full_write(STDOUT_FILENO, press_enter, sizeof(press_enter) - 1);
528                 while (safe_read(STDIN_FILENO, &c, 1) == 1 && c != '\n')
529                         continue;
530         }
531
532         /*
533          * When a file named /.init_enable_core exists, setrlimit is called
534          * before processes are spawned to set core file size as unlimited.
535          * This is for debugging only.  Don't use this is production, unless
536          * you want core dumps lying about....
537          */
538         if (ENABLE_FEATURE_INIT_COREDUMPS) {
539                 if (access("/.init_enable_core", F_OK) == 0) {
540                         struct rlimit limit;
541                         limit.rlim_cur = RLIM_INFINITY;
542                         limit.rlim_max = RLIM_INFINITY;
543                         setrlimit(RLIMIT_CORE, &limit);
544                 }
545         }
546
547         /* Log the process name and args */
548         message(L_LOG, "starting pid %u, tty '%s': '%s'",
549                         (int)getpid(), a->terminal, a->command);
550
551         /* Now run it.  The new program will take over this PID,
552          * so nothing further in init.c should be run. */
553         init_exec(a->command);
554         /* We're still here?  Some error happened. */
555         _exit(-1);
556 }
557
558 static struct init_action *mark_terminated(pid_t pid)
559 {
560         struct init_action *a;
561
562         if (pid > 0) {
563                 update_utmp_DEAD_PROCESS(pid);
564                 for (a = init_action_list; a; a = a->next) {
565                         if (a->pid == pid) {
566                                 a->pid = 0;
567                                 return a;
568                         }
569                 }
570         }
571         return NULL;
572 }
573
574 static void waitfor(pid_t pid)
575 {
576         /* waitfor(run(x)): protect against failed fork inside run() */
577         if (pid <= 0)
578                 return;
579
580         /* Wait for any child (prevent zombies from exiting orphaned processes)
581          * but exit the loop only when specified one has exited. */
582         while (1) {
583                 pid_t wpid = wait(NULL);
584                 mark_terminated(wpid);
585                 /* Unsafe. SIGTSTP handler might have wait'ed it already */
586                 /*if (wpid == pid) break;*/
587                 /* More reliable: */
588                 if (kill(pid, 0))
589                         break;
590         }
591 }
592
593 /* Run all commands of a particular type */
594 static void run_actions(int action_type)
595 {
596         struct init_action *a;
597
598         for (a = init_action_list; a; a = a->next) {
599                 if (!(a->action_type & action_type))
600                         continue;
601
602                 if (a->action_type & (SYSINIT | WAIT | ONCE | CTRLALTDEL | SHUTDOWN)) {
603                         pid_t pid = run(a);
604                         if (a->action_type & (SYSINIT | WAIT | CTRLALTDEL | SHUTDOWN))
605                                 waitfor(pid);
606                 }
607                 if (a->action_type & (RESPAWN | ASKFIRST)) {
608                         /* Only run stuff with pid == 0. If pid != 0,
609                          * it is already running
610                          */
611                         if (a->pid == 0)
612                                 a->pid = run(a);
613                 }
614         }
615 }
616
617 static void new_init_action(uint8_t action_type, const char *command, const char *cons)
618 {
619         struct init_action *a, **nextp;
620
621         /* Scenario:
622          * old inittab:
623          * ::shutdown:umount -a -r
624          * ::shutdown:swapoff -a
625          * new inittab:
626          * ::shutdown:swapoff -a
627          * ::shutdown:umount -a -r
628          * On reload, we must ensure entries end up in correct order.
629          * To achieve that, if we find a matching entry, we move it
630          * to the end.
631          */
632         nextp = &init_action_list;
633         while ((a = *nextp) != NULL) {
634                 /* Don't enter action if it's already in the list.
635                  * This prevents losing running RESPAWNs.
636                  */
637                 if (strcmp(a->command, command) == 0
638                  && strcmp(a->terminal, cons) == 0
639                 ) {
640                         /* Remove from list */
641                         *nextp = a->next;
642                         /* Find the end of the list */
643                         while (*nextp != NULL)
644                                 nextp = &(*nextp)->next;
645                         a->next = NULL;
646                         goto append;
647                 }
648                 nextp = &a->next;
649         }
650
651         a = xzalloc(sizeof(*a) + strlen(command));
652
653         /* Append to the end of the list */
654  append:
655         *nextp = a;
656         a->action_type = action_type;
657         strcpy(a->command, command);
658         safe_strncpy(a->terminal, cons, sizeof(a->terminal));
659         dbg_message(L_LOG | L_CONSOLE, "command='%s' action=%x tty='%s'\n",
660                 a->command, a->action_type, a->terminal);
661 }
662
663 /* NOTE that if CONFIG_FEATURE_USE_INITTAB is NOT defined,
664  * then parse_inittab() simply adds in some default
665  * actions (i.e., runs INIT_SCRIPT and then starts a pair
666  * of "askfirst" shells).  If CONFIG_FEATURE_USE_INITTAB
667  * _is_ defined, but /etc/inittab is missing, this
668  * results in the same set of default behaviors.
669  */
670 static void parse_inittab(void)
671 {
672 #if ENABLE_FEATURE_USE_INITTAB
673         char *token[4];
674         parser_t *parser = config_open2("/etc/inittab", fopen_for_read);
675
676         if (parser == NULL)
677 #endif
678         {
679                 /* No inittab file - set up some default behavior */
680                 /* Sysinit */
681                 new_init_action(SYSINIT, INIT_SCRIPT, "");
682                 /* Askfirst shell on tty1-4 */
683                 new_init_action(ASKFIRST, bb_default_login_shell, "");
684 //TODO: VC_1 instead of ""? "" is console -> ctty problems -> angry users
685                 new_init_action(ASKFIRST, bb_default_login_shell, VC_2);
686                 new_init_action(ASKFIRST, bb_default_login_shell, VC_3);
687                 new_init_action(ASKFIRST, bb_default_login_shell, VC_4);
688                 /* Reboot on Ctrl-Alt-Del */
689                 new_init_action(CTRLALTDEL, "reboot", "");
690                 /* Umount all filesystems on halt/reboot */
691                 new_init_action(SHUTDOWN, "umount -a -r", "");
692                 /* Swapoff on halt/reboot */
693                 new_init_action(SHUTDOWN, "swapoff -a", "");
694                 /* Restart init when a QUIT is received */
695                 new_init_action(RESTART, "init", "");
696                 return;
697         }
698
699 #if ENABLE_FEATURE_USE_INITTAB
700         /* optional_tty:ignored_runlevel:action:command
701          * Delims are not to be collapsed and need exactly 4 tokens
702          */
703         while (config_read(parser, token, 4, 0, "#:",
704                                 PARSE_NORMAL & ~(PARSE_TRIM | PARSE_COLLAPSE))) {
705                 /* order must correspond to SYSINIT..RESTART constants */
706                 static const char actions[] ALIGN1 =
707                         "sysinit\0""wait\0""once\0""respawn\0""askfirst\0"
708                         "ctrlaltdel\0""shutdown\0""restart\0";
709                 int action;
710                 char *tty = token[0];
711
712                 if (!token[3]) /* less than 4 tokens */
713                         goto bad_entry;
714                 action = index_in_strings(actions, token[2]);
715                 if (action < 0 || !token[3][0]) /* token[3]: command */
716                         goto bad_entry;
717                 /* turn .*TTY -> /dev/TTY */
718                 if (tty[0]) {
719                         tty = concat_path_file("/dev/", skip_dev_pfx(tty));
720                 }
721                 new_init_action(1 << action, token[3], tty);
722                 if (tty[0])
723                         free(tty);
724                 continue;
725  bad_entry:
726                 message(L_LOG | L_CONSOLE, "Bad inittab entry at line %d",
727                                 parser->lineno);
728         }
729         config_close(parser);
730 #endif
731 }
732
733 static void pause_and_low_level_reboot(unsigned magic) NORETURN;
734 static void pause_and_low_level_reboot(unsigned magic)
735 {
736         pid_t pid;
737
738         /* Allow time for last message to reach serial console, etc */
739         sleep(1);
740
741         /* We have to fork here, since the kernel calls do_exit(EXIT_SUCCESS)
742          * in linux/kernel/sys.c, which can cause the machine to panic when
743          * the init process exits... */
744         pid = vfork();
745         if (pid == 0) { /* child */
746                 reboot(magic);
747                 _exit(EXIT_SUCCESS);
748         }
749         while (1)
750                 sleep(1);
751 }
752
753 static void run_shutdown_and_kill_processes(void)
754 {
755         /* Run everything to be run at "shutdown".  This is done _prior_
756          * to killing everything, in case people wish to use scripts to
757          * shut things down gracefully... */
758         run_actions(SHUTDOWN);
759
760         message(L_CONSOLE | L_LOG, "The system is going down NOW!");
761
762         /* Send signals to every process _except_ pid 1 */
763         kill(-1, SIGTERM);
764         message(L_CONSOLE, "Sent SIG%s to all processes", "TERM");
765         sync();
766         sleep(1);
767
768         kill(-1, SIGKILL);
769         message(L_CONSOLE, "Sent SIG%s to all processes", "KILL");
770         sync();
771         /*sleep(1); - callers take care about making a pause */
772 }
773
774 /* Signal handling by init:
775  *
776  * For process with PID==1, on entry kernel sets all signals to SIG_DFL
777  * and unmasks all signals. However, for process with PID==1,
778  * default action (SIG_DFL) on any signal is to ignore it,
779  * even for special signals SIGKILL and SIGCONT.
780  * Also, any signal can be caught or blocked.
781  * (but SIGSTOP is still handled specially, at least in 2.6.20)
782  *
783  * We install two kinds of handlers, "immediate" and "delayed".
784  *
785  * Immediate handlers execute at any time, even while, say, sysinit
786  * is running.
787  *
788  * Delayed handlers just set a flag variable. The variable is checked
789  * in the main loop and acted upon.
790  *
791  * halt/poweroff/reboot and restart have immediate handlers.
792  * They only traverse linked list of struct action's, never modify it,
793  * this should be safe to do even in signal handler. Also they
794  * never return.
795  *
796  * SIGSTOP and SIGTSTP have immediate handlers. They just wait
797  * for SIGCONT to happen.
798  *
799  * SIGHUP has a delayed handler, because modifying linked list
800  * of struct action's from a signal handler while it is manipulated
801  * by the program may be disastrous.
802  *
803  * Ctrl-Alt-Del has a delayed handler. Not a must, but allowing
804  * it to happen even somewhere inside "sysinit" would be a bit awkward.
805  *
806  * There is a tiny probability that SIGHUP and Ctrl-Alt-Del will collide
807  * and only one will be remembered and acted upon.
808  */
809
810 /* The SIGPWR/SIGUSR[12]/SIGTERM handler */
811 static void halt_reboot_pwoff(int sig) NORETURN;
812 static void halt_reboot_pwoff(int sig)
813 {
814         const char *m;
815         unsigned rb;
816
817         /* We may call run() and it unmasks signals,
818          * including the one masked inside this signal handler.
819          * Testcase which would start multiple reboot scripts:
820          *  while true; do reboot; done
821          * Preventing it:
822          */
823         reset_sighandlers_and_unblock_sigs();
824
825         run_shutdown_and_kill_processes();
826
827         m = "halt";
828         rb = RB_HALT_SYSTEM;
829         if (sig == SIGTERM) {
830                 m = "reboot";
831                 rb = RB_AUTOBOOT;
832         } else if (sig == SIGUSR2) {
833                 m = "poweroff";
834                 rb = RB_POWER_OFF;
835         }
836         message(L_CONSOLE, "Requesting system %s", m);
837         pause_and_low_level_reboot(rb);
838         /* not reached */
839 }
840
841 /* Handler for QUIT - exec "restart" action,
842  * else (no such action defined) do nothing */
843 static void exec_restart_action(void)
844 {
845         struct init_action *a;
846
847         for (a = init_action_list; a; a = a->next) {
848                 if (!(a->action_type & RESTART))
849                         continue;
850
851                 /* Starting from here, we won't return.
852                  * Thus don't need to worry about preserving errno
853                  * and such.
854                  */
855
856                 reset_sighandlers_and_unblock_sigs();
857
858                 run_shutdown_and_kill_processes();
859
860 #ifdef RB_ENABLE_CAD
861                 /* Allow Ctrl-Alt-Del to reboot the system.
862                  * This is how kernel sets it up for init, we follow suit.
863                  */
864                 reboot(RB_ENABLE_CAD); /* misnomer */
865 #endif
866
867                 if (open_stdio_to_tty(a->terminal)) {
868                         dbg_message(L_CONSOLE, "Trying to re-exec %s", a->command);
869                         /* Theoretically should be safe.
870                          * But in practice, kernel bugs may leave
871                          * unkillable processes, and wait() may block forever.
872                          * Oh well. Hoping "new" init won't be too surprised
873                          * by having children it didn't create.
874                          */
875                         //while (wait(NULL) > 0)
876                         //      continue;
877                         init_exec(a->command);
878                 }
879                 /* Open or exec failed */
880                 pause_and_low_level_reboot(RB_HALT_SYSTEM);
881                 /* not reached */
882         }
883 }
884
885 /* The SIGSTOP/SIGTSTP handler
886  * NB: inside it, all signals except SIGCONT are masked
887  * via appropriate setup in sigaction().
888  */
889 static void stop_handler(int sig UNUSED_PARAM)
890 {
891         smallint saved_bb_got_signal;
892         int saved_errno;
893
894         saved_bb_got_signal = bb_got_signal;
895         saved_errno = errno;
896         signal(SIGCONT, record_signo);
897
898         while (1) {
899                 pid_t wpid;
900
901                 if (bb_got_signal == SIGCONT)
902                         break;
903                 /* NB: this can accidentally wait() for a process
904                  * which we waitfor() elsewhere! waitfor() must have
905                  * code which is resilient against this.
906                  */
907                 wpid = wait_any_nohang(NULL);
908                 mark_terminated(wpid);
909                 sleep(1);
910         }
911
912         signal(SIGCONT, SIG_DFL);
913         errno = saved_errno;
914         bb_got_signal = saved_bb_got_signal;
915 }
916
917 #if ENABLE_FEATURE_USE_INITTAB
918 static void reload_inittab(void)
919 {
920         struct init_action *a, **nextp;
921
922         message(L_LOG, "reloading /etc/inittab");
923
924         /* Disable old entries */
925         for (a = init_action_list; a; a = a->next)
926                 a->action_type = 0;
927
928         /* Append new entries, or modify existing entries
929          * (incl. setting a->action_type) if cmd and device name
930          * match new ones. End result: only entries with
931          * a->action_type == 0 are stale.
932          */
933         parse_inittab();
934
935 #if ENABLE_FEATURE_KILL_REMOVED
936         /* Kill stale entries */
937         /* Be nice and send SIGTERM first */
938         for (a = init_action_list; a; a = a->next)
939                 if (a->action_type == 0 && a->pid != 0)
940                         kill(a->pid, SIGTERM);
941         if (CONFIG_FEATURE_KILL_DELAY) {
942                 /* NB: parent will wait in NOMMU case */
943                 if ((BB_MMU ? fork() : vfork()) == 0) { /* child */
944                         sleep(CONFIG_FEATURE_KILL_DELAY);
945                         for (a = init_action_list; a; a = a->next)
946                                 if (a->action_type == 0 && a->pid != 0)
947                                         kill(a->pid, SIGKILL);
948                         _exit(EXIT_SUCCESS);
949                 }
950         }
951 #endif
952
953         /* Remove stale entries and SYSINIT entries.
954          * We never rerun SYSINIT entries anyway,
955          * removing them too saves a few bytes
956          */
957         nextp = &init_action_list;
958         while ((a = *nextp) != NULL) {
959                 /*
960                  * Why pid == 0 check?
961                  * Process can be removed from inittab and added *later*.
962                  * If we delete its entry but process still runs,
963                  * duplicate is spawned when the entry is re-added.
964                  */
965                 if ((a->action_type & ~SYSINIT) == 0 && a->pid == 0) {
966                         *nextp = a->next;
967                         free(a);
968                 } else {
969                         nextp = &a->next;
970                 }
971         }
972
973         /* Not needed: */
974         /* run_actions(RESPAWN | ASKFIRST); */
975         /* - we return to main loop, which does this automagically */
976 }
977 #endif
978
979 static int check_delayed_sigs(void)
980 {
981         int sigs_seen = 0;
982
983         while (1) {
984                 smallint sig = bb_got_signal;
985
986                 if (!sig)
987                         return sigs_seen;
988                 bb_got_signal = 0;
989                 sigs_seen = 1;
990 #if ENABLE_FEATURE_USE_INITTAB
991                 if (sig == SIGHUP)
992                         reload_inittab();
993 #endif
994                 if (sig == SIGINT)
995                         run_actions(CTRLALTDEL);
996                 if (sig == SIGQUIT) {
997                         exec_restart_action();
998                         /* returns only if no restart action defined */
999                 }
1000                 if ((1 << sig) & (0
1001 #ifdef SIGPWR
1002                     + (1 << SIGPWR)
1003 #endif
1004                     + (1 << SIGUSR1)
1005                     + (1 << SIGUSR2)
1006                     + (1 << SIGTERM)
1007                 )) {
1008                         halt_reboot_pwoff(sig);
1009                 }
1010         }
1011 }
1012
1013 #if DEBUG_SEGV_HANDLER
1014 static
1015 void handle_sigsegv(int sig, siginfo_t *info, void *ucontext)
1016 {
1017         long ip;
1018         ucontext_t *uc;
1019
1020         uc = ucontext;
1021         ip = uc->uc_mcontext.gregs[REG_EIP];
1022         fdprintf(2, "signal:%d address:0x%lx ip:0x%lx\n",
1023                         sig,
1024                         /* this is void*, but using %p would print "(null)"
1025                          * even for ptrs which are not exactly 0, but, say, 0x123:
1026                          */
1027                         (long)info->si_addr,
1028                         ip);
1029         {
1030                 /* glibc extension */
1031                 void *array[50];
1032                 int size;
1033                 size = backtrace(array, 50);
1034                 backtrace_symbols_fd(array, size, 2);
1035         }
1036         for (;;) sleep(9999);
1037 }
1038 #endif
1039
1040 static void sleep_much(void)
1041 {
1042         sleep(30 * 24*60*60);
1043 }
1044
1045 int init_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
1046 int init_main(int argc UNUSED_PARAM, char **argv)
1047 {
1048         if (argv[1] && strcmp(argv[1], "-q") == 0) {
1049                 return kill(1, SIGHUP);
1050         }
1051
1052 #if DEBUG_SEGV_HANDLER
1053         {
1054                 struct sigaction sa;
1055                 memset(&sa, 0, sizeof(sa));
1056                 sa.sa_sigaction = handle_sigsegv;
1057                 sa.sa_flags = SA_SIGINFO;
1058                 sigaction(SIGSEGV, &sa, NULL);
1059                 sigaction(SIGILL, &sa, NULL);
1060                 sigaction(SIGFPE, &sa, NULL);
1061                 sigaction(SIGBUS, &sa, NULL);
1062         }
1063 #endif
1064
1065         if (!DEBUG_INIT) {
1066                 /* Expect to be invoked as init with PID=1 or be invoked as linuxrc */
1067                 if (getpid() != 1
1068                  && (!ENABLE_LINUXRC || applet_name[0] != 'l') /* not linuxrc? */
1069                 ) {
1070                         bb_error_msg_and_die("must be run as PID 1");
1071                 }
1072 #ifdef RB_DISABLE_CAD
1073                 /* Turn off rebooting via CTL-ALT-DEL - we get a
1074                  * SIGINT on CAD so we can shut things down gracefully... */
1075                 reboot(RB_DISABLE_CAD); /* misnomer */
1076 #endif
1077         }
1078
1079         /* If, say, xmalloc would ever die, we don't want to oops kernel
1080          * by exiting.
1081          * NB: we set die_func *after* PID 1 check and bb_show_usage.
1082          * Otherwise, for example, "init u" ("please rexec yourself"
1083          * command for sysvinit) will show help text (which isn't too bad),
1084          * *and sleep forever* (which is bad!)
1085          */
1086         die_func = sleep_much;
1087
1088         /* Figure out where the default console should be */
1089         console_init();
1090         set_sane_term();
1091         xchdir("/");
1092         setsid();
1093
1094         /* Make sure environs is set to something sane */
1095         putenv((char *) "HOME=/");
1096         putenv((char *) bb_PATH_root_path);
1097         putenv((char *) "SHELL=/bin/sh");
1098         putenv((char *) "USER=root"); /* needed? why? */
1099
1100         if (argv[1])
1101                 xsetenv("RUNLEVEL", argv[1]);
1102
1103 #if !ENABLE_FEATURE_INIT_QUIET
1104         /* Hello world */
1105         message(L_CONSOLE | L_LOG, "init started: %s", bb_banner);
1106 #endif
1107
1108 #if 0
1109 /* It's 2013, does anyone really still depend on this? */
1110 /* If you do, consider adding swapon to sysinit actions then! */
1111 /* struct sysinfo is linux-specific */
1112 # ifdef __linux__
1113         /* Make sure there is enough memory to do something useful. */
1114         /*if (ENABLE_SWAPONOFF) - WRONG: we may have non-bbox swapon*/ {
1115                 struct sysinfo info;
1116
1117                 if (sysinfo(&info) == 0
1118                  && (info.mem_unit ? info.mem_unit : 1) * (long long)info.totalram < 1024*1024
1119                 ) {
1120                         message(L_CONSOLE, "Low memory, forcing swapon");
1121                         /* swapon -a requires /proc typically */
1122                         new_init_action(SYSINIT, "mount -t proc proc /proc", "");
1123                         /* Try to turn on swap */
1124                         new_init_action(SYSINIT, "swapon -a", "");
1125                         run_actions(SYSINIT);   /* wait and removing */
1126                 }
1127         }
1128 # endif
1129 #endif
1130
1131         /* Check if we are supposed to be in single user mode */
1132         if (argv[1]
1133          && (strcmp(argv[1], "single") == 0 || strcmp(argv[1], "-s") == 0 || LONE_CHAR(argv[1], '1'))
1134         ) {
1135                 /* ??? shouldn't we set RUNLEVEL="b" here? */
1136                 /* Start a shell on console */
1137                 new_init_action(RESPAWN, bb_default_login_shell, "");
1138         } else {
1139                 /* Not in single user mode - see what inittab says */
1140
1141                 /* NOTE that if CONFIG_FEATURE_USE_INITTAB is NOT defined,
1142                  * then parse_inittab() simply adds in some default
1143                  * actions (i.e., INIT_SCRIPT and a pair
1144                  * of "askfirst" shells) */
1145                 parse_inittab();
1146         }
1147
1148 #if ENABLE_SELINUX
1149         if (getenv("SELINUX_INIT") == NULL) {
1150                 int enforce = 0;
1151
1152                 putenv((char*)"SELINUX_INIT=YES");
1153                 if (selinux_init_load_policy(&enforce) == 0) {
1154                         BB_EXECVP(argv[0], argv);
1155                 } else if (enforce > 0) {
1156                         /* SELinux in enforcing mode but load_policy failed */
1157                         message(L_CONSOLE, "can't load SELinux Policy. "
1158                                 "Machine is in enforcing mode. Halting now.");
1159                         return EXIT_FAILURE;
1160                 }
1161         }
1162 #endif
1163
1164         if (ENABLE_FEATURE_INIT_MODIFY_CMDLINE) {
1165                 /* Make the command line just say "init"  - that's all, nothing else */
1166                 strncpy(argv[0], "init", strlen(argv[0]));
1167                 /* Wipe argv[1]-argv[N] so they don't clutter the ps listing */
1168                 while (*++argv)
1169                         nuke_str(*argv);
1170         }
1171
1172         /* Set up signal handlers */
1173         if (!DEBUG_INIT) {
1174                 struct sigaction sa;
1175
1176                 /* Stop handler must allow only SIGCONT inside itself */
1177                 memset(&sa, 0, sizeof(sa));
1178                 sigfillset(&sa.sa_mask);
1179                 sigdelset(&sa.sa_mask, SIGCONT);
1180                 sa.sa_handler = stop_handler;
1181                 /* NB: sa_flags doesn't have SA_RESTART.
1182                  * It must be able to interrupt wait().
1183                  */
1184                 sigaction_set(SIGTSTP, &sa); /* pause */
1185                 /* Does not work as intended, at least in 2.6.20.
1186                  * SIGSTOP is simply ignored by init:
1187                  */
1188                 sigaction_set(SIGSTOP, &sa); /* pause */
1189
1190                 /* These signals must interrupt wait(),
1191                  * setting handler without SA_RESTART flag.
1192                  */
1193                 bb_signals_recursive_norestart(0
1194                         + (1 << SIGINT)  /* Ctrl-Alt-Del */
1195                         + (1 << SIGQUIT) /* re-exec another init */
1196 #ifdef SIGPWR
1197                         + (1 << SIGPWR)  /* halt */
1198 #endif
1199                         + (1 << SIGUSR1) /* halt */
1200                         + (1 << SIGTERM) /* reboot */
1201                         + (1 << SIGUSR2) /* poweroff */
1202 #if ENABLE_FEATURE_USE_INITTAB
1203                         + (1 << SIGHUP)  /* reread /etc/inittab */
1204 #endif
1205                         , record_signo);
1206         }
1207
1208         /* Now run everything that needs to be run */
1209         /* First run the sysinit command */
1210         run_actions(SYSINIT);
1211         check_delayed_sigs();
1212         /* Next run anything that wants to block */
1213         run_actions(WAIT);
1214         check_delayed_sigs();
1215         /* Next run anything to be run only once */
1216         run_actions(ONCE);
1217
1218         /* Now run the looping stuff for the rest of forever.
1219          */
1220         while (1) {
1221                 int maybe_WNOHANG;
1222
1223                 maybe_WNOHANG = check_delayed_sigs();
1224
1225                 /* (Re)run the respawn/askfirst stuff */
1226                 run_actions(RESPAWN | ASKFIRST);
1227                 maybe_WNOHANG |= check_delayed_sigs();
1228
1229                 /* Don't consume all CPU time - sleep a bit */
1230                 sleep(1);
1231                 maybe_WNOHANG |= check_delayed_sigs();
1232
1233                 /* Wait for any child process(es) to exit.
1234                  *
1235                  * If check_delayed_sigs above reported that a signal
1236                  * was caught, wait will be nonblocking. This ensures
1237                  * that if SIGHUP has reloaded inittab, respawn and askfirst
1238                  * actions will not be delayed until next child death.
1239                  */
1240                 if (maybe_WNOHANG)
1241                         maybe_WNOHANG = WNOHANG;
1242                 while (1) {
1243                         pid_t wpid;
1244                         struct init_action *a;
1245
1246                         /* If signals happen _in_ the wait, they interrupt it,
1247                          * bb_signals_recursive_norestart set them up that way
1248                          */
1249                         wpid = waitpid(-1, NULL, maybe_WNOHANG);
1250                         if (wpid <= 0)
1251                                 break;
1252
1253                         a = mark_terminated(wpid);
1254                         if (a) {
1255                                 message(L_LOG, "process '%s' (pid %d) exited. "
1256                                                 "Scheduling for restart.",
1257                                                 a->command, wpid);
1258                         }
1259                         /* See if anyone else is waiting to be reaped */
1260                         maybe_WNOHANG = WNOHANG;
1261                 }
1262         } /* while (1) */
1263 }
1264
1265 //usage:#define linuxrc_trivial_usage NOUSAGE_STR
1266 //usage:#define linuxrc_full_usage ""
1267
1268 //usage:#define init_trivial_usage
1269 //usage:       ""
1270 //usage:#define init_full_usage "\n\n"
1271 //usage:       "Init is the first process started during boot. It never exits."
1272 //usage:        IF_FEATURE_USE_INITTAB(
1273 //usage:   "\n""It (re)spawns children according to /etc/inittab."
1274 //usage:        )
1275 //usage:        IF_NOT_FEATURE_USE_INITTAB(
1276 //usage:   "\n""This version of init doesn't use /etc/inittab,"
1277 //usage:   "\n""has fixed set of processed to run."
1278 //usage:        )
1279 //usage:
1280 //usage:#define init_notes_usage
1281 //usage:        "This version of init is designed to be run only by the kernel.\n"
1282 //usage:        "\n"
1283 //usage:        "BusyBox init doesn't support multiple runlevels. The runlevels field of\n"
1284 //usage:        "the /etc/inittab file is completely ignored by BusyBox init. If you want\n"
1285 //usage:        "runlevels, use sysvinit.\n"
1286 //usage:        "\n"
1287 //usage:        "BusyBox init works just fine without an inittab. If no inittab is found,\n"
1288 //usage:        "it has the following default behavior:\n"
1289 //usage:        "\n"
1290 //usage:        "       ::sysinit:/etc/init.d/rcS\n"
1291 //usage:        "       ::askfirst:/bin/sh\n"
1292 //usage:        "       ::ctrlaltdel:/sbin/reboot\n"
1293 //usage:        "       ::shutdown:/sbin/swapoff -a\n"
1294 //usage:        "       ::shutdown:/bin/umount -a -r\n"
1295 //usage:        "       ::restart:/sbin/init\n"
1296 //usage:        "       tty2::askfirst:/bin/sh\n"
1297 //usage:        "       tty3::askfirst:/bin/sh\n"
1298 //usage:        "       tty4::askfirst:/bin/sh\n"
1299 //usage:        "\n"
1300 //usage:        "If you choose to use an /etc/inittab file, the inittab entry format is as follows:\n"
1301 //usage:        "\n"
1302 //usage:        "       <id>:<runlevels>:<action>:<process>\n"
1303 //usage:        "\n"
1304 //usage:        "       <id>:\n"
1305 //usage:        "\n"
1306 //usage:        "               WARNING: This field has a non-traditional meaning for BusyBox init!\n"
1307 //usage:        "               The id field is used by BusyBox init to specify the controlling tty for\n"
1308 //usage:        "               the specified process to run on. The contents of this field are\n"
1309 //usage:        "               appended to \"/dev/\" and used as-is. There is no need for this field to\n"
1310 //usage:        "               be unique, although if it isn't you may have strange results. If this\n"
1311 //usage:        "               field is left blank, then the init's stdin/out will be used.\n"
1312 //usage:        "\n"
1313 //usage:        "       <runlevels>:\n"
1314 //usage:        "\n"
1315 //usage:        "               The runlevels field is completely ignored.\n"
1316 //usage:        "\n"
1317 //usage:        "       <action>:\n"
1318 //usage:        "\n"
1319 //usage:        "               Valid actions include: sysinit, respawn, askfirst, wait,\n"
1320 //usage:        "               once, restart, ctrlaltdel, and shutdown.\n"
1321 //usage:        "\n"
1322 //usage:        "               The available actions can be classified into two groups: actions\n"
1323 //usage:        "               that are run only once, and actions that are re-run when the specified\n"
1324 //usage:        "               process exits.\n"
1325 //usage:        "\n"
1326 //usage:        "               Run only-once actions:\n"
1327 //usage:        "\n"
1328 //usage:        "                       'sysinit' is the first item run on boot. init waits until all\n"
1329 //usage:        "                       sysinit actions are completed before continuing. Following the\n"
1330 //usage:        "                       completion of all sysinit actions, all 'wait' actions are run.\n"
1331 //usage:        "                       'wait' actions, like 'sysinit' actions, cause init to wait until\n"
1332 //usage:        "                       the specified task completes. 'once' actions are asynchronous,\n"
1333 //usage:        "                       therefore, init does not wait for them to complete. 'restart' is\n"
1334 //usage:        "                       the action taken to restart the init process. By default this should\n"
1335 //usage:        "                       simply run /sbin/init, but can be a script which runs pivot_root or it\n"
1336 //usage:        "                       can do all sorts of other interesting things. The 'ctrlaltdel' init\n"
1337 //usage:        "                       actions are run when the system detects that someone on the system\n"
1338 //usage:        "                       console has pressed the CTRL-ALT-DEL key combination. Typically one\n"
1339 //usage:        "                       wants to run 'reboot' at this point to cause the system to reboot.\n"
1340 //usage:        "                       Finally the 'shutdown' action specifies the actions to taken when\n"
1341 //usage:        "                       init is told to reboot. Unmounting filesystems and disabling swap\n"
1342 //usage:        "                       is a very good here.\n"
1343 //usage:        "\n"
1344 //usage:        "               Run repeatedly actions:\n"
1345 //usage:        "\n"
1346 //usage:        "                       'respawn' actions are run after the 'once' actions. When a process\n"
1347 //usage:        "                       started with a 'respawn' action exits, init automatically restarts\n"
1348 //usage:        "                       it. Unlike sysvinit, BusyBox init does not stop processes from\n"
1349 //usage:        "                       respawning out of control. The 'askfirst' actions acts just like\n"
1350 //usage:        "                       respawn, except that before running the specified process it\n"
1351 //usage:        "                       displays the line \"Please press Enter to activate this console.\"\n"
1352 //usage:        "                       and then waits for the user to press enter before starting the\n"
1353 //usage:        "                       specified process.\n"
1354 //usage:        "\n"
1355 //usage:        "               Unrecognized actions (like initdefault) will cause init to emit an\n"
1356 //usage:        "               error message, and then go along with its business. All actions are\n"
1357 //usage:        "               run in the order they appear in /etc/inittab.\n"
1358 //usage:        "\n"
1359 //usage:        "       <process>:\n"
1360 //usage:        "\n"
1361 //usage:        "               Specifies the process to be executed and its command line.\n"
1362 //usage:        "\n"
1363 //usage:        "Example /etc/inittab file:\n"
1364 //usage:        "\n"
1365 //usage:        "       # This is run first except when booting in single-user mode\n"
1366 //usage:        "       #\n"
1367 //usage:        "       ::sysinit:/etc/init.d/rcS\n"
1368 //usage:        "       \n"
1369 //usage:        "       # /bin/sh invocations on selected ttys\n"
1370 //usage:        "       #\n"
1371 //usage:        "       # Start an \"askfirst\" shell on the console (whatever that may be)\n"
1372 //usage:        "       ::askfirst:-/bin/sh\n"
1373 //usage:        "       # Start an \"askfirst\" shell on /dev/tty2-4\n"
1374 //usage:        "       tty2::askfirst:-/bin/sh\n"
1375 //usage:        "       tty3::askfirst:-/bin/sh\n"
1376 //usage:        "       tty4::askfirst:-/bin/sh\n"
1377 //usage:        "       \n"
1378 //usage:        "       # /sbin/getty invocations for selected ttys\n"
1379 //usage:        "       #\n"
1380 //usage:        "       tty4::respawn:/sbin/getty 38400 tty4\n"
1381 //usage:        "       tty5::respawn:/sbin/getty 38400 tty5\n"
1382 //usage:        "       \n"
1383 //usage:        "       \n"
1384 //usage:        "       # Example of how to put a getty on a serial line (for a terminal)\n"
1385 //usage:        "       #\n"
1386 //usage:        "       #::respawn:/sbin/getty -L ttyS0 9600 vt100\n"
1387 //usage:        "       #::respawn:/sbin/getty -L ttyS1 9600 vt100\n"
1388 //usage:        "       #\n"
1389 //usage:        "       # Example how to put a getty on a modem line\n"
1390 //usage:        "       #::respawn:/sbin/getty 57600 ttyS2\n"
1391 //usage:        "       \n"
1392 //usage:        "       # Stuff to do when restarting the init process\n"
1393 //usage:        "       ::restart:/sbin/init\n"
1394 //usage:        "       \n"
1395 //usage:        "       # Stuff to do before rebooting\n"
1396 //usage:        "       ::ctrlaltdel:/sbin/reboot\n"
1397 //usage:        "       ::shutdown:/bin/umount -a -r\n"
1398 //usage:        "       ::shutdown:/sbin/swapoff -a\n"