.TH psktool 1 "18 Sep 2014" "3.3.8" "User Commands"
.\"
.\"  DO NOT EDIT THIS FILE   (psktool-args.man)
.\"
.\"  It has been AutoGen-ed  September 18, 2014 at 01:53:13 PM by AutoGen 5.18.3
.\"  From the definitions    psktool-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" "[={\fIv|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.
.TP
.BR 70 " (EX_SOFTWARE)"
libopts had an internal operational error.  Please report
it to autogen-users@lists.sourceforge.net.  Thank you.
.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/AUTHORS for a complete list.
.SH "COPYRIGHT"
Copyright (C) 2000-2014 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.
.SH "BUGS"
Please send bug reports to: bugs@gnutls.org
.SH "NOTES"
This manual page was \fIAutoGen\fP-erated from the \fBpsktool\fP
option definitions.