continue documenting

diff --git a/systembsd.8 b/systembsd.8
index 97ec3448cf5711915299fad41669839cc020ec1c..6f020b3da8acfcc60a2a94e29cae693e1c5d912a 100644 (file)
--- a/systembsd.8
+++ b/systembsd.8
@@ -7,5 +7,52 @@
 .\" .Sh SYNOPSIS
 .\" .Nm systembsd
 .Sh DESCRIPTION
-.Nm
-provides the functionality of hostnamed, localed, timedated and (eventually) logind, four systemd daemons. 
+.Nm provides the functionality of hostnamed, localed, timedated and
+(eventually) logind, four systemd daemons.
+.Sh OVERVIEW
+.Nm systembsd emulates the DBus behavior of several afforementioned
+systemd daemons by exposing matching interfaces on the system bus. The
+systembsd executables themselves are run dynamically, as a call to a
+DBus method/property listed in a .service file will cause DBus to
+execute the systembsd binary with proper permissions. The resulting
+proccess, after a period of inactivity, will exit() safely.
+.Pp 
+.Nm systembsd was written to provide compatibility for large codebases
+(e.g. GNOME) that depend on Linux's systemd. Systemd is decidedly
+incompatibile on *BSD systems. Systembsd does not intend to bring
+systemd philosphy or practices to its target platform.
+.Sh HOSTNAMED
+Hostnamed manages setting the system's hostnames, which comprise of the
+dynamic hostname via sethostname(3), the static hostname via
+sethostname(3) and /etc/myname, and the pretty hostname, a UTF-8 string
+contained in /etc/machine-info.
+.Pp
+Hostnamed also handles determining the physical machine's
+characteristics, which it reciprocates through the Chassis and IconName
+properties. IconName is a string following the XDG naming specification
+and is set based off the information from the Chassis property. The
+Chassis property is a string, one of "desktop", "laptop", "server",
+"tablet", "handset", "vm" or "container". Chassis determination involves
+analyzing hwctl, dmesg, and uname output.
+.Pp
+The remaining Kernel* properties and OperatingSystemPrettyName are
+analogous to corresponding uname(3) calls. OperatingSystemCPEName is a
+string following the Common Platform Enumeration specification.
+.Sh LOCALED
+Write this!
+.Sh TIMEDATED
+Write this!
+.Sh LOGIND
+Not implemented yet, work ongoing.
+.Sh FILES
+
+.Sh EXIT STATUS
+.Nm systemd-*d will return 0 on success, 1 on failure.
+.Sh HISTORY
+systembsd was written as a Google Summer of Code project in 2014,
+OpenBSD's first year participating.
+.Sh AUTHORS
+.Nm Written by Ian Sutton <ian@kremlin.cc>
+.br
+.Nm Mentored/Co-authored by Antione Jacoutot <ajacoutot@openbsd.org>
+and Landry Breuil <landry@openbsd.org>