1psktool(1)                       User Commands                      psktool(1)
2
3
4

NAME

6       psktool - GnuTLS PSK tool
7

SYNOPSIS

9       psktool [-flags] [-flag [value]] [--option-name[[=| ]value]]
10
11       All arguments must be options.
12
13

DESCRIPTION

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

OPTIONS

19       -d number, --debug=number
20              Enable debugging.  This option takes an integer  number  as  its
21              argument.  The value of number is constrained to being:
22                  in the range  0 through 9999
23
24              Specifies the debug level.
25
26       -s number, --keysize=number
27              Specify the key size in bytes (default is 32-bytes or 256-bits).
28              This option takes an integer number as its argument.  The value
29              of number is constrained to being:
30                  in the range  0 through 512
31
32
33       -u string, --username=string
34              Specify the username to use.
35
36
37       -p string, --pskfile=string
38              Specify a pre-shared key file.
39
40              This option will specify the pre-shared key file to store the
41              generated keys.
42
43       --passwd
44              This is an alias for the --pskfile option.
45
46              NOTE: THIS OPTION IS DEPRECATED
47
48       -h, --help
49              Display usage information and exit.
50
51       -!, --more-help
52              Pass the extended usage information through a pager.
53
54       -v [{v|c|n --version [{v|c|n}]}]
55              Output version of program and exit.  The default mode is `v', a
56              simple version.  The `c' mode will print copyright information
57              and `n' will print the full copyright notice.
58

EXAMPLES

60       To add a user 'psk_identity' in keys.psk for use with GnuTLS run:
61           $ ./psktool -u psk_identity -p keys.psk
62           Generating a random key for user 'psk_identity'
63           Key stored to keys.psk
64           $ cat keys.psk
65           psk_identity:88f3824b3e5659f52d00e959bacab954b6540344
66           $
67
68       This command will create keys.psk if it does not exist and will add
69       user 'psk_identity'.
70

EXIT STATUS

72       One of the following exit values will be returned:
73
74       0  (EXIT_SUCCESS)
75              Successful program execution.
76
77       1  (EXIT_FAILURE)
78              The operation failed or the command syntax was not valid.
79
80       70  (EX_SOFTWARE)
81              libopts had an internal operational error.  Please report it to
82              autogen-users@lists.sourceforge.net.  Thank you.
83

SEE ALSO

85           gnutls-cli-debug (1), gnutls-serv (1), srptool (1), certtool (1)
86

AUTHORS

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

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

BUGS

97       Please send bug reports to: bugs@gnutls.org
98

NOTES

100       This manual page was AutoGen-erated from the psktool option defini‐
101       tions.
102
103
104
1053.7.2                             29 May 2021                       psktool(1)
Impressum