Index: doc/tls.html ================================================================== --- doc/tls.html +++ doc/tls.html @@ -33,11 +33,11 @@ <dt> </dt> <dd><b>tls::ciphers</b> <em>?protocol? ?verbose? ?supported?</em></dd> <dd><b>tls::protocols</b></dd> <dd><b>tls::version</b></dd> <dt> </dt> - <dd><b>tls::digest</b> <em>type data</em></dd> + <dd><b>tls::digest</b> <em>type ?-bin|-hex? [-file filename | ?-data? data]</em></dd> <dd><b>tls::digests</b></dd> <dd><b>tls::md4</b> <em>data</em></dd> <dd><b>tls::md5</b> <em>data</em></dd> <dd><b>tls::sha1</b> <em>data</em></dd> <dd><b>tls::sha256</b> <em>data</em></dd> @@ -73,11 +73,11 @@ <br> <a href="#tls::ciphers"><b>tls::ciphers</b> <i>?protocol? ?verbose? ?supported?</i></a><br> <a href="#tls::protocols"><b>tls::protocols</b></a><br> <a href="#tls::version"><b>tls::version</b></a><br> <br> -<a href="#tls::digest"><b>tls::digest</b> <i>type data</i></a><br> +<a href="#tls::digest"><b>tls::digest</b> <i>type ?-bin|-hex? [-file filename | ?-data? data]</i></a><br> <a href="#tls::digests"><b>tls::digests</b></a><br> <a href="#tls::md4"><b>tls::md4</b> <i>data</i></a><br> <a href="#tls::md5"><b>tls::md5</b> <i>data</i></a><br> <a href="#tls::sha1"><b>tls::sha1</b> <i>data</i></a><br> <a href="#tls::sha256"><b>tls::sha256</b> <i>data</i></a><br> @@ -429,11 +429,11 @@ </blockquote> <dt><a name="tls::ciphers"><strong>tls::ciphers</strong> <em>?protocol? ?verbose? ?supported?</em></a></dt> <dd>Without any args, returns a list of all ciphers. With - <em>protocol</em>, only the ciphers supportted for that protocol + <em>protocol</em>, only the ciphers supported for that protocol are returned where <em>protocol</em> must be one of <b>ssl2, ssl3, tls1, tls1.1, tls1.2,</b> or <b>tls1.3</b>. If <em>verbose</em> is specified as true then a verbose, human readable list is returned with additional information on the cipher. If <em>supported</em> is specified as true, then only the ciphers supported for protocol @@ -447,31 +447,33 @@ <dt><a name="tls::version"><strong>tls::version</strong></a></dt> <dd>Returns the OpenSSL version string.</dd> <br> - <dt><a name="tls::digest"><strong>tls::digest</strong> <em>type data</em></a></dt> - <dd>Calculate the message digest for <em>data</em> using <em>type</em> - hash algorithm. Returns value as a hex string. Type can be any - OpenSSL supported hash algorithm including: <b>md4</b>, <b>md5</b>, + <dt><a name="tls::digest"><strong>tls::digest</strong> <em>type ?-bin|-hex? + [-file filename | ?-data? data]</em></a></dt> + <dd>Calculate the message digest for <em>data</em> or file <em>filename</em> + using <em>type</em> hash algorithm. Returns value as a hex string + (default) or as a binary value with <em>-bin</em> option. Type can be + any OpenSSL supported hash algorithm including: <b>md4</b>, <b>md5</b>, <b>sha1</b>, <b>sha256</b>, <b>sha512</b>, <b>sha3-256</b>, etc. - See <b>digests</b> command for a full list.</dd> + See <b>tls::digests</b> command for a full list.</dd> <dt><a name="tls::digests"><strong>tls::digests</strong></a></dt> - <dd>Returns a list of the valid hash algorithms used to create message digests.</dd> + <dd>Returns a list of the hash algorithms for <b>tls::digest</b> command.</dd> <dt><a name="tls::md4"><strong>tls::md4</strong> <em>data</em></a></dt> - <dd>Return the MD4 message-digest for <em>data</em>.</dd> + <dd>Returns the MD4 message-digest for <em>data</em> as a hex string.</dd> <dt><a name="tls::md5"><strong>tls::md5</strong> <em>data</em></a></dt> - <dd>Return the MD5 message-digest for <em>data</em>.</dd> + <dd>Returns the MD5 message-digest for <em>data</em> as a hex string.</dd> <dt><a name="tls::sha1"><strong>tls::sha1</strong> <em>data</em></a></dt> - <dd>Return the SHA1 secure hash algorithm digest for <em>data</em>.</dd> + <dd>Returns the SHA1 secure hash algorithm digest for <em>data</em> as a hex string.</dd> <dt><a name="tls::sha256"><strong>tls::sha256</strong> <em>data</em></a></dt> - <dd>Return the SHA-2 SHA256 secure hash algorithm digest for <em>data</em>.</dd> + <dd>Returns the SHA-2 SHA256 secure hash algorithm digest for <em>data</em> as a hex string.</dd> </dl> <h3><a name="CALLBACK OPTIONS">CALLBACK OPTIONS</a></h3> <p>