From: Shamus Hammons Date: Mon, 3 Apr 2017 15:07:37 +0000 (-0500) Subject: Updated README. X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?p=init-ng;a=commitdiff_plain;h=816f53f5e41f9d049f5643e3d3112431fd649845 Updated README. --- diff --git a/.gitignore b/.gitignore index 1d45c0a..2f15055 100644 --- a/.gitignore +++ b/.gitignore @@ -1 +1,2 @@ +init-ng *.patch diff --git a/README b/README index 7f5e224..b4a95fc 100644 --- a/README +++ b/README @@ -5,37 +5,36 @@ RATIONALE --------- init-ng is meant to be a drop-in replacement for Sys V init. It leverages the -mighty power of OpenRC to do only what's needed, and nothing more! It is still -somewhat experimental (hence written in Ruby) but works well. Currently, it -can reliably bring the system up, bring it down, and respawn agettys if they -die. +mighty power of OpenRC to do only what's needed, and nothing more! Currently, +it can reliably bring the system up, bring it down three different ways, and +respawn agettys if they die. init-ng can also be extended fairly easily as well; for those who want service supervision or socket activation, these can be fairly easily added. There is already some supervision capability built-in, as init-ng monitors the agettys that it spawns; this can be extended to other services as well. -Note that while this init is written in Ruby, init-ng will eventually be -written in C. It's being developed in Ruby in order to make development and -testing easy. - HOW TO INSTALL/USE IT --------------------- - • Make sure you have Ruby 2.1.x installed. +First, run 'make' to create the init-ng binary. Then, there are two main ways +to install it. First way: + • Move your current init binary out of the way (mv /sbin/init /sbin/init.sysv) - • Copy the init script to /sbin (cp ./init /sbin/) - • Make sure /sbin/init is marked executable (chmod ugo+x /sbin/init) + • Copy the init-ng binary to /sbin (cp ./init-ng /sbin/init) • Reboot -Once you have rebooted successfully and logged in as root, typing 'init' on the -command line will display the commands that init-ng understands. +Second way: + + • Copy the init-ng binary to /sbin (cp ./init-ng /sbin/) + • Add a kernel parameter with 'init=/sbin/init-ng' (without the quotes) to + your current kernel boot command line + • Reboot -It is also possible to leave the existing init in place without renaming it; in -this case you would rename the new init to something else, such as init-ng. -Then, on your kernel boot command line, you would add "init=/sbin/init-ng" -(without the quotes) to have the kernel use it instead of your current init. +Once you have rebooted successfully and logged in as root, typing 'init' (or +'init-ng', if you installed the second way) on the command line will display +the commands that init-ng understands. CREDITS