1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
@node psktool Invocation
@subsubsection Invoking psktool
@pindex psktool
@ignore
# -*- buffer-read-only: t -*- vi: set ro:
#
# DO NOT EDIT THIS FILE (invoke-psktool.texi)
#
# It has been AutoGen-ed May 29, 2013 at 07:53:06 PM by AutoGen 5.17.3
# From the definitions ../src/psk-args.def
# and the template file agtexi-cmd.tpl
@end ignore
Program that generates random keys for use with TLS-PSK. The
keys are stored in hexadecimal format in a key file.
This section was generated by @strong{AutoGen},
using the @code{agtexi-cmd} template and the option descriptions for the @code{psktool} program.
This software is released under the GNU General Public License, version 3 or later.
@anchor{psktool usage}
@subsubheading psktool help/usage (@option{--help})
@cindex psktool help
This is the automatically generated usage text for psktool.
The text printed is the same whether selected with the @code{help} option
(@option{--help}) or the @code{more-help} option (@option{--more-help}). @code{more-help} will print
the usage text by passing it through a pager program.
@code{more-help} is disabled on platforms without a working
@code{fork(2)} function. The @code{PAGER} environment variable is
used to select the program, defaulting to @file{more}. Both will exit
with a status code of 0.
@exampleindent 0
@example
psktool - GnuTLS PSK tool
Usage: psktool [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
-d, --debug=num Enable debugging.
- it must be in the range:
0 to 9999
-s, --keysize=num specify the key size in bytes
- it must be in the range:
0 to 512
-u, --username=str specify a username
-p, --passwd=str specify a password file.
-v, --version[=arg] output version information and exit
-h, --help display extended usage information and exit
-!, --more-help extended usage information passed thru pager
Options are specified by doubled hyphens and their name or by a single
hyphen and the flag character.
Program that generates random keys for use with TLS-PSK. The keys are
stored in hexadecimal format in a key file.
Please send bug reports to: <bug-gnutls@@gnu.org>
@end example
@exampleindent 4
@anchor{psktool debug}
@subsubheading debug option (-d)
This is the ``enable debugging.'' option.
This option takes an argument number.
Specifies the debug level.
@anchor{psktool exit status}
@subsubheading psktool exit status
One of the following exit values will be returned:
@table @samp
@item 0 (EXIT_SUCCESS)
Successful program execution.
@item 1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid.
@end table
@anchor{psktool See Also}
@subsubheading psktool See Also
gnutls-cli-debug (1), gnutls-serv (1), srptool (1), certtool (1)
@anchor{psktool Examples}
@subsubheading psktool Examples
To add a user 'psk_identity' in @file{passwd.psk} for use with GnuTLS run:
@example
$ ./psktool -u psk_identity -p passwd.psk
Generating a random key for user 'psk_identity'
Key stored to passwd.psk
$ cat psks.txt
psk_identity:88f3824b3e5659f52d00e959bacab954b6540344
$
@end example
This command will create @file{passwd.psk} if it does not exist
and will add user 'psk_identity' (you will also be prompted for a password).
|
