From a0d7c46e801a5d5874eae9a9ec55588863a97483 Mon Sep 17 00:00:00 2001
From: Starbeamrainbowlabs <sbrl@starbeamrainbowlabs.com>
Date: Mon, 27 Jan 2020 13:13:47 +0000
Subject: [PATCH] openrc, rc-status, rc-service, rc-update: add pages (#3800)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* rc-status: add page

* openrc: add page

* rc-service: add page

* rc-update: add page

* rc-status: add list all runlevels example

* openrc: fix travis errors

* rc-status: fix travis errors again

* Update pages/linux/rc-update.md

Co-Authored-By: Zlatan Vasović <zlatanvasovic@gmail.com>

* Update pages/linux/rc-status.md

Co-Authored-By: Zlatan Vasović <zlatanvasovic@gmail.com>

Co-authored-by: Zlatan Vasović <zlatanvasovic@gmail.com>
---
 pages/linux/openrc.md     | 13 +++++++++++++
 pages/linux/rc-service.md | 32 ++++++++++++++++++++++++++++++++
 pages/linux/rc-status.md  | 32 ++++++++++++++++++++++++++++++++
 pages/linux/rc-update.md  | 20 ++++++++++++++++++++
 4 files changed, 97 insertions(+)
 create mode 100644 pages/linux/openrc.md
 create mode 100644 pages/linux/rc-service.md
 create mode 100644 pages/linux/rc-status.md
 create mode 100644 pages/linux/rc-update.md

diff --git a/pages/linux/openrc.md b/pages/linux/openrc.md
new file mode 100644
index 0000000000..c3e4417549
--- /dev/null
+++ b/pages/linux/openrc.md
@@ -0,0 +1,13 @@
+# openrc
+
+> The OpenRC service manager.
+> See also `rc-status`, `rc-update`, and `rc-service`.
+> More information: <https://wiki.gentoo.org/wiki/OpenRC>.
+
+- Change to a specific runlevel:
+
+`sudo openrc {{runlevel_name}}`
+
+- Change to a specific runlevel, but don't stop any existing services:
+
+`sudo openrc --no-stop {{runlevel_name}}`
diff --git a/pages/linux/rc-service.md b/pages/linux/rc-service.md
new file mode 100644
index 0000000000..fe8f9bdd01
--- /dev/null
+++ b/pages/linux/rc-service.md
@@ -0,0 +1,32 @@
+# rc-service
+
+> Locate and run OpenRC services with arguments.
+> See also `openrc`.
+
+- Show a service's status:
+
+`rc-service {{service_name}} status`
+
+- Start a service:
+
+`sudo rc-service {{service_name}} start`
+
+- Stop a service:
+
+`sudo rc-servie {{service_name}} stop`
+
+- Restart a service:
+
+`sudo rc-service {{service_name}} restart`
+
+- Simulate running a service's custom command:
+
+`sudo rc-service --dry-run {{service_name}} {{command_name}}`
+
+- Actually run a service's custom command:
+
+`sudo rc-service {{service_name}} {{command_name}}`
+
+- Resolve the location of a service definition on disk:
+
+`sudo rc-service --resolve {{service_name}}`
diff --git a/pages/linux/rc-status.md b/pages/linux/rc-status.md
new file mode 100644
index 0000000000..a735cbf9d5
--- /dev/null
+++ b/pages/linux/rc-status.md
@@ -0,0 +1,32 @@
+# rc-status
+
+> Show status info about runlevels.
+> See also `openrc`.
+
+- Show a summary of services and their status:
+
+`rc-status`
+
+- Include services in all runlevels in the summary:
+
+`rc-status --all`
+
+- List services that have crashed:
+
+`rc-status --crashed`
+
+- List manually started services:
+
+`rc-status --manual`
+
+- List supervised services:
+
+`rc-status --supervised`
+
+- Get the current runlevel:
+
+`rc-status --runlevel`
+
+- List all runlevels:
+
+`rc-status --list`
diff --git a/pages/linux/rc-update.md b/pages/linux/rc-update.md
new file mode 100644
index 0000000000..225141262d
--- /dev/null
+++ b/pages/linux/rc-update.md
@@ -0,0 +1,20 @@
+# rc-update
+
+> Add and remove OpenRC services to and from runlevels.
+> See also `openrc`.
+
+- List all services and the runlevels they are added to:
+
+`rc-update show`
+
+- Add a service to a runlevel:
+
+`sudo rc-update add {{service_name}} {{runlevel}}`
+
+- Delete a service from a runlevel:
+
+`sudo rc-update delete {{service_name}} {{runlevel}}`
+
+- Delete a service from all runlevels:
+
+`sudo rc-update --all delete {{service_name}}`