[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#727708: additional OpenRC information: OpenRC now in Debian Experimental!



On 01/04/2014 01:42 AM, Ian Jackson wrote:
> Thomas Goirand writes ("Bug#727708: additional OpenRC information: OpenRC now in Debian Experimental!"):
>> OpenRC is now in Debian experimental! \o/
> 
> Good, thanks.
> 
>> I of course welcome anyone to try OpenRC and report bugs.
> 
> Can you point me to the relevant reference documentation ?
> 
> Thanks,
> Ian.

Hi Ian,

I'm not sure what kind of doc you are looking for. If you want to know
how to install it, well, it's just an "apt-get install openrc" plus a
tricky first reboot. Otherwise, read further.

You can first have a look over here:
https://wiki.debian.org/OpenRC

Though I just have made some edits to make it up-to-date, that page is
still a work in progress, and would need much improvements, like how to
write runscripts and so on.

There's also this from Gentoo upstream:
http://wiki.gentoo.org/wiki/OpenRC

As much as I know, most of the available documentation is available from
the set of man pages from the OpenRC project. Here's a list of available
manpages:
einfo.3 openrc.8 rc_config.3 rc_find_pids.3 rc_runlevel.3  rc-service.8
rc_stringlist.3 service.8 openrc-run.8 rc_deptree.3 rc_plugin_hook.3
rc_service.3 rc-status.8 rc-update.8 start-stop-daemon.8

They are not all installed by the Debian package yet, so you may want to
have a look in the man folder of the source package.

You can to start reading the man page for openrc-run, which describe how
to write OpenRC "runscripts". A runscript is what can replace init
scripts, eg you would replace #!/bin/sh  by #!/sbin/openrc-run. FYI,
openrc-run is the new name of /sbin/runscript. It was renamed because of
the clash with the command line from minicom. I guess we'll keep the
therm "runscript" for a while still, even if it's really referring to
"openrc-run" now.

But probably, the most easy way to learn how to make runscripts is to
read what's been done in Gentoo. Inside the openrc source package, under
the init.d script, there's a bunch of runscripts which you can read as
examples. When reading them, keep in mind that these are rather complex,
and most of the daemons in Debian will not need that complexity.

If you need to know more, let me know.

Cheers,

Thomas Goirand (zigo)


Reply to: