DragonFly On-Line Manual Pages

SHISA(1)                         User Commands                        SHISA(1)

NAME
       shisa - Shishi database interface

SYNOPSIS
       shisa [OPTIONS]... [REALM [PRINCIPAL]]...

DESCRIPTION
       shisa 1.0.2

       Manipulate information stored in the Shisa user database.

       -h, --help
              Print help and exit

       -V, --version
              Print version and exit

   Operations:
       -a, --add
              Add realm or principal to database.

       -d, --dump
              Dump entries in database.

       -n, --key-add
              Add new key to a principal in database.

       --key-remove
              Remove a key from a principal in database.

       -l, --list
              List entries in database.

       -m, --modify
              Modify principal entry in database.

       -r, --remove
              Remove realm or principal from database.

   Parameters:
       -f, --force
              Allow removal of non-empty realms.  (default=off)

       --enabled
              Only dump or list enabled principals.  (default=off)

       --disabled
              Only dump or list disabled principals.  (default=off)

       --keys Print cryptographic key and password in hostkey format.
              (default=off)

   Values:
       -E, --encryption-type=STRING
              Override default key encryption type.  Valid values include
              'aes128', 'aes256', 'aes' (same as 'aes256'), '3des', 'des-md5',
              'des-md4', 'des-crc', 'des' (same as 'des-md5'), and 'arcfour'.

       --key-version=NUMBER
              Version of key.

       --password[=STRING]
              Derive key from this password.

       --priority=NUMBER
              Specify key priority, used to differentiate between keys when
              multiple keys are eligible for use.  Higher value means higher
              priority.

              (default is 0, which mean a random key of

              the best etype is chosen)

       --random
              Use a random key.  (default)

       --salt=STRING
              Use specified salt for deriving key.  Defaults to concatenation
              of realm and (unwrapped) principal name.

       --string-to-key-parameter=HEX
              Encryption algorithm specific parameter for

       password derivation.
              Currently only the AES

              algorithm can utilize this, where it is interpreted as the
              iteration count of the PKCS#5 PBKDF2 key deriver.

   Other options:
       -c, --configuration-file=FILE Use specified configuration file.

       -o, --library-options=STRING
              Parse string as configuration file statement.

       -v, --verbose
              Produce verbose output.  (default=off)

       -q, --quiet
              Don't produce any diagnostic output.  (default=off)

       Mandatory arguments to long options are mandatory for short options
       too.

AUTHOR
       Written by Simon Josefsson.

REPORTING BUGS
       Report bugs to: bug-shishi@gnu.org
       GNU Shishi home page: <http://www.gnu.org/software/shishi/>
       General help using GNU software: <http://www.gnu.org/gethelp/>

COPYRIGHT
       Copyright (C) 2013 Simon Josefsson.  License GPLv3+: GNU GPL version 3
       or later <http://gnu.org/licenses/gpl.html>.
       This is free software: you are free to change and redistribute it.
       There is NO WARRANTY, to the extent permitted by law.

SEE ALSO
       The full documentation for shisa is maintained as a Texinfo manual.  If
       the info and shisa programs are properly installed at your site, the
       command

              info shishi

       should give you access to the complete manual.

shisa 1.0.2                       April 2013                          SHISA(1)