.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 prints the files to the standard output, in the following format:
.RS
.nf

\fB\(dq%s %s %s\en\(dq, \fP<\fIuser\fP>\fB, \fP<\fIkey-name\fP>\fB, \fP<\fIkey-hash\fP>
.fi
.RE

.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 >