NAME

       trocla - trocla executable

SYNOPSIS

       trocla (--help | --version)
       trocla [--config | --trace] SUBCOMMAND [ARGS]

DESCRIPTION

       trocla is a password store for password creation and retrieval.

OPTIONS

       -c, --config
              Path to configuration file.

       -h, --help
              Show the help message and exit.

       --trace
              Show stack trace on failure.

       -V, --version
              Show the version number and exit.

SUBCOMMANDS

       create [--length | --no-random ] <key> <format>
              Create  a  random  password  (if  not already stored in trocla) and store its plain text under the
              specified key. Some formats require additional options.

              Use --length to define the length of the generated password.

              Use --no-random to skip generating a random password if a plain password is not already  available
              for this key.

       get <key> <format>
              Return a stored password (does not create one if absent).

       set [--no-format | (-p | --password) <password>] <key> <format>
              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.

              Use --no-format to supply an already-formatted password and store it without a corresponding plain
              password.

              Use --password to supply the password on the command-line.

       reset <key> <format>
              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.

       delete <key> [format]
              Delete the passwords at the specified key and (optionally) format.

       formats
              List available and supported formats.

       search <string>
              Search  among the password store keys for the specified string (only available for Sequel and YAML
              backends). The string may be a regular expression.

BUGS

       Bugs  with  this  software  may  be  reported  to  your  distribution's  bug  tracker  or   upstream   at
       <https://github.com/duritong/trocla/issues>

SEE ALSO

       For more information, see /usr/share/doc/trocla/README.md

AUTHOR

       Jérôme Charaoui

                                                      2023                                             TROCLA(1)