From eb4218d0a4b3f96a61ddd89726b0214630c87769 Mon Sep 17 00:00:00 2001 From: Eric Andersen <andersen@codepoet.org> Date: Fri, 8 Dec 2000 20:38:00 +0000 Subject: Update inittab docs --- docs/busybox.pod | 38 +++++++++++++++++++++++++++++++------- docs/busybox.sgml | 52 ++++++++++++++++++++++++++++++++++++++++++---------- 2 files changed, 73 insertions(+), 17 deletions(-) diff --git a/docs/busybox.pod b/docs/busybox.pod index 9b92d1981..2ddacd152 100644 --- a/docs/busybox.pod +++ b/docs/busybox.pod @@ -900,13 +900,37 @@ If you choose to use an /etc/inittab file, the inittab entry format is as follow Valid actions include: sysinit, respawn, askfirst, wait, once, and ctrlaltdel. - askfirst acts just like respawn, but before running the specified - process it displays the line "Please press Enter to activate this - console." and then waits for the user to press enter before starting - the specified process. - Unrecognized actions (like initdefault) will cause init to emit - an error message, and then go along with its business. + The available actions can be classified into two groups: actions + that are run only once, and actions that are re-run when the specified + process exits. + + Run only-once actions: + + 'sysinit' is the first item run on boot. init waits until all + sysinit actions are completed before continuing. Following the + completion of all sysinit actions, all 'wait' actions are run. + 'wait' actions, like 'sysinit' actions, cause init to wait until + the specified task completes. 'once' actions are asyncronous, + therefore, init does not wait for them to complete. 'ctrlaltdel' + actions are run immediately before init causes the system to reboot + (unmounting filesystems with a 'ctrlaltdel' action is a very good + idea). + + Run repeatedly actions: + + 'respawn' actions are run after the 'once' actions. When a process + started with a 'respawn' action exits, init automatically restarts + it. Unlike sysvinit, BusyBox init does not stop processes from + respawning out of control. The 'askfirst' actions acts just like + respawn, except that before running the specified process it + displays the line "Please press Enter to activate this console." + and then waits for the user to press enter before starting the + specified process. + + Unrecognized actions (like initdefault) will cause init to emit an + error message, and then go along with its business. All actions are + run in the reverse order from how they appear in /etc/inittab. <process>: @@ -2262,4 +2286,4 @@ Enrique Zanardi <ezanardi@ull.es> =cut -# $Id: busybox.pod,v 1.78 2000/12/08 19:52:01 andersen Exp $ +# $Id: busybox.pod,v 1.79 2000/12/08 20:38:00 andersen Exp $ diff --git a/docs/busybox.sgml b/docs/busybox.sgml index 1542337dd..184814125 100644 --- a/docs/busybox.sgml +++ b/docs/busybox.sgml @@ -1538,24 +1538,56 @@ <sect2> <title>action</title> + + <para> + Valid actions include: sysinit, respawn, askfirst, wait, + once, and ctrlaltdel. + </para> + + + <para> + The available actions can be classified into two groups: actions + that are run only once, and actions that are re-run when the specified + process exits. + </para> + <para> - Valid actions include: sysinit, respawn, - askfirst, wait, once, and ctrlaltdel. + Run only-once actions: </para> <para> - askfirst acts just like respawn, but before - running the specified process it displays the - line "Please press Enter to activate this - console." and then waits for the user to press - enter before starting the specified process. + 'sysinit' is the first item run on boot. init waits until all + sysinit actions are completed before continuing. Following the + completion of all sysinit actions, all 'wait' actions are run. + 'wait' actions, like 'sysinit' actions, cause init to wait until + the specified task completes. 'once' actions are asyncronous, + therefore, init does not wait for them to complete. 'ctrlaltdel' + actions are run immediately before init causes the system to reboot + (unmounting filesystems with a 'ctrlaltdel' action is a very good + idea). </para> <para> - Unrecognized actions (like initdefault) will - cause init to emit an error message, and then go - along with its business. + Run repeatedly actions: </para> + + <para> + 'respawn' actions are run after the 'once' actions. When a process + started with a 'respawn' action exits, init automatically restarts + it. Unlike sysvinit, BusyBox init does not stop processes from + respawning out of control. The 'askfirst' actions acts just like + respawn, except that before running the specified process it + displays the line "Please press Enter to activate this console." + and then waits for the user to press enter before starting the + specified process. + </para> + + <para> + Unrecognized actions (like initdefault) will cause init to emit an + error message, and then go along with its business. All actions are + run in the reverse order from how they appear in /etc/inittab. + </para> + </sect2> <sect2> -- cgit v1.2.3