commit fb16bcc72207bf3fdab0e93681bed106e48b4bdb
parent 126bf98416bcdc8e0c7bf7b2b026a1914632dd1e
Author: Friedel Schön <[email protected]>
Date: Tue, 30 May 2023 11:02:09 +0200
add manual
Diffstat:
| A | man/chpst.8 | | | 83 | +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| A | man/finit.8 | | | 55 | +++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| A | man/fsvc.8 | | | 100 | +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| A | man/fsvs.8 | | | 26 | ++++++++++++++++++++++++++ |
| A | man/halt.8 | | | 38 | ++++++++++++++++++++++++++++++++++++++ |
| A | man/modules-load.8 | | | 37 | +++++++++++++++++++++++++++++++++++++ |
| A | man/shutdown.8 | | | 82 | +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| A | man/sigremap.8 | | | 28 | ++++++++++++++++++++++++++++ |
| A | man/vlogger.1 | | | 115 | +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |
| A | man/zzz.8 | | | 44 | ++++++++++++++++++++++++++++++++++++++++++++ |
10 files changed, 608 insertions(+), 0 deletions(-)
diff --git a/man/chpst.8 b/man/chpst.8
@@ -0,0 +1,83 @@
+.TH chpst 8 "MAY 2023" "0.3.2" "fiss man page"
+.SH NAME
+.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
+.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.
+.PP
+\fB\fC\-U [:]user[:group]\fR
+.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.
+.PP
+\fB\fC\-b argv0\fR
+Run prog with argv0 as the 0th argument.
+.PP
+\fB\fC\-/ root\fR
+Change the root directory to root before starting prog.
+.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.
+.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.
+.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.
+.PP
+\fB\fC\-L lock\fR
+The same as \-l, but fail immediately if lock is locked by another process.
+.PP
+\fB\fC\-P\fR
+Run prog in a new process group.
+.PP
+\fB\fC\-0\fR
+Close standard input before starting prog.
+.PP
+\fB\fC\-1\fR
+Close standard output before starting prog.
+.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
+\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\-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\-d bytes\fR
+limit data segment. Limit the data segment per process to bytes bytes.
+.PP
+\fB\fC\-o n\fR
+Limit the number of open file descriptors per process to n.
+.PP
+\fB\fC\-p n\fR
+Limit the number of processes per uid to n.
+.PP
+\fB\fC\-f bytes\fR
+Limit the output file size to bytes bytes.
+.PP
+\fB\fC\-c bytes\fR
+Limit the core file size to bytes bytes.
+.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.
+.SH AUTHOR
+.PP
+Based on the implementation by Gerrit Pape \[la][email protected]\[ra],
+rewritten by Friedel Schon \[la][email protected]\[ra]
diff --git a/man/finit.8 b/man/finit.8
@@ -0,0 +1,55 @@
+.TH finit 8 "MAY 2023" "01.0" "fiss man page"
+.SH NAME
+.PP
+fiss \- a UNIX process no 1
+.SH SYNOPSIS
+.PP
+\fB\fCfsvc\fR
+when running as PID 0 (as 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.
+.PP
+\fB\fCfinit\fR 0
+halts 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
+This happens in three stages:
+.SH STAGE 1
+.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\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\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.
+.PP
+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.
+.SH SEE ALSO
+.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]>
diff --git a/man/fsvc.8 b/man/fsvc.8
@@ -0,0 +1,100 @@
+.TH fsvc 8 "MAY 2023" "0.3.2" "fiss man page"
+.SH NAME
+.PP
+\fB\fCfsvc\fR \- fiss' service controller
+.SH SYNOPSIS
+.PP
+\fB\fCfsvc\fR \fB\fCstart\fR [\fIoptions\fP] [\fB\fC\-\-pin_\fR] <service>
+.PP
+\fB\fCfsvc\fR \fB\fCstop\fR [\fIoptions\fP] [\fB\fC\-\-pin\fR] <service>
+.PP
+\fB\fCfsvc\fR \fB\fCenable\fR [\fIoptions\fP] [\fB\fC\-\-once\fR] <service>
+.PP
+\fB\fCfsvc\fR \fB\fCdisable\fR [\fIoptions\fP] [\fB\fC\-\-once\fR] <service>
+.PP
+\fB\fCfsvc\fR \fB\fCkill\fR [\fIoptions\fP] <service> <signal|signo>
+.PP
+\fB\fCfsvc\fR \fB\fCstatus\fR [\fIoptions\fP] [\fB\fC\-\-check\fR] [<service>]
+.PP
+\fB\fCfsvc\fR \fB\fCpause\fR [\fIoptions\fP] <service>
+.PP
+\fB\fCfsvc\fR \fB\fCresume\fR [\fIoptions\fP] <service>
+.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.
+.SH OPTIONS
+.PP
+The following options are available for every command:
+.PP
+\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\&.
+.PP
+\fB\fC\-s, \-\-service\-dir <path>\fR
+Will use \fB\fCpath\fR as service directory instead of \fI/etc/fiss/service.d\fP\&.
+.PP
+\fB\fC\-v, \-\-verbose\fR
+Prints verbose information.
+.PP
+\fB\fC\-V, \-\-version\fR
+Prints the version and exits.
+.PP
+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.
+.PP
+\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
+.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
+\fB\fCstart\fR
+Starts the specified service. A synonym is \fB\fCup\fR\&.
+.PP
+\fB\fCstop\fR
+Stops the specified service. A synonym is \fB\fCdown\fR\&.
+.PP
+\fB\fCenable\fR
+Enables the specified service, causing it to automatically start on subsequent bootups.
+.PP
+\fB\fCdisable\fR
+Disables the specified service, causing it to not start automatically on subsequent bootups.
+.PP
+\fB\fCkill\fR
+Sends the specified signal or signal number to the specified service. A synonym is \fB\fCsend\fR\&.
+.PP
+\fB\fCstatus\fR
+Displays the status of the specified service. If no service is specified, displays the status of all services.
+.PP
+\fB\fCpause\fR
+Pauses the specified service.
+.PP
+\fB\fCresume\fR
+Resumes the specified service.
+.PP
+\fB\fCswitch\fR
+Switches the runlevel to the specified value.
+.SH SEE ALSO
+.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]>
diff --git a/man/fsvs.8 b/man/fsvs.8
@@ -0,0 +1,26 @@
+.TH fsvs 8 "MAY 2023" "0.3.2" "fiss man page"
+.SH NAME
+.PP
+\fB\fCfsvs\fR \- friedel's service superviser
+.SH SYNOPSIS
+.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
+Following options are available:
+.PP
+\fB\fC\-v, \-\-verbose\fR
+Prints more information, easier to debug problems
+.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.
+.PP
+\fB\fC\-V, \-\-version\fR
+Prints the version and exits.
+.PP
+Services can be controlled with \fB\fCfsvc 8\fR
+.SH AUTHORS
+.PP
+Friedel Schon \[la][email protected]\[ra]
diff --git a/man/halt.8 b/man/halt.8
@@ -0,0 +1,38 @@
+.TH halt 8 "MAY 2023" "0.3.2" "fiss man page"
+.SH NAME
+.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\fCreboot\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
+.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\-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\-d\fR
+Don't write the \fIwtmp\fP record
+.PP
+\fB\fCw\fR
+Only write the wtmp record, no further action
+.SH SEE ALSO
+.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]>
diff --git a/man/modules-load.8 b/man/modules-load.8
@@ -0,0 +1,37 @@
+.TH modules\-load 8 "MAY 2023" "0.3.2" "fiss man page"
+.SH NAME
+.PP
+\fB\fCmodules\-load\fR \- configure kernel modules at boot
+.SH SYNOPSIS
+.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.
+.PP
+\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.
+.SH FILES
+.PP
+Configuration files are read from the following locations:
+.PP
+\fI/etc/modules\-load.d/*\&.conf\fP
+.PP
+\fI/run/modules\-load.d/*\&.conf\fP
+.PP
+\fI/usr/lib/modules\-load.d/*\&.conf\fP
+.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.
+.SH AUTHOR
+.PP
+Leah Neukirchen, \[la][email protected]\[ra]\&.
diff --git a/man/shutdown.8 b/man/shutdown.8
@@ -0,0 +1,82 @@
+.TH shutdown 8 "MAY 2023" "0.3.2" "fiss man page"
+.SH NAME
+.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 ...]
+.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.
+.PP
+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.
+.PP
+\fB\fC\-f\fR
+Enable fast booting; skip
+.BR fsck (8)
+on next boot.
+.PP
+\fB\fC\-F\fR
+Force run of
+.BR fsck (8)
+on next boot.
+.PP
+\fB\fC\-h\fR
+Halt the system.
+.PP
+\fB\fC\-k\fR
+Don't really shutdown; only send the warning messages to everybody.
+.PP
+\fB\fC\-P\fR
+Poweroff the system.
+.PP
+\fB\fC\-r\fR
+Reboot the system.
+.PP
+\fB\fCnow\fR
+Shutdown without further waiting.
+.PP
+\fB\fC+mins\fR
+Wait mins minutes before shutting down.
+.PP
+\fB\fCmessage\fR
+.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:
+.PP
+\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.
+.PP
+\fB\fC\-H\fR
+Drop into boot monitor.
+.PP
+\fB\fC\-n\fR
+Don't call
+.BR init (8).
+.PP
+\fB\fChh:mm\fR
+Absolute time specification is not implemented.
+.SH SEE ALSO
+.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]\&.
diff --git a/man/sigremap.8 b/man/sigremap.8
@@ -0,0 +1,28 @@
+.TH sigremap 8 "MAY 2023" "0.3.2" "fiss man page"
+.SH NAME
+.PP
+\fB\fCsigremap\fR \- a minimal init system for Linux containers
+.SH SYNOPSIS
+.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
+Optional arguments:
+.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.
+.PP
+\fB\fC\-v, \-\-verbose\fR
+Print debugging information to stderr.
+.PP
+\fB\fC\-V, \-\-version\fR
+Print the current version and exit.
+.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]
diff --git a/man/vlogger.1 b/man/vlogger.1
@@ -0,0 +1,115 @@
+.TH vlogger 1 "MAY 2023" "0.3.2" "fiss man page"
+.SH NAME
+.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 ...]
+.SH DESCRIPTION
+.PP
+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).
+.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.
+.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.
+.PP
+The options are as follows:
+.PP
+\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.
+.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”.
+.PP
+\fB\fC\-S\fR
+Force vlogger to use
+.BR 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.
+.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.
+.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.
+.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.
+.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.
+.SH EXIT STATUS
+.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
+.PP
+exec svlogd /var/log/$1
+.SH SEE ALSO
+.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.
+.SH AUTHORS
+.PP
+Duncan Overbruck \[la][email protected]\[ra]
+.SH LICENSE
+.PP
+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.
+.PP
+\[la]http://creativecommons.org/publicdomain/zero/1.0/\[ra]
diff --git a/man/zzz.8 b/man/zzz.8
@@ -0,0 +1,44 @@
+.TH zzz 8 "MAY 2023" "0.3.2" "fiss man page"
+.SH NAME
+.PP
+zzz \- suspend or hibernate your system
+.SH SYNOPSIS
+.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.
+.PP
+\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
+.PP
+\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
+.PP
+\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
+.SH HOOKS
+.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
+.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]>
