commit ff361e15052f955e42564f5379d36c4887d1534c
parent 24bdfb3b50c8388d7a1d08a073c0b5b482bbe0b4
Author: Friedel Schön <[email protected]>
Date: Tue, 30 May 2023 16:14:04 +0200
drop md2man dependency, add own man-generator
Diffstat:
45 files changed, 1694 insertions(+), 990 deletions(-)
diff --git a/Makefile b/Makefile
@@ -1,4 +1,4 @@
-VERSION = 0.3.2
+VERSION := 0.3.2
# Directories
SRC_DIR := src
@@ -13,6 +13,7 @@ DOCS_DIR := docs
ASSETS_DIR := assets
DOC_AST_DIR := docs/assets
MAKE_DOCS := make-docs.py
+MAKE_MAN := make-man.py
# Compiler Options
CC ?= gcc
@@ -34,12 +35,12 @@ BIN_FILES := $(patsubst $(EXEC_DIR)/%.c,$(BIN_DIR)/%,$(EXEC_FILES)) \
$(patsubst $(EXEC_DIR)/%.lnk,$(BIN_DIR)/%,$(EXEC_FILES))
INCLUDE_FILES := $(wildcard $(INCLUDE_DIR)/*.h)
-MAN_FILES := $(wildcard $(MAN_DIR)/*)
-ROFF_FILES := $(patsubst $(MAN_DIR)/%.md,$(ROFF_DIR)/%,$(MAN_FILES)) \
- $(patsubst $(MAN_DIR)/%.roff,$(ROFF_DIR)/%,$(MAN_FILES))
-
+MAN_FILES := $(wildcard $(MAN_DIR)/*.txt)
TEMPL_FILES := $(wildcard $(TEMPL_DIR)/*.txt)
-DOCS_FILES := $(patsubst $(TEMPL_DIR)/%.txt,$(DOCS_DIR)/%.html,$(TEMPL_FILES))
+
+ROFF_FILES := $(patsubst $(MAN_DIR)/%.txt,$(ROFF_DIR)/%,$(MAN_FILES))
+DOCS_FILES := $(patsubst $(TEMPL_DIR)/%.txt,$(DOCS_DIR)/%.html,$(TEMPL_FILES)) \
+ $(patsubst $(MAN_DIR)/%.txt,$(DOCS_DIR)/%.html,$(MAN_FILES))
# Intermediate directories
INTERMED_DIRS := $(BIN_DIR) $(BUILD_DIR) $(ROFF_DIR) $(DOCS_DIR)
@@ -85,18 +86,16 @@ $(BIN_DIR)/%: $(EXEC_DIR)/%.sh | $(BIN_DIR)
$(BIN_DIR)/%: $(EXEC_DIR)/%.lnk | $(BIN_DIR)
ln -sf $(shell cat $<) $@
-
+
+# Documentation and Manual
$(DOCS_DIR)/%.html: $(TEMPL_DIR)/%.txt $(DOC_AST_DIR) | $(DOCS_DIR)
$(SED) 's/%VERSION%/$(VERSION)/' $< | $(PYTHON) $(MAKE_DOCS) > $@
+$(DOCS_DIR)/%.html: $(MAN_DIR)/%.txt $(DOC_AST_DIR) | $(DOCS_DIR)
+ $(SED) 's/%VERSION%/$(VERSION)/' $< | $(PYTHON) $(MAKE_DOCS) > $@
-# Manual targets
-
-$(ROFF_DIR)/%: $(MAN_DIR)/%.md | $(ROFF_DIR)
- $(SED) 's/%VERSION%/$(VERSION)/' $< | md2man-roff > $@
-
-$(ROFF_DIR)/%: $(MAN_DIR)/%.roff | $(ROFF_DIR)
- $(SED) 's/%VERSION%/$(VERSION)/' $< > $@
+$(ROFF_DIR)/%: $(MAN_DIR)/%.txt | $(ROFF_DIR)
+ $(SED) 's/%VERSION%/$(VERSION)/' $< | $(PYTHON) $(MAKE_MAN) > $@
# Debug
compile_flags.txt:
diff --git a/docs/chpst.8.html b/docs/chpst.8.html
@@ -0,0 +1,88 @@
+<!doctype html>
+<html lang=en>
+
+<head>
+ <title>Friedel's Initialization and Service Supervision</title>
+ <meta charset=utf-8 />
+ <meta name=viewport content='width=device-width,initial-scale=1' />
+ <link rel=stylesheet href=assets/style.css />
+ <script type=text/javascript src=assets/toggle-dark.js></script>
+</head>
+
+<body>
+<div id=wrapper>
+<span class=header><a class=title id=top href=#top>chpst(8) 0.3.2</a><span class=right><span id=toggle_dark onclick=toggle_dark()> turn the lights on </span> <a href=https://github.com/friedelschoen/fiss><img id=github alt=GitHub src=assets/github-mark.svg /></a></span></span>
+================================================================================
+
+<a class=title id=name href=#name>Name</a>
+--------------------------------------------------------------------------------
+
+<b>chpst</b> - runs a program with a changed process state
+
+<a class=title id=synopsis href=#synopsis>Synopsis</a>
+--------------------------------------------------------------------------------
+
+<b>chpst</b> [<b>-vP012</b>] [<b>-u</b> user] [<b>-U</b> user] [<b>-b</b> argv0] [<b>-e</b> dir] [<b>-/</b> root] [<b>-n</b> inc] [<b>-l</b>|<b>-L</b> lock] [<b>-m</b> bytes] [<b>-d</b> bytes] [<b>-o</b> n] [<b>-p</b> n] [<b>-f</b> bytes] [<b>-c</b> bytes] prog [arguments...]
+
+<a class=title id=description href=#description>Description</a>
+--------------------------------------------------------------------------------
+<ul>
+<li><b>-u [:]user[:group]</b>
+setuidgid. Set uid and gid to the user's uid and gid, as found in /etc/passwd. If user is followed by a colon and a group, set the gid to group's gid, as found in /etc/group, instead of user's gid. If group consists of a colon-separated list of group names, chpst sets the group ids of all listed groups. If user is prefixed with a colon, the user and all group arguments are interpreted as uid and gids respectivly, and not looked up in the password or group file. All initial supplementary groups are removed. </li>
+<li><b>-U [:]user[:group]</b>
+envuidgid. Set the environment variables $UID and $GID to the user's uid and gid, as found in /etc/passwd. If user is followed by a colon and a group, set $GID to the group's gid, as found in /etc/group, instead of user's gid. If user is prefixed with a colon, the user and group arguments are interpreted as uid and gid respectivly, and not looked up in the password or group file. </li>
+<li><b>-b argv0</b>
+Run prog with argv0 as the 0th argument. </li>
+<li><b>-/ root</b>
+Change the root directory to root before starting prog. </li>
+<li><b>-C pwd</b>
+Change the working directory to pwd before starting prog. When combined with -/, the working directory is changed after the chroot. </li>
+<li><b>-n inc</b>
+Add inc to the nice(2) value before starting prog. inc must be an integer, and may start with a minus or plus. </li>
+<li><b>-l lock</b>
+Open the file lock for writing, and obtain an exclusive lock on it. lock will be created if it does not exist. If lock is locked by another process, wait until a new lock can be obtained. </li>
+<li><b>-L lock</b>
+The same as -l, but fail immediately if lock is locked by another process. </li>
+<li><b>-P</b>
+Run prog in a new process group. </li>
+<li><b>-0</b>
+Close standard input before starting prog. </li>
+<li><b>-1</b>
+Close standard output before starting prog. </li>
+<li><b>-2</b>
+Close standard error before starting prog. </li></ul>
+
+<a class=title id=not-implemented href=#not-implemented>Not Implemented</a>
+--------------------------------------------------------------------------------
+
+Following options are defined in runit's chpst but are ignored by fiss' implementation.
+<ul>
+<li><b>-e dir</b>
+Set various environment variables as specified by files in the directory dir: If dir contains a file named k whose first line is v, chpst removes the environment variable k if it exists, and then adds the environment variable k with the value v. The name k must not contain =. Spaces and tabs at the end of v are removed, and nulls in v are changed to newlines. If the file k is empty (0 bytes long), chpst removes the environment variable k if it exists, without adding a new variable. </li>
+<li><b>-m bytes</b>
+Limit the data segment, stack segment, locked physical pages, and total of all segment per process to bytes bytes each. </li>
+<li><b>-d bytes</b>
+limit data segment. Limit the data segment per process to bytes bytes. </li>
+<li><b>-o n</b>
+Limit the number of open file descriptors per process to n. </li>
+<li><b>-p n</b>
+Limit the number of processes per uid to n. </li>
+<li><b>-f bytes</b>
+Limit the output file size to bytes bytes. </li>
+<li><b>-c bytes</b>
+Limit the core file size to bytes bytes. </li>
+<li><b>-v</b>
+Print verbose messages to standard error. This includes warnings about limits unsupported by the system. </li></ul>
+<a class=title id=exit-codes href=#exit-codes>Exit Codes</a>
+--------------------------------------------------------------------------------
+
+chpst exits 100 when called with wrong options. It prints an error message and exits 111 if it has trouble changing the process state. Otherwise its exit code is the same as that of prog.
+
+<a class=title id=author href=#author>Author</a>
+--------------------------------------------------------------------------------
+
+Based on the implementation by Gerrit Pape <[email protected]>, rewritten by Friedel Schon <[email protected]>
+</div>
+</body>
+</html>
+
diff --git a/docs/finit.8.html b/docs/finit.8.html
@@ -0,0 +1,66 @@
+<!doctype html>
+<html lang=en>
+
+<head>
+ <title>Friedel's Initialization and Service Supervision</title>
+ <meta charset=utf-8 />
+ <meta name=viewport content='width=device-width,initial-scale=1' />
+ <link rel=stylesheet href=assets/style.css />
+ <script type=text/javascript src=assets/toggle-dark.js></script>
+</head>
+
+<body>
+<div id=wrapper>
+
+<a class=title id=name href=#name>Name</a>
+--------------------------------------------------------------------------------
+
+fiss - a UNIX process no 1
+<a class=title id=synopsis href=#synopsis>Synopsis</a>
+--------------------------------------------------------------------------------
+
+<ul>
+<li><b>fsvc</b> when running as PID 0 (as init) </li>
+<li><b>fsvc</b> <0|6> when running regulary to controll init </li></ul>
+<a class=title id=controlling href=#controlling>Controlling</a>
+--------------------------------------------------------------------------------
+
+If <b>finit</b> is invoked by any other user than <i>root</i>, it failes.
+<ul>
+<li><b>finit</b> 0 halts the system </li>
+<li><b>finit</b> 6 reboots the system </li></ul>
+<a class=title id=description href=#description>Description</a>
+--------------------------------------------------------------------------------
+
+<b>fiss</b> must be run as Unix process no 1 if invoked without arguments and handles the boot process in user-land.
+This happens in three stages:
+<a class=title id=stage href=#stage>Stage 1</a>
+--------------------------------------------------------------------------------
+
+<b>fiss</b> runs <i>/etc/fiss/start</i> and waits for it to terminate. The system's one time tasks are done here. <i>/etc/fiss/start</i> has full control of <i>/dev/console</i> to be able to start an emergency shell if the one time initialization tasks fail. If <i>/etc/fiss/start</i> crashes, <b>finit</b> will skip stage 2 and enter stage 3.
+<a class=title id=stage href=#stage>Stage 2</a>
+--------------------------------------------------------------------------------
+
+<b>fiss</b> starts all services in <i>/etc/fiss/service.d</i> which should not return until system shutdown; if it crashes, it will be restarted.
+<a class=title id=stage href=#stage>Stage 3</a>
+--------------------------------------------------------------------------------
+
+If <b>fiss</b> is told to shutdown the system, it terminates stage 2 if it is running, and runs <i>/etc/fiss/stop</i>. The systems tasks to shutdown and possibly halt or reboot the system are done here. If stage 3 returns, <b>finit</b> checks if the file
+<a class=title id=signals href=#signals>Signals</a>
+--------------------------------------------------------------------------------
+
+<b>finit</b> only accepts signals in stage 2.
+If <b>finit</b> receives a CONT signal and the file <b>finit</b> is told to shutdown the system.
+if <b>finit</b> receives an INT signal, <b>finit</b> restarts the system.
+<a class=title id=see href=#see>See ALSO</a>
+--------------------------------------------------------------------------------
+
+fiss-init(8), runsvdir(8), runsvchdir(8), sv(8), runsv(8), chpst(8), utmpset(8), svlogd(8)
+<a class=title id=author href=#author>Author</a>
+--------------------------------------------------------------------------------
+
+Friedel Schön <[email protected]>
+</div>
+</body>
+</html>
+
diff --git a/docs/fsvc.8.html b/docs/fsvc.8.html
@@ -0,0 +1,75 @@
+<!doctype html>
+<html lang=en>
+
+<head>
+ <title>Friedel's Initialization and Service Supervision</title>
+ <meta charset=utf-8 />
+ <meta name=viewport content='width=device-width,initial-scale=1' />
+ <link rel=stylesheet href=assets/style.css />
+ <script type=text/javascript src=assets/toggle-dark.js></script>
+</head>
+
+<body>
+<div id=wrapper>
+
+<a class=title id=name href=#name>Name</a>
+--------------------------------------------------------------------------------
+
+<b>fsvc</b> - fiss' service controller
+<a class=title id=synopsis href=#synopsis>Synopsis</a>
+--------------------------------------------------------------------------------
+
+<b>fsvc</b> <b>start</b> [<i>options</i>] [<b>--pin_</b>] <service>
+<b>fsvc</b> <b>stop</b> [<i>options</i>] [<b>--pin</b>] <service>
+<b>fsvc</b> <b>enable</b> [<i>options</i>] [<b>--once</b>] <service>
+<b>fsvc</b> <b>disable</b> [<i>options</i>] [<b>--once</b>] <service>
+<b>fsvc</b> <b>kill</b> [<i>options</i>] <service> <signal|signo>
+<b>fsvc</b> <b>status</b> [<i>options</i>] [<b>--check</b>] [<service>]
+<b>fsvc</b> <b>pause</b> [<i>options</i>] <service>
+<b>fsvc</b> <b>resume</b> [<i>options</i>] <service>
+<b>fsvc</b> <b>switch</b> [<i>options</i>] [<b>--reset</b>] <runlevel>
+<a class=title id=description href=#description>Description</a>
+--------------------------------------------------------------------------------
+
+<b>fsvc</b> is a command line tool for controlling services on a fiss system. It provides various commands for starting, stopping, enabling, disabling, sending signals to, checking the status of, pausing, resuming, and switching the runlevel of services.
+<a class=title id=options href=#options>Options</a>
+--------------------------------------------------------------------------------
+
+The following options are available for every command:
+<ul>
+<li><b>-q, --short</b> Will print brief information about the service. </li>
+<li><b>-r, --runlevel <runlevel></b> Will use fBrunlevelfB instead of <i>default</i>. </li>
+<li><b>-s, --service-dir <path></b> Will use <b>path</b> as service directory instead of <i>/etc/fiss/service.d</i>. </li>
+<li><b>-v, --verbose</b> Prints verbose information. </li>
+<li><b>-V, --version</b> Prints the version and exits. </li>
+<li>The following options are available per command: </li>
+<li><b>-p, --pin</b> Pins the state. If issued with <b>start</b> it will cause the service to restart. If issued with <b>stop</b> it will cause the service to be hold down. </li>
+<li><b>-o, --once</b> Specifies that the service should only be enabled/disabled once and not automatically started/stopped on subsequent bootups. </li>
+<li><b>-c, --check</b> Command will return <i>0</i> if the specified service is active otherwise <i>1</i> </li>
+<li><b>-r, --reset</b> Specifies that the switch command should reset all running services (if manually set to up/down) </li></ul>
+<a class=title id=commands href=#commands>Commands</a>
+--------------------------------------------------------------------------------
+
+The following commands are available:
+<ul>
+<li><b>start</b> Starts the specified service. A synonym is <b>up</b>. </li>
+<li><b>stop</b> Stops the specified service. A synonym is <b>down</b>. </li>
+<li><b>enable</b> Enables the specified service, causing it to automatically start on subsequent bootups. </li>
+<li><b>disable</b> Disables the specified service, causing it to not start automatically on subsequent bootups. </li>
+<li><b>kill</b> Sends the specified signal or signal number to the specified service. A synonym is <b>send</b>. </li>
+<li><b>status</b> Displays the status of the specified service. If no service is specified, displays the status of all services. </li>
+<li><b>pause</b> Pauses the specified service. </li>
+<li><b>resume</b> Resumes the specified service. </li>
+<li><b>switch</b> Switches the runlevel to the specified value. </li></ul>
+<a class=title id=see href=#see>See ALSO</a>
+--------------------------------------------------------------------------------
+
+finit(1), fsvc(8), fsvs(8), halt(8), modules-load(8), shutdown(8),
+<a class=title id=author href=#author>Author</a>
+--------------------------------------------------------------------------------
+
+Friedel Schön <[email protected]>
+</div>
+</body>
+</html>
+
diff --git a/docs/fsvs.8.html b/docs/fsvs.8.html
@@ -0,0 +1,40 @@
+<!doctype html>
+<html lang=en>
+
+<head>
+ <title>Friedel's Initialization and Service Supervision</title>
+ <meta charset=utf-8 />
+ <meta name=viewport content='width=device-width,initial-scale=1' />
+ <link rel=stylesheet href=assets/style.css />
+ <script type=text/javascript src=assets/toggle-dark.js></script>
+</head>
+
+<body>
+<div id=wrapper>
+
+<a class=title id=name href=#name>Name</a>
+--------------------------------------------------------------------------------
+
+<b>fsvs</b> - friedel's service superviser
+<a class=title id=synopsis href=#synopsis>Synopsis</a>
+--------------------------------------------------------------------------------
+
+<b>fsvs</b> [options] service-dir runlevel
+<a class=title id=description href=#description>Description</a>
+--------------------------------------------------------------------------------
+
+<b>fsvs</b> is the superviser called by <b>finit</b> but without initialization.
+Following options are available:
+<ul>
+<li><b>-v, --verbose</b> Prints more information, easier to debug problems </li>
+<li><b>-f, --force</b> Forces the socket if existing, if called without <b>-f</b> and the socket already exists, it failes. </li>
+<li><b>-V, --version</b> Prints the version and exits. </li></ul>
+Services can be controlled with <b>fsvc 8</b>
+<a class=title id=authors href=#authors>Authors</a>
+--------------------------------------------------------------------------------
+
+Friedel Schon <[email protected]>
+</div>
+</body>
+</html>
+
diff --git a/docs/halt.8.html b/docs/halt.8.html
@@ -0,0 +1,49 @@
+<!doctype html>
+<html lang=en>
+
+<head>
+ <title>Friedel's Initialization and Service Supervision</title>
+ <meta charset=utf-8 />
+ <meta name=viewport content='width=device-width,initial-scale=1' />
+ <link rel=stylesheet href=assets/style.css />
+ <script type=text/javascript src=assets/toggle-dark.js></script>
+</head>
+
+<body>
+<div id=wrapper>
+
+<a class=title id=name href=#name>Name</a>
+--------------------------------------------------------------------------------
+
+halt, reboot, poweroff - stop the system
+<a class=title id=synopsis href=#synopsis>Synopsis</a>
+--------------------------------------------------------------------------------
+
+<ul>
+<li><b>poweroff</b> [<b>-n</b>] [<b>-f</b>] [<b>-d</b>] [<b>-w</b>] [<b>-b</b>] </li>
+<li><b>reboot</b> [<b>-n</b>] [<b>-f</b>] [<b>-d</b>] [<b>-w</b>] [<b>-b</b>] </li>
+<li><b>halt</b> [<b>-n</b>] [<b>-f</b>] [<b>-d</b>] [<b>-w</b>] [<b>-b</b>] </li></ul>
+<a class=title id=description href=#description>Description</a>
+--------------------------------------------------------------------------------
+
+<b>poweroff</b> / <b>reboot</b> / <b>halt</b> tells <b>init</b> to stop running services and stop the system. Invoked without <b>-f</b>, it is a shortcut for <b>init <0|6></b>
+<a class=title id=options href=#options>Options</a>
+--------------------------------------------------------------------------------
+
+<ul>
+<li><b>-n</b> Don't sync devices, this doensn't imply that the kernel is not synced already </li>
+<li><b>-f</b> Forces halt / reboot without notifying <b>init</b>. Forcing the system to halt should be the last hope and can be dangerous, you should not try it </li>
+<li><b>-d</b> Don't write the <i>wtmp</i> record </li>
+<li><b>w</b> Only write the wtmp record, no further action </li></ul>
+<a class=title id=see href=#see>See ALSO</a>
+--------------------------------------------------------------------------------
+
+finit(1), fsvc(8), fsvs(8), halt(8), modules-load(8), shutdown(8),
+<a class=title id=author href=#author>Author</a>
+--------------------------------------------------------------------------------
+
+Based on the version of Leah Neukirchen <[email protected]>, rewritten by Friedel Schön <[email protected]>
+</div>
+</body>
+</html>
+
diff --git a/docs/index.html b/docs/index.html
@@ -11,7 +11,7 @@
<body>
<div id=wrapper>
-<span class=header><a class=title id=top href=#top>fiss</a><span class=right><span id=toggle_dark onclick=toggle_dark()> turn the lights on </span> <a href=https://github.com/friedelschoen/fiss><img id=github alt=GitHub src=assets/github-mark.svg /></a></span></span>
+<span class=header><a class=title id=top href=#top>fiss 0.3.2</a><span class=right><span id=toggle_dark onclick=toggle_dark()> turn the lights on </span> <a href=https://github.com/friedelschoen/fiss><img id=github alt=GitHub src=assets/github-mark.svg /></a></span></span>
================================================================================
Aloha! You somehow landed on the website of <b>fiss</b> (_Friedel's Initialization and Service Supervision_). <b>fiss</b> is a supervision suite for Unix and Unix-like systems with the power off system initialization. This project is based on <b>runit</b> and other <b>daemontools</b>-based utilities.
@@ -182,4 +182,8 @@ If this file is present, the services will be started automatically and restarte
<li><i>./once-<runlevel></i>
If this file is present, the services will be started automatically but not restarted if this services dies. </li></ul>
To be a valid service, <i>run</i>, <i>start</i> or <i>depends</i> must be present. If only depends is present, this service is a dummy service thus no actual action will be taken but starting and stopping dependencies.
-<i>start</i>, <i>stop</i>, <i>setup</i> and <i>finish</i> are executed as the same user as <b>fsvs</b> or <b>finit</b> is started, thus root in the most cased. <i>user</i>, <i>env</i>, <i>params</i> are not read when handling a background-service. Every file will be executed in the services directory, reading a file like './conf' will be read out of the service directory. </div></body></html>
+<i>start</i>, <i>stop</i>, <i>setup</i> and <i>finish</i> are executed as the same user as <b>fsvs</b> or <b>finit</b> is started, thus root in the most cased. <i>user</i>, <i>env</i>, <i>params</i> are not read when handling a background-service. Every file will be executed in the services directory, reading a file like './conf' will be read out of the service directory.
+</div>
+</body>
+</html>
+
diff --git a/docs/modules-load.8.html b/docs/modules-load.8.html
@@ -0,0 +1,50 @@
+<!doctype html>
+<html lang=en>
+
+<head>
+ <title>Friedel's Initialization and Service Supervision</title>
+ <meta charset=utf-8 />
+ <meta name=viewport content='width=device-width,initial-scale=1' />
+ <link rel=stylesheet href=assets/style.css />
+ <script type=text/javascript src=assets/toggle-dark.js></script>
+</head>
+
+<body>
+<div id=wrapper>
+
+<a class=title id=name href=#name>Name</a>
+--------------------------------------------------------------------------------
+
+<b>modules-load</b> - configure kernel modules at boot
+<a class=title id=synopsis href=#synopsis>Synopsis</a>
+--------------------------------------------------------------------------------
+
+<b>modules-load</b> [<b>-nv</b>]
+<a class=title id=description href=#description>Description</a>
+--------------------------------------------------------------------------------
+
+modules-load reads files which contain kernel modules to load during boot from the list of locations below.
+<ul>
+<li><b>-n</b> dry-run mode. This option does everything but actually insert or delete the modules. </li>
+<li><b>-v</b> verbose mode. Print messages about what the program is doing. </li></ul>
+<a class=title id=files href=#files>Files</a>
+--------------------------------------------------------------------------------
+
+Configuration files are read from the following locations:
+<ul>
+<li><i>/etc/modules-load.d/*.conf</i> </li>
+<li><i>/run/modules-load.d/*.conf</i> </li>
+<li><i>/usr/lib/modules-load.d/*.conf</i> </li></ul>
+The configuration files should simply contain a list of kernel module names to load, separated by newlines. Empty lines and lines whose first non-whitespace character is # or ; are ignored.
+<a class=title id=history href=#history>History</a>
+--------------------------------------------------------------------------------
+
+This program is a replacement for the modules-load utility provided by systemd.
+<a class=title id=author href=#author>Author</a>
+--------------------------------------------------------------------------------
+
+Leah Neukirchen, [email protected].
+</div>
+</body>
+</html>
+
diff --git a/docs/shutdown.8.html b/docs/shutdown.8.html
@@ -0,0 +1,59 @@
+<!doctype html>
+<html lang=en>
+
+<head>
+ <title>Friedel's Initialization and Service Supervision</title>
+ <meta charset=utf-8 />
+ <meta name=viewport content='width=device-width,initial-scale=1' />
+ <link rel=stylesheet href=assets/style.css />
+ <script type=text/javascript src=assets/toggle-dark.js></script>
+</head>
+
+<body>
+<div id=wrapper>
+
+<a class=title id=name href=#name>Name</a>
+--------------------------------------------------------------------------------
+
+<b>shutdown</b> – bring down the system
+<a class=title id=synopsis href=#synopsis>Synopsis</a>
+--------------------------------------------------------------------------------
+
+<b>shutdown</b> [<b>-rhP</b>] [<b>-fF</b>] [now | +mins] [message ...]
+<a class=title id=description href=#description>Description</a>
+--------------------------------------------------------------------------------
+
+shutdown brings the system down in a secure way. All logged-in users are notified that the system is going down, and login(1) is blocked.
+By default, shutdown puts the system into single user mode. Rebooting and halting the system can be done using the following options:
+<ul>
+<li><b>-c</b> Cancel an ongoing shutdown. </li>
+<li><b>-f</b> Enable fast booting; skip fsck(8) on next boot. </li>
+<li><b>-F</b> Force run of fsck(8) on next boot. </li>
+<li><b>-h</b> Halt the system. </li>
+<li><b>-k</b> Don't really shutdown; only send the warning messages to everybody. </li>
+<li><b>-P</b> Poweroff the system. </li>
+<li><b>-r</b> Reboot the system. </li>
+<li><b>now</b> Shutdown without further waiting. </li>
+<li><b>+mins</b> Wait mins minutes before shutting down. </li>
+<li><b>message</b> Message displayed to all users, defaults to "system is going down". </li></ul>
+<a class=title id=unsupported href=#unsupported>Unsupported OPTIONS</a>
+--------------------------------------------------------------------------------
+
+This version of shutdown is based on runit(8), the following features are not supported:
+<b>-t secs</b> to wait secs seconds between SIGKILL and SIGTERM on shutdown is silently ignored.
+<b>-a</b> Use /etc/shutdown.allow.
+<b>-H</b> Drop into boot monitor.
+<b>-n</b> Don't call init(8).
+<b>hh:mm</b> Absolute time specification is not implemented.
+<a class=title id=see href=#see>See ALSO</a>
+--------------------------------------------------------------------------------
+
+fsck(8), halt(8), init(8), poweroff(8), reboot(8), fiss(8), runsvchdir(8)
+<a class=title id=author href=#author>Author</a>
+--------------------------------------------------------------------------------
+
+Leah Neukirchen, [email protected].
+</div>
+</body>
+</html>
+
diff --git a/docs/sigremap.8.html b/docs/sigremap.8.html
@@ -0,0 +1,40 @@
+<!doctype html>
+<html lang=en>
+
+<head>
+ <title>Friedel's Initialization and Service Supervision</title>
+ <meta charset=utf-8 />
+ <meta name=viewport content='width=device-width,initial-scale=1' />
+ <link rel=stylesheet href=assets/style.css />
+ <script type=text/javascript src=assets/toggle-dark.js></script>
+</head>
+
+<body>
+<div id=wrapper>
+
+<a class=title id=name href=#name>Name</a>
+--------------------------------------------------------------------------------
+
+<b>sigremap</b> - a minimal init system for Linux containers
+<a class=title id=synopsis href=#synopsis>Synopsis</a>
+--------------------------------------------------------------------------------
+
+<b>sigremap</b> [option] [old-signal=new-signal...] command [arguments ...]
+<a class=title id=description href=#description>Description</a>
+--------------------------------------------------------------------------------
+
+<b>sigremap</b> is a simple process supervisor that forwards signals to children. It is designed to run as PID1 in minimal container environments.
+Optional arguments:
+<ul>
+<li><b>-c, --single</b> Run in single-child mode. In this mode, signals are only proxied to the direct child and not any of its descendants. </li>
+<li><b>-v, --verbose</b> Print debugging information to stderr. </li>
+<li><b>-V, --version</b> Print the current version and exit. </li>
+<li><b>old-signal=new-signal...</b> Rewrite received signal s to new signal r before proxying. To ignore (not proxy) a signal, rewrite it to 0. This option can be specified multiple times. </li></ul>
+<a class=title id=authors href=#authors>Authors</a>
+--------------------------------------------------------------------------------
+
+<b>sigremap</b> is based on dumb-init by Yelp. Rewritten by Friedel Schon <[email protected]>
+</div>
+</body>
+</html>
+
diff --git a/docs/vlogger.1.html b/docs/vlogger.1.html
@@ -0,0 +1,80 @@
+<!doctype html>
+<html lang=en>
+
+<head>
+ <title>Friedel's Initialization and Service Supervision</title>
+ <meta charset=utf-8 />
+ <meta name=viewport content='width=device-width,initial-scale=1' />
+ <link rel=stylesheet href=assets/style.css />
+ <script type=text/javascript src=assets/toggle-dark.js></script>
+</head>
+
+<body>
+<div id=wrapper>
+
+<a class=title id=name href=#name>Name</a>
+--------------------------------------------------------------------------------
+
+<b>vlogger</b> - log messages to syslog or an arbitrary executable
+<a class=title id=synopsis href=#synopsis>Synopsis</a>
+--------------------------------------------------------------------------------
+
+<b>vlogger</b> [<b>-isS</b>] [<b>-f</b> file] [<b>-p</b> pri] [<b>-t</b> tag] [message ...]
+<a class=title id=description href=#description>Description</a>
+--------------------------------------------------------------------------------
+
+The vlogger utility writes messages to the system log or an arbitrary executable.
+If vlogger is executed as logger it will always use the system log and behave like the regular logger(1).
+Without message arguments vlogger reads messages from stdin or the file specified with the -f flag. If the /etc/vlogger executable exists vlogger executes it with tag, level and facility as arguments, replacing the vlogger process.
+If vlogger is executed as a log service for fiss(8) or another daemontools like supervision suite it uses the service name as default tag. As example if vlogger is linked to /var/service/foo/log/run it uses “foo” as tag and “daemon.notice” as pri.
+The options are as follows:
+<ul>
+<li><b>-f file</b> Read lines from the specified file. This option cannot be combine message arguments. </li>
+<li><b>-i</b> Log the PID of the vlogger process. Only supported if syslog(3) is used. </li>
+<li><b>-p pri</b> The. pri can be facility.level or just facility. See FACILITIES, LEVELS or syslog(3). The default is “user.notice”. </li>
+<li><b>-S</b> Force vlogger to use syslog(3) even if /etc/vlogger exists. </li>
+<li><b>-s</b> Output the message to standard error, as well as syslog(3). Only supported if syslog(3) is used. </li>
+<li><b>-t tag</b> Defines the openlog(3) ident which is used as prefix for each log message or passed as first argument to /etc/vlogger. The default is the LOGNAME environment variable. </li>
+<li><b>message</b> Write the message to the system log. </li></ul>
+<a class=title id=facilities href=#facilities>Facilities</a>
+--------------------------------------------------------------------------------
+
+auth authpriv cron daemon ftp kern can not be used from userspace replaced with daemon. lpr mail news syslog user uucp local[0-7] security deprecated synonym for auth.
+<a class=title id=levels href=#levels>Levels</a>
+--------------------------------------------------------------------------------
+
+emerg alert crit err warning notice info debug panic deprecated synonym for emerg. error deprecated synonym for err. warn deprecated synonym for warning.
+<a class=title id=files href=#files>Files</a>
+--------------------------------------------------------------------------------
+
+<b>/etc/vlogger</b> An optional executable file that is used to handle the messages. It is executed with tag, level and facility as arguments and replaces the vlogger process.
+<a class=title id=exit href=#exit>Exit STATUS</a>
+--------------------------------------------------------------------------------
+
+The vlogger utility exits 0 on success, and >0 if an error occurs.
+<a class=title id=examples href=#examples>Examples</a>
+--------------------------------------------------------------------------------
+
+<b>/etc/vlogger:</b> #!/bin/sh exec svlogd /var/log/$1
+<a class=title id=see href=#see>See ALSO</a>
+--------------------------------------------------------------------------------
+
+logger(1), syslog(3), svlogd(8)
+<a class=title id=history href=#history>History</a>
+--------------------------------------------------------------------------------
+
+This program is a replacement for the logger utility provided by util-linux and forked from daemontools.
+<a class=title id=authors href=#authors>Authors</a>
+--------------------------------------------------------------------------------
+
+Duncan Overbruck <[email protected]>
+<a class=title id=license href=#license>License</a>
+--------------------------------------------------------------------------------
+
+vlogger is in the public domain.
+To the extent possible under law, the creator of this work has waived all copyright and related or neighboring rights to this work.
+http://creativecommons.org/publicdomain/zero/1.0/
+</div>
+</body>
+</html>
+
diff --git a/docs/zzz.8.html b/docs/zzz.8.html
@@ -0,0 +1,49 @@
+<!doctype html>
+<html lang=en>
+
+<head>
+ <title>Friedel's Initialization and Service Supervision</title>
+ <meta charset=utf-8 />
+ <meta name=viewport content='width=device-width,initial-scale=1' />
+ <link rel=stylesheet href=assets/style.css />
+ <script type=text/javascript src=assets/toggle-dark.js></script>
+</head>
+
+<body>
+<div id=wrapper>
+
+<a class=title id=name href=#name>Name</a>
+--------------------------------------------------------------------------------
+
+zzz - suspend or hibernate your system
+<a class=title id=synopsis href=#synopsis>Synopsis</a>
+--------------------------------------------------------------------------------
+
+<b>zzz [-nSzZRH]</b>
+<a class=title id=description href=#description>Description</a>
+--------------------------------------------------------------------------------
+
+<b>zzz</b> is a simple utility to hibernate or suspend your computer and part of the fiss-system. It supports suspend/resume-hooks.
+<ul>
+<li><b>-n, --noop</b> dry-run, sleep for 5sec instead of actually running ACPI actions. </li>
+<li><b>-S, --freeze</b> enter low-power idle mode </li>
+<li><b>-z, --suspend</b> suspend to RAM, this is the default behaviour of <b>zzz</b> </li>
+<li><b>-Z, --hibernate</b> hibernate to disk and power off </li>
+<li><b>-R, --reboot</b> hibernate to disk and reboot (useful for switching operating systems) </li>
+<li><b>-H, --hybrid</b> hibernate to disk and suspend </li></ul>
+<a class=title id=hooks href=#hooks>Hooks</a>
+--------------------------------------------------------------------------------
+
+Before suspending, <b>zzz</b> executes <i>/usr/share/fiss/suspend</i> which intents to execute scripts inside <i>/etc/zzz.d/suspend</i> in alphanumeric order. After resuming, <b>zzz</b> executes <i>/usr/share/fiss/resume</i> which intents to execute scripts inside <i>/etc/zzz.d/resume</i> in alphanumeric order.
+<a class=title id=see href=#see>See ALSO</a>
+--------------------------------------------------------------------------------
+
+fiss-init(8), runsvdir(8), runsvchdir(8), sv(8), runsv(8), chpst(8), utmpset(8), svlogd(8)
+<a class=title id=author href=#author>Author</a>
+--------------------------------------------------------------------------------
+
+Based on the version of Leah Neukirchen <[email protected]>, rewritten by Friedel Schön <[email protected]>
+</div>
+</body>
+</html>
+
diff --git a/make-docs.py b/make-docs.py
@@ -44,7 +44,9 @@ for line in sys.stdin:
line = line.strip()
# is control
- if line.startswith("@header"):
+ if line.startswith("@man"):
+ pass
+ elif line.startswith("@header"):
_, text = line.split(" ", 1)
print(HEADER_TEMPLATE.format(text=text))
print(HEADER_CHAR * WIDTH)
diff --git a/make-man.py b/make-man.py
@@ -0,0 +1,74 @@
+import sys
+import re
+
+WIDTH = 80
+HEADER_CHAR = '='
+TITLE_CHAR = '-'
+HEADER_SUFFIX = "<span class=right><span id=toggle_dark onclick=toggle_dark()> turn the lights on </span> <a href=https://github.com/friedelschoen/fiss><img id=github alt=GitHub src=assets/github-mark.svg /></a></span>"
+
+PREFIX = """<!doctype html>
+<html lang=en>
+
+<head>
+ <title>Friedel's Initialization and Service Supervision</title>
+ <meta charset=utf-8 />
+ <meta name=viewport content='width=device-width,initial-scale=1' />
+ <link rel=stylesheet href=assets/style.css />
+ <script type=text/javascript src=assets/toggle-dark.js></script>
+</head>
+
+<body>
+<div id=wrapper>"""
+
+SUFFIX = """
+</div>
+</body>
+</html>
+"""
+
+HEADER_TEMPLATE = "<span class=header><a class=title id=top href=#top>{text}</a><span class=right><span id=toggle_dark onclick=toggle_dark()> turn the lights on </span> <a href=https://github.com/friedelschoen/fiss><img id=github alt=GitHub src=assets/github-mark.svg /></a></span></span>"
+TITLE_TEMPLATE = "<a class=title id={id} href=#{id}>{text}</a>"
+
+def inline_convert(text):
+ text = re.sub(r'\*(.+?)\*', r'\\fB\\fC\1\\fR', text)
+ text = re.sub(r'_(.+?)_', r'\\fI\1\\fR', text)
+# text = re.sub(r'\[(.*?)\]\((.*?)\)', r'<a href="\2">\1</a>', text)
+ return text
+
+in_list = False
+
+#print(PREFIX)
+
+for line in sys.stdin:
+ line = line.strip()
+
+ # is control
+ if line.startswith("@man"):
+ _, text = line.split(" ", 1)
+ print(".TH " + text)
+ elif line.startswith("@header"):
+ pass
+ elif line.startswith("@title"):
+ _, id, text = line.split(" ", 2)
+ print(".SH " + text.upper())
+ elif line.startswith("@code"):
+ pass
+ elif line.startswith("@endcode"):
+ pass
+ elif line.startswith("@list"):
+ in_list = True
+ elif line.startswith("@endlist"):
+ in_list = False
+
+ elif in_list and line.endswith('~'):
+ sys.stdout.write(inline_convert(line[:-1]) + '\n')
+ elif line.endswith('~'):
+ sys.stdout.write(inline_convert(line[:-1]) + '\n.PP\n')
+ elif line:
+ sys.stdout.write(inline_convert(line) + ' ')
+ elif in_list: # is empty but in line
+ sys.stdout.write("\n.PP\n")
+ else: # is empty
+ sys.stdout.write('\n.PP\n')
+
+#print(SUFFIX)
+\ No newline at end of file
diff --git a/man/chpst.8 b/man/chpst.8
@@ -1,83 +1,96 @@
.TH chpst 8 "MAY 2023" "0.3.2" "fiss man page"
+
+.PP
.SH NAME
+
+.PP
+\fB\fCchpst\fR - runs a program with a changed process state
+.PP
+
.PP
-\fB\fCchpst\fR \- runs a program with a changed process state
.SH SYNOPSIS
+
.PP
-\fB\fCchpst\fR [\fB\fC\-vP012\fR] [\fB\fC\-u\fR user] [\fB\fC\-U\fR user] [\fB\fC\-b\fR argv0] [\fB\fC\-e\fR dir] [\fB\fC\-/\fR root] [\fB\fC\-n\fR inc] [\fB\fC\-l\fR|\fB\fC\-L\fR lock] [\fB\fC\-m\fR bytes] [\fB\fC\-d\fR bytes] [\fB\fC\-o\fR n] [\fB\fC\-p\fR n] [\fB\fC\-f\fR bytes] [\fB\fC\-c\fR bytes] prog [arguments...]
-.SH DESCRIPTION
+\fB\fCchpst\fR [\fB\fC-vP012\fR] [\fB\fC-u\fR user] [\fB\fC-U\fR user] [\fB\fC-b\fR argv0] [\fB\fC-e\fR dir] [\fB\fC-/\fR root] [\fB\fC-n\fR inc] [\fB\fC-l\fR|\fB\fC-L\fR lock] [\fB\fC-m\fR bytes] [\fB\fC-d\fR bytes] [\fB\fC-o\fR n] [\fB\fC-p\fR n] [\fB\fC-f\fR bytes] [\fB\fC-c\fR bytes] prog [arguments...]
.PP
-\fB\fC\-u [:]user[:group]\fR
+
.PP
-setuidgid. Set uid and gid to the user's uid and gid, as found in /etc/passwd. If user is followed by a colon and a group, set the gid to group's gid, as found in /etc/group, instead of user's gid. If group consists of a colon\-separated list of group names, chpst sets the group ids of all listed groups. If user is prefixed with a colon, the user and all group arguments are interpreted as uid and gids respectivly, and not looked up in the password or group file. All initial supplementary groups are removed.
+.SH DESCRIPTION
+\fB\fC-u [:]user[:group]\fR
+setuidgid. Set uid and gid to the user's uid and gid, as found in /etc/passwd. If user is followed by a colon and a group, set the gid to group's gid, as found in /etc/group, instead of user's gid. If group consists of a colon-separated list of group names, chpst sets the group ids of all listed groups. If user is prefixed with a colon, the user and all group arguments are interpreted as uid and gids respectivly, and not looked up in the password or group file. All initial supplementary groups are removed.
.PP
-\fB\fC\-U [:]user[:group]\fR
+\fB\fC-U [:]user[:group]\fR
+envuidgid. Set the environment variables $UID and $GID to the user's uid and gid, as found in /etc/passwd. If user is followed by a colon and a group, set $GID to the group's gid, as found in /etc/group, instead of user's gid. If user is prefixed with a colon, the user and group arguments are interpreted as uid and gid respectivly, and not looked up in the password or group file.
.PP
-envuidgid. Set the environment variables $UID and $GID to the user's uid and gid, as found in /etc/passwd. If user is followed by a colon and a group, set $GID to the group's gid, as found in /etc/group, instead of user's gid. If user is prefixed with a colon, the user and group arguments are interpreted as uid and gid respectivly, and not looked up in the password or group file.
+\fB\fC-b argv0\fR
+Run prog with argv0 as the 0th argument.
.PP
-\fB\fC\-b argv0\fR
-Run prog with argv0 as the 0th argument.
+\fB\fC-/ root\fR
+Change the root directory to root before starting prog.
.PP
-\fB\fC\-/ root\fR
-Change the root directory to root before starting prog.
+\fB\fC-C pwd\fR
+Change the working directory to pwd before starting prog. When combined with -/, the working directory is changed after the chroot.
.PP
-\fB\fC\-C pwd\fR
-Change the working directory to pwd before starting prog. When combined with \-/, the working directory is changed after the chroot.
+\fB\fC-n inc\fR
+Add inc to the nice(2) value before starting prog. inc must be an integer, and may start with a minus or plus.
.PP
-\fB\fC\-n inc\fR
-Add inc to the
-.BR nice (2)
-value before starting prog. inc must be an integer, and may start with a minus or plus.
+\fB\fC-l lock\fR
+Open the file lock for writing, and obtain an exclusive lock on it. lock will be created if it does not exist. If lock is locked by another process, wait until a new lock can be obtained.
.PP
-\fB\fC\-l lock\fR
-Open the file lock for writing, and obtain an exclusive lock on it. lock will be created if it does not exist. If lock is locked by another process, wait until a new lock can be obtained.
+\fB\fC-L lock\fR
+The same as -l, but fail immediately if lock is locked by another process.
.PP
-\fB\fC\-L lock\fR
-The same as \-l, but fail immediately if lock is locked by another process.
+\fB\fC-P\fR
+Run prog in a new process group.
.PP
-\fB\fC\-P\fR
-Run prog in a new process group.
+\fB\fC-0\fR
+Close standard input before starting prog.
.PP
-\fB\fC\-0\fR
-Close standard input before starting prog.
+\fB\fC-1\fR
+Close standard output before starting prog.
.PP
-\fB\fC\-1\fR
-Close standard output before starting prog.
+\fB\fC-2\fR
+Close standard error before starting prog.
+.PP
+
.PP
-\fB\fC\-2\fR
-Close standard error before starting prog.
.SH NOT IMPLEMENTED
+
+.PP
+Following options are defined in runit's chpst but are ignored by fiss' implementation.
.PP
-Following options are defined in runit's chpst but are ignored by fiss' implementation.
+\fB\fC-e dir\fR
+Set various environment variables as specified by files in the directory dir: If dir contains a file named k whose first line is v, chpst removes the environment variable k if it exists, and then adds the environment variable k with the value v. The name k must not contain =. Spaces and tabs at the end of v are removed, and nulls in v are changed to newlines. If the file k is empty (0 bytes long), chpst removes the environment variable k if it exists, without adding a new variable.
.PP
-\fB\fC\-e dir\fR
-Set various environment variables as specified by files in the directory dir: If dir contains a file named k whose first line is v, chpst removes the environment variable k if it exists, and then adds the environment variable k with the value v. The name k must not contain =. Spaces and tabs at the end of v are removed, and nulls in v are changed to newlines. If
-the file k is empty (0 bytes long), chpst removes the environment variable k if it exists, without adding a new variable.
+\fB\fC-m bytes\fR
+Limit the data segment, stack segment, locked physical pages, and total of all segment per process to bytes bytes each.
.PP
-\fB\fC\-m bytes\fR
-Limit the data segment, stack segment, locked physical pages, and total of all segment per process to bytes bytes each.
+\fB\fC-d bytes\fR
+limit data segment. Limit the data segment per process to bytes bytes.
.PP
-\fB\fC\-d bytes\fR
-limit data segment. Limit the data segment per process to bytes bytes.
+\fB\fC-o n\fR
+Limit the number of open file descriptors per process to n.
.PP
-\fB\fC\-o n\fR
-Limit the number of open file descriptors per process to n.
+\fB\fC-p n\fR
+Limit the number of processes per uid to n.
.PP
-\fB\fC\-p n\fR
-Limit the number of processes per uid to n.
+\fB\fC-f bytes\fR
+Limit the output file size to bytes bytes.
.PP
-\fB\fC\-f bytes\fR
-Limit the output file size to bytes bytes.
+\fB\fC-c bytes\fR
+Limit the core file size to bytes bytes.
.PP
-\fB\fC\-c bytes\fR
-Limit the core file size to bytes bytes.
+\fB\fC-v\fR
+Print verbose messages to standard error. This includes warnings about limits unsupported by the system.
.PP
-\fB\fC\-v\fR
-Print verbose messages to standard error. This includes warnings about limits unsupported by the system.
.SH EXIT CODES
+
+.PP
+chpst exits 100 when called with wrong options. It prints an error message and exits 111 if it has trouble changing the process state. Otherwise its exit code is the same as that of prog.
+.PP
+
.PP
-chpst exits 100 when called with wrong options. It prints an error message and exits 111 if it has trouble changing the process state. Otherwise its exit code is the same as that of prog.
.SH AUTHOR
+
.PP
-Based on the implementation by Gerrit Pape \[la][email protected]\[ra],
-rewritten by Friedel Schon \[la][email protected]\[ra]
+Based on the implementation by Gerrit Pape <[email protected]>, rewritten by Friedel Schon <[email protected]>
+\ No newline at end of file
diff --git a/man/finit.8 b/man/finit.8
@@ -1,55 +1,64 @@
.TH finit 8 "MAY 2023" "01.0" "fiss man page"
+
+.PP
.SH NAME
+
+.PP
+fiss - a UNIX process no 1
.PP
-fiss \- a UNIX process no 1
.SH SYNOPSIS
+
+.PP
+\fB\fCfsvc\fR when running as PID 0 (as init)
.PP
-\fB\fCfsvc\fR
-when running as PID 0 (as init)
+\fB\fCfsvc\fR <0|6> when running regulary to controll init
.PP
-\fB\fCfsvc\fR <0|6>
-when running regulary to controll init
.SH CONTROLLING
+
.PP
-If \fB\fCfinit\fR is invoked by any other user than \fIroot\fP, it failes.
+If \fB\fCfinit\fR is invoked by any other user than \fIroot\fR, it failes.
.PP
-\fB\fCfinit\fR 0
-halts the system
+\fB\fCfinit\fR 0 halts the system
+.PP
+\fB\fCfinit\fR 6 reboots the system
.PP
-\fB\fCfinit\fR 6
-reboots the system
.SH DESCRIPTION
+
+.PP
+\fB\fCfiss\fR must be run as Unix process no 1 if invoked without arguments and handles the boot process in user-land.
.PP
-\fB\fCfiss\fR must be run as Unix process no 1 if invoked without arguments and handles the boot process in user\-land.
+This happens in three stages:
.PP
-This happens in three stages:
.SH STAGE 1
+
+.PP
+\fB\fCfiss\fR runs \fI/etc/fiss/start\fR and waits for it to terminate. The system's one time tasks are done here. \fI/etc/fiss/start\fR has full control of \fI/dev/console\fR to be able to start an emergency shell if the one time initialization tasks fail. If \fI/etc/fiss/start\fR crashes, \fB\fCfinit\fR will skip stage 2 and enter stage 3.
.PP
-\fB\fCfiss\fR runs \fI/etc/fiss/start\fP and waits for it to terminate. The system's one time tasks are done here. \fI/etc/fiss/start\fP has full control of \fI/dev/console\fP to be able to start an emergency shell if the one time initialization tasks fail. If \fI/etc/fiss/start\fP crashes, \fB\fCfinit\fR will skip stage 2 and enter stage 3.
.SH STAGE 2
+
+.PP
+\fB\fCfiss\fR starts all services in \fI/etc/fiss/service.d\fR which should not return until system shutdown; if it crashes, it will be restarted.
.PP
-\fB\fCfiss\fR starts all services in \fI/etc/fiss/service.d\fP which should not return until system shutdown; if it crashes, it will be restarted.
.SH STAGE 3
+
+.PP
+If \fB\fCfiss\fR is told to shutdown the system, it terminates stage 2 if it is running, and runs \fI/etc/fiss/stop\fR. The systems tasks to shutdown and possibly halt or reboot the system are done here. If stage 3 returns, \fB\fCfinit\fR checks if the file
.PP
-If \fB\fCfiss\fR is told to shutdown the system, it terminates stage 2 if it is running, and runs \fI/etc/fiss/stop\fP\&. The systems tasks to shutdown and possibly halt or reboot the system are done here. If stage 3 returns, \fB\fCfinit\fR checks if the file
.SH SIGNALS
+
.PP
-\fB\fCfinit\fR only accepts signals in stage 2.
+\fB\fCfinit\fR only accepts signals in stage 2.
.PP
-If \fB\fCfinit\fR receives a CONT signal and the file \fB\fCfinit\fR
-is told to shutdown the system.
+If \fB\fCfinit\fR receives a CONT signal and the file \fB\fCfinit\fR is told to shutdown the system.
+.PP
+if \fB\fCfinit\fR receives an INT signal, \fB\fCfinit\fR restarts the system.
.PP
-if \fB\fCfinit\fR receives an INT signal, \fB\fCfinit\fR restarts the system.
.SH SEE ALSO
+
+.PP
+fiss-init(8), runsvdir(8), runsvchdir(8), sv(8), runsv(8), chpst(8), utmpset(8), svlogd(8)
.PP
-.BR fiss-init (8),
-.BR runsvdir (8),
-.BR runsvchdir (8),
-.BR sv (8),
-.BR runsv (8),
-.BR chpst (8),
-.BR utmpset (8),
-.BR svlogd (8)
.SH AUTHOR
+
.PP
-Friedel Schön <\[la][email protected]\[ra]>
+Friedel Schön <[email protected]>
+\ No newline at end of file
diff --git a/man/fsvc.8 b/man/fsvc.8
@@ -1,100 +1,91 @@
.TH fsvc 8 "MAY 2023" "0.3.2" "fiss man page"
+
+.PP
.SH NAME
+
+.PP
+\fB\fCfsvc\fR - fiss' service controller
.PP
-\fB\fCfsvc\fR \- fiss' service controller
.SH SYNOPSIS
+
.PP
-\fB\fCfsvc\fR \fB\fCstart\fR [\fIoptions\fP] [\fB\fC\-\-pin_\fR] <service>
+\fB\fCfsvc\fR \fB\fCstart\fR [\fIoptions\fR] [\fB\fC--pin_\fR] <service>
.PP
-\fB\fCfsvc\fR \fB\fCstop\fR [\fIoptions\fP] [\fB\fC\-\-pin\fR] <service>
+\fB\fCfsvc\fR \fB\fCstop\fR [\fIoptions\fR] [\fB\fC--pin\fR] <service>
.PP
-\fB\fCfsvc\fR \fB\fCenable\fR [\fIoptions\fP] [\fB\fC\-\-once\fR] <service>
+\fB\fCfsvc\fR \fB\fCenable\fR [\fIoptions\fR] [\fB\fC--once\fR] <service>
.PP
-\fB\fCfsvc\fR \fB\fCdisable\fR [\fIoptions\fP] [\fB\fC\-\-once\fR] <service>
+\fB\fCfsvc\fR \fB\fCdisable\fR [\fIoptions\fR] [\fB\fC--once\fR] <service>
.PP
-\fB\fCfsvc\fR \fB\fCkill\fR [\fIoptions\fP] <service> <signal|signo>
+\fB\fCfsvc\fR \fB\fCkill\fR [\fIoptions\fR] <service> <signal|signo>
.PP
-\fB\fCfsvc\fR \fB\fCstatus\fR [\fIoptions\fP] [\fB\fC\-\-check\fR] [<service>]
+\fB\fCfsvc\fR \fB\fCstatus\fR [\fIoptions\fR] [\fB\fC--check\fR] [<service>]
.PP
-\fB\fCfsvc\fR \fB\fCpause\fR [\fIoptions\fP] <service>
+\fB\fCfsvc\fR \fB\fCpause\fR [\fIoptions\fR] <service>
.PP
-\fB\fCfsvc\fR \fB\fCresume\fR [\fIoptions\fP] <service>
+\fB\fCfsvc\fR \fB\fCresume\fR [\fIoptions\fR] <service>
+.PP
+\fB\fCfsvc\fR \fB\fCswitch\fR [\fIoptions\fR] [\fB\fC--reset\fR] <runlevel>
.PP
-\fB\fCfsvc\fR \fB\fCswitch\fR [\fIoptions\fP] [\fB\fC\-\-reset\fR] <runlevel>
.SH DESCRIPTION
+
+.PP
+\fB\fCfsvc\fR is a command line tool for controlling services on a fiss system. It provides various commands for starting, stopping, enabling, disabling, sending signals to, checking the status of, pausing, resuming, and switching the runlevel of services.
.PP
-\fB\fCfsvc\fR is a command line tool for controlling services on a fiss system. It provides various commands for starting, stopping, enabling, disabling, sending signals to, checking the status of, pausing, resuming, and switching the runlevel of services.
.SH OPTIONS
+
.PP
-The following options are available for every command:
+The following options are available for every command:
.PP
-\fB\fC\-q, \-\-short\fR
-Will print brief information about the service.
+\fB\fC-q, --short\fR Will print brief information about the service.
.PP
-\fB\fC\-r, \-\-runlevel <runlevel>\fR
-Will use \[rs]fBrunlevel\[rs]fB instead of \fIdefault\fP\&.
+\fB\fC-r, --runlevel <runlevel>\fR Will use fBrunlevelfB instead of \fIdefault\fR.
.PP
-\fB\fC\-s, \-\-service\-dir <path>\fR
-Will use \fB\fCpath\fR as service directory instead of \fI/etc/fiss/service.d\fP\&.
+\fB\fC-s, --service-dir <path>\fR Will use \fB\fCpath\fR as service directory instead of \fI/etc/fiss/service.d\fR.
.PP
-\fB\fC\-v, \-\-verbose\fR
-Prints verbose information.
+\fB\fC-v, --verbose\fR Prints verbose information.
.PP
-\fB\fC\-V, \-\-version\fR
-Prints the version and exits.
+\fB\fC-V, --version\fR Prints the version and exits.
.PP
-The following options are available per command:
+The following options are available per command:
.PP
-\fB\fC\-p, \-\-pin\fR
-Pins the state. If issued with \fB\fCstart\fR it will cause the service to restart.
-If issued with \fB\fCstop\fR it will cause the service to be hold down.
+\fB\fC-p, --pin\fR Pins the state. If issued with \fB\fCstart\fR it will cause the service to restart. If issued with \fB\fCstop\fR it will cause the service to be hold down.
.PP
-\fB\fC\-o, \-\-once\fR
-Specifies that the service should only be enabled/disabled once and not automatically started/stopped on subsequent bootups.
+\fB\fC-o, --once\fR Specifies that the service should only be enabled/disabled once and not automatically started/stopped on subsequent bootups.
.PP
-\fB\fC\-c, \-\-check\fR
-Command will return \fI0\fP if the specified service is active otherwise \fI1\fP
+\fB\fC-c, --check\fR Command will return \fI0\fR if the specified service is active otherwise \fI1\fR
+.PP
+\fB\fC-r, --reset\fR Specifies that the switch command should reset all running services (if manually set to up/down)
.PP
-\fB\fC\-r, \-\-reset\fR
-Specifies that the switch command should reset all running services (if manually set to up/down)
.SH COMMANDS
+
+.PP
+The following commands are available:
.PP
-The following commands are available:
+\fB\fCstart\fR Starts the specified service. A synonym is \fB\fCup\fR.
.PP
-\fB\fCstart\fR
-Starts the specified service. A synonym is \fB\fCup\fR\&.
+\fB\fCstop\fR Stops the specified service. A synonym is \fB\fCdown\fR.
.PP
-\fB\fCstop\fR
-Stops the specified service. A synonym is \fB\fCdown\fR\&.
+\fB\fCenable\fR Enables the specified service, causing it to automatically start on subsequent bootups.
.PP
-\fB\fCenable\fR
-Enables the specified service, causing it to automatically start on subsequent bootups.
+\fB\fCdisable\fR Disables the specified service, causing it to not start automatically on subsequent bootups.
.PP
-\fB\fCdisable\fR
-Disables the specified service, causing it to not start automatically on subsequent bootups.
+\fB\fCkill\fR Sends the specified signal or signal number to the specified service. A synonym is \fB\fCsend\fR.
.PP
-\fB\fCkill\fR
-Sends the specified signal or signal number to the specified service. A synonym is \fB\fCsend\fR\&.
+\fB\fCstatus\fR Displays the status of the specified service. If no service is specified, displays the status of all services.
.PP
-\fB\fCstatus\fR
-Displays the status of the specified service. If no service is specified, displays the status of all services.
+\fB\fCpause\fR Pauses the specified service.
.PP
-\fB\fCpause\fR
-Pauses the specified service.
+\fB\fCresume\fR Resumes the specified service.
.PP
-\fB\fCresume\fR
-Resumes the specified service.
+\fB\fCswitch\fR Switches the runlevel to the specified value.
.PP
-\fB\fCswitch\fR
-Switches the runlevel to the specified value.
.SH SEE ALSO
+
+.PP
+finit(1), fsvc(8), fsvs(8), halt(8), modules-load(8), shutdown(8),
.PP
-.BR finit (1),
-.BR fsvc (8),
-.BR fsvs (8),
-.BR halt (8),
-.BR modules-load (8),
-.BR shutdown (8),
.SH AUTHOR
+
.PP
-Friedel Schön <\[la][email protected]\[ra]>
+Friedel Schön <[email protected]>
+\ No newline at end of file
diff --git a/man/fsvs.8 b/man/fsvs.8
@@ -1,26 +1,32 @@
.TH fsvs 8 "MAY 2023" "0.3.2" "fiss man page"
+
+.PP
.SH NAME
+
+.PP
+\fB\fCfsvs\fR - friedel's service superviser
.PP
-\fB\fCfsvs\fR \- friedel's service superviser
.SH SYNOPSIS
+
+.PP
+\fB\fCfsvs\fR [options] service-dir runlevel
.PP
-\fB\fCfsvs\fR [options] service\-dir runlevel
.SH DESCRIPTION
+
+.PP
+\fB\fCfsvs\fR is the superviser called by \fB\fCfinit\fR but without initialization.
.PP
-\fB\fCfsvs\fR is the superviser called by \fB\fCfinit\fR but without initialization.
+Following options are available:
.PP
-Following options are available:
+\fB\fC-v, --verbose\fR Prints more information, easier to debug problems
.PP
-\fB\fC\-v, \-\-verbose\fR
-Prints more information, easier to debug problems
+\fB\fC-f, --force\fR Forces the socket if existing, if called without \fB\fC-f\fR and the socket already exists, it failes.
.PP
-\fB\fC\-f, \-\-force\fR
-Forces the socket if existing, if called without \fB\fC\-f\fR and the socket already exists, it failes.
+\fB\fC-V, --version\fR Prints the version and exits.
.PP
-\fB\fC\-V, \-\-version\fR
-Prints the version and exits.
+Services can be controlled with \fB\fCfsvc 8\fR
.PP
-Services can be controlled with \fB\fCfsvc 8\fR
.SH AUTHORS
+
.PP
-Friedel Schon \[la][email protected]\[ra]
+Friedel Schon <[email protected]>
+\ No newline at end of file
diff --git a/man/halt.8 b/man/halt.8
@@ -1,38 +1,42 @@
.TH halt 8 "MAY 2023" "0.3.2" "fiss man page"
+
+.PP
.SH NAME
+
+.PP
+halt, reboot, poweroff - stop the system
.PP
-halt, reboot, poweroff \- stop the system
.SH SYNOPSIS
+
+.PP
+\fB\fCpoweroff\fR [\fB\fC-n\fR] [\fB\fC-f\fR] [\fB\fC-d\fR] [\fB\fC-w\fR] [\fB\fC-b\fR]
.PP
-\fB\fCpoweroff\fR [\fB\fC\-n\fR] [\fB\fC\-f\fR] [\fB\fC\-d\fR] [\fB\fC\-w\fR] [\fB\fC\-b\fR]
+\fB\fCreboot\fR [\fB\fC-n\fR] [\fB\fC-f\fR] [\fB\fC-d\fR] [\fB\fC-w\fR] [\fB\fC-b\fR]
.PP
-\fB\fCreboot\fR [\fB\fC\-n\fR] [\fB\fC\-f\fR] [\fB\fC\-d\fR] [\fB\fC\-w\fR] [\fB\fC\-b\fR]
+\fB\fChalt\fR [\fB\fC-n\fR] [\fB\fC-f\fR] [\fB\fC-d\fR] [\fB\fC-w\fR] [\fB\fC-b\fR]
.PP
-\fB\fChalt\fR [\fB\fC\-n\fR] [\fB\fC\-f\fR] [\fB\fC\-d\fR] [\fB\fC\-w\fR] [\fB\fC\-b\fR]
.SH DESCRIPTION
+
+.PP
+\fB\fCpoweroff\fR / \fB\fCreboot\fR / \fB\fChalt\fR tells \fB\fCinit\fR to stop running services and stop the system. Invoked without \fB\fC-f\fR, it is a shortcut for \fB\fCinit <0|6>\fR
.PP
-\fB\fCpoweroff\fR / \fB\fCreboot\fR / \fB\fChalt\fR tells \fB\fCinit\fR to stop running services and stop the system. Invoked without \fB\fC\-f\fR, it is a shortcut for \fB\fCinit <0|6>\fR
.SH OPTIONS
+
+.PP
+\fB\fC-n\fR Don't sync devices, this doensn't imply that the kernel is not synced already
.PP
-\fB\fC\-n\fR
-Don't sync devices, this doensn't imply that the kernel is not synced already
+\fB\fC-f\fR Forces halt / reboot without notifying \fB\fCinit\fR. Forcing the system to halt should be the last hope and can be dangerous, you should not try it
.PP
-\fB\fC\-f\fR
-Forces halt / reboot without notifying \fB\fCinit\fR\&. Forcing the system to halt should be the last hope and can be dangerous, you should not try it
+\fB\fC-d\fR Don't write the \fIwtmp\fR record
.PP
-\fB\fC\-d\fR
-Don't write the \fIwtmp\fP record
+\fB\fCw\fR Only write the wtmp record, no further action
.PP
-\fB\fCw\fR
-Only write the wtmp record, no further action
.SH SEE ALSO
+
+.PP
+finit(1), fsvc(8), fsvs(8), halt(8), modules-load(8), shutdown(8),
.PP
-.BR finit (1),
-.BR fsvc (8),
-.BR fsvs (8),
-.BR halt (8),
-.BR modules-load (8),
-.BR shutdown (8),
.SH AUTHOR
+
.PP
-Based on the version of Leah Neukirchen <\[la][email protected]\[ra]>, rewritten by Friedel Schön <\[la][email protected]\[ra]>
+Based on the version of Leah Neukirchen <[email protected]>, rewritten by Friedel Schön <[email protected]>
+\ No newline at end of file
diff --git a/man/modules-load.8 b/man/modules-load.8
@@ -1,37 +1,44 @@
-.TH modules\-load 8 "MAY 2023" "0.3.2" "fiss man page"
+.TH modules-load 8 "MAY 2023" "0.3.2" "fiss man page"
+
+.PP
.SH NAME
+
+.PP
+\fB\fCmodules-load\fR - configure kernel modules at boot
.PP
-\fB\fCmodules\-load\fR \- configure kernel modules at boot
.SH SYNOPSIS
+
+.PP
+\fB\fCmodules-load\fR [\fB\fC-nv\fR]
.PP
-\fB\fCmodules\-load\fR [\fB\fC\-nv\fR]
.SH DESCRIPTION
+
.PP
-modules\-load reads files which contain kernel modules to load during boot from the list of locations below.
+modules-load reads files which contain kernel modules to load during boot from the list of locations below.
.PP
-\fB\fC\-n\fR
-dry\-run mode. This option does everything but actually insert or
-delete the modules.
+\fB\fC-n\fR dry-run mode. This option does everything but actually insert or delete the modules.
+.PP
+\fB\fC-v\fR verbose mode. Print messages about what the program is doing.
.PP
-\fB\fC\-v\fR
-verbose mode. Print messages about what the program is doing.
.SH FILES
+
+.PP
+Configuration files are read from the following locations:
.PP
-Configuration files are read from the following locations:
+\fI/etc/modules-load.d/*.conf\fR
.PP
-\fI/etc/modules\-load.d/*\&.conf\fP
+\fI/run/modules-load.d/*.conf\fR
.PP
-\fI/run/modules\-load.d/*\&.conf\fP
+\fI/usr/lib/modules-load.d/*.conf\fR
.PP
-\fI/usr/lib/modules\-load.d/*\&.conf\fP
+The configuration files should simply contain a list of kernel module names to load, separated by newlines. Empty lines and lines whose first non-whitespace character is # or ; are ignored.
.PP
-The configuration files should simply contain a list of kernel module
-names to load, separated by newlines. Empty lines and lines whose first
-non\-whitespace character is # or ; are ignored.
.SH HISTORY
+
+.PP
+This program is a replacement for the modules-load utility provided by systemd.
.PP
-This program is a replacement for the modules\-load utility provided by
-systemd.
.SH AUTHOR
+
.PP
-Leah Neukirchen, \[la][email protected]\[ra]\&.
+Leah Neukirchen, [email protected].
+\ No newline at end of file
diff --git a/man/shutdown.8 b/man/shutdown.8
@@ -1,82 +1,64 @@
.TH shutdown 8 "MAY 2023" "0.3.2" "fiss man page"
+
+.PP
.SH NAME
+
+.PP
+\fB\fCshutdown\fR – bring down the system
.PP
-\fB\fCshutdown\fR – bring down the system
.SH SYNOPSIS
+
+.PP
+\fB\fCshutdown\fR [\fB\fC-rhP\fR] [\fB\fC-fF\fR] [now | +mins] [message ...]
.PP
-\fB\fCshutdown\fR [\fB\fC\-rhP\fR] [\fB\fC\-fF\fR] [now | +mins] [message ...]
.SH DESCRIPTION
+
.PP
-shutdown brings the system down in a secure way. All logged\-in users are notified that the system is going down, and
-.BR login (1)
-is blocked.
+shutdown brings the system down in a secure way. All logged-in users are notified that the system is going down, and login(1) is blocked.
.PP
-By default, shutdown puts the system into single user mode. Rebooting and halting the system can be done using the following options:
+By default, shutdown puts the system into single user mode. Rebooting and halting the system can be done using the following options:
.PP
-\fB\fC\-c\fR
-Cancel an ongoing shutdown.
+\fB\fC-c\fR Cancel an ongoing shutdown.
.PP
-\fB\fC\-f\fR
-Enable fast booting; skip
-.BR fsck (8)
-on next boot.
+\fB\fC-f\fR Enable fast booting; skip fsck(8) on next boot.
.PP
-\fB\fC\-F\fR
-Force run of
-.BR fsck (8)
-on next boot.
+\fB\fC-F\fR Force run of fsck(8) on next boot.
.PP
-\fB\fC\-h\fR
-Halt the system.
+\fB\fC-h\fR Halt the system.
.PP
-\fB\fC\-k\fR
-Don't really shutdown; only send the warning messages to everybody.
+\fB\fC-k\fR Don't really shutdown; only send the warning messages to everybody.
.PP
-\fB\fC\-P\fR
-Poweroff the system.
+\fB\fC-P\fR Poweroff the system.
.PP
-\fB\fC\-r\fR
-Reboot the system.
+\fB\fC-r\fR Reboot the system.
.PP
-\fB\fCnow\fR
-Shutdown without further waiting.
+\fB\fCnow\fR Shutdown without further waiting.
.PP
-\fB\fC+mins\fR
-Wait mins minutes before shutting down.
+\fB\fC+mins\fR Wait mins minutes before shutting down.
.PP
-\fB\fCmessage\fR
+\fB\fCmessage\fR Message displayed to all users, defaults to "system is going down".
.PP
-Message displayed to all users, defaults to "system is going down".
.SH UNSUPPORTED OPTIONS
+
.PP
-This version of shutdown is based on
-.BR runit (8),
-the following features are not supported:
+This version of shutdown is based on runit(8), the following features are not supported:
.PP
-\fB\fC\-t secs\fR
-to wait secs seconds between SIGKILL and SIGTERM on shutdown is silently ignored.
+\fB\fC-t secs\fR to wait secs seconds between SIGKILL and SIGTERM on shutdown is silently ignored.
.PP
-\fB\fC\-a\fR
-Use /etc/shutdown.allow.
+\fB\fC-a\fR Use /etc/shutdown.allow.
.PP
-\fB\fC\-H\fR
-Drop into boot monitor.
+\fB\fC-H\fR Drop into boot monitor.
.PP
-\fB\fC\-n\fR
-Don't call
-.BR init (8).
+\fB\fC-n\fR Don't call init(8).
+.PP
+\fB\fChh:mm\fR Absolute time specification is not implemented.
.PP
-\fB\fChh:mm\fR
-Absolute time specification is not implemented.
.SH SEE ALSO
+
+.PP
+fsck(8), halt(8), init(8), poweroff(8), reboot(8), fiss(8), runsvchdir(8)
.PP
-.BR fsck (8),
-.BR halt (8),
-.BR init (8),
-.BR poweroff (8),
-.BR reboot (8),
-.BR fiss (8),
-.BR runsvchdir (8)
.SH AUTHOR
+
.PP
-Leah Neukirchen, \[la][email protected]\[ra]\&.
+Leah Neukirchen, [email protected].
+\ No newline at end of file
diff --git a/man/sigremap.8 b/man/sigremap.8
@@ -1,28 +1,32 @@
.TH sigremap 8 "MAY 2023" "0.3.2" "fiss man page"
+
+.PP
.SH NAME
+
+.PP
+\fB\fCsigremap\fR - a minimal init system for Linux containers
.PP
-\fB\fCsigremap\fR \- a minimal init system for Linux containers
.SH SYNOPSIS
+
+.PP
+\fB\fCsigremap\fR [option] [old-signal=new-signal...] command [arguments ...]
.PP
-\fB\fCsigremap\fR [option] [old\-signal=new\-signal...] command [arguments ...]
.SH DESCRIPTION
+
+.PP
+\fB\fCsigremap\fR is a simple process supervisor that forwards signals to children. It is designed to run as PID1 in minimal container environments.
.PP
-\fB\fCsigremap\fR is a simple process supervisor that forwards signals to children. It is designed to run as PID1 in minimal container environments.
+Optional arguments:
.PP
-Optional arguments:
+\fB\fC-c, --single\fR Run in single-child mode. In this mode, signals are only proxied to the direct child and not any of its descendants.
.PP
-\fB\fC\-c, \-\-single\fR
-Run in single\-child mode. In this mode, signals are only proxied to the direct child and not any of its descendants.
+\fB\fC-v, --verbose\fR Print debugging information to stderr.
.PP
-\fB\fC\-v, \-\-verbose\fR
-Print debugging information to stderr.
+\fB\fC-V, --version\fR Print the current version and exit.
.PP
-\fB\fC\-V, \-\-version\fR
-Print the current version and exit.
+\fB\fCold-signal=new-signal...\fR Rewrite received signal s to new signal r before proxying. To ignore (not proxy) a signal, rewrite it to 0. This option can be specified multiple times.
.PP
-\fB\fCold\-signal=new\-signal...\fR
-Rewrite received signal s to new signal r before proxying. To ignore (not proxy) a signal, rewrite it to 0. This option can be specified multiple times.
.SH AUTHORS
+
.PP
-\fB\fCsigremap\fR is based on dumb\-init by Yelp.
-Rewritten by Friedel Schon \[la][email protected]\[ra]
+\fB\fCsigremap\fR is based on dumb-init by Yelp. Rewritten by Friedel Schon <[email protected]>
+\ No newline at end of file
diff --git a/man/vlogger.1 b/man/vlogger.1
@@ -1,115 +1,88 @@
.TH vlogger 1 "MAY 2023" "0.3.2" "fiss man page"
+
+.PP
.SH NAME
+
+.PP
+\fB\fCvlogger\fR - log messages to syslog or an arbitrary executable
.PP
-\fB\fCvlogger\fR \- log messages to syslog or an arbitrary executable
.SH SYNOPSIS
+
+.PP
+\fB\fCvlogger\fR [\fB\fC-isS\fR] [\fB\fC-f\fR file] [\fB\fC-p\fR pri] [\fB\fC-t\fR tag] [message ...]
.PP
-\fB\fCvlogger\fR [\fB\fC\-isS\fR] [\fB\fC\-f\fR file] [\fB\fC\-p\fR pri] [\fB\fC\-t\fR tag] [message ...]
.SH DESCRIPTION
+
.PP
-The vlogger utility writes messages to the system log or an arbitrary executable.
+The vlogger utility writes messages to the system log or an arbitrary executable.
.PP
-If vlogger is executed as logger it will always use the system log and behave like the regular
-.BR logger (1).
+If vlogger is executed as logger it will always use the system log and behave like the regular logger(1).
.PP
-Without message arguments vlogger reads messages from stdin or the file specified with the \-f flag. If the /etc/vlogger executable exists vlogger executes it with tag, level and facility as arguments, replacing
-the vlogger process.
+Without message arguments vlogger reads messages from stdin or the file specified with the -f flag. If the /etc/vlogger executable exists vlogger executes it with tag, level and facility as arguments, replacing the vlogger process.
.PP
-If vlogger is executed as a log service for
-.BR fiss (8)
-or another daemontools like supervision suite it uses the service name as default tag. As example if vlogger is linked to /var/service/foo/log/run it uses “foo” as tag and “daemon.notice” as pri.
+If vlogger is executed as a log service for fiss(8) or another daemontools like supervision suite it uses the service name as default tag. As example if vlogger is linked to /var/service/foo/log/run it uses “foo” as tag and “daemon.notice” as pri.
.PP
-The options are as follows:
+The options are as follows:
.PP
-\fB\fC\-f file\fR
-Read lines from the specified file. This option cannot be combine message arguments.
+\fB\fC-f file\fR Read lines from the specified file. This option cannot be combine message arguments.
.PP
-\fB\fC\-i\fR
-Log the PID of the vlogger process. Only supported if
-.BR syslog (3)
-is used.
+\fB\fC-i\fR Log the PID of the vlogger process. Only supported if syslog(3) is used.
.PP
-\fB\fC\-p pri\fR
-The. pri can be facility.level or just facility. See FACILITIES, LEVELS or
-.BR syslog (3).
-The default is “user.notice”.
+\fB\fC-p pri\fR The. pri can be facility.level or just facility. See FACILITIES, LEVELS or syslog(3). The default is “user.notice”.
.PP
-\fB\fC\-S\fR
-Force vlogger to use
-.BR syslog (3)
-even if /etc/vlogger exists.
+\fB\fC-S\fR Force vlogger to use syslog(3) even if /etc/vlogger exists.
.PP
-\fB\fC\-s\fR
-Output the message to standard error, as well as
-.BR syslog (3).
-Only supported if
-.BR syslog (3)
-is used.
+\fB\fC-s\fR Output the message to standard error, as well as syslog(3). Only supported if syslog(3) is used.
.PP
-\fB\fC\-t tag\fR
-Defines the
-.BR openlog (3)
-ident which is used as prefix for each log message or passed as first argument to /etc/vlogger. The default is the LOGNAME environment variable.
+\fB\fC-t tag\fR Defines the openlog(3) ident which is used as prefix for each log message or passed as first argument to /etc/vlogger. The default is the LOGNAME environment variable.
+.PP
+\fB\fCmessage\fR Write the message to the system log.
.PP
-\fB\fCmessage\fR
-Write the message to the system log.
.SH FACILITIES
+
+.PP
+auth authpriv cron daemon ftp kern can not be used from userspace replaced with daemon. lpr mail news syslog user uucp local[0-7] security deprecated synonym for auth.
.PP
-auth
-authpriv
-cron
-daemon
-ftp
-kern can not be used from userspace replaced with daemon.
-lpr
-mail
-news
-syslog
-user
-uucp
-local[0\-7]
-security deprecated synonym for auth.
.SH LEVELS
+
+.PP
+emerg alert crit err warning notice info debug panic deprecated synonym for emerg. error deprecated synonym for err. warn deprecated synonym for warning.
.PP
-emerg
-alert
-crit
-err
-warning
-notice
-info
-debug
-panic deprecated synonym for emerg.
-error deprecated synonym for err.
-warn deprecated synonym for warning.
.SH FILES
+
+.PP
+\fB\fC/etc/vlogger\fR An optional executable file that is used to handle the messages. It is executed with tag, level and facility as arguments and replaces the vlogger process.
.PP
-\fB\fC/etc/vlogger\fR
-An optional executable file that is used to handle the messages. It is executed with tag, level and facility as arguments and replaces the vlogger process.
.SH EXIT STATUS
+
+.PP
+The vlogger utility exits 0 on success, and >0 if an error occurs.
.PP
-The vlogger utility exits 0 on success, and >0 if an error occurs.
.SH EXAMPLES
+
.PP
-\fB\fC/etc/vlogger:\fR
-.SH !/bin/sh
+\fB\fC/etc/vlogger:\fR #!/bin/sh exec svlogd /var/log/$1
.PP
-exec svlogd /var/log/$1
.SH SEE ALSO
+
+.PP
+logger(1), syslog(3), svlogd(8)
.PP
-.BR logger (1),
-.BR syslog (3),
-.BR svlogd (8)
.SH HISTORY
+
+.PP
+This program is a replacement for the logger utility provided by util-linux and forked from daemontools.
.PP
-This program is a replacement for the logger utility provided by util\-linux and forked from daemontools.
.SH AUTHORS
+
+.PP
+Duncan Overbruck <[email protected]>
.PP
-Duncan Overbruck \[la][email protected]\[ra]
.SH LICENSE
+
.PP
-vlogger is in the public domain.
+vlogger is in the public domain.
.PP
-To the extent possible under law, the creator of this work has waived all copyright and related or neighboring rights to this work.
+To the extent possible under law, the creator of this work has waived all copyright and related or neighboring rights to this work.
.PP
-\[la]http://creativecommons.org/publicdomain/zero/1.0/\[ra]
+http://creativecommons.org/publicdomain/zero/1.0/
+\ No newline at end of file
diff --git a/man/zzz.8 b/man/zzz.8
@@ -1,44 +1,44 @@
.TH zzz 8 "MAY 2023" "0.3.2" "fiss man page"
+
+.PP
.SH NAME
+
+.PP
+zzz - suspend or hibernate your system
.PP
-zzz \- suspend or hibernate your system
.SH SYNOPSIS
+
+.PP
+\fB\fCzzz [-nSzZRH]\fR
.PP
-\fB\fCzzz [\-nSzZRH]\fR
.SH DESCRIPTION
+
.PP
-\fB\fCzzz\fR is a simple utility to hibernate or suspend your computer and part of the fiss\-system. It supports suspend/resume\-hooks.
+\fB\fCzzz\fR is a simple utility to hibernate or suspend your computer and part of the fiss-system. It supports suspend/resume-hooks.
.PP
-\fB\fC\-n, \-\-noop\fR
-dry\-run, sleep for 5sec instead of actually running ACPI actions.
+\fB\fC-n, --noop\fR dry-run, sleep for 5sec instead of actually running ACPI actions.
.PP
-\fB\fC\-S, \-\-freeze\fR
-enter low\-power idle mode
+\fB\fC-S, --freeze\fR enter low-power idle mode
.PP
-\fB\fC\-z, \-\-suspend\fR
-suspend to RAM, this is the default behaviour of \fB\fCzzz\fR
+\fB\fC-z, --suspend\fR suspend to RAM, this is the default behaviour of \fB\fCzzz\fR
.PP
-\fB\fC\-Z, \-\-hibernate\fR
-hibernate to disk and power off
+\fB\fC-Z, --hibernate\fR hibernate to disk and power off
.PP
-\fB\fC\-R, \-\-reboot\fR
-hibernate to disk and reboot (useful for switching operating systems)
+\fB\fC-R, --reboot\fR hibernate to disk and reboot (useful for switching operating systems)
+.PP
+\fB\fC-H, --hybrid\fR hibernate to disk and suspend
.PP
-\fB\fC\-H, \-\-hybrid\fR
-hibernate to disk and suspend
.SH HOOKS
+
+.PP
+Before suspending, \fB\fCzzz\fR executes \fI/usr/share/fiss/suspend\fR which intents to execute scripts inside \fI/etc/zzz.d/suspend\fR in alphanumeric order. After resuming, \fB\fCzzz\fR executes \fI/usr/share/fiss/resume\fR which intents to execute scripts inside \fI/etc/zzz.d/resume\fR in alphanumeric order.
.PP
-Before suspending, \fB\fCzzz\fR executes \fI/usr/share/fiss/suspend\fP which intents to execute scripts inside \fI/etc/zzz.d/suspend\fP in alphanumeric order. After resuming, \fB\fCzzz\fR executes \fI/usr/share/fiss/resume\fP which intents to execute scripts inside \fI/etc/zzz.d/resume\fP in alphanumeric order.
.SH SEE ALSO
+
+.PP
+fiss-init(8), runsvdir(8), runsvchdir(8), sv(8), runsv(8), chpst(8), utmpset(8), svlogd(8)
.PP
-.BR fiss-init (8),
-.BR runsvdir (8),
-.BR runsvchdir (8),
-.BR sv (8),
-.BR runsv (8),
-.BR chpst (8),
-.BR utmpset (8),
-.BR svlogd (8)
.SH AUTHOR
+
.PP
-Based on the version of Leah Neukirchen <\[la][email protected]\[ra]>, rewritten by Friedel Schön <\[la][email protected]\[ra]>
+Based on the version of Leah Neukirchen <[email protected]>, rewritten by Friedel Schön <[email protected]>
+\ No newline at end of file
diff --git a/src/docs/index.txt b/src/docs/index.txt
@@ -1,4 +1,4 @@
-@header fiss
+@header fiss %VERSION%
Aloha! You somehow landed on the website of *fiss* (_Friedel's Initialization and
Service Supervision_). *fiss* is a supervision suite for Unix and Unix-like systems
diff --git a/src/man/chpst.8.md b/src/man/chpst.8.md
@@ -1,89 +0,0 @@
-# chpst 8 "MAY 2023" "%VERSION%" "fiss man page"
-
-## NAME
-
-`chpst` - runs a program with a changed process state
-
-## SYNOPSIS
-
-`chpst` \[`-vP012`] \[`-u` user] \[`-U` user] \[`-b` argv0] \[`-e` dir] \[`-/` root] \[`-n` inc] \[`-l`|`-L` lock] \[`-m` bytes] \[`-d` bytes] \[`-o` n] \[`-p` n] \[`-f` bytes] \[`-c` bytes] prog \[arguments...]
-
-## DESCRIPTION
-
-`-u [:]user[:group]`
-
-setuidgid. Set uid and gid to the user's uid and gid, as found in /etc/passwd. If user is followed by a colon and a group, set the gid to group's gid, as found in /etc/group, instead of user's gid. If group consists of a colon-separated list of group names, chpst sets the group ids of all listed groups. If user is prefixed with a colon, the user and all group arguments are interpreted as uid and gids respectivly, and not looked up in the password or group file. All initial supplementary groups are removed.
-
-`-U [:]user[:group]`
-
-envuidgid. Set the environment variables $UID and $GID to the user's uid and gid, as found in /etc/passwd. If user is followed by a colon and a group, set $GID to the group's gid, as found in /etc/group, instead of user's gid. If user is prefixed with a colon, the user and group arguments are interpreted as uid and gid respectivly, and not looked up in the password or group file.
-
-`-b argv0`
-Run prog with argv0 as the 0th argument.
-
-`-/ root`
-Change the root directory to root before starting prog.
-
-`-C pwd`
-Change the working directory to pwd before starting prog. When combined with -/, the working directory is changed after the chroot.
-
-`-n inc`
-Add inc to the nice(2) value before starting prog. inc must be an integer, and may start with a minus or plus.
-
-`-l lock`
-Open the file lock for writing, and obtain an exclusive lock on it. lock will be created if it does not exist. If lock is locked by another process, wait until a new lock can be obtained.
-
-`-L lock`
-The same as -l, but fail immediately if lock is locked by another process.
-
-`-P`
-Run prog in a new process group.
-
-`-0`
-Close standard input before starting prog.
-
-`-1`
-Close standard output before starting prog.
-
-`-2`
-Close standard error before starting prog.
-
-
-## NOT IMPLEMENTED
-
-Following options are defined in runit's chpst but are ignored by fiss' implementation.
-
-`-e dir`
-Set various environment variables as specified by files in the directory dir: If dir contains a file named k whose first line is v, chpst removes the environment variable k if it exists, and then adds the environment variable k with the value v. The name k must not contain =. Spaces and tabs at the end of v are removed, and nulls in v are changed to newlines. If
-the file k is empty (0 bytes long), chpst removes the environment variable k if it exists, without adding a new variable.
-
-`-m bytes`
-Limit the data segment, stack segment, locked physical pages, and total of all segment per process to bytes bytes each.
-
-`-d bytes`
-limit data segment. Limit the data segment per process to bytes bytes.
-
-`-o n`
-Limit the number of open file descriptors per process to n.
-
-`-p n`
-Limit the number of processes per uid to n.
-
-`-f bytes`
-Limit the output file size to bytes bytes.
-
-`-c bytes`
-Limit the core file size to bytes bytes.
-
-`-v`
-Print verbose messages to standard error. This includes warnings about limits unsupported by the system.
-
-
-## EXIT CODES
-
-chpst exits 100 when called with wrong options. It prints an error message and exits 111 if it has trouble changing the process state. Otherwise its exit code is the same as that of prog.
-
-## AUTHOR
-
-Based on the implementation by Gerrit Pape <[email protected]>,
-rewritten by Friedel Schon <[email protected]>
diff --git a/src/man/chpst.8.txt b/src/man/chpst.8.txt
@@ -0,0 +1,93 @@
+@man chpst 8 "MAY 2023" "%VERSION%" "fiss man page"
+@header chpst(8) %VERSION%
+
+@title name Name
+
+*chpst* - runs a program with a changed process state
+
+
+@title synopsis Synopsis
+
+*chpst* [*-vP012*] [*-u* user] [*-U* user] [*-b* argv0] [*-e* dir] [*-/* root] [*-n* inc] [*-l*|*-L* lock] [*-m* bytes] [*-d* bytes] [*-o* n] [*-p* n] [*-f* bytes] [*-c* bytes] prog [arguments...]
+
+
+@title description Description
+@list
+*-u [:]user[:group]*~
+setuidgid. Set uid and gid to the user's uid and gid, as found in /etc/passwd. If user is followed by a colon and a group, set the gid to group's gid, as found in /etc/group, instead of user's gid. If group consists of a colon-separated list of group names, chpst sets the group ids of all listed groups. If user is prefixed with a colon, the user and all group arguments are interpreted as uid and gids respectivly, and not looked up in the password or group file. All initial supplementary groups are removed.
+
+*-U [:]user[:group]*~
+envuidgid. Set the environment variables $UID and $GID to the user's uid and gid, as found in /etc/passwd. If user is followed by a colon and a group, set $GID to the group's gid, as found in /etc/group, instead of user's gid. If user is prefixed with a colon, the user and group arguments are interpreted as uid and gid respectivly, and not looked up in the password or group file.
+
+*-b argv0*~
+Run prog with argv0 as the 0th argument.
+
+*-/ root*~
+Change the root directory to root before starting prog.
+
+*-C pwd*~
+Change the working directory to pwd before starting prog. When combined with -/, the working directory is changed after the chroot.
+
+*-n inc*~
+Add inc to the nice(2) value before starting prog. inc must be an integer, and may start with a minus or plus.
+
+*-l lock*~
+Open the file lock for writing, and obtain an exclusive lock on it. lock will be created if it does not exist. If lock is locked by another process, wait until a new lock can be obtained.
+
+*-L lock*~
+The same as -l, but fail immediately if lock is locked by another process.
+
+*-P*~
+Run prog in a new process group.
+
+*-0*~
+Close standard input before starting prog.
+
+*-1*~
+Close standard output before starting prog.
+
+*-2*~
+Close standard error before starting prog.
+@endlist
+
+
+@title not-implemented Not Implemented
+
+Following options are defined in runit's chpst but are ignored by fiss' implementation.
+
+@list
+*-e dir*~
+Set various environment variables as specified by files in the directory dir: If dir contains a file named k whose first line is v, chpst removes the environment variable k if it exists, and then adds the environment variable k with the value v. The name k must not contain =. Spaces and tabs at the end of v are removed, and nulls in v are changed to newlines. If
+the file k is empty (0 bytes long), chpst removes the environment variable k if it exists, without adding a new variable.
+
+*-m bytes*~
+Limit the data segment, stack segment, locked physical pages, and total of all segment per process to bytes bytes each.
+
+*-d bytes*~
+limit data segment. Limit the data segment per process to bytes bytes.
+
+*-o n*~
+Limit the number of open file descriptors per process to n.
+
+*-p n*~
+Limit the number of processes per uid to n.
+
+*-f bytes*~
+Limit the output file size to bytes bytes.
+
+*-c bytes*~
+Limit the core file size to bytes bytes.
+
+*-v*~
+Print verbose messages to standard error. This includes warnings about limits unsupported by the system.
+@endlist
+
+@title exit-codes Exit Codes
+
+chpst exits 100 when called with wrong options. It prints an error message and exits 111 if it has trouble changing the process state. Otherwise its exit code is the same as that of prog.
+
+
+@title author Author
+
+Based on the implementation by Gerrit Pape <[email protected]>,
+rewritten by Friedel Schon <[email protected]>
diff --git a/src/man/finit.8.md b/src/man/finit.8.md
@@ -1,58 +0,0 @@
-# finit 8 "MAY 2023" "01.0" "fiss man page"
-
-## NAME
-
-fiss - a UNIX process no 1
-
-## SYNOPSIS
-
-`fsvc`
-when running as PID 0 (as init)
-
-`fsvc` \<0|6\>
-when running regulary to controll init
-
-## CONTROLLING
-
-If `finit` is invoked by any other user than _root_, it failes.
-
-`finit` 0
-halts the system
-
-`finit` 6
-reboots the system
-
-## DESCRIPTION
-
-`fiss` must be run as Unix process no 1 if invoked without arguments and handles the boot process in user-land.
-
-This happens in three stages:
-
-## STAGE 1
-
-`fiss` runs _/etc/fiss/start_ and waits for it to terminate. The system's one time tasks are done here. _/etc/fiss/start_ has full control of _/dev/console_ to be able to start an emergency shell if the one time initialization tasks fail. If _/etc/fiss/start_ crashes, `finit` will skip stage 2 and enter stage 3.
-
-## STAGE 2
-
-`fiss` starts all services in _/etc/fiss/service.d_ which should not return until system shutdown; if it crashes, it will be restarted.
-
-## STAGE 3
-
-If `fiss` is told to shutdown the system, it terminates stage 2 if it is running, and runs _/etc/fiss/stop_. The systems tasks to shutdown and possibly halt or reboot the system are done here. If stage 3 returns, `finit` checks if the file
-
-## SIGNALS
-
-`finit` only accepts signals in stage 2.
-
-If `finit` receives a CONT signal and the file `finit`
-is told to shutdown the system.
-
-if `finit` receives an INT signal, `finit` restarts the system.
-
-## SEE ALSO
-
-fiss-init(8), runsvdir(8), runsvchdir(8), sv(8), runsv(8), chpst(8), utmpset(8), svlogd(8)
-
-## AUTHOR
-
-Friedel Schön \<[email protected]\>
diff --git a/src/man/finit.8.txt b/src/man/finit.8.txt
@@ -0,0 +1,62 @@
+@man finit 8 "MAY 2023" "01.0" "fiss man page"
+
+@title name Name
+
+fiss - a UNIX process no 1
+
+@title synopsis Synopsis
+
+@list
+*fsvc*
+when running as PID 0 (as init)
+
+*fsvc* <0|6>
+when running regulary to controll init
+@endlist
+
+@title controlling Controlling
+
+If *finit* is invoked by any other user than _root_, it failes.
+
+@list
+*finit* 0
+halts the system
+
+*finit* 6
+reboots the system
+@endlist
+
+@title description Description
+
+*fiss* must be run as Unix process no 1 if invoked without arguments and handles the boot process in user-land.
+
+This happens in three stages:
+
+@title stage Stage 1
+
+*fiss* runs _/etc/fiss/start_ and waits for it to terminate. The system's one time tasks are done here. _/etc/fiss/start_ has full control of _/dev/console_ to be able to start an emergency shell if the one time initialization tasks fail. If _/etc/fiss/start_ crashes, *finit* will skip stage 2 and enter stage 3.
+
+@title stage Stage 2
+
+*fiss* starts all services in _/etc/fiss/service.d_ which should not return until system shutdown; if it crashes, it will be restarted.
+
+@title stage Stage 3
+
+If *fiss* is told to shutdown the system, it terminates stage 2 if it is running, and runs _/etc/fiss/stop_. The systems tasks to shutdown and possibly halt or reboot the system are done here. If stage 3 returns, *finit* checks if the file
+
+@title signals Signals
+
+*finit* only accepts signals in stage 2.
+
+If *finit* receives a CONT signal and the file *finit*
+is told to shutdown the system.
+
+if *finit* receives an INT signal, *finit* restarts the system.
+
+@title see See ALSO
+
+fiss-init(8), runsvdir(8), runsvchdir(8), sv(8), runsv(8), chpst(8), utmpset(8), svlogd(8)
+
+@title author Author
+
+Friedel Schön <[email protected]>
diff --git a/src/man/fsvc.8.md b/src/man/fsvc.8.md
@@ -1,102 +0,0 @@
-# fsvc 8 "MAY 2023" "%VERSION%" "fiss man page"
-
-## NAME
-
-`fsvc` - fiss' service controller
-
-## SYNOPSIS
-
-`fsvc` `start` \[_options_] \[`--pin_`] \<service>
-
-`fsvc` `stop` \[_options_] \[`--pin`] \<service>
-
-`fsvc` `enable` \[_options_] \[`--once`] \<service>
-
-`fsvc` `disable` \[_options_] \[`--once`] \<service>
-
-`fsvc` `kill` \[_options_] \<service> \<signal|signo>
-
-`fsvc` `status` \[_options_] \[`--check`] \[\<service>]
-
-`fsvc` `pause` \[_options_] \<service>
-
-`fsvc` `resume` \[_options_] \<service>
-
-`fsvc` `switch` \[_options_] \[`--reset`] \<runlevel>
-
-## DESCRIPTION
-
-`fsvc` is a command line tool for controlling services on a fiss system. It provides various commands for starting, stopping, enabling, disabling, sending signals to, checking the status of, pausing, resuming, and switching the runlevel of services.
-
-## OPTIONS
-
-The following options are available for every command:
-
-`-q, --short`
-Will print brief information about the service.
-
-`-r, --runlevel <runlevel>`
-Will use \fBrunlevel\fB instead of _default_.
-
-`-s, --service-dir <path>`
-Will use `path` as service directory instead of _/etc/fiss/service.d_.
-
-`-v, --verbose`
-Prints verbose information.
-
-`-V, --version`
-Prints the version and exits.
-
-The following options are available per command:
-
-`-p, --pin`
-Pins the state. If issued with `start` it will cause the service to restart.
-If issued with `stop` it will cause the service to be hold down.
-
-`-o, --once`
-Specifies that the service should only be enabled/disabled once and not automatically started/stopped on subsequent bootups.
-
-`-c, --check`
-Command will return _0_ if the specified service is active otherwise _1_
-
-`-r, --reset`
-Specifies that the switch command should reset all running services (if manually set to up/down)
-
-## COMMANDS
-
-The following commands are available:
-
-`start`
-Starts the specified service. A synonym is `up`.
-
-`stop`
-Stops the specified service. A synonym is `down`.
-
-`enable`
-Enables the specified service, causing it to automatically start on subsequent bootups.
-
-`disable`
-Disables the specified service, causing it to not start automatically on subsequent bootups.
-
-`kill`
-Sends the specified signal or signal number to the specified service. A synonym is `send`.
-
-`status`
-Displays the status of the specified service. If no service is specified, displays the status of all services.
-
-`pause`
-Pauses the specified service.
-
-`resume`
-Resumes the specified service.
-
-`switch`
-Switches the runlevel to the specified value.
-
-## SEE ALSO
-
-finit(1), fsvc(8), fsvs(8), halt(8), modules-load(8), shutdown(8),
-
-## AUTHOR
-
-Friedel Schön \<[email protected]>
diff --git a/src/man/fsvc.8.txt b/src/man/fsvc.8.txt
@@ -0,0 +1,106 @@
+@man fsvc 8 "MAY 2023" "%VERSION%" "fiss man page"
+
+@title name Name
+
+*fsvc* - fiss' service controller
+
+@title synopsis Synopsis
+
+*fsvc* *start* [_options_] [*--pin_*] <service>
+
+*fsvc* *stop* [_options_] [*--pin*] <service>
+
+*fsvc* *enable* [_options_] [*--once*] <service>
+
+*fsvc* *disable* [_options_] [*--once*] <service>
+
+*fsvc* *kill* [_options_] <service> <signal|signo>
+
+*fsvc* *status* [_options_] [*--check*] [<service>]
+
+*fsvc* *pause* [_options_] <service>
+
+*fsvc* *resume* [_options_] <service>
+
+*fsvc* *switch* [_options_] [*--reset*] <runlevel>
+
+@title description Description
+
+*fsvc* is a command line tool for controlling services on a fiss system. It provides various commands for starting, stopping, enabling, disabling, sending signals to, checking the status of, pausing, resuming, and switching the runlevel of services.
+
+@title options Options
+
+The following options are available for every command:
+
+@list
+*-q, --short*
+Will print brief information about the service.
+
+*-r, --runlevel <runlevel>*
+Will use fBrunlevelfB instead of _default_.
+
+*-s, --service-dir <path>*
+Will use *path* as service directory instead of _/etc/fiss/service.d_.
+
+*-v, --verbose*
+Prints verbose information.
+
+*-V, --version*
+Prints the version and exits.
+
+The following options are available per command:
+
+*-p, --pin*
+Pins the state. If issued with *start* it will cause the service to restart.
+If issued with *stop* it will cause the service to be hold down.
+
+*-o, --once*
+Specifies that the service should only be enabled/disabled once and not automatically started/stopped on subsequent bootups.
+
+*-c, --check*
+Command will return _0_ if the specified service is active otherwise _1_
+
+*-r, --reset*
+Specifies that the switch command should reset all running services (if manually set to up/down)
+@endlist
+
+@title commands Commands
+
+The following commands are available:
+
+@list
+*start*
+Starts the specified service. A synonym is *up*.
+
+*stop*
+Stops the specified service. A synonym is *down*.
+
+*enable*
+Enables the specified service, causing it to automatically start on subsequent bootups.
+
+*disable*
+Disables the specified service, causing it to not start automatically on subsequent bootups.
+
+*kill*
+Sends the specified signal or signal number to the specified service. A synonym is *send*.
+
+*status*
+Displays the status of the specified service. If no service is specified, displays the status of all services.
+
+*pause*
+Pauses the specified service.
+
+*resume*
+Resumes the specified service.
+
+*switch*
+Switches the runlevel to the specified value.
+@endlist
+
+@title see See ALSO
+
+finit(1), fsvc(8), fsvs(8), halt(8), modules-load(8), shutdown(8),
+
+@title author Author
+
+Friedel Schön <[email protected]>
diff --git a/src/man/fsvs.8.md b/src/man/fsvs.8.md
@@ -1,30 +0,0 @@
-# fsvs 8 "MAY 2023" "%VERSION%" "fiss man page"
-
-## NAME
-
-`fsvs` - friedel's service superviser
-
-## SYNOPSIS
-
-`fsvs` \[options] service-dir runlevel
-
-## DESCRIPTION
-
-`fsvs` is the superviser called by `finit` but without initialization.
-
-Following options are available:
-
-`-v, --verbose`
-Prints more information, easier to debug problems
-
-`-f, --force`
-Forces the socket if existing, if called without `-f` and the socket already exists, it failes.
-
-`-V, --version`
-Prints the version and exits.
-
-Services can be controlled with `fsvc 8`
-
-## AUTHORS
-
-Friedel Schon <[email protected]>
diff --git a/src/man/fsvs.8.txt b/src/man/fsvs.8.txt
@@ -0,0 +1,32 @@
+@man fsvs 8 "MAY 2023" "%VERSION%" "fiss man page"
+
+@title name Name
+
+*fsvs* - friedel's service superviser
+
+@title synopsis Synopsis
+
+*fsvs* [options] service-dir runlevel
+
+@title description Description
+
+*fsvs* is the superviser called by *finit* but without initialization.
+
+Following options are available:
+
+@list
+*-v, --verbose*
+Prints more information, easier to debug problems
+
+*-f, --force*
+Forces the socket if existing, if called without *-f* and the socket already exists, it failes.
+
+*-V, --version*
+Prints the version and exits.
+@endlist
+
+Services can be controlled with *fsvc 8*
+
+@title authors Authors
+
+Friedel Schon <[email protected]>
diff --git a/src/man/halt.8.md b/src/man/halt.8.md
@@ -1,39 +0,0 @@
-# halt 8 "MAY 2023" "%VERSION%" "fiss man page"
-
-## NAME
-
-halt, reboot, poweroff - stop the system
-
-## SYNOPSIS
-
-`poweroff` \[`-n`] \[`-f`] \[`-d`] \[`-w`] \[`-b`]
-
-`reboot` \[`-n`] \[`-f`] \[`-d`] \[`-w`] \[`-b`]
-
-`halt` \[`-n`] \[`-f`] \[`-d`] \[`-w`] \[`-b`]
-
-## DESCRIPTION
-
-`poweroff` / `reboot` / `halt` tells `init` to stop running services and stop the system. Invoked without `-f`, it is a shortcut for `init <0|6>`
-
-## OPTIONS
-
-`-n`
-Don't sync devices, this doensn't imply that the kernel is not synced already
-
-`-f`
-Forces halt / reboot without notifying `init`. Forcing the system to halt should be the last hope and can be dangerous, you should not try it
-
-`-d`
-Don't write the _wtmp_ record
-
-`w`
-Only write the wtmp record, no further action
-
-## SEE ALSO
-
-finit(1), fsvc(8), fsvs(8), halt(8), modules-load(8), shutdown(8),
-
-## AUTHOR
-
-Based on the version of Leah Neukirchen \<[email protected]\>, rewritten by Friedel Schön \<[email protected]\>
diff --git a/src/man/halt.8.txt b/src/man/halt.8.txt
@@ -0,0 +1,43 @@
+@man halt 8 "MAY 2023" "%VERSION%" "fiss man page"
+
+@title name Name
+
+halt, reboot, poweroff - stop the system
+
+@title synopsis Synopsis
+
+@list
+*poweroff* [*-n*] [*-f*] [*-d*] [*-w*] [*-b*]
+
+*reboot* [*-n*] [*-f*] [*-d*] [*-w*] [*-b*]
+
+*halt* [*-n*] [*-f*] [*-d*] [*-w*] [*-b*]
+@endlist
+
+@title description Description
+
+*poweroff* / *reboot* / *halt* tells *init* to stop running services and stop the system. Invoked without *-f*, it is a shortcut for *init <0|6>*
+
+@title options Options
+
+@list
+*-n*
+Don't sync devices, this doensn't imply that the kernel is not synced already
+
+*-f*
+Forces halt / reboot without notifying *init*. Forcing the system to halt should be the last hope and can be dangerous, you should not try it
+
+*-d*
+Don't write the _wtmp_ record
+
+*w*
+Only write the wtmp record, no further action
+@endlist
+
+@title see See ALSO
+
+finit(1), fsvc(8), fsvs(8), halt(8), modules-load(8), shutdown(8),
+
+@title author Author
+
+Based on the version of Leah Neukirchen <[email protected]>, rewritten by Friedel Schön <[email protected]>
diff --git a/src/man/modules-load.8.md b/src/man/modules-load.8.md
@@ -1,43 +0,0 @@
-# modules-load 8 "MAY 2023" "%VERSION%" "fiss man page"
-
-## NAME
-
-`modules-load` - configure kernel modules at boot
-
-## SYNOPSIS
-
-`modules-load` \[`-nv`]
-
-## DESCRIPTION
-
-modules-load reads files which contain kernel modules to load during boot from the list of locations below.
-
-`-n`
-dry-run mode. This option does everything but actually insert or
-delete the modules.
-
-`-v`
-verbose mode. Print messages about what the program is doing.
-
-## FILES
-
-Configuration files are read from the following locations:
-
-_/etc/modules-load.d/\*.conf_
-
-_/run/modules-load.d/\*.conf_
-
-_/usr/lib/modules-load.d/\*.conf_
-
-The configuration files should simply contain a list of kernel module
-names to load, separated by newlines. Empty lines and lines whose first
-non-whitespace character is # or ; are ignored.
-
-## HISTORY
-
-This program is a replacement for the modules-load utility provided by
-systemd.
-
-## AUTHOR
-
-Leah Neukirchen, [email protected].
diff --git a/src/man/modules-load.8.txt b/src/man/modules-load.8.txt
@@ -0,0 +1,47 @@
+@man modules-load 8 "MAY 2023" "%VERSION%" "fiss man page"
+
+@title name Name
+
+*modules-load* - configure kernel modules at boot
+
+@title synopsis Synopsis
+
+*modules-load* [*-nv*]
+
+@title description Description
+
+modules-load reads files which contain kernel modules to load during boot from the list of locations below.
+
+@list
+*-n*
+dry-run mode. This option does everything but actually insert or
+delete the modules.
+
+*-v*
+verbose mode. Print messages about what the program is doing.
+@endlist
+
+@title files Files
+
+Configuration files are read from the following locations:
+
+@list
+_/etc/modules-load.d/*.conf_
+
+_/run/modules-load.d/*.conf_
+
+_/usr/lib/modules-load.d/*.conf_
+@endlist
+
+The configuration files should simply contain a list of kernel module
+names to load, separated by newlines. Empty lines and lines whose first
+non-whitespace character is # or ; are ignored.
+
+@title history History
+
+This program is a replacement for the modules-load utility provided by
+systemd.
+
+@title author Author
+
+Leah Neukirchen, [email protected].
diff --git a/src/man/shutdown.8.md b/src/man/shutdown.8.md
@@ -1,73 +0,0 @@
-# shutdown 8 "MAY 2023" "%VERSION%" "fiss man page"
-
-## NAME
-
-`shutdown` – bring down the system
-
-## SYNOPSIS
-
-`shutdown` \[`-rhP`] \[`-fF`] \[now | +mins] \[message ...]
-
-## DESCRIPTION
-
-shutdown brings the system down in a secure way. All logged-in users are notified that the system is going down, and login(1) is blocked.
-
-By default, shutdown puts the system into single user mode. Rebooting and halting the system can be done using the following options:
-
-`-c`
-Cancel an ongoing shutdown.
-
-`-f`
-Enable fast booting; skip fsck(8) on next boot.
-
-`-F`
-Force run of fsck(8) on next boot.
-
-`-h`
-Halt the system.
-
-`-k`
-Don't really shutdown; only send the warning messages to everybody.
-
-`-P`
-Poweroff the system.
-
-`-r`
-Reboot the system.
-
-`now`
-Shutdown without further waiting.
-
-`+mins`
-Wait mins minutes before shutting down.
-
-`message`
-
-Message displayed to all users, defaults to "system is going down".
-
-## UNSUPPORTED OPTIONS
-
-This version of shutdown is based on runit(8), the following features are not supported:
-
-`-t secs`
-to wait secs seconds between SIGKILL and SIGTERM on shutdown is silently ignored.
-
-`-a`
-Use /etc/shutdown.allow.
-
-`-H`
-Drop into boot monitor.
-
-`-n`
-Don't call init(8).
-
-`hh:mm`
-Absolute time specification is not implemented.
-
-## SEE ALSO
-
-fsck(8), halt(8), init(8), poweroff(8), reboot(8), fiss(8), runsvchdir(8)
-
-## AUTHOR
-
-Leah Neukirchen, [email protected].
diff --git a/src/man/shutdown.8.txt b/src/man/shutdown.8.txt
@@ -0,0 +1,74 @@
+@man shutdown 8 "MAY 2023" "%VERSION%" "fiss man page"
+
+@title name Name
+
+*shutdown* – bring down the system
+
+@title synopsis Synopsis
+
+*shutdown* [*-rhP*] [*-fF*] [now | +mins] [message ...]
+
+@title description Description
+
+shutdown brings the system down in a secure way. All logged-in users are notified that the system is going down, and login(1) is blocked.
+
+By default, shutdown puts the system into single user mode. Rebooting and halting the system can be done using the following options:
+
+@list
+*-c*
+Cancel an ongoing shutdown.
+
+*-f*
+Enable fast booting; skip fsck(8) on next boot.
+
+*-F*
+Force run of fsck(8) on next boot.
+
+*-h*
+Halt the system.
+
+*-k*
+Don't really shutdown; only send the warning messages to everybody.
+
+*-P*
+Poweroff the system.
+
+*-r*
+Reboot the system.
+
+*now*
+Shutdown without further waiting.
+
+*+mins*
+Wait mins minutes before shutting down.
+
+*message*
+Message displayed to all users, defaults to "system is going down".
+@endlist
+
+@title unsupported Unsupported OPTIONS
+
+This version of shutdown is based on runit(8), the following features are not supported:
+
+*-t secs*
+to wait secs seconds between SIGKILL and SIGTERM on shutdown is silently ignored.
+
+*-a*
+Use /etc/shutdown.allow.
+
+*-H*
+Drop into boot monitor.
+
+*-n*
+Don't call init(8).
+
+*hh:mm*
+Absolute time specification is not implemented.
+
+@title see See ALSO
+
+fsck(8), halt(8), init(8), poweroff(8), reboot(8), fiss(8), runsvchdir(8)
+
+@title author Author
+
+Leah Neukirchen, [email protected].
diff --git a/src/man/sigremap.8.md b/src/man/sigremap.8.md
@@ -1,32 +0,0 @@
-# sigremap 8 "MAY 2023" "%VERSION%" "fiss man page"
-
-## NAME
-
-`sigremap` - a minimal init system for Linux containers
-
-## SYNOPSIS
-
-`sigremap` \[option] \[old-signal=new-signal...] command \[arguments ...]
-
-## DESCRIPTION
-
-`sigremap` is a simple process supervisor that forwards signals to children. It is designed to run as PID1 in minimal container environments.
-
-Optional arguments:
-
-`-c, --single`
-Run in single-child mode. In this mode, signals are only proxied to the direct child and not any of its descendants.
-
-`-v, --verbose`
-Print debugging information to stderr.
-
-`-V, --version`
-Print the current version and exit.
-
-`old-signal=new-signal...`
-Rewrite received signal s to new signal r before proxying. To ignore (not proxy) a signal, rewrite it to 0. This option can be specified multiple times.
-
-## AUTHORS
-
-`sigremap` is based on dumb-init by Yelp.
-Rewritten by Friedel Schon <[email protected]>
diff --git a/src/man/sigremap.8.txt b/src/man/sigremap.8.txt
@@ -0,0 +1,34 @@
+@man sigremap 8 "MAY 2023" "%VERSION%" "fiss man page"
+
+@title name Name
+
+*sigremap* - a minimal init system for Linux containers
+
+@title synopsis Synopsis
+
+*sigremap* [option] [old-signal=new-signal...] command [arguments ...]
+
+@title description Description
+
+*sigremap* is a simple process supervisor that forwards signals to children. It is designed to run as PID1 in minimal container environments.
+
+Optional arguments:
+
+@list
+*-c, --single*
+Run in single-child mode. In this mode, signals are only proxied to the direct child and not any of its descendants.
+
+*-v, --verbose*
+Print debugging information to stderr.
+
+*-V, --version*
+Print the current version and exit.
+
+*old-signal=new-signal...*
+Rewrite received signal s to new signal r before proxying. To ignore (not proxy) a signal, rewrite it to 0. This option can be specified multiple times.
+@endlist
+
+@title authors Authors
+
+*sigremap* is based on dumb-init by Yelp.
+Rewritten by Friedel Schon <[email protected]>
diff --git a/src/man/vlogger.1.md b/src/man/vlogger.1.md
@@ -1,109 +0,0 @@
-# vlogger 1 "MAY 2023" "%VERSION%" "fiss man page"
-
-## NAME
-
-`vlogger` - log messages to syslog or an arbitrary executable
-
-## SYNOPSIS
-
-`vlogger` \[`-isS`] \[`-f` file] \[`-p` pri] \[`-t` tag] \[message ...]
-
-## DESCRIPTION
-
-The vlogger utility writes messages to the system log or an arbitrary executable.
-
-If vlogger is executed as logger it will always use the system log and behave like the regular logger(1).
-
-Without message arguments vlogger reads messages from stdin or the file specified with the -f flag. If the /etc/vlogger executable exists vlogger executes it with tag, level and facility as arguments, replacing
-the vlogger process.
-
-If vlogger is executed as a log service for fiss(8) or another daemontools like supervision suite it uses the service name as default tag. As example if vlogger is linked to /var/service/foo/log/run it uses “foo” as tag and “daemon.notice” as pri.
-
-The options are as follows:
-
-`-f file`
-Read lines from the specified file. This option cannot be combine message arguments.
-
-`-i`
-Log the PID of the vlogger process. Only supported if syslog(3) is used.
-
-`-p pri`
-The. pri can be facility.level or just facility. See FACILITIES, LEVELS or syslog(3). The default is “user.notice”.
-
-`-S`
-Force vlogger to use syslog(3) even if /etc/vlogger exists.
-
-`-s`
-Output the message to standard error, as well as syslog(3). Only supported if syslog(3) is used.
-
-`-t tag`
-Defines the openlog(3) ident which is used as prefix for each log message or passed as first argument to /etc/vlogger. The default is the LOGNAME environment variable.
-
-`message`
-Write the message to the system log.
-
-## FACILITIES
-
-auth
-authpriv
-cron
-daemon
-ftp
-kern can not be used from userspace replaced with daemon.
-lpr
-mail
-news
-syslog
-user
-uucp
-local[0-7]
-security deprecated synonym for auth.
-
-## LEVELS
-
-emerg
-alert
-crit
-err
-warning
-notice
-info
-debug
-panic deprecated synonym for emerg.
-error deprecated synonym for err.
-warn deprecated synonym for warning.
-
-## FILES
-
-`/etc/vlogger`
-An optional executable file that is used to handle the messages. It is executed with tag, level and facility as arguments and replaces the vlogger process.
-
-## EXIT STATUS
-
-The vlogger utility exits 0 on success, and >0 if an error occurs.
-
-## EXAMPLES
-
-`/etc/vlogger:`
-#!/bin/sh
-exec svlogd /var/log/$1
-
-## SEE ALSO
-
-logger(1), syslog(3), svlogd(8)
-
-## HISTORY
-
-This program is a replacement for the logger utility provided by util-linux and forked from daemontools.
-
-## AUTHORS
-
-Duncan Overbruck <[email protected]>
-
-## LICENSE
-
-vlogger is in the public domain.
-
-To the extent possible under law, the creator of this work has waived all copyright and related or neighboring rights to this work.
-
-http://creativecommons.org/publicdomain/zero/1.0/
diff --git a/src/man/vlogger.1.txt b/src/man/vlogger.1.txt
@@ -0,0 +1,111 @@
+@man vlogger 1 "MAY 2023" "%VERSION%" "fiss man page"
+
+@title name Name
+
+*vlogger* - log messages to syslog or an arbitrary executable
+
+@title synopsis Synopsis
+
+*vlogger* [*-isS*] [*-f* file] [*-p* pri] [*-t* tag] [message ...]
+
+@title description Description
+
+The vlogger utility writes messages to the system log or an arbitrary executable.
+
+If vlogger is executed as logger it will always use the system log and behave like the regular logger(1).
+
+Without message arguments vlogger reads messages from stdin or the file specified with the -f flag. If the /etc/vlogger executable exists vlogger executes it with tag, level and facility as arguments, replacing
+the vlogger process.
+
+If vlogger is executed as a log service for fiss(8) or another daemontools like supervision suite it uses the service name as default tag. As example if vlogger is linked to /var/service/foo/log/run it uses “foo” as tag and “daemon.notice” as pri.
+
+The options are as follows:
+
+@list
+*-f file*
+Read lines from the specified file. This option cannot be combine message arguments.
+
+*-i*
+Log the PID of the vlogger process. Only supported if syslog(3) is used.
+
+*-p pri*
+The. pri can be facility.level or just facility. See FACILITIES, LEVELS or syslog(3). The default is “user.notice”.
+
+*-S*
+Force vlogger to use syslog(3) even if /etc/vlogger exists.
+
+*-s*
+Output the message to standard error, as well as syslog(3). Only supported if syslog(3) is used.
+
+*-t tag*
+Defines the openlog(3) ident which is used as prefix for each log message or passed as first argument to /etc/vlogger. The default is the LOGNAME environment variable.
+
+*message*
+Write the message to the system log.
+@endlist
+
+@title facilities Facilities
+
+auth
+authpriv
+cron
+daemon
+ftp
+kern can not be used from userspace replaced with daemon.
+lpr
+mail
+news
+syslog
+user
+uucp
+local[0-7]
+security deprecated synonym for auth.
+
+@title levels Levels
+
+emerg
+alert
+crit
+err
+warning
+notice
+info
+debug
+panic deprecated synonym for emerg.
+error deprecated synonym for err.
+warn deprecated synonym for warning.
+
+@title files Files
+
+*/etc/vlogger*
+An optional executable file that is used to handle the messages. It is executed with tag, level and facility as arguments and replaces the vlogger process.
+
+@title exit Exit STATUS
+
+The vlogger utility exits 0 on success, and >0 if an error occurs.
+
+@title examples Examples
+
+*/etc/vlogger:*
+#!/bin/sh
+exec svlogd /var/log/$1
+
+@title see See ALSO
+
+logger(1), syslog(3), svlogd(8)
+
+@title history History
+
+This program is a replacement for the logger utility provided by util-linux and forked from daemontools.
+
+@title authors Authors
+
+Duncan Overbruck <[email protected]>
+
+@title license License
+
+vlogger is in the public domain.
+
+To the extent possible under law, the creator of this work has waived all copyright and related or neighboring rights to this work.
+
+http://creativecommons.org/publicdomain/zero/1.0/
diff --git a/src/man/zzz.8.md b/src/man/zzz.8.md
@@ -1,43 +0,0 @@
-# zzz 8 "MAY 2023" "%VERSION%" "fiss man page"
-
-## NAME
-
-zzz - suspend or hibernate your system
-
-## SYNOPSIS
-
-`zzz [-nSzZRH]`
-
-## DESCRIPTION
-
-`zzz` is a simple utility to hibernate or suspend your computer and part of the fiss-system. It supports suspend/resume-hooks.
-
-`-n, --noop`
-dry-run, sleep for 5sec instead of actually running ACPI actions.
-
-`-S, --freeze`
-enter low-power idle mode
-
-`-z, --suspend`
-suspend to RAM, this is the default behaviour of `zzz`
-
-`-Z, --hibernate`
-hibernate to disk and power off
-
-`-R, --reboot`
-hibernate to disk and reboot (useful for switching operating systems)
-
-`-H, --hybrid`
-hibernate to disk and suspend
-
-## HOOKS
-
-Before suspending, `zzz` executes _/usr/share/fiss/suspend_ which intents to execute scripts inside _/etc/zzz.d/suspend_ in alphanumeric order. After resuming, `zzz` executes _/usr/share/fiss/resume_ which intents to execute scripts inside _/etc/zzz.d/resume_ in alphanumeric order.
-
-## SEE ALSO
-
-fiss-init(8), runsvdir(8), runsvchdir(8), sv(8), runsv(8), chpst(8), utmpset(8), svlogd(8)
-
-## AUTHOR
-
-Based on the version of Leah Neukirchen \<[email protected]\>, rewritten by Friedel Schön \<[email protected]\>
diff --git a/src/man/zzz.8.txt b/src/man/zzz.8.txt
@@ -0,0 +1,45 @@
+@man zzz 8 "MAY 2023" "%VERSION%" "fiss man page"
+
+@title name Name
+
+zzz - suspend or hibernate your system
+
+@title synopsis Synopsis
+
+*zzz [-nSzZRH]*
+
+@title description Description
+
+*zzz* is a simple utility to hibernate or suspend your computer and part of the fiss-system. It supports suspend/resume-hooks.
+
+@list
+*-n, --noop*
+dry-run, sleep for 5sec instead of actually running ACPI actions.
+
+*-S, --freeze*
+enter low-power idle mode
+
+*-z, --suspend*
+suspend to RAM, this is the default behaviour of *zzz*
+
+*-Z, --hibernate*
+hibernate to disk and power off
+
+*-R, --reboot*
+hibernate to disk and reboot (useful for switching operating systems)
+
+*-H, --hybrid*
+hibernate to disk and suspend
+@endlist
+
+@title hooks Hooks
+
+Before suspending, *zzz* executes _/usr/share/fiss/suspend_ which intents to execute scripts inside _/etc/zzz.d/suspend_ in alphanumeric order. After resuming, *zzz* executes _/usr/share/fiss/resume_ which intents to execute scripts inside _/etc/zzz.d/resume_ in alphanumeric order.
+
+@title see See ALSO
+
+fiss-init(8), runsvdir(8), runsvchdir(8), sv(8), runsv(8), chpst(8), utmpset(8), svlogd(8)
+
+@title author Author
+
+Based on the version of Leah Neukirchen <[email protected]>, rewritten by Friedel Schön <[email protected]>
