.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "TROCLA" 1 "2023" ""
.SH NAME
trocla \- trocla executable
.SH SYNOPSIS
.nf
\fBtrocla\fP (\-\-help | \-\-version)
\fBtrocla\fP [\-\-config | \-\-trace] SUBCOMMAND [ARGS]
.fi
.sp
.SH DESCRIPTION
.sp
\fBtrocla\fP is a password store for password creation and retrieval.
.SH OPTIONS
.INDENT 0.0
.TP
.B  \-c\fP,\fB  \-\-config
Path to configuration file.
.TP
.B  \-h\fP,\fB  \-\-help
Show the help message and exit.
.TP
.B  \-\-trace
Show stack trace on failure.
.TP
.B  \-V\fP,\fB  \-\-version
Show the version number and exit.
.UNINDENT
.SH SUBCOMMANDS
.INDENT 0.0
.TP
.B \fBcreate\fP [\fI\-\-length\fP | \fI\-\-no\-random\fP ] \fI<key>\fP \fI<format>\fP
Create a random password (if not already stored in trocla) and store its plain
text under the specified key. Some formats require additional options.
.sp
Use \fI\-\-length\fP to define the length of the generated password.
.sp
Use \fI\-\-no\-random\fP to skip generating a random password if a plain password is
not already available for this key.
.TP
.B \fBget\fP \fI<key>\fP \fI<format>\fP
Return a stored password (does not create one if absent).
.TP
.B \fBset\fP [\fI\-\-no\-format\fP | (\fI\-p\fP | \fI\-\-password\fP) \fI<password>\fP] \fI<key>\fP \fI<format>\fP
Prompt for a plain password and save it under the appropriate key/format.
Alternatively, the password may be supplied via standard input or using file
redirection.
.sp
Use \fI\-\-no\-format\fP to supply an already\-formatted password and store it without
a corresponding plain password.
.sp
Use \fI\-\-password\fP to supply the password on the command\-line.
.TP
.B \fBreset\fP \fI<key>\fP \fI<format>\fP
Recreate a salted shadow\-style hash, without creating a new plain text
password. If a plain password exists for this key, all the previously hashed
passwords are deleted.
.TP
.B \fBdelete\fP \fI<key>\fP \fI[format]\fP
Delete the passwords at the specified key and (optionally) format.
.TP
.B \fBformats\fP
List available and supported formats.
.TP
.B \fBsearch\fP \fI<string>\fP
Search among the password store keys for the specified string (only available
for Sequel and YAML backends). The string may be a regular expression.
.UNINDENT
.SH BUGS
.sp
Bugs with this software may be reported to your distribution\(aqs bug tracker or
upstream at \fI\%https://github.com/duritong/trocla/issues\fP
.SH SEE ALSO
.sp
For more information, see /usr/share/doc/trocla/README.md
.SH AUTHOR
Jérôme Charaoui
.\" Generated by docutils manpage writer.
.