First commit

Signed-off-by: Mattias Andrée <maandree@kth.se>

1 files changed, 112 insertions, 0 deletions

diff --git a/key2root-lskeys.8 b/key2root-lskeys.8
new file mode 100644
index 0000000..cfd0bd8
--- /dev/null
+++ b/key2root-lskeys.8
@@ -0,0 +1,112 @@
+.TH KEY2ROOT 8 key2root-lskeys
+
+.SH NAME
+key2root-lskeys - list keyfiles for privilege escalation with key2root
+
+.SH SYNOPSIS
+.B key2root-lskeys
+.RI [ user ]\ ...
+
+.SH DESCRIPTION
+The
+.B key2root-lskey
+utility lists keyfiles that may be used to authenticate
+for privilege escalation with the
+.BR key2root (8)
+utility.
+
+.SH OPTIONS
+The
+.B key2root-lskey
+utility conforms to the Base Definitions volume of POSIX.1-2017,
+.IR "Section 12.2" ,
+.IR "Utility Syntax Guidelines" .
+.PP
+No options are supported.
+
+.SH OPERANDS
+The following operands are supported:
+.TP
+.I user
+User whose keyfiles shall be listed. This can either
+be a user ID or a user name. See
+.BR NOTES .
+
+If no
+.I user
+is specified, all keyfiles in the database are list, for all users.
+
+.SH STDIN
+The
+.B key2root-lskeys
+utility does not use the standard input.
+
+.SH INPUT FILES
+None.
+
+.SH ENVIRONMENT VARIABLES
+No following environment variable affects the execution of
+.BR key2root-lskeys .
+
+.SH ASYNCHRONOUS EVENTS
+Default.
+
+.SH STDOUT
+The
+.B key2root-lskeys
+utility does not use the standard output.
+
+.SH STDERR
+The standard error is used for diagnostic messages.
+
+.SH OUTPUT FILES
+None.
+
+.SH EXTENDED DESCRIPTION
+None.
+
+.SH EXIT STATUS
+If the
+.B key2root-lskeys
+utility fails it will exit with one of the following statuses:
+.TP
+0
+Successful completion.
+.TP
+1
+A error occurred.
+
+.SH CONSEQUENCES OF ERRORS
+Default.
+
+.SH APPLICATION USAGE
+None.
+
+.SH EXAMPLES
+None.
+
+.SH RATIONALE
+None.
+
+.SH NOTES
+Keyfiles added by user ID and by user names are stored separatedly.
+If a keyfile was added with a user name specified, it is only
+associated with the user name, and the user name must be specified
+for it to be listed. Likewise if a keyfile was added with a user ID
+specified, it is only associated with the user ID, and the user ID
+must be specified for it to be listed.
+
+.SH BUGS
+None.
+
+.SH FUTURE DIRECTIONS
+None.
+
+.SH SEE ALSO
+.BR key2root (8),
+.BR key2root-addkey (8),
+.BR key2root-rmkey (8)
+
+.SH AUTHORS
+Mattias Andrée
+.RI < maandree@kth.se >