Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, February 9, 2022
 
 

psktool (1)

Name

psktool - GnuTLS PSK tool

Synopsis

psktool [-flags] [-flag [value]] [--option-name[[=| ]value]]

All arguments must be options.

Description

psktool(1)                       User Commands                      psktool(1)



NAME
       psktool - GnuTLS PSK tool

SYNOPSIS
       psktool [-flags] [-flag [value]] [--option-name[[=| ]value]]

       All arguments must be options.


DESCRIPTION
       Program   that generates random keys for use with TLS-PSK. The keys are
       stored in hexadecimal format in a key file.

OPTIONS
       -d number, --debug=number
              Enable debugging.  This option takes an integer  number  as  its
              argument.  The value of number is constrained to being:
                  in the range  0 through 9999

              Specifies the debug level.

       -s number, --keysize=number
              Specify the key size in bytes (default is 32-bytes or 256-bits).
              This option takes an integer number as its argument.  The value
              of number is constrained to being:
                  in the range  0 through 512


       -u string, --username=string
              Specify the username to use.


       -p string, --pskfile=string
              Specify a pre-shared key file.

              This option will specify the pre-shared key file to store the
              generated keys.

       --passwd
              This is an alias for the --pskfile option.

              NOTE: THIS OPTION IS DEPRECATED

       -h, --help
              Display usage information and exit.

       -!, --more-help
              Pass the extended usage information through a pager.

       -v [{v|c|n --version [{v|c|n}]}]
              Output version of program and exit.  The default mode is `v', a
              simple version.  The `c' mode will print copyright information
              and `n' will print the full copyright notice.

EXAMPLES
       To add a user 'psk_identity' in keys.psk for use with GnuTLS run:
           $ ./psktool -u psk_identity -p keys.psk
           Generating a random key for user 'psk_identity'
           Key stored to keys.psk
           $ cat keys.psk
           psk_identity:88f3824b3e5659f52d00e959bacab954b6540344
           $

       This command will create keys.psk if it does not exist and will add
       user 'psk_identity'.

EXIT STATUS
       One of the following exit values will be returned:

       0  (EXIT_SUCCESS)
              Successful program execution.

       1  (EXIT_FAILURE)
              The operation failed or the command syntax was not valid.

       70  (EX_SOFTWARE)
              libopts had an internal operational error.  Please report it to
              autogen-users@lists.sourceforge.net.  Thank you.

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE     |
       +---------------+-----------------------+
       |Availability   | library/gnutls-3      |
       +---------------+-----------------------+
       |Stability      | Pass-through volatile |
       +---------------+-----------------------+

SEE ALSO
           gnutls-cli-debug (1), gnutls-serv (1), srptool (1), certtool (1)

AUTHORS
       Nikos Mavrogiannopoulos, Simon Josefsson and others; see
       /usr/share/doc/gnutls/AUTHORS for a complete list.

COPYRIGHT
       Copyright (C) 2000-2020 Free Software Foundation, and others all rights
       reserved.  This program is released under the terms of the GNU General
       Public License, version 3 or later.

BUGS
       Please send bug reports to: bugs@gnutls.org

NOTES
       This manual page was AutoGen-erated from the psktool option defini-
       tions.


       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       https://www.gnupg.org/ftp/gcrypt/gnutls/v3.7/gnutls-3.7.1.tar.xz.

       Further information about this software can be found on the open source
       community website at https://www.gnutls.org/.



3.7.1                             10 Mar 2021                       psktool(1)