diff options
Diffstat (limited to 'manual/html_node/srptool-Invocation.html')
-rw-r--r-- | manual/html_node/srptool-Invocation.html | 297 |
1 files changed, 0 insertions, 297 deletions
diff --git a/manual/html_node/srptool-Invocation.html b/manual/html_node/srptool-Invocation.html deleted file mode 100644 index dadfe5378b..0000000000 --- a/manual/html_node/srptool-Invocation.html +++ /dev/null @@ -1,297 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<html> -<!-- This manual is last updated 4 March 2015 for version -3.5.4 of GnuTLS. - -Copyright (C) 2001-2015 Free Software Foundation, Inc.\\ -Copyright (C) 2001-2015 Nikos Mavrogiannopoulos - -Permission is granted to copy, distribute and/or modify this document -under the terms of the GNU Free Documentation License, Version 1.3 or -any later version published by the Free Software Foundation; with no -Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A -copy of the license is included in the section entitled "GNU Free -Documentation License". --> -<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ --> -<head> -<title>GnuTLS 3.5.4: srptool Invocation</title> - -<meta name="description" content="GnuTLS 3.5.4: srptool Invocation"> -<meta name="keywords" content="GnuTLS 3.5.4: srptool Invocation"> -<meta name="resource-type" content="document"> -<meta name="distribution" content="global"> -<meta name="Generator" content="makeinfo"> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -<link href="index.html#Top" rel="start" title="Top"> -<link href="Function-and-Data-Index.html#Function-and-Data-Index" rel="index" title="Function and Data Index"> -<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> -<link href="SRP-authentication.html#SRP-authentication" rel="up" title="SRP authentication"> -<link href="PSK-authentication.html#PSK-authentication" rel="next" title="PSK authentication"> -<link href="Authentication-using-SRP.html#Authentication-using-SRP" rel="prev" title="Authentication using SRP"> -<style type="text/css"> -<!-- -a.summary-letter {text-decoration: none} -blockquote.indentedblock {margin-right: 0em} -blockquote.smallindentedblock {margin-right: 0em; font-size: smaller} -blockquote.smallquotation {font-size: smaller} -div.display {margin-left: 3.2em} -div.example {margin-left: 3.2em} -div.lisp {margin-left: 3.2em} -div.smalldisplay {margin-left: 3.2em} -div.smallexample {margin-left: 3.2em} -div.smalllisp {margin-left: 3.2em} -kbd {font-style: oblique} -pre.display {font-family: inherit} -pre.format {font-family: inherit} -pre.menu-comment {font-family: serif} -pre.menu-preformatted {font-family: serif} -pre.smalldisplay {font-family: inherit; font-size: smaller} -pre.smallexample {font-size: smaller} -pre.smallformat {font-family: inherit; font-size: smaller} -pre.smalllisp {font-size: smaller} -span.nolinebreak {white-space: nowrap} -span.roman {font-family: initial; font-weight: normal} -span.sansserif {font-family: sans-serif; font-weight: normal} -ul.no-bullet {list-style: none} -body { - margin: 2%; - padding: 0 5%; - background: #ffffff; -} -h1,h2,h3,h4,h5 { - font-weight: bold; - padding: 5px 5px 5px 5px; - background-color: #c2e0ff; - color: #336699; -} -h1 { - padding: 2em 2em 2em 5%; - color: white; - background: #336699; - text-align: center; - letter-spacing: 3px; -} -h2 { text-decoration: underline; } -pre { - margin: 0 5%; - padding: 0.5em; -} -pre.example,pre.verbatim { - padding-bottom: 1em; - - border: solid #c2e0ff; - background: #f0faff; - border-width: 1px 1px 1px 5px; - margin: 1em auto; - width: 90%; -} - -div.node { - margin: 0 -5% 0 -2%; - padding: 0.5em 0.5em; - margin-top: 0.5em; - margin-bottom: 0.5em; - font-weight: bold; -} -dd, li { - padding-top: 0.1em; - padding-bottom: 0.1em; -} -div.float { - - margin-bottom: 0.5em; - text-align: center; -} - -table { - text-align: left; - margin-left:auto; - margin-right:auto; - border-spacing: 7px; - width: 50%; -} - -th { - padding: 0; - color: #336699; - background-color: #c2e0ff; - border: solid #000000; - border-width: 0px; - margin: 1em auto; - text-align: center; - margin-left:auto; - margin-right:auto; -} - -td { - padding: 0; - border: solid #000000; - background-color: #f0faff; - border-width: 0px; - margin: 1em auto; - text-align: left; - margin-left:auto; - margin-right:auto; - padding-left: 1em; -} - -dl { - text-align: left; - margin-left:auto; - margin-right:auto; - width: 50%; - - padding-left: 1em; - border: solid #c2e0ff; - background: #f0faff; - border-width: 5px 1px 1px 1px; - margin: 1em auto; -} - ---> -</style> - - -</head> - -<body lang="en"> -<a name="srptool-Invocation"></a> -<div class="header"> -<p> -Previous: <a href="Authentication-using-SRP.html#Authentication-using-SRP" accesskey="p" rel="prev">Authentication using SRP</a>, Up: <a href="SRP-authentication.html#SRP-authentication" accesskey="u" rel="up">SRP authentication</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Function-and-Data-Index.html#Function-and-Data-Index" title="Index" rel="index">Index</a>]</p> -</div> -<hr> -<a name="Invoking-srptool"></a> -<h4 class="subsubsection">4.3.1.2 Invoking srptool</h4> -<a name="index-srptool"></a> - - -<p>Simple program that emulates the programs in the Stanford SRP (Secure -Remote Password) libraries using GnuTLS. It is intended for use in places -where you don’t expect SRP authentication to be the used for system users. -</p> -<p>In brief, to use SRP you need to create two files. These are the password -file that holds the users and the verifiers associated with them and the -configuration file to hold the group parameters (called tpasswd.conf). -</p> -<p>This section was generated by <strong>AutoGen</strong>, -using the <code>agtexi-cmd</code> template and the option descriptions for the <code>srptool</code> program. -This software is released under the GNU General Public License, version 3 or later. -</p> - -<a name="srptool-usage"></a><a name="srptool-help_002fusage-_0028_002d_002dhelp_0029"></a> -<h4 class="subsubheading">srptool help/usage (<samp>--help</samp>)</h4> -<a name="index-srptool-help"></a> - -<p>This is the automatically generated usage text for srptool. -</p> -<p>The text printed is the same whether selected with the <code>help</code> option -(<samp>--help</samp>) or the <code>more-help</code> option (<samp>--more-help</samp>). <code>more-help</code> will print -the usage text by passing it through a pager program. -<code>more-help</code> is disabled on platforms without a working -<code>fork(2)</code> function. The <code>PAGER</code> environment variable is -used to select the program, defaulting to <samp>more</samp>. Both will exit -with a status code of 0. -</p> -<div class="example"> -<pre class="example">srptool - GnuTLS SRP tool -Usage: srptool [ -<flag> [<val>] | --<name>[{=| }<val>] ]... - - -d, --debug=num Enable debugging - - it must be in the range: - 0 to 9999 - -i, --index=num specify the index of the group parameters in tpasswd.conf to use - -u, --username=str specify a username - -p, --passwd=str specify a password file - -s, --salt=num specify salt size - --verify just verify the password. - -v, --passwd-conf=str specify a password conf file. - --create-conf=str Generate a password configuration 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. - -Simple program that emulates the programs in the Stanford SRP (Secure -Remote Password) libraries using GnuTLS. It is intended for use in places -where you don't expect SRP authentication to be the used for system users. - -In brief, to use SRP you need to create two files. These are the password -file that holds the users and the verifiers associated with them and the -configuration file to hold the group parameters (called tpasswd.conf). - -</pre></div> - -<a name="srptool-debug"></a><a name="debug-option-_0028_002dd_0029-4"></a> -<h4 class="subsubheading">debug option (-d)</h4> - -<p>This is the “enable debugging” option. -This option takes a number argument. -Specifies the debug level. -<a name="srptool-verify"></a></p><a name="verify-option-1"></a> -<h4 class="subsubheading">verify option</h4> - -<p>This is the “just verify the password.” option. -Verifies the password provided against the password file. -<a name="srptool-passwd_002dconf"></a></p><a name="passwd_002dconf-option-_0028_002dv_0029"></a> -<h4 class="subsubheading">passwd-conf option (-v)</h4> - -<p>This is the “specify a password conf file.” option. -This option takes a string argument. -Specify a filename or a PKCS #11 URL to read the CAs from. -<a name="srptool-create_002dconf"></a></p><a name="create_002dconf-option"></a> -<h4 class="subsubheading">create-conf option</h4> - -<p>This is the “generate a password configuration file.” option. -This option takes a string argument. -This generates a password configuration file (tpasswd.conf) -containing the required for TLS parameters. -<a name="srptool-exit-status"></a></p><a name="srptool-exit-status-1"></a> -<h4 class="subsubheading">srptool exit status</h4> - -<p>One of the following exit values will be returned: -</p><dl compact="compact"> -<dt>‘<samp>0 (EXIT_SUCCESS)</samp>’</dt> -<dd><p>Successful program execution. -</p></dd> -<dt>‘<samp>1 (EXIT_FAILURE)</samp>’</dt> -<dd><p>The operation failed or the command syntax was not valid. -</p></dd> -</dl> -<a name="srptool-See-Also"></a><a name="srptool-See-Also-1"></a> -<h4 class="subsubheading">srptool See Also</h4> -<p>gnutls-cli-debug (1), gnutls-serv (1), srptool (1), psktool (1), certtool (1) -<a name="srptool-Examples"></a></p><a name="srptool-Examples-1"></a> -<h4 class="subsubheading">srptool Examples</h4> -<p>To create <samp>tpasswd.conf</samp> which holds the g and n values for SRP protocol -(generator and a large prime), run: -</p><div class="example"> -<pre class="example">$ srptool --create-conf /etc/tpasswd.conf -</pre></div> - -<p>This command will create <samp>/etc/tpasswd</samp> and will add user ’test’ (you -will also be prompted for a password). Verifiers are stored by default -in the way libsrp expects. -</p><div class="example"> -<pre class="example">$ srptool --passwd /etc/tpasswd --passwd-conf /etc/tpasswd.conf -u test -</pre></div> - - -<p>This command will check against a password. If the password matches -the one in <samp>/etc/tpasswd</samp> you will get an ok. -</p><div class="example"> -<pre class="example">$ srptool --passwd /etc/tpasswd --passwd\-conf /etc/tpasswd.conf --verify -u test -</pre></div> - -<hr> -<div class="header"> -<p> -Previous: <a href="Authentication-using-SRP.html#Authentication-using-SRP" accesskey="p" rel="prev">Authentication using SRP</a>, Up: <a href="SRP-authentication.html#SRP-authentication" accesskey="u" rel="up">SRP authentication</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Function-and-Data-Index.html#Function-and-Data-Index" title="Index" rel="index">Index</a>]</p> -</div> - - - -</body> -</html> |