2018-01-13 01:40:42 +05:30
|
|
|
OpenRC README
|
|
|
|
|
=============
|
2007-11-19 21:40:33 +05:30
|
|
|
|
2015-04-23 01:24:12 +05:30
|
|
|
OpenRC is a dependency-based init system that works with the
|
2020-04-07 04:44:21 +05:30
|
|
|
system-provided init program, normally `/sbin/init`.
|
2015-04-23 01:24:12 +05:30
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
|
|
OpenRC requires GNU make.
|
|
|
|
|
|
|
|
|
|
Once you have GNU Make installed, the default OpenRC installation can be
|
|
|
|
|
executed using this command:
|
2007-11-19 21:40:33 +05:30
|
|
|
|
2021-03-14 02:14:24 +05:30
|
|
|
`make install`
|
2007-11-19 21:40:33 +05:30
|
|
|
|
2015-04-23 01:24:12 +05:30
|
|
|
## Configuration
|
|
|
|
|
|
|
|
|
|
You may wish to configure the installation by passing one or more of the
|
|
|
|
|
below arguments to the make command
|
|
|
|
|
|
2015-04-23 02:09:24 +05:30
|
|
|
```
|
2008-01-06 02:13:32 +05:30
|
|
|
PROGLDFLAGS=-static
|
2008-01-06 02:35:19 +05:30
|
|
|
LIBNAME=lib64
|
2007-11-19 21:40:33 +05:30
|
|
|
DESTDIR=/tmp/openrc-image
|
2017-12-08 00:23:04 +05:30
|
|
|
MKBASHCOMP=no
|
2013-03-19 04:59:36 +05:30
|
|
|
MKNET=no
|
2008-01-13 15:51:22 +05:30
|
|
|
MKPAM=pam
|
2012-08-31 19:52:12 +05:30
|
|
|
MKPREFIX=yes
|
2009-10-08 04:49:18 +05:30
|
|
|
MKPKGCONFIG=no
|
2011-01-31 03:50:07 +05:30
|
|
|
MKSELINUX=yes
|
2011-11-18 06:26:53 +05:30
|
|
|
MKSTATICLIBS=no
|
2017-05-31 23:45:32 +05:30
|
|
|
MKSYSVINIT=yes
|
2008-01-13 15:51:22 +05:30
|
|
|
MKTERMCAP=ncurses
|
|
|
|
|
MKTERMCAP=termcap
|
2017-12-08 00:23:04 +05:30
|
|
|
MKZSHCOMP=no
|
2008-02-28 16:38:49 +05:30
|
|
|
PKG_PREFIX=/usr/pkg
|
2008-03-03 16:03:42 +05:30
|
|
|
LOCAL_PREFIX=/usr/local
|
2008-02-28 16:38:49 +05:30
|
|
|
PREFIX=/usr/local
|
2015-04-23 01:24:12 +05:30
|
|
|
BRANDING=\"Gentoo/$(uname -s)\"
|
2019-02-08 04:38:12 +05:30
|
|
|
SH=/bin/sh
|
2015-04-23 02:09:24 +05:30
|
|
|
```
|
2015-04-23 01:24:12 +05:30
|
|
|
|
|
|
|
|
## Notes
|
2007-11-19 21:40:33 +05:30
|
|
|
|
2008-01-04 20:49:04 +05:30
|
|
|
We don't support building a static OpenRC with PAM.
|
2008-01-04 19:31:24 +05:30
|
|
|
|
2015-04-23 01:24:12 +05:30
|
|
|
You may need to use `PROGLDFLAGS=-Wl,-Bstatic` on glibc instead of just `-static`.
|
|
|
|
|
|
|
|
|
|
If you are building OpenRC for a Gentoo Prefix installation, add `MKPREFIX=yes`.
|
|
|
|
|
|
|
|
|
|
`PKG_PREFIX` should be set to where packages install to by default.
|
|
|
|
|
|
2019-11-17 23:23:48 +05:30
|
|
|
`LOCAL_PREFIX` should be set to where user maintained packages are.
|
2015-04-23 01:24:12 +05:30
|
|
|
Only set `LOCAL_PREFIX` if different from `PKG_PREFIX`.
|
2008-01-03 18:32:03 +05:30
|
|
|
|
2015-04-23 01:24:12 +05:30
|
|
|
`PREFIX` should be set when OpenRC is not installed to /.
|
2008-02-28 16:38:49 +05:30
|
|
|
|
2007-11-19 21:40:33 +05:30
|
|
|
If any of the following files exist then we do not overwrite them
|
2015-04-23 01:24:12 +05:30
|
|
|
|
2015-04-23 02:09:24 +05:30
|
|
|
```
|
2007-11-23 17:42:38 +05:30
|
|
|
/etc/devd.conf
|
2007-11-19 21:40:33 +05:30
|
|
|
/etc/rc
|
|
|
|
|
/etc/rc.shutdown
|
|
|
|
|
/etc/conf.d/*
|
2015-04-23 02:09:24 +05:30
|
|
|
```
|
2007-11-19 21:40:33 +05:30
|
|
|
|
2015-04-23 01:24:12 +05:30
|
|
|
`rc` and `rc.shutdown` are the hooks from the BSD init into OpenRC.
|
|
|
|
|
|
|
|
|
|
`devd.conf` is modified from FreeBSD to call `/etc/rc.devd` which is a
|
|
|
|
|
generic hook into OpenRC.
|
|
|
|
|
|
|
|
|
|
`inittab` is the same, but for SysVInit as used by most Linux distributions.
|
2008-01-06 02:13:32 +05:30
|
|
|
This can be found in the support folder.
|
2015-04-23 01:24:12 +05:30
|
|
|
|
|
|
|
|
Obviously, if you're installing this onto a system that does not use
|
|
|
|
|
OpenRC by default then you may wish to backup the above listed files,
|
|
|
|
|
remove them and then install so that the OS hooks into OpenRC.
|
|
|
|
|
|
|
|
|
|
## Reporting Bugs
|
|
|
|
|
|
2021-03-29 23:17:33 +05:30
|
|
|
Please report issues on our github bug tracker [1].
|
2015-04-23 01:24:12 +05:30
|
|
|
|
|
|
|
|
Better yet, if you can contribute code, please feel free to submit pull
|
2021-03-29 23:17:33 +05:30
|
|
|
requests [2].
|
2015-04-23 01:24:12 +05:30
|
|
|
|
|
|
|
|
## IRC Channel
|
|
|
|
|
|
|
|
|
|
We have an official irc channel, #openrc on freenode, feel free to join
|
|
|
|
|
us there.
|
|
|
|
|
|
2021-03-29 23:17:33 +05:30
|
|
|
[1] https://github.com/openrc/openrc/issues
|
|
|
|
|
[2] https://github.com/openrc/openrc/pulls
|
