.TH psktool 1 "10 May 2013" "3.1.11" "User Commands" .\" .\" DO NOT EDIT THIS FILE (psk-args.man) .\" .\" It has been AutoGen-ed May 10, 2013 at 11:36:33 AM by AutoGen 5.16 .\" From the definitions psk-args.def.tmp .\" and the template file agman-cmd.tpl .\" .SH NAME psktool \- GnuTLS PSK tool .SH SYNOPSIS .B psktool .\" Mixture of short (flag) options and long options .RB [ \-\fIflag\fP " [\fIvalue\fP]]... [" \-\-\fIopt\-name\fP " [[=| ]\fIvalue\fP]]..." .PP All arguments must be options. .PP .SH "DESCRIPTION" Program that generates random keys for use with TLS-PSK. The keys are stored in hexadecimal format in a key file. .SH "OPTIONS" .TP .BR \-d " \fInumber\fP, " \-\-debug "=" \fInumber\fP Enable debugging.. This option takes an integer number as its argument. The value of \fInumber\fP is constrained to being: .in +4 .nf .na in the range 0 through 9999 .fi .in -4 .sp Specifies the debug level. .TP .BR \-s " \fInumber\fP, " \-\-keysize "=" \fInumber\fP specify the key size in bytes. This option takes an integer number as its argument. The value of \fInumber\fP is constrained to being: .in +4 .nf .na in the range 0 through 512 .fi .in -4 .sp .TP .BR \-u " \fIstring\fP, " \-\-username "=" \fIstring\fP specify a username. .sp .TP .BR \-p " \fIstring\fP, " \-\-passwd "=" \fIstring\fP specify a password file.. .sp .TP .BR \-h , " \-\-help" Display usage information and exit. .TP .BR \-! , " \-\-more-help" Pass the extended usage information through a pager. .TP .BR \-v " [{\fIv|c|n\fP}]," " \-\-version" "[=\fI{v|c|n}\fP]" 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. .SH EXAMPLES To add a user 'psk_identity' in \fIpasswd.psk\fP for use with GnuTLS run: .br .in +4 .nf $ ./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 $ .in -4 .fi .sp This command will create \fIpasswd.psk\fP if it does not exist and will add user 'psk_identity' (you will also be prompted for a password). .SH "EXIT STATUS" One of the following exit values will be returned: .TP .BR 0 " (EXIT_SUCCESS)" Successful program execution. .TP .BR 1 " (EXIT_FAILURE)" The operation failed or the command syntax was not valid. .SH "SEE ALSO" gnutls\-cli\-debug (1), gnutls\-serv (1), srptool (1), certtool (1) .SH "AUTHORS" Nikos Mavrogiannopoulos, Simon Josefsson and others; see /usr/share/doc/gnutls-bin/AUTHORS for a complete list. .SH "COPYRIGHT" Copyright (C) 2000-2012 Free Software Foundation all rights reserved. This program is released under the terms of the GNU General Public License, version 3 or later. .SH "BUGS" Please send bug reports to: bug-gnutls@gnu.org .SH "NOTES" This manual page was \fIAutoGen\fP-erated from the \fBpsktool\fP option definitions.