Quoting Michael H. Warfield ([email protected]): > This is a part of (now) 4 patches controlling the autoboot process. > Dwight submitted the first patch to change the sysvinit script and the > systemd service to use the sysvinit script during the autoboot process. > > Subject: [PATCH v2] have systemd service call lxc-autostart via script > > I then submitted 2 patches under: > > Subject: [PATCH] Add a non-null group for autobooting > > The first patch added the "onboot" group to the sysvinit script and the > second added the same functionality to the Upstart lxc.conf file so our > three major init systems behave coherently. > > This now completes the set by adding documentation to the lxc-autostart > and lxc.container.conf man pages documented the boot up behavior and and > the various start options. > > All four patches need to be applied in concert. > > Regards, > Mike > > -- > Documentation for Autoboot behaviour. > > Added sections to lxc-autostart and lxc.container.config to document > the behavior of the LXC service at host system boot time with regards > to the lxc.group and lxc.start.auto parameters. > > Signed-off-by: Michael H. Warfield <[email protected]>
Thanks Michael, sorry about the delay. Acked-by: Serge E. Hallyn <[email protected]> > --- > doc/lxc-autostart.sgml.in | 30 ++++++++++++++++++++++++++++++ > doc/lxc.container.conf.sgml.in | 23 +++++++++++++++++++++++ > 2 files changed, 53 insertions(+) > > diff --git a/doc/lxc-autostart.sgml.in b/doc/lxc-autostart.sgml.in > index 3d423dd..116d7bc 100644 > --- a/doc/lxc-autostart.sgml.in > +++ b/doc/lxc-autostart.sgml.in > @@ -185,6 +185,36 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, > Boston, MA 02110-1301 USA > </variablelist> > </refsect1> > > + <refsect1> > + <title>Autostart and System Boot</title> > + > + <para> > + The <command>lxc-autostart</command> command is used as part of > the > + LXC system service, when enabled to run on host system at bootup > and at > + shutdown. It's used to select which containers to start in what > order > + and how much to delay between each startup when the host system > boots. > + </para> > + > + <para> > + Each container can be part of any number of groups or no group > at all. > + Two groups are special. One is the NULL group, i.e. the > container does > + not belong to any group. The other group is the "onboot" group. > + </para> > + > + <para> > + When the system boots with the LXC service enabled, it will first > + attempt to boot any containers with lxc.start.auto == 1 that is > a member > + of the "onboot" group. The startup will be in order of > lxc.start.order. > + If an lxc.start.delay has been specified, that delay will be > honored > + before attempting to start the next container to give the current > + container time to begin initialization and reduce overloading > the host > + system. After starting the members of the "onboot" group, the > LXC system > + will proceed to boot containers with lxc.start.auto == 1 which > are not > + members of any group (the NULL group) and proceed as with the > onboot > + group. > + </para> > + </refsect1> > + > &seealso; > > <refsect1> > diff --git a/doc/lxc.container.conf.sgml.in b/doc/lxc.container.conf.sgml.in > index 6e96889..bbae448 100644 > --- a/doc/lxc.container.conf.sgml.in > +++ b/doc/lxc.container.conf.sgml.in > @@ -1464,6 +1464,29 @@ mknod errno 0 > </varlistentry> > </variablelist> > </refsect2> > + > + <refsect2> > + <title>Autostart and System Boot</title> > + <para> > + Each container can be part of any number of groups or no group at > all. > + Two groups are special. One is the NULL group, i.e. the container > does > + not belong to any group. The other group is the "onboot" group. > + </para> > + > + <para> > + When the system boots with the LXC service enabled, it will first > + attempt to boot any containers with lxc.start.auto == 1 that is a > member > + of the "onboot" group. The startup will be in order of > lxc.start.order. > + If an lxc.start.delay has been specified, that delay will be > honored > + before attempting to start the next container to give the current > + container time to begin initialization and reduce overloading the > host > + system. After starting the members of the "onboot" group, the LXC > system > + will proceed to boot containers with lxc.start.auto == 1 which are > not > + members of any group (the NULL group) and proceed as with the > onboot > + group. > + </para> > + > + </refsect2> > </refsect1> > > <refsect1> > -- > 1.9.0 > > > -- > Michael H. Warfield (AI4NB) | (770) 978-7061 | [email protected] > /\/\|=mhw=|\/\/ | (678) 463-0932 | http://www.wittsend.com/mhw/ > NIC whois: MHW9 | An optimist believes we live in the best of all > PGP Key: 0x674627FF | possible worlds. A pessimist is sure of it! > > _______________________________________________ > lxc-devel mailing list > [email protected] > http://lists.linuxcontainers.org/listinfo/lxc-devel _______________________________________________ lxc-devel mailing list [email protected] http://lists.linuxcontainers.org/listinfo/lxc-devel
