3 files changed, 59 insertions, 2 deletions
diff --git a/man/runit-init.8 b/man/runit-init.8
index 0e3ea3f..77b06e3 100644
--- a/man/runit-init.8
+++ b/man/runit-init.8
@@ -43,7 +43,8 @@ returns 111 on error, 0 in all other cases.
 .SH SEE ALSO
 runit(8),
 svwaitdown(8),
-svwaitup(8)
+svwaitup(8),
+utmpset(8)
 .P
 http://smarden.org/runit/
 .SH AUTHOR
diff --git a/man/runit.8 b/man/runit.8
index e2c9b9c..4502143 100644
--- a/man/runit.8
+++ b/man/runit.8
@@ -72,7 +72,8 @@ receives an INT signal, a ctrl-alt-del keyboard request is triggered.
 .SH SEE ALSO
 runit-init(8),
 svwaitdown(8),
-svwaitup(8)
+svwaitup(8),
+utmpset(8)
 .P
 http://smarden.org/runit/
 .SH AUTHOR
diff --git a/man/utmpset.8 b/man/utmpset.8
new file mode 100644
index 0000000..e63981b
--- /dev/null
+++ b/man/utmpset.8
@@ -0,0 +1,55 @@
+.TH utmpset 8
+.SH NAME
+utmpset \- logout a line from utmp and wtmp file
+.SH SYNOPSIS
+.B utmpset
+[
+.B \-w
+]
+.I line
+.SH DESCRIPTION
+The
+.B utmpset
+program modifies the user accounting database
+.BR utmp (5)
+and optionally
+.BR wtmp (5)
+to indicate that the user on the terminal
+.I line
+has logged out.
+.P
+Ordinary
+.BR init (8)
+processes handle utmp file records for local login accounting. The
+.BR runit (8)
+program doesn't include code to update the utmp file, the
+.BR getty (8)
+processes are handled the same as all other services.
+.P
+To enable local login accounting, add
+.B utmpset
+to the
+.BR getty (8)
+run scripts, e.g.:
+.P
+ #!/bin/sh
+ /package/admin/runit/command/utmpset -w tty5
+ exec /sbin/getty 38400 tty5 linux
+.SH OPTIONS
+.TP
+.B \-w
+wtmp. Additionally to the utmp file, write an empty record for
+.I line
+to the wtmp file.
+.SH EXIT CODES
+.B utmpset
+returns 111 on error, 1 on wrong usage, 0 in all other cases.
+.SH SEE ALSO
+runit(8),
+runit-init(8),
+svwaitdown(8),
+svwaitup(8)
+.P
+http://smarden.org/runit/
+.SH AUTHOR
+Gerrit Pape <pape@smarden.org>