0000: 3c 21 44 4f 43 54 59 50 45 20 68 74 6d 6c 3e 0a <!DOCTYPE html>.
0010: 3c 68 74 6d 6c 20 6c 61 6e 67 3d 22 65 6e 22 3e <html lang="en">
0020: 0a 3c 68 65 61 64 3e 0a 3c 6d 65 74 61 20 68 74 .<head>.<meta ht
0030: 74 70 2d 65 71 75 69 76 3d 22 43 6f 6e 74 65 6e tp-equiv="Conten
0040: 74 2d 54 79 70 65 22 20 63 6f 6e 74 65 6e 74 3d t-Type" content=
0050: 22 74 65 78 74 2f 68 74 6d 6c 3b 20 63 68 61 72 "text/html; char
0060: 73 65 74 3d 75 74 66 2d 38 22 3e 0a 3c 6d 65 74 set=utf-8">.<met
0070: 61 20 6e 61 6d 65 3d 22 43 6f 70 79 72 69 67 68 a name="Copyrigh
0080: 74 22 20 63 6f 6e 74 65 6e 74 3d 22 32 30 32 33 t" content="2023
0090: 20 42 72 69 61 6e 20 4f 27 48 61 67 61 6e 22 3e Brian O'Hagan">
00a0: 0a 3c 74 69 74 6c 65 3e 54 68 65 20 54 63 6c 20 .<title>The Tcl
00b0: 43 72 79 70 74 6f 67 72 61 70 68 79 20 50 61 63 Cryptography Pac
00c0: 6b 61 67 65 3c 2f 74 69 74 6c 65 3e 0a 3c 6c 69 kage</title>.<li
00d0: 6e 6b 20 72 65 6c 3d 22 73 74 79 6c 65 73 68 65 nk rel="styleshe
00e0: 65 74 22 20 68 72 65 66 3d 22 64 6f 63 73 2e 63 et" href="docs.c
00f0: 73 73 22 20 74 79 70 65 3d 22 74 65 78 74 2f 63 ss" type="text/c
0100: 73 73 22 20 6d 65 64 69 61 3d 22 61 6c 6c 22 3e ss" media="all">
0110: 0a 3c 2f 68 65 61 64 3e 0a 0a 3c 62 6f 64 79 20 .</head>..<body
0120: 63 6c 61 73 73 3d 22 76 73 63 2d 69 6e 69 74 69 class="vsc-initi
0130: 61 6c 69 7a 65 64 22 3e 0a 0a 3c 68 32 3e 54 63 alized">..<h2>Tc
0140: 6c 20 43 72 79 70 74 6f 67 72 61 70 68 79 20 44 l Cryptography D
0150: 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 3c 2f 68 32 ocumentation</h2
0160: 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 64 3e >..<dl>. <dd>
0170: 3c 61 20 68 72 65 66 3d 22 23 4e 41 4d 45 22 3e <a href="#NAME">
0180: 4e 41 4d 45 3c 2f 61 3e 0a 09 3c 64 6c 3e 3c 64 NAME</a>..<dl><d
0190: 64 3e 3c 62 3e 74 6c 73 3c 2f 62 3e 20 2d 20 62 d><b>tls</b> - b
01a0: 69 6e 64 69 6e 67 20 74 6f 20 3c 62 3e 4f 70 65 inding to <b>Ope
01b0: 6e 53 53 4c 3c 2f 62 3e 20 74 6f 6f 6c 6b 69 74 nSSL</b> toolkit
01c0: 2e 3c 2f 64 64 3e 3c 2f 64 6c 3e 0a 20 20 20 20 .</dd></dl>.
01d0: 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 64 3e 3c 61 </dd>. <dd><a
01e0: 20 68 72 65 66 3d 22 23 44 45 53 43 52 49 50 54 href="#DESCRIPT
01f0: 49 4f 4e 22 3e 44 45 53 43 52 49 50 54 49 4f 4e ION">DESCRIPTION
0200: 3c 2f 61 3e 20 3c 2f 64 64 3e 0a 20 20 20 20 3c </a> </dd>. <
0210: 64 64 3e 3c 61 20 68 72 65 66 3d 22 23 53 59 4e dd><a href="#SYN
0220: 4f 50 53 49 53 22 3e 53 59 4e 4f 50 53 49 53 3c OPSIS">SYNOPSIS<
0230: 2f 61 3e 20 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 /a> </dd>. <d
0240: 64 3e 3c 64 6c 3e 0a 09 20 20 20 20 3c 64 64 3e d><dl>.. <dd>
0250: 3c 62 3e 70 61 63 6b 61 67 65 20 72 65 71 75 69 <b>package requi
0260: 72 65 20 54 63 6c 3c 2f 62 3e 20 3c 65 6d 3e 3f re Tcl</b> <em>?
0270: 38 2e 35 2d 3f 3c 2f 65 6d 3e 3c 2f 64 64 3e 0a 8.5-?</em></dd>.
0280: 09 20 20 20 20 3c 64 64 3e 3c 62 3e 70 61 63 6b . <dd><b>pack
0290: 61 67 65 20 72 65 71 75 69 72 65 20 74 6c 73 3c age require tls<
02a0: 2f 62 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 /b></dd>.. <d
02b0: 74 3e 26 6e 62 73 70 3b 3c 2f 64 74 3e 0a 09 20 t> </dt>..
02c0: 20 20 20 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 63 <dd><b>tls::c
02d0: 69 70 68 65 72 3c 2f 62 3e 20 3c 65 6d 3e 6e 61 ipher</b> <em>na
02e0: 6d 65 3c 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 20 20 me</em></dd>..
02f0: 20 20 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 63 69 <dd><b>tls::ci
0300: 70 68 65 72 73 3c 2f 62 3e 20 3c 65 6d 3e 3f 70 phers</b> <em>?p
0310: 72 6f 74 6f 63 6f 6c 3f 20 3f 76 65 72 62 6f 73 rotocol? ?verbos
0320: 65 3f 20 3f 73 75 70 70 6f 72 74 65 64 3f 3c 2f e? ?supported?</
0330: 65 6d 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 em></dd>.. <d
0340: 64 3e 3c 62 3e 74 6c 73 3a 3a 64 69 67 65 73 74 d><b>tls::digest
0350: 73 3c 2f 62 3e 20 3c 65 6d 3e 3f 6e 61 6d 65 3f s</b> <em>?name?
0360: 3c 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 </em></dd>..
0370: 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 6d 61 63 73 <dd><b>tls::macs
0380: 3c 2f 62 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 3c </b></dd>.. <
0390: 64 64 3e 3c 62 3e 74 6c 73 3a 3a 70 72 6f 74 6f dd><b>tls::proto
03a0: 63 6f 6c 73 3c 2f 62 3e 3c 2f 64 64 3e 0a 09 20 cols</b></dd>..
03b0: 20 20 20 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 76 <dd><b>tls::v
03c0: 65 72 73 69 6f 6e 3c 2f 62 3e 3c 2f 64 64 3e 0a ersion</b></dd>.
03d0: 09 20 20 20 20 3c 64 74 3e 26 6e 62 73 70 3b 3c . <dt> <
03e0: 2f 64 74 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 /dt>.. <dd><b
03f0: 3e 74 6c 73 3a 3a 63 6d 61 63 3c 2f 62 3e 20 3c >tls::cmac</b> <
0400: 62 3e 2d 63 69 70 68 65 72 3c 2f 62 3e 20 3c 65 b>-cipher</b> <e
0410: 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e 20 3c 62 3e 2d m>name</em> <b>-
0420: 6b 65 79 3c 2f 62 3e 20 3c 65 6d 3e 6b 65 79 20 key</b> <em>key
0430: 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 65 6d 3e 3c 2f ?options?</em></
0440: 64 64 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 3e dd>.. <dd><b>
0450: 74 6c 73 3a 3a 68 6d 61 63 3c 2f 62 3e 20 3c 62 tls::hmac</b> <b
0460: 3e 2d 64 69 67 65 73 74 3c 2f 62 3e 20 3c 65 6d >-digest</b> <em
0470: 3e 6e 61 6d 65 3c 2f 65 6d 3e 20 3c 62 3e 2d 6b >name</em> <b>-k
0480: 65 79 3c 2f 62 3e 20 3c 65 6d 3e 6b 65 79 20 3f ey</b> <em>key ?
0490: 6f 70 74 69 6f 6e 73 3f 3c 2f 65 6d 3e 3c 2f 64 options?</em></d
04a0: 64 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 3e 74 d>.. <dd><b>t
04b0: 6c 73 3a 3a 6d 64 3c 2f 62 3e 20 3c 62 3e 2d 64 ls::md</b> <b>-d
04c0: 69 67 65 73 74 3c 2f 62 3e 20 3c 65 6d 3e 6e 61 igest</b> <em>na
04d0: 6d 65 20 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 65 6d me ?options?</em
04e0: 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 64 3e ></dd>.. <dd>
04f0: 3c 62 3e 74 6c 73 3a 3a 6d 64 34 3c 2f 62 3e 20 <b>tls::md4</b>
0500: 3c 65 6d 3e 64 61 74 61 3c 2f 65 6d 3e 3c 2f 64 <em>data</em></d
0510: 64 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 3e 74 d>.. <dd><b>t
0520: 6c 73 3a 3a 6d 64 35 3c 2f 62 3e 20 3c 65 6d 3e ls::md5</b> <em>
0530: 64 61 74 61 3c 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 data</em></dd>..
0540: 20 20 20 20 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a <dd><b>tls::
0550: 73 68 61 31 3c 2f 62 3e 20 3c 65 6d 3e 64 61 74 sha1</b> <em>dat
0560: 61 3c 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 20 20 20 a</em></dd>..
0570: 20 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 73 68 61 <dd><b>tls::sha
0580: 32 35 36 3c 2f 62 3e 20 3c 65 6d 3e 64 61 74 61 256</b> <em>data
0590: 3c 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 </em></dd>..
05a0: 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 73 68 61 35 <dd><b>tls::sha5
05b0: 31 32 3c 2f 62 3e 20 3c 65 6d 3e 64 61 74 61 3c 12</b> <em>data<
05c0: 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 3c /em></dd>.. <
05d0: 64 64 3e 3c 62 3e 74 6c 73 3a 3a 75 6e 73 74 61 dd><b>tls::unsta
05e0: 63 6b 3c 2f 62 3e 20 3c 65 6d 3e 63 68 61 6e 6e ck</b> <em>chann
05f0: 65 6c 49 64 3c 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 elId</em></dd>..
0600: 20 20 20 20 3c 64 74 3e 26 6e 62 73 70 3b 3c 2f <dt> </
0610: 64 74 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 3e dt>.. <dd><b>
0620: 74 6c 73 3a 3a 65 6e 63 72 79 70 74 3c 2f 62 3e tls::encrypt</b>
0630: 20 3c 62 3e 2d 63 69 70 68 65 72 3c 2f 62 3e 20 <b>-cipher</b>
0640: 3c 65 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e 20 3c 62 <em>name</em> <b
0650: 3e 2d 6b 65 79 3c 2f 62 3e 20 3c 65 6d 3e 6b 65 >-key</b> <em>ke
0660: 79 20 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 65 6d 3e y ?options?</em>
0670: 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 64 3e 3c </dd>.. <dd><
0680: 62 3e 74 6c 73 3a 3a 64 65 63 72 79 70 74 3c 2f b>tls::decrypt</
0690: 62 3e 20 3c 62 3e 2d 63 69 70 68 65 72 3c 2f 62 b> <b>-cipher</b
06a0: 3e 20 3c 65 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e 20 > <em>name</em>
06b0: 3c 62 3e 2d 6b 65 79 3c 2f 62 3e 20 3c 65 6d 3e <b>-key</b> <em>
06c0: 6b 65 79 20 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 65 key ?options?</e
06d0: 6d 3e 3c 2f 64 64 3e 0a 09 3c 2f 64 6c 3e 0a 20 m></dd>..</dl>.
06e0: 20 20 20 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 64 </dd>. <dd
06f0: 3e 3c 61 20 68 72 65 66 3d 22 23 4f 50 54 49 4f ><a href="#OPTIO
0700: 4e 53 22 3e 4f 50 54 49 4f 4e 53 3c 2f 61 3e 3c NS">OPTIONS</a><
0710: 2f 64 64 3e 0a 20 20 20 20 3c 64 64 3e 3c 61 20 /dd>. <dd><a
0720: 68 72 65 66 3d 22 23 43 4f 4d 4d 41 4e 44 53 22 href="#COMMANDS"
0730: 3e 43 4f 4d 4d 41 4e 44 53 3c 2f 61 3e 3c 2f 64 >COMMANDS</a></d
0740: 64 3e 0a 20 20 20 20 3c 64 64 3e 3c 61 20 68 72 d>. <dd><a hr
0750: 65 66 3d 22 23 47 4c 4f 53 53 41 52 59 22 3e 47 ef="#GLOSSARY">G
0760: 4c 4f 53 53 41 52 59 3c 2f 61 3e 20 3c 2f 64 64 LOSSARY</a> </dd
0770: 3e 0a 20 20 20 20 3c 64 64 3e 3c 61 20 68 72 65 >. <dd><a hre
0780: 66 3d 22 23 45 58 41 4d 50 4c 45 53 22 3e 45 58 f="#EXAMPLES">EX
0790: 41 4d 50 4c 45 53 3c 2f 61 3e 3c 2f 64 64 3e 0a AMPLES</a></dd>.
07a0: 20 20 20 20 3c 64 64 3e 3c 61 20 68 72 65 66 3d <dd><a href=
07b0: 22 23 53 50 45 43 49 41 4c 22 3e 53 50 45 43 49 "#SPECIAL">SPECI
07c0: 41 4c 20 43 4f 4e 53 49 44 45 52 41 54 49 4f 4e AL CONSIDERATION
07d0: 53 3c 2f 61 3e 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e S</a></dd>.</dl>
07e0: 0a 0a 3c 62 72 3e 0a 0a 3c 68 33 3e 3c 61 20 6e ..<br>..<h3><a n
07f0: 61 6d 65 3d 22 4e 41 4d 45 22 3e 4e 41 4d 45 3c ame="NAME">NAME<
0800: 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 3c 73 74 /a></h3>..<p><st
0810: 72 6f 6e 67 3e 74 6c 73 3c 2f 73 74 72 6f 6e 67 rong>tls</strong
0820: 3e 20 2d 20 62 69 6e 64 69 6e 67 20 74 6f 20 3c > - binding to <
0830: 73 74 72 6f 6e 67 3e 4f 70 65 6e 53 53 4c 3c 2f strong>OpenSSL</
0840: 73 74 72 6f 6e 67 3e 20 74 6f 6f 6c 6b 69 74 2e strong> toolkit.
0850: 3c 2f 70 3e 0a 0a 3c 68 33 3e 3c 61 20 6e 61 6d </p>..<h3><a nam
0860: 65 3d 22 44 45 53 43 52 49 50 54 49 4f 4e 22 3e e="DESCRIPTION">
0870: 44 45 53 43 52 49 50 54 49 4f 4e 3c 2f 61 3e 3c DESCRIPTION</a><
0880: 2f 68 33 3e 0a 0a 3c 70 3e 54 68 69 73 20 65 78 /h3>..<p>This ex
0890: 74 65 6e 73 69 6f 6e 20 70 72 6f 76 69 64 65 73 tension provides
08a0: 20 61 20 67 65 6e 65 72 69 63 20 69 6e 74 65 72 a generic inter
08b0: 66 61 63 65 20 74 6f 20 74 68 65 0a 3c 61 20 68 face to the.<a h
08c0: 72 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e ref="http://www.
08d0: 6f 70 65 6e 73 73 6c 2e 6f 72 67 2f 22 3e 4f 70 openssl.org/">Op
08e0: 65 6e 53 53 4c 3c 2f 61 3e 20 63 72 79 70 74 6f enSSL</a> crypto
08f0: 67 72 61 70 68 79 20 66 75 6e 63 74 69 6f 6e 73 graphy functions
0900: 2e 20 54 68 65 0a 70 72 6f 76 69 64 65 64 20 63 . The.provided c
0910: 6f 6d 6d 61 6e 64 73 20 63 61 6e 20 62 65 20 75 ommands can be u
0920: 73 65 64 20 74 6f 20 65 6e 73 75 72 65 20 74 68 sed to ensure th
0930: 65 20 63 6f 6e 66 69 64 65 6e 74 69 61 6c 69 74 e confidentialit
0940: 79 2c 20 61 75 74 68 65 6e 74 69 63 69 74 79 2c y, authenticity,
0950: 0a 61 6e 64 20 69 6e 74 65 67 72 69 74 79 20 6f .and integrity o
0960: 66 20 6d 65 73 73 61 67 65 73 20 61 6e 64 20 64 f messages and d
0970: 61 74 61 2e 3c 2f 70 3e 0a 0a 3c 62 72 3e 0a 3c ata.</p>..<br>.<
0980: 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 53 59 4e 4f h3><a name="SYNO
0990: 50 53 49 53 22 3e 53 59 4e 4f 50 53 49 53 3c 2f PSIS">SYNOPSIS</
09a0: 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 3c 62 3e 70 a></h3>..<p><b>p
09b0: 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 54 ackage require T
09c0: 63 6c 20 38 2e 35 2d 3c 2f 62 3e 3c 62 72 3e 0a cl 8.5-</b><br>.
09d0: 3c 62 3e 70 61 63 6b 61 67 65 20 72 65 71 75 69 <b>package requi
09e0: 72 65 20 74 6c 73 3c 2f 62 3e 3c 62 72 3e 0a 3c re tls</b><br>.<
09f0: 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c br>.<a href="#tl
0a00: 73 3a 3a 63 69 70 68 65 72 22 3e 3c 62 3e 74 6c s::cipher"><b>tl
0a10: 73 3a 3a 63 69 70 68 65 72 3c 2f 62 3e 20 3c 69 s::cipher</b> <i
0a20: 3e 6e 61 6d 65 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 >name</i></a><br
0a30: 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a >.<a href="#tls:
0a40: 3a 63 69 70 68 65 72 73 22 3e 3c 62 3e 74 6c 73 :ciphers"><b>tls
0a50: 3a 3a 63 69 70 68 65 72 73 3c 2f 62 3e 20 3c 69 ::ciphers</b> <i
0a60: 3e 3f 70 72 6f 74 6f 63 6f 6c 3f 20 3f 76 65 72 >?protocol? ?ver
0a70: 62 6f 73 65 3f 20 3f 73 75 70 70 6f 72 74 65 64 bose? ?supported
0a80: 3f 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 ?</i></a><br>.<a
0a90: 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a 64 69 67 href="#tls::dig
0aa0: 65 73 74 73 22 3e 3c 62 3e 74 6c 73 3a 3a 64 69 ests"><b>tls::di
0ab0: 67 65 73 74 73 3c 2f 62 3e 20 3c 69 3e 3f 6e 61 gests</b> <i>?na
0ac0: 6d 65 3f 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e 0a me?</i></a><br>.
0ad0: 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a 6d <a href="#tls::m
0ae0: 61 63 73 22 3e 3c 62 3e 74 6c 73 3a 3a 6d 61 63 acs"><b>tls::mac
0af0: 73 3c 2f 62 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 s</b></a><br>.<a
0b00: 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a 70 72 6f href="#tls::pro
0b10: 74 6f 63 6f 6c 73 22 3e 3c 62 3e 74 6c 73 3a 3a tocols"><b>tls::
0b20: 70 72 6f 74 6f 63 6f 6c 73 3c 2f 62 3e 3c 2f 61 protocols</b></a
0b30: 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 ><br>.<a href="#
0b40: 74 6c 73 3a 3a 76 65 72 73 69 6f 6e 22 3e 3c 62 tls::version"><b
0b50: 3e 74 6c 73 3a 3a 76 65 72 73 69 6f 6e 3c 2f 62 >tls::version</b
0b60: 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 62 72 3e 0a 3c ></a><br>.<br>.<
0b70: 61 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a 63 6d a href="#tls::cm
0b80: 61 63 22 3e 3c 62 3e 74 6c 73 3a 3a 63 6d 61 63 ac"><b>tls::cmac
0b90: 3c 2f 62 3e 20 3c 62 3e 2d 63 69 70 68 65 72 3c </b> <b>-cipher<
0ba0: 2f 62 3e 20 3c 69 3e 6e 61 6d 65 3c 2f 69 3e 20 /b> <i>name</i>
0bb0: 3c 62 3e 2d 6b 65 79 3c 2f 62 3e 20 3c 69 3e 6b <b>-key</b> <i>k
0bc0: 65 79 20 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 69 3e ey ?options?</i>
0bd0: 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 66 </a><br>.<a href
0be0: 3d 22 23 74 6c 73 3a 3a 68 6d 61 63 22 3e 3c 62 ="#tls::hmac"><b
0bf0: 3e 74 6c 73 3a 3a 68 6d 61 63 3c 2f 62 3e 20 3c >tls::hmac</b> <
0c00: 62 3e 2d 64 69 67 65 73 74 3c 2f 62 3e 20 3c 69 b>-digest</b> <i
0c10: 3e 6e 61 6d 65 3c 2f 69 3e 20 3c 62 3e 2d 6b 65 >name</i> <b>-ke
0c20: 79 3c 2f 62 3e 20 3c 69 3e 6b 65 79 20 3f 6f 70 y</b> <i>key ?op
0c30: 74 69 6f 6e 73 3f 3c 2f 69 3e 3c 2f 61 3e 3c 62 tions?</i></a><b
0c40: 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 r>.<a href="#tls
0c50: 3a 3a 6d 64 22 3e 3c 62 3e 74 6c 73 3a 3a 6d 64 ::md"><b>tls::md
0c60: 3c 2f 62 3e 20 3c 62 3e 2d 64 69 67 65 73 74 3c </b> <b>-digest<
0c70: 2f 62 3e 20 3c 69 3e 6e 61 6d 65 20 3f 6f 70 74 /b> <i>name ?opt
0c80: 69 6f 6e 73 3f 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 ions?</i></a><br
0c90: 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a >.<a href="#tls:
0ca0: 3a 6d 64 34 22 3e 3c 62 3e 74 6c 73 3a 3a 6d 64 :md4"><b>tls::md
0cb0: 34 3c 2f 62 3e 20 3c 69 3e 64 61 74 61 3c 2f 69 4</b> <i>data</i
0cc0: 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 ></a><br>.<a hre
0cd0: 66 3d 22 23 74 6c 73 3a 3a 6d 64 35 22 3e 3c 62 f="#tls::md5"><b
0ce0: 3e 74 6c 73 3a 3a 6d 64 35 3c 2f 62 3e 20 3c 69 >tls::md5</b> <i
0cf0: 3e 64 61 74 61 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 >data</i></a><br
0d00: 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a >.<a href="#tls:
0d10: 3a 73 68 61 31 22 3e 3c 62 3e 74 6c 73 3a 3a 73 :sha1"><b>tls::s
0d20: 68 61 31 3c 2f 62 3e 20 3c 69 3e 64 61 74 61 3c ha1</b> <i>data<
0d30: 2f 69 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 /i></a><br>.<a h
0d40: 72 65 66 3d 22 23 74 6c 73 3a 3a 73 68 61 32 35 ref="#tls::sha25
0d50: 36 22 3e 3c 62 3e 74 6c 73 3a 3a 73 68 61 32 35 6"><b>tls::sha25
0d60: 36 3c 2f 62 3e 20 3c 69 3e 64 61 74 61 3c 2f 69 6</b> <i>data</i
0d70: 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 ></a><br>.<a hre
0d80: 66 3d 22 23 74 6c 73 3a 3a 73 68 61 35 31 32 22 f="#tls::sha512"
0d90: 3e 3c 62 3e 74 6c 73 3a 3a 73 68 61 35 31 32 3c ><b>tls::sha512<
0da0: 2f 62 3e 20 3c 69 3e 64 61 74 61 3c 2f 69 3e 3c /b> <i>data</i><
0db0: 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d /a><br>.<a href=
0dc0: 22 23 74 6c 73 3a 3a 75 6e 73 74 61 63 6b 22 3e "#tls::unstack">
0dd0: 3c 62 3e 74 6c 73 3a 3a 75 6e 73 74 61 63 6b 3c <b>tls::unstack<
0de0: 2f 62 3e 20 3c 69 3e 63 68 61 6e 6e 65 6c 49 64 /b> <i>channelId
0df0: 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 62 72 </i></a><br>.<br
0e00: 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a >.<a href="#tls:
0e10: 3a 65 6e 63 72 79 70 74 22 3e 3c 62 3e 74 6c 73 :encrypt"><b>tls
0e20: 3a 3a 65 6e 63 72 79 70 74 3c 2f 62 3e 20 3c 62 ::encrypt</b> <b
0e30: 3e 2d 63 69 70 68 65 72 3c 2f 62 3e 20 3c 69 3e >-cipher</b> <i>
0e40: 6e 61 6d 65 3c 2f 69 3e 20 3c 62 3e 2d 6b 65 79 name</i> <b>-key
0e50: 3c 2f 62 3e 20 3c 69 3e 6b 65 79 20 3f 6f 70 74 </b> <i>key ?opt
0e60: 69 6f 6e 73 3f 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 ions?</i></a><br
0e70: 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a >.<a href="#tls:
0e80: 3a 64 65 63 72 79 70 74 22 3e 3c 62 3e 74 6c 73 :decrypt"><b>tls
0e90: 3a 3a 64 65 63 72 79 70 74 3c 2f 62 3e 20 3c 62 ::decrypt</b> <b
0ea0: 3e 2d 63 69 70 68 65 72 3c 2f 62 3e 20 3c 69 3e >-cipher</b> <i>
0eb0: 6e 61 6d 65 3c 2f 69 3e 20 3c 62 3e 2d 6b 65 79 name</i> <b>-key
0ec0: 3c 2f 62 3e 20 3c 69 3e 6b 65 79 20 3f 6f 70 74 </b> <i>key ?opt
0ed0: 69 6f 6e 73 3f 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 ions?</i></a><br
0ee0: 3e 0a 3c 2f 70 3e 0a 0a 3c 62 72 3e 0a 3c 68 33 >.</p>..<br>.<h3
0ef0: 3e 3c 61 20 6e 61 6d 65 3d 22 4f 50 54 49 4f 4e ><a name="OPTION
0f00: 53 22 3e 4f 50 54 49 4f 4e 53 3c 2f 61 3e 3c 2f S">OPTIONS</a></
0f10: 68 33 3e 0a 0a 3c 70 3e 54 68 65 20 66 6f 6c 6c h3>..<p>The foll
0f20: 6f 77 69 6e 67 20 6f 70 74 69 6f 6e 73 20 61 72 owing options ar
0f30: 65 20 75 73 65 64 20 62 79 20 74 68 65 20 63 72 e used by the cr
0f40: 79 70 74 6f 67 72 61 70 68 79 20 63 6f 6d 6d 61 yptography comma
0f50: 6e 64 73 2e 3c 2f 70 3e 0a 3c 62 72 3e 0a 3c 68 nds.</p>.<br>.<h
0f60: 34 3e 43 72 79 70 74 6f 67 72 61 70 68 69 63 20 4>Cryptographic
0f70: 4f 70 74 69 6f 6e 73 3c 2f 68 34 3e 0a 0a 3c 64 Options</h4>..<d
0f80: 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 l>. <dt><a na
0f90: 6d 65 3d 22 2d 63 69 70 68 65 72 22 3e 3c 73 74 me="-cipher"><st
0fa0: 72 6f 6e 67 3e 2d 63 69 70 68 65 72 3c 2f 73 74 rong>-cipher</st
0fb0: 72 6f 6e 67 3e 20 3c 65 6d 3e 6e 61 6d 65 3c 2f rong> <em>name</
0fc0: 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 em></a></dt>.
0fd0: 20 3c 64 64 3e 4e 61 6d 65 20 6f 66 20 63 72 79 <dd>Name of cry
0fe0: 70 74 6f 67 72 61 70 68 69 63 20 63 69 70 68 65 ptographic ciphe
0ff0: 72 20 74 6f 20 75 73 65 2e 20 55 73 65 64 20 62 r to use. Used b
1000: 79 20 65 6e 63 72 79 70 74 2f 64 65 63 72 79 70 y encrypt/decryp
1010: 74 20 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 61 6e t command. an
1020: 64 20 43 4d 41 43 20 26 61 6d 70 3b 20 47 4d 41 d CMAC & GMA
1030: 43 20 68 61 73 68 20 61 6c 67 6f 72 69 74 68 6d C hash algorithm
1040: 73 2e 20 46 6f 72 20 43 4d 41 43 20 69 74 20 6d s. For CMAC it m
1050: 75 73 74 20 62 65 20 6f 6e 65 20 6f 66 20 41 45 ust be one of AE
1060: 53 2d 31 32 38 2d 43 42 43 2c 0a 20 20 20 20 41 S-128-CBC,. A
1070: 45 53 2d 31 39 32 2d 43 42 43 2c 20 41 45 53 2d ES-192-CBC, AES-
1080: 32 35 36 2d 43 42 43 20 6f 72 20 44 45 53 2d 45 256-CBC or DES-E
1090: 44 45 33 2d 43 42 43 2e 20 46 6f 72 20 47 4d 41 DE3-CBC. For GMA
10a0: 43 20 69 74 20 73 68 6f 75 6c 64 20 62 65 20 61 C it should be a
10b0: 20 47 43 4d 20 6d 6f 64 65 0a 20 20 20 20 63 69 GCM mode. ci
10c0: 70 68 65 72 20 65 2e 67 2e 20 41 45 53 2d 31 32 pher e.g. AES-12
10d0: 38 2d 47 43 4d 2e 20 53 65 65 20 3c 61 20 68 72 8-GCM. See <a hr
10e0: 65 66 3d 22 23 74 6c 73 3a 3a 63 69 70 68 65 72 ef="#tls::cipher
10f0: 73 22 3e 3c 62 3e 74 6c 73 3a 3a 63 69 70 68 65 s"><b>tls::ciphe
1100: 72 73 3c 2f 62 3e 3c 2f 61 3e 0a 20 20 20 20 66 rs</b></a>. f
1110: 6f 72 20 74 68 65 20 76 61 6c 69 64 20 76 61 6c or the valid val
1120: 75 65 73 2e 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a ues.</dd>.</dl>.
1130: 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 .<dl>. <dt><a
1140: 20 6e 61 6d 65 3d 22 2d 64 69 67 65 73 74 22 3e name="-digest">
1150: 3c 73 74 72 6f 6e 67 3e 2d 64 69 67 65 73 74 3c <strong>-digest<
1160: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6e 61 6d /strong> <em>nam
1170: 65 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a e</em></a></dt>.
1180: 20 20 20 20 3c 64 64 3e 4e 61 6d 65 20 6f 66 20 <dd>Name of
1190: 68 61 73 68 20 66 75 6e 63 74 69 6f 6e 20 28 61 hash function (a
11a0: 6b 61 20 6d 65 73 73 61 67 65 20 64 69 67 65 73 ka message diges
11b0: 74 29 20 74 6f 20 75 73 65 2e 0a 20 20 20 20 53 t) to use.. S
11c0: 65 65 20 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 ee <a href="#tls
11d0: 3a 3a 64 69 67 65 73 74 73 22 3e 3c 62 3e 74 6c ::digests"><b>tl
11e0: 73 3a 3a 64 69 67 65 73 74 73 3c 2f 62 3e 3c 2f s::digests</b></
11f0: 61 3e 20 66 6f 72 20 74 68 65 20 76 61 6c 69 64 a> for the valid
1200: 20 76 61 6c 75 65 73 2e 3c 2f 64 64 3e 0a 3c 2f values.</dd>.</
1210: 64 6c 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 dl>..<dl>. <d
1220: 74 3e 3c 61 20 6e 61 6d 65 3d 22 2d 69 74 65 72 t><a name="-iter
1230: 61 74 69 6f 6e 73 22 3e 3c 73 74 72 6f 6e 67 3e ations"><strong>
1240: 2d 69 74 65 72 61 74 69 6f 6e 73 3c 2f 73 74 72 -iterations</str
1250: 6f 6e 67 3e 20 3c 65 6d 3e 63 6f 75 6e 74 3c 2f ong> <em>count</
1260: 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 em></a></dt>.
1270: 20 3c 64 64 3e 4e 75 6d 62 65 72 20 28 69 6e 74 <dd>Number (int
1280: 65 67 65 72 29 20 6f 66 20 69 74 65 72 61 74 69 eger) of iterati
1290: 6f 6e 73 20 6f 6e 20 74 68 65 20 70 61 73 73 77 ons on the passw
12a0: 6f 72 64 20 74 6f 20 75 73 65 20 69 6e 20 64 65 ord to use in de
12b0: 72 69 76 69 6e 67 20 74 68 65 0a 20 20 20 20 65 riving the. e
12c0: 6e 63 72 79 70 74 69 6f 6e 20 6b 65 79 2e 20 44 ncryption key. D
12d0: 65 66 61 75 6c 74 20 69 73 20 31 30 30 30 30 2e efault is 10000.
12e0: 20 53 6f 6d 65 20 4b 44 46 20 69 6d 70 6c 65 6d Some KDF implem
12f0: 65 6e 74 61 74 69 6f 6e 73 20 72 65 71 75 69 72 entations requir
1300: 65 20 61 6e 0a 20 20 20 20 69 74 65 72 61 74 69 e an. iterati
1310: 6f 6e 20 63 6f 75 6e 74 2e 3c 2f 64 64 3e 0a 3c on count.</dd>.<
1320: 2f 64 6c 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 20 3c /dl>..<dl>. <
1330: 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 2d 69 76 22 dt><a name="-iv"
1340: 3e 3c 73 74 72 6f 6e 67 3e 2d 69 76 3c 2f 73 74 ><strong>-iv</st
1350: 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 rong> <em>string
1360: 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 </em></a></dt>.
1370: 20 20 20 3c 64 64 3e 49 6e 69 74 69 61 6c 69 7a <dd>Initializ
1380: 61 74 69 6f 6e 20 76 65 63 74 6f 72 20 28 49 56 ation vector (IV
1390: 29 20 74 6f 20 75 73 65 2e 20 52 65 71 75 69 72 ) to use. Requir
13a0: 65 64 20 66 6f 72 20 73 6f 6d 65 20 63 69 70 68 ed for some ciph
13b0: 65 72 73 20 61 6e 64 20 47 4d 41 43 2e 0a 20 20 ers and GMAC..
13c0: 20 20 43 69 70 68 65 72 20 6d 6f 64 65 73 20 43 Cipher modes C
13d0: 42 43 2c 20 43 46 42 2c 20 4f 46 42 20 61 6e 64 BC, CFB, OFB and
13e0: 20 43 54 52 20 61 6c 6c 20 6e 65 65 64 20 61 6e CTR all need an
13f0: 20 49 56 20 77 68 69 6c 65 20 45 43 42 20 6d 6f IV while ECB mo
1400: 64 65 20 64 6f 65 73 20 6e 6f 74 2e 0a 20 20 20 de does not..
1410: 20 41 20 6e 65 77 2c 20 72 61 6e 64 6f 6d 20 49 A new, random I
1420: 56 20 73 68 6f 75 6c 64 20 62 65 20 63 72 65 61 V should be crea
1430: 74 65 64 20 66 6f 72 20 65 61 63 68 20 75 73 65 ted for each use
1440: 2e 20 54 68 69 6e 6b 20 6f 66 20 74 68 65 20 49 . Think of the I
1450: 56 20 61 73 20 61 20 6e 6f 6e 63 65 0a 20 20 20 V as a nonce.
1460: 20 28 6e 75 6d 62 65 72 20 75 73 65 64 20 6f 6e (number used on
1470: 63 65 29 2c 20 69 74 27 73 20 70 75 62 6c 69 63 ce), it's public
1480: 20 62 75 74 20 72 61 6e 64 6f 6d 20 61 6e 64 20 but random and
1490: 75 6e 70 72 65 64 69 63 74 61 62 6c 65 2e 20 53 unpredictable. S
14a0: 65 65 20 74 68 65 0a 20 20 20 3c 61 20 68 72 65 ee the. <a hre
14b0: 66 3d 22 23 74 6c 73 3a 3a 63 69 70 68 65 72 22 f="#tls::cipher"
14c0: 3e 3c 62 3e 74 6c 73 3a 3a 63 69 70 68 65 72 3c ><b>tls::cipher<
14d0: 2f 62 3e 3c 2f 61 3e 20 66 6f 72 20 69 76 5f 6c /b></a> for iv_l
14e0: 65 6e 67 74 68 20 61 6e 64 0a 20 20 20 20 77 68 ength and. wh
14f0: 65 6e 20 72 65 71 75 69 72 65 64 20 28 6c 65 6e en required (len
1500: 67 74 68 20 3e 20 30 29 2e 20 49 66 20 6e 6f 74 gth > 0). If not
1510: 20 73 65 74 2c 20 69 74 20 77 69 6c 6c 20 64 65 set, it will de
1520: 66 61 75 6c 74 20 74 6f 20 5c 78 30 30 20 66 69 fault to \x00 fi
1530: 6c 6c 20 64 61 74 61 2e 3c 2f 64 64 3e 0a 3c 2f ll data.</dd>.</
1540: 64 6c 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 dl>..<dl>. <d
1550: 74 3e 3c 61 20 6e 61 6d 65 3d 22 2d 6b 65 79 22 t><a name="-key"
1560: 3e 3c 73 74 72 6f 6e 67 3e 2d 6b 65 79 3c 2f 73 ><strong>-key</s
1570: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 6e trong> <em>strin
1580: 67 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a g</em></a></dt>.
1590: 20 20 20 20 3c 64 64 3e 45 6e 63 72 79 70 74 69 <dd>Encrypti
15a0: 6f 6e 20 6b 65 79 20 74 6f 20 75 73 65 20 66 6f on key to use fo
15b0: 72 20 63 72 79 70 74 6f 67 72 61 70 68 79 20 66 r cryptography f
15c0: 75 6e 63 74 69 6f 6e 2e 20 43 61 6e 20 62 65 20 unction. Can be
15d0: 61 20 62 69 6e 61 72 79 20 6f 72 0a 20 20 20 20 a binary or.
15e0: 74 65 78 74 20 73 74 72 69 6e 67 2e 20 4c 6f 6e text string. Lon
15f0: 67 65 72 20 6b 65 79 73 20 70 72 6f 76 69 64 65 ger keys provide
1600: 20 62 65 74 74 65 72 20 70 72 6f 74 65 63 74 69 better protecti
1610: 6f 6e 2e 20 55 73 65 64 20 62 79 20 63 69 70 68 on. Used by ciph
1620: 65 72 73 2c 20 48 4d 41 43 2c 0a 20 20 20 20 73 ers, HMAC,. s
1630: 6f 6d 65 20 43 4d 41 43 2c 20 61 6e 64 20 73 6f ome CMAC, and so
1640: 6d 65 20 4b 44 46 20 69 6d 70 6c 65 6d 65 6e 74 me KDF implement
1650: 61 74 69 6f 6e 73 2e 20 49 66 20 74 68 65 20 6c ations. If the l
1660: 65 6e 67 74 68 20 6f 66 20 74 68 65 20 6b 65 79 ength of the key
1670: 20 69 73 20 26 6c 74 3b 0a 20 20 20 20 3c 62 3e is <. <b>
1680: 6b 65 79 5f 6c 65 6e 67 74 68 3c 2f 62 3e 20 69 key_length</b> i
1690: 74 20 77 69 6c 6c 20 62 65 20 70 61 64 64 65 64 t will be padded
16a0: 2e 20 49 66 20 26 67 74 3b 20 6b 65 79 5f 6c 65 . If > key_le
16b0: 6e 67 74 68 2c 20 69 74 20 77 69 6c 6c 20 62 65 ngth, it will be
16c0: 20 72 65 6a 65 63 74 65 64 2e 0a 20 20 20 20 53 rejected.. S
16d0: 65 65 20 74 68 65 20 3c 61 20 68 72 65 66 3d 22 ee the <a href="
16e0: 23 74 6c 73 3a 3a 63 69 70 68 65 72 22 3e 3c 62 #tls::cipher"><b
16f0: 3e 74 6c 73 3a 3a 63 69 70 68 65 72 3c 2f 62 3e >tls::cipher</b>
1700: 3c 2f 61 3e 20 66 6f 72 20 6b 65 79 5f 6c 65 6e </a> for key_len
1710: 67 74 68 2e 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a gth.</dd>.</dl>.
1720: 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 .<dl>. <dt><a
1730: 20 6e 61 6d 65 3d 22 2d 6d 61 63 22 3e 3c 73 74 name="-mac"><st
1740: 72 6f 6e 67 3e 2d 6d 61 63 3c 2f 73 74 72 6f 6e rong>-mac</stron
1750: 67 3e 20 3c 65 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e g> <em>name</em>
1760: 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 </a></dt>. <d
1770: 64 3e 4e 61 6d 65 20 6f 66 20 4d 65 73 73 61 67 d>Name of Messag
1780: 65 20 41 75 74 68 65 6e 74 69 63 61 74 69 6f 6e e Authentication
1790: 20 43 6f 64 65 20 28 4d 41 43 29 20 74 6f 20 75 Code (MAC) to u
17a0: 73 65 2e 0a 20 20 20 20 53 65 65 20 3c 61 20 68 se.. See <a h
17b0: 72 65 66 3d 22 23 74 6c 73 3a 3a 6d 61 63 22 3e ref="#tls::mac">
17c0: 3c 62 3e 74 6c 73 3a 3a 6d 61 63 73 3c 2f 62 3e <b>tls::macs</b>
17d0: 3c 2f 61 3e 20 66 6f 72 20 74 68 65 20 76 61 6c </a> for the val
17e0: 69 64 20 76 61 6c 75 65 73 2e 3c 2f 64 64 3e 0a id values.</dd>.
17f0: 3c 2f 64 6c 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 20 </dl>..<dl>.
1800: 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 2d 70 61 <dt><a name="-pa
1810: 73 73 77 6f 72 64 22 3e 3c 73 74 72 6f 6e 67 3e ssword"><strong>
1820: 2d 70 61 73 73 77 6f 72 64 3c 2f 73 74 72 6f 6e -password</stron
1830: 67 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 3c 2f 65 g> <em>string</e
1840: 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 m></a></dt>.
1850: 3c 64 64 3e 50 61 73 73 77 6f 72 64 20 74 6f 20 <dd>Password to
1860: 75 73 65 20 66 6f 72 20 73 6f 6d 65 20 4b 44 46 use for some KDF
1870: 20 66 75 6e 63 74 69 6f 6e 73 2e 3c 2f 64 64 3e functions.</dd>
1880: 0a 3c 2f 64 6c 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 .</dl>..<dl>.
1890: 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 2d 70 <dt><a name="-p
18a0: 72 6f 70 65 72 74 69 65 73 22 3e 3c 73 74 72 6f roperties"><stro
18b0: 6e 67 3e 2d 70 72 6f 70 65 72 74 69 65 73 3c 2f ng>-properties</
18c0: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6c 69 73 74 strong> <em>list
18d0: 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 </em></a></dt>.
18e0: 20 20 20 3c 64 64 3e 4c 69 73 74 20 6f 66 20 61 <dd>List of a
18f0: 64 64 69 74 69 6f 6e 61 6c 20 70 72 6f 70 65 72 dditional proper
1900: 74 69 65 73 20 74 6f 20 70 61 73 73 20 74 6f 20 ties to pass to
1910: 63 72 79 70 74 6f 67 72 61 70 68 79 20 66 75 6e cryptography fun
1920: 63 74 69 6f 6e 2e 3c 2f 64 64 3e 0a 3c 2f 64 6c ction.</dd>.</dl
1930: 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 74 3e >..<dl>. <dt>
1940: 3c 61 20 6e 61 6d 65 3d 22 2d 73 61 6c 74 22 3e <a name="-salt">
1950: 3c 73 74 72 6f 6e 67 3e 2d 73 61 6c 74 3c 2f 73 <strong>-salt</s
1960: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 6e trong> <em>strin
1970: 67 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a g</em></a></dt>.
1980: 20 20 20 20 3c 64 64 3e 53 70 65 63 69 66 69 65 <dd>Specifie
1990: 73 20 73 61 6c 74 20 76 61 6c 75 65 20 74 6f 20 s salt value to
19a0: 75 73 65 20 77 68 65 6e 20 65 6e 63 72 79 70 74 use when encrypt
19b0: 69 6e 67 20 64 61 74 61 2e 20 44 65 66 61 75 6c ing data. Defaul
19c0: 74 20 69 73 20 74 6f 20 75 73 65 20 61 0a 20 20 t is to use a.
19d0: 20 20 72 61 6e 64 6f 6d 6c 79 20 67 65 6e 65 72 randomly gener
19e0: 61 74 65 64 20 76 61 6c 75 65 2e 20 54 68 69 73 ated value. This
19f0: 20 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64 20 option is used
1a00: 62 79 20 42 4c 41 4b 45 32 20 4d 41 43 20 61 6e by BLAKE2 MAC an
1a10: 64 20 73 6f 6d 65 20 4b 44 46 0a 20 20 20 20 69 d some KDF. i
1a20: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 75 mplementations u
1a30: 73 65 20 61 20 6e 6f 6e 2d 73 65 63 72 65 74 20 se a non-secret
1a40: 75 6e 69 71 75 65 20 63 72 79 70 74 6f 67 72 61 unique cryptogra
1a50: 70 68 69 63 20 73 61 6c 74 2e 3c 2f 64 64 3e 0a phic salt.</dd>.
1a60: 3c 2f 64 6c 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 20 </dl>..<dl>.
1a70: 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 2d 73 69 <dt><a name="-si
1a80: 7a 65 22 3e 3c 73 74 72 6f 6e 67 3e 2d 73 69 7a ze"><strong>-siz
1a90: 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6e e</strong> <em>n
1aa0: 75 6d 62 65 72 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f umber</em></a></
1ab0: 64 74 3e 0a 20 20 20 20 3c 64 64 3e 53 65 74 20 dt>. <dd>Set
1ac0: 74 68 65 20 6f 75 74 70 75 74 20 68 61 73 68 20 the output hash
1ad0: 73 69 7a 65 20 69 6e 20 62 79 74 65 73 2e 20 55 size in bytes. U
1ae0: 73 65 64 20 62 79 20 4b 4d 41 43 31 32 38 20 6f sed by KMAC128 o
1af0: 72 20 4b 4d 41 43 32 35 36 20 74 6f 20 73 70 65 r KMAC256 to spe
1b00: 63 69 66 79 0a 20 20 20 20 61 6e 20 6f 75 74 70 cify. an outp
1b10: 75 74 20 6c 65 6e 67 74 68 2e 20 54 68 65 20 64 ut length. The d
1b20: 65 66 61 75 6c 74 20 73 69 7a 65 73 20 61 72 65 efault sizes are
1b30: 20 33 32 20 6f 72 20 36 34 20 62 79 74 65 73 20 32 or 64 bytes
1b40: 72 65 73 70 65 63 74 69 76 65 6c 79 2e 3c 2f 64 respectively.</d
1b50: 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 64 6c 3e 0a 20 d>.</dl>..<dl>.
1b60: 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 <dt><a name="
1b70: 2d 78 6f 66 22 3e 3c 73 74 72 6f 6e 67 3e 2d 78 -xof"><strong>-x
1b80: 6f 66 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e of</strong> <em>
1b90: 62 6f 6f 6c 65 61 6e 3c 2f 65 6d 3e 3c 2f 61 3e boolean</em></a>
1ba0: 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 53 65 </dt>. <dd>Se
1bb0: 74 20 77 68 65 74 68 65 72 20 74 6f 20 75 73 65 t whether to use
1bc0: 20 58 4f 46 2e 20 54 68 69 73 20 6f 70 74 69 6f XOF. This optio
1bd0: 6e 20 69 73 20 75 73 65 64 20 62 79 20 4b 4d 41 n is used by KMA
1be0: 43 2e 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c C.</dd>.</dl>..<
1bf0: 62 72 3e 0a 3c 68 34 3e 49 6e 70 75 74 2f 4f 75 br>.<h4>Input/Ou
1c00: 74 70 75 74 20 4f 70 74 69 6f 6e 73 3c 2f 68 34 tput Options</h4
1c10: 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 74 3e >..<dl>. <dt>
1c20: 3c 61 20 6e 61 6d 65 3d 22 2d 63 68 61 6e 22 3e <a name="-chan">
1c30: 3c 73 74 72 6f 6e 67 3e 2d 63 68 61 6e 3c 2f 73 <strong>-chan</s
1c40: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 63 68 61 6e 6e trong> <em>chann
1c50: 65 6c 49 64 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 elId</em></a></d
1c60: 74 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 t>. <dt><a na
1c70: 6d 65 3d 22 2d 63 68 61 6e 22 3e 3c 73 74 72 6f me="-chan"><stro
1c80: 6e 67 3e 2d 63 68 61 6e 6e 65 6c 3c 2f 73 74 72 ng>-channel</str
1c90: 6f 6e 67 3e 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c ong> <em>channel
1ca0: 49 64 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e Id</em></a></dt>
1cb0: 0a 20 20 20 20 3c 64 64 3e 41 64 64 20 74 68 65 . <dd>Add the
1cc0: 20 63 72 79 70 74 6f 67 72 61 70 68 69 63 20 74 cryptographic t
1cd0: 72 61 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e ransformation on
1ce0: 20 74 6f 70 20 6f 66 20 63 68 61 6e 6e 65 6c 0a top of channel.
1cf0: 09 3c 65 6d 3e 63 68 61 6e 6e 65 6c 49 64 3c 2f .<em>channelId</
1d00: 65 6d 3e 2e 20 41 75 74 6f 6d 61 74 69 63 61 6c em>. Automatical
1d10: 6c 79 20 73 65 74 73 20 63 68 61 6e 6e 65 6c 20 ly sets channel
1d20: 74 6f 20 62 69 6e 61 72 79 20 6d 6f 64 65 2e 20 to binary mode.
1d30: 57 6f 72 6b 73 0a 09 6c 69 6b 65 20 3c 62 3e 63 Works..like <b>c
1d40: 68 61 6e 20 70 75 73 68 3c 2f 62 3e 20 74 6f 20 han push</b> to
1d50: 63 72 65 61 74 65 20 61 20 73 74 61 63 6b 65 64 create a stacked
1d60: 20 63 68 61 6e 6e 65 6c 2e 20 49 66 20 74 68 65 channel. If the
1d70: 20 63 6f 6d 6d 61 6e 64 0a 09 3c 62 3e 66 69 6c command..<b>fil
1d80: 65 65 76 65 6e 74 3c 2f 62 3e 20 69 73 20 74 6f eevent</b> is to
1d90: 20 62 65 20 75 73 65 64 20 66 6f 72 20 63 68 61 be used for cha
1da0: 6e 6e 65 6c 20 65 76 65 6e 74 20 6d 6f 6e 69 74 nnel event monit
1db0: 6f 72 69 6e 67 2c 20 61 6c 6c 0a 09 63 68 61 6e oring, all..chan
1dc0: 6e 65 6c 73 20 69 6e 20 74 68 65 20 73 74 61 63 nels in the stac
1dd0: 6b 20 73 68 6f 75 6c 64 20 62 65 20 73 65 74 20 k should be set
1de0: 74 6f 20 6e 6f 6e 2d 62 6c 6f 63 6b 69 6e 67 20 to non-blocking
1df0: 6d 6f 64 65 2e 20 49 66 20 6e 6f 74 2c 0a 09 74 mode. If not,..t
1e00: 68 65 20 73 79 73 74 65 6d 20 6d 61 79 20 68 61 he system may ha
1e10: 6e 67 20 77 68 69 6c 65 20 77 61 69 74 69 6e 67 ng while waiting
1e20: 20 66 6f 72 20 64 61 74 61 2e 20 57 68 65 6e 20 for data. When
1e30: 64 6f 6e 65 2c 20 75 73 65 20 65 69 74 68 65 72 done, use either
1e40: 20 74 68 65 0a 09 63 6c 6f 73 65 20 63 6f 6d 6d the..close comm
1e50: 61 6e 64 20 6f 72 20 3c 61 20 68 72 65 66 3d 22 and or <a href="
1e60: 23 74 6c 73 3a 3a 75 6e 73 74 61 63 6b 22 3e 3c #tls::unstack"><
1e70: 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 75 6e 73 74 strong>tls::unst
1e80: 61 63 6b 3c 2f 73 74 72 6f 6e 67 3e 3c 2f 61 3e ack</strong></a>
1e90: 0a 09 74 6f 20 72 65 6d 6f 76 65 20 74 68 65 20 ..to remove the
1ea0: 74 72 61 6e 73 66 6f 72 6d 20 66 72 6f 6d 20 74 transform from t
1eb0: 68 65 20 63 68 61 6e 6e 65 6c 2e 20 41 64 64 69 he channel. Addi
1ec0: 74 69 6f 6e 61 6c 20 74 72 61 6e 73 66 6f 72 6d tional transform
1ed0: 73 20 63 61 6e 6e 6f 74 0a 09 62 65 20 61 64 64 s cannot..be add
1ee0: 65 64 20 74 6f 20 63 68 61 6e 6e 65 6c 2e 20 45 ed to channel. E
1ef0: 78 61 6d 70 6c 65 20 63 6f 64 65 3a 3c 2f 64 64 xample code:</dd
1f00: 3e 3c 2f 64 6c 3e 0a 20 20 20 20 3c 62 6c 6f 63 ></dl>. <bloc
1f10: 6b 71 75 6f 74 65 3e 3c 63 6f 64 65 3e 0a 09 09 kquote><code>...
1f20: 73 65 74 20 63 68 20 5b 6f 70 65 6e 20 74 65 73 set ch [open tes
1f30: 74 5f 66 69 6c 65 2e 74 78 74 20 72 62 5d 3c 62 t_file.txt rb]<b
1f40: 72 3e 0a 09 09 3a 3a 74 6c 73 3a 3a 64 69 67 65 r>...::tls::dige
1f50: 73 74 20 2d 64 69 67 65 73 74 20 73 68 61 32 35 st -digest sha25
1f60: 36 20 2d 63 68 61 6e 20 24 63 68 3c 62 72 3e 0a 6 -chan $ch<br>.
1f70: 09 09 73 65 74 20 64 61 74 20 22 22 3c 62 72 3e ..set dat ""<br>
1f80: 0a 09 09 77 68 69 6c 65 20 7b 21 5b 65 6f 66 20 ...while {![eof
1f90: 24 63 68 5d 7d 20 7b 61 70 70 65 6e 64 20 64 61 $ch]} {append da
1fa0: 74 20 5b 72 65 61 64 20 24 63 68 20 34 30 39 36 t [read $ch 4096
1fb0: 5d 7d 3c 62 72 3e 0a 09 09 63 6c 6f 73 65 20 24 ]}<br>...close $
1fc0: 63 68 3c 62 72 3e 0a 09 09 70 75 74 73 20 24 64 ch<br>...puts $d
1fd0: 61 74 0a 20 20 20 20 3c 2f 63 6f 64 65 3e 3c 2f at. </code></
1fe0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 64 6c blockquote>..<dl
1ff0: 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d >. <dt><a nam
2000: 65 3d 22 2d 63 6f 6d 6d 61 6e 64 22 3e 3c 73 74 e="-command"><st
2010: 72 6f 6e 67 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f 73 rong>-command</s
2020: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 63 6d 64 4e 61 trong> <em>cmdNa
2030: 6d 65 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e me</em></a></dt>
2040: 0a 20 20 20 20 3c 64 64 3e 43 72 65 61 74 65 20 . <dd>Create
2050: 61 6e 64 20 72 65 74 75 72 6e 20 3c 65 6d 3e 63 and return <em>c
2060: 6d 64 4e 61 6d 65 3c 2f 65 6d 3e 20 77 68 69 63 mdName</em> whic
2070: 68 20 69 73 20 75 73 65 64 20 74 6f 20 69 6e 63 h is used to inc
2080: 72 65 6d 65 6e 74 61 6c 6c 79 20 61 64 64 0a 09 rementally add..
2090: 64 61 74 61 20 74 6f 20 61 20 63 72 79 70 74 6f data to a crypto
20a0: 67 72 61 70 68 69 63 20 66 75 6e 63 74 69 6f 6e graphic function
20b0: 2e 20 54 6f 20 61 64 64 20 64 61 74 61 20 74 6f . To add data to
20c0: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 2c 20 63 the function, c
20d0: 61 6c 6c 0a 09 26 71 75 6f 74 3b 3c 65 6d 3e 63 all.."<em>c
20e0: 6d 64 4e 61 6d 65 3c 2f 65 6d 3e 20 3c 62 3e 75 mdName</em> <b>u
20f0: 70 64 61 74 65 3c 2f 62 3e 20 3c 65 6d 3e 64 61 pdate</b> <em>da
2100: 74 61 3c 2f 65 6d 3e 26 71 75 6f 74 3b 2c 20 77 ta</em>", w
2110: 68 65 72 65 0a 09 3c 65 6d 3e 64 61 74 61 3c 2f here..<em>data</
2120: 65 6d 3e 20 69 73 20 74 68 65 20 64 61 74 61 20 em> is the data
2130: 74 6f 20 61 64 64 2e 20 57 68 65 6e 20 64 6f 6e to add. When don
2140: 65 2c 20 63 61 6c 6c 0a 09 26 71 75 6f 74 3b 3c e, call.."<
2150: 65 6d 3e 63 6d 64 4e 61 6d 65 3c 2f 65 6d 3e 20 em>cmdName</em>
2160: 3c 62 3e 66 69 6e 61 6c 69 7a 65 3c 2f 62 3e 26 <b>finalize</b>&
2170: 71 75 6f 74 3b 20 74 6f 20 72 65 74 75 72 6e 20 quot; to return
2180: 74 68 65 20 72 65 73 75 6c 74 69 6e 67 0a 09 76 the resulting..v
2190: 61 6c 75 65 20 61 6e 64 20 64 65 6c 65 74 65 20 alue and delete
21a0: 3c 65 6d 3e 63 6d 64 4e 61 6d 65 3c 2f 65 6d 3e <em>cmdName</em>
21b0: 2e 20 45 78 61 6d 70 6c 65 20 63 6f 64 65 3a 3c . Example code:<
21c0: 2f 64 64 3e 3c 2f 64 6c 3e 0a 20 20 20 20 3c 62 /dd></dl>. <b
21d0: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 63 6f 64 65 3e lockquote><code>
21e0: 0a 09 09 73 65 74 20 63 6d 64 20 5b 3a 3a 74 6c ...set cmd [::tl
21f0: 73 3a 3a 64 69 67 65 73 74 20 2d 64 69 67 65 73 s::digest -diges
2200: 74 20 73 68 61 32 35 36 20 2d 63 6f 6d 6d 61 6e t sha256 -comman
2210: 64 20 3a 3a 74 6c 73 3a 3a 74 65 6d 70 5d 3c 62 d ::tls::temp]<b
2220: 72 3e 0a 09 09 73 65 74 20 64 61 74 20 22 22 3c r>...set dat ""<
2230: 62 72 3e 0a 09 09 61 70 70 65 6e 64 20 64 61 74 br>...append dat
2240: 20 5b 24 63 6d 64 20 75 70 64 61 74 65 20 22 53 [$cmd update "S
2250: 6f 6d 65 20 64 61 74 61 2e 20 22 5d 3c 62 72 3e ome data. "]<br>
2260: 0a 09 09 61 70 70 65 6e 64 20 64 61 74 20 5b 24 ...append dat [$
2270: 63 6d 64 20 75 70 64 61 74 65 20 22 4d 6f 72 65 cmd update "More
2280: 20 64 61 74 61 2e 22 5d 3c 62 72 3e 0a 09 09 61 data."]<br>...a
2290: 70 70 65 6e 64 20 64 61 74 20 5b 24 63 6d 64 20 ppend dat [$cmd
22a0: 66 69 6e 61 6c 69 7a 65 5d 3c 62 72 3e 0a 09 09 finalize]<br>...
22b0: 70 75 74 73 20 24 64 61 74 0a 20 20 20 20 3c 2f puts $dat. </
22c0: 63 6f 64 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 code></blockquot
22d0: 65 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 74 e>..<dl>. <dt
22e0: 3e 3c 61 20 6e 61 6d 65 3d 22 2d 64 61 74 61 22 ><a name="-data"
22f0: 3e 3c 73 74 72 6f 6e 67 3e 2d 64 61 74 61 3c 2f ><strong>-data</
2300: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 strong> <em>stri
2310: 6e 67 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e ng</em></a></dt>
2320: 0a 20 20 20 20 3c 64 64 3e 50 65 72 66 6f 72 6d . <dd>Perform
2330: 20 74 68 65 20 63 72 79 70 74 6f 67 72 61 70 68 the cryptograph
2340: 69 63 20 66 75 6e 63 74 69 6f 6e 20 6f 6e 20 3c ic function on <
2350: 65 6d 3e 64 61 74 61 3c 2f 65 6d 3e 20 61 6e 64 em>data</em> and
2360: 20 72 65 74 75 72 6e 20 74 68 65 0a 20 20 20 20 return the.
2370: 72 65 73 75 6c 74 2e 20 45 78 61 6d 70 6c 65 20 result. Example
2380: 63 6f 64 65 3a 3c 2f 64 64 3e 3c 2f 64 6c 3e 0a code:</dd></dl>.
2390: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e <blockquote>
23a0: 3c 63 6f 64 65 3e 0a 09 09 73 65 74 20 6d 64 20 <code>...set md
23b0: 5b 3a 3a 74 6c 73 3a 3a 64 69 67 65 73 74 20 73 [::tls::digest s
23c0: 68 61 32 35 36 20 22 53 6f 6d 65 20 65 78 61 6d ha256 "Some exam
23d0: 70 6c 65 20 64 61 74 61 2e 22 5d 3c 62 72 3e 0a ple data."]<br>.
23e0: 09 09 70 75 74 73 20 24 6d 64 0a 20 20 20 20 3c ..puts $md. <
23f0: 2f 63 6f 64 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f /code></blockquo
2400: 74 65 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 te>..<dl>. <d
2410: 74 3e 3c 61 20 6e 61 6d 65 3d 22 2d 66 69 6c 65 t><a name="-file
2420: 22 3e 3c 73 74 72 6f 6e 67 3e 2d 66 69 6c 65 3c "><strong>-file<
2430: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 66 69 6c /strong> <em>fil
2440: 65 6e 61 6d 65 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f ename</em></a></
2450: 64 74 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e dt>. <dt><a n
2460: 61 6d 65 3d 22 2d 66 69 6c 65 22 3e 3c 73 74 72 ame="-file"><str
2470: 6f 6e 67 3e 2d 66 69 6c 65 6e 61 6d 65 3c 2f 73 ong>-filename</s
2480: 74 72 6f 6e 67 3e 20 3c 65 6d 3e 66 69 6c 65 6e trong> <em>filen
2490: 61 6d 65 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 ame</em></a></dt
24a0: 3e 0a 20 20 20 20 3c 64 64 3e 50 65 72 66 6f 72 >. <dd>Perfor
24b0: 6d 20 74 68 65 20 63 72 79 70 74 6f 67 72 61 70 m the cryptograp
24c0: 68 69 63 20 66 75 6e 63 74 69 6f 6e 20 6f 6e 20 hic function on
24d0: 66 69 6c 65 20 3c 65 6d 3e 66 69 6c 65 6e 61 6d file <em>filenam
24e0: 65 3c 2f 65 6d 3e 20 61 6e 64 20 72 65 74 75 72 e</em> and retur
24f0: 6e 0a 20 20 20 20 74 68 65 20 72 65 73 75 6c 74 n. the result
2500: 2e 20 54 68 69 73 20 6f 70 65 72 61 74 69 6f 6e . This operation
2510: 20 77 69 6c 6c 20 6f 70 65 6e 20 66 69 6c 65 2c will open file,
2520: 20 72 65 61 64 20 74 68 65 20 66 69 6c 65 20 64 read the file d
2530: 61 74 61 2c 20 63 6c 6f 73 65 20 74 68 65 0a 20 ata, close the.
2540: 20 20 20 66 69 6c 65 2c 20 61 6e 64 20 72 65 74 file, and ret
2550: 75 72 6e 20 74 68 65 20 72 65 73 75 6c 74 20 75 urn the result u
2560: 73 69 6e 67 20 74 68 65 20 54 43 4c 20 66 69 6c sing the TCL fil
2570: 65 20 41 50 49 73 2c 20 73 6f 20 56 46 53 20 66 e APIs, so VFS f
2580: 69 6c 65 73 20 61 72 65 0a 20 20 20 20 73 75 70 iles are. sup
2590: 70 6f 72 74 65 64 2e 20 45 78 61 6d 70 6c 65 20 ported. Example
25a0: 63 6f 64 65 3a 3c 2f 64 64 3e 3c 2f 64 6c 3e 0a code:</dd></dl>.
25b0: 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e <blockquote>
25c0: 3c 63 6f 64 65 3e 0a 09 09 73 65 74 20 6d 64 20 <code>...set md
25d0: 5b 3a 3a 74 6c 73 3a 3a 64 69 67 65 73 74 20 2d [::tls::digest -
25e0: 64 69 67 65 73 74 20 73 68 61 32 35 36 20 2d 66 digest sha256 -f
25f0: 69 6c 65 20 74 65 73 74 5f 66 69 6c 65 2e 74 78 ile test_file.tx
2600: 74 5d 3c 62 72 3e 0a 09 09 70 75 74 73 20 24 6d t]<br>...puts $m
2610: 64 0a 20 20 20 20 3c 2f 63 6f 64 65 3e 3c 2f 62 d. </code></b
2620: 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 64 6c 3e lockquote>..<dl>
2630: 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 . <dt><a name
2640: 3d 22 2d 69 6e 66 69 6c 65 22 3e 3c 73 74 72 6f ="-infile"><stro
2650: 6e 67 3e 2d 69 6e 66 69 6c 65 3c 2f 73 74 72 6f ng>-infile</stro
2660: 6e 67 3e 20 3c 65 6d 3e 66 69 6c 65 6e 61 6d 65 ng> <em>filename
2670: 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 </em></a></dt>.
2680: 20 20 20 3c 64 64 3e 53 70 65 63 69 66 69 65 73 <dd>Specifies
2690: 20 74 68 65 20 66 69 6c 65 20 74 6f 20 75 73 65 the file to use
26a0: 20 61 73 20 64 61 74 61 20 69 6e 70 75 74 20 73 as data input s
26b0: 6f 75 72 63 65 2e 20 54 68 69 73 20 6f 70 74 69 ource. This opti
26c0: 6f 6e 20 75 73 65 73 20 74 68 65 0a 20 20 20 20 on uses the.
26d0: 54 43 4c 20 66 69 6c 65 20 41 50 49 73 2c 20 73 TCL file APIs, s
26e0: 6f 20 56 46 53 20 66 69 6c 65 73 20 61 72 65 20 o VFS files are
26f0: 73 75 70 70 6f 72 74 65 64 2e 20 45 78 61 6d 70 supported. Examp
2700: 6c 65 20 63 6f 64 65 3a 3c 2f 64 64 3e 3c 2f 64 le code:</dd></d
2710: 6c 3e 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f l>. <blockquo
2720: 74 65 3e 3c 63 6f 64 65 3e 0a 09 09 3a 3a 74 6c te><code>...::tl
2730: 73 3a 3a 65 6e 63 72 79 70 74 20 2d 63 69 70 68 s::encrypt -ciph
2740: 65 72 20 61 65 73 2d 31 32 38 2d 63 62 63 20 2d er aes-128-cbc -
2750: 6b 65 79 20 22 54 65 73 74 20 6b 65 79 22 0a 09 key "Test key"..
2760: 09 2d 69 6e 66 69 6c 65 20 75 6e 65 6e 63 72 79 .-infile unencry
2770: 70 74 65 64 2e 74 78 74 20 2d 6f 75 74 66 69 6c pted.txt -outfil
2780: 65 20 65 6e 63 72 79 70 74 65 64 2e 64 61 74 0a e encrypted.dat.
2790: 20 20 20 20 3c 2f 63 6f 64 65 3e 3c 2f 62 6c 6f </code></blo
27a0: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 64 6c 3e 0a 20 ckquote>..<dl>.
27b0: 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 <dt><a name="
27c0: 2d 6f 75 74 66 69 6c 65 22 3e 3c 73 74 72 6f 6e -outfile"><stron
27d0: 67 3e 2d 6f 75 74 66 69 6c 65 3c 2f 73 74 72 6f g>-outfile</stro
27e0: 6e 67 3e 20 3c 65 6d 3e 66 69 6c 65 6e 61 6d 65 ng> <em>filename
27f0: 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 </em></a></dt>.
2800: 20 20 20 3c 64 64 3e 53 70 65 63 69 66 69 65 73 <dd>Specifies
2810: 20 74 68 65 20 66 69 6c 65 20 74 6f 20 6f 75 74 the file to out
2820: 70 75 74 20 74 68 65 20 65 6e 63 72 79 70 74 69 put the encrypti
2830: 6f 6e 20 72 65 73 75 6c 74 73 20 74 6f 2e 20 54 on results to. T
2840: 68 69 73 20 6f 70 74 69 6f 6e 0a 20 20 20 20 75 his option. u
2850: 73 65 73 20 74 68 65 20 54 43 4c 20 66 69 6c 65 ses the TCL file
2860: 20 41 50 49 73 2c 20 73 6f 20 56 46 53 20 66 69 APIs, so VFS fi
2870: 6c 65 73 20 61 72 65 20 73 75 70 70 6f 72 74 65 les are supporte
2880: 64 2e 20 45 78 61 6d 70 6c 65 20 63 6f 64 65 3a d. Example code:
2890: 3c 2f 64 64 3e 3c 2f 64 6c 3e 0a 20 20 20 20 3c </dd></dl>. <
28a0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 63 6f 64 65 blockquote><code
28b0: 3e 0a 09 09 3a 3a 74 6c 73 3a 3a 64 65 63 72 79 >...::tls::decry
28c0: 70 74 20 2d 63 69 70 68 65 72 20 61 65 73 2d 31 pt -cipher aes-1
28d0: 32 38 2d 63 62 63 20 2d 6b 65 79 20 22 54 65 73 28-cbc -key "Tes
28e0: 74 20 6b 65 79 22 0a 09 09 2d 69 6e 66 69 6c 65 t key"...-infile
28f0: 20 65 6e 63 72 79 70 74 65 64 2e 64 61 74 20 2d encrypted.dat -
2900: 6f 75 74 66 69 6c 65 20 75 6e 65 6e 63 72 79 70 outfile unencryp
2910: 74 65 64 2e 74 78 74 0a 20 20 20 20 3c 2f 63 6f ted.txt. </co
2920: 64 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e de></blockquote>
2930: 0a 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c ..<dl>. <dt><
2940: 61 20 6e 61 6d 65 3d 22 2d 6b 65 79 66 69 6c 65 a name="-keyfile
2950: 22 3e 3c 73 74 72 6f 6e 67 3e 2d 6b 65 79 66 69 "><strong>-keyfi
2960: 6c 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e le</strong> <em>
2970: 66 69 6c 65 6e 61 6d 65 3c 2f 65 6d 3e 3c 2f 61 filename</em></a
2980: 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 53 ></dt>. <dd>S
2990: 70 65 63 69 66 69 65 73 20 74 68 65 20 66 69 6c pecifies the fil
29a0: 65 20 74 6f 20 67 65 74 20 74 68 65 20 65 6e 63 e to get the enc
29b0: 72 79 70 74 69 6f 6e 20 6b 65 79 20 66 72 6f 6d ryption key from
29c0: 2e 3c 2f 64 64 3e 3c 2f 64 6c 3e 0a 0a 3c 62 72 .</dd></dl>..<br
29d0: 3e 0a 0a 3c 68 34 3e 46 6f 72 6d 61 74 20 4f 70 >..<h4>Format Op
29e0: 74 69 6f 6e 73 3c 2f 68 34 3e 0a 0a 3c 64 6c 3e tions</h4>..<dl>
29f0: 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 . <dt><a name
2a00: 3d 22 2d 62 61 73 65 36 34 22 3e 3c 73 74 72 6f ="-base64"><stro
2a10: 6e 67 3e 2d 62 61 73 65 36 34 3c 2f 73 74 72 6f ng>-base64</stro
2a20: 6e 67 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 ng></a></dt>.
2a30: 20 3c 64 64 3e 42 61 73 65 36 34 20 65 6e 63 6f <dd>Base64 enco
2a40: 64 65 20 64 61 74 61 20 61 66 74 65 72 20 65 6e de data after en
2a50: 63 72 79 70 74 69 6f 6e 20 6f 72 20 64 65 63 6f cryption or deco
2a60: 64 65 20 62 65 66 6f 72 65 20 64 65 63 72 79 70 de before decryp
2a70: 74 69 6f 6e 2e 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e tion.</dd>.</dl>
2a80: 0a 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c ..<dl>. <dt><
2a90: 61 20 6e 61 6d 65 3d 22 2d 62 69 6e 22 3e 3c 73 a name="-bin"><s
2aa0: 74 72 6f 6e 67 3e 2d 62 69 6e 3c 2f 73 74 72 6f trong>-bin</stro
2ab0: 6e 67 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 ng></a></dt>.
2ac0: 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 2d 62 <dt><a name="-b
2ad0: 69 6e 22 3e 3c 73 74 72 6f 6e 67 3e 2d 62 69 6e in"><strong>-bin
2ae0: 61 72 79 3c 2f 73 74 72 6f 6e 67 3e 3c 2f 61 3e ary</strong></a>
2af0: 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 4f 75 </dt>. <dd>Ou
2b00: 74 70 75 74 20 72 65 73 75 6c 74 20 6f 66 20 66 tput result of f
2b10: 75 6e 63 74 69 6f 6e 20 61 73 20 61 20 62 69 6e unction as a bin
2b20: 61 72 79 20 73 74 72 69 6e 67 2e 3c 2f 64 64 3e ary string.</dd>
2b30: 0a 3c 2f 64 6c 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 .</dl>..<dl>.
2b40: 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 2d 68 <dt><a name="-h
2b50: 65 78 22 3e 3c 73 74 72 6f 6e 67 3e 2d 68 65 78 ex"><strong>-hex
2b60: 3c 2f 73 74 72 6f 6e 67 3e 3c 2f 61 3e 3c 2f 64 </strong></a></d
2b70: 74 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 t>. <dt><a na
2b80: 6d 65 3d 22 2d 68 65 78 22 3e 3c 73 74 72 6f 6e me="-hex"><stron
2b90: 67 3e 2d 68 65 78 61 64 65 63 69 6d 61 6c 3c 2f g>-hexadecimal</
2ba0: 73 74 72 6f 6e 67 3e 3c 2f 61 3e 3c 2f 64 74 3e strong></a></dt>
2bb0: 0a 20 20 20 20 3c 64 64 3e 4f 75 74 70 75 74 20 . <dd>Output
2bc0: 72 65 73 75 6c 74 20 6f 66 20 66 75 6e 63 74 69 result of functi
2bd0: 6f 6e 20 61 73 20 61 20 68 65 78 61 64 65 63 69 on as a hexadeci
2be0: 6d 61 6c 20 73 74 72 69 6e 67 2e 20 54 68 69 73 mal string. This
2bf0: 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 0a is the default.
2c00: 09 6f 70 74 69 6f 6e 20 75 6e 6c 65 73 73 20 6f .option unless o
2c10: 74 68 65 72 77 69 73 65 20 73 70 65 63 69 66 69 therwise specifi
2c20: 65 64 2e 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a ed.</dd>.</dl>..
2c30: 3c 62 72 3e 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 <br>.<h3><a name
2c40: 3d 22 43 4f 4d 4d 41 4e 44 53 22 3e 43 4f 4d 4d ="COMMANDS">COMM
2c50: 41 4e 44 53 3c 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c ANDS</a></h3>..<
2c60: 70 3e 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 p>The following
2c70: 63 6f 6d 6d 61 6e 64 73 20 70 72 6f 76 69 64 65 commands provide
2c80: 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 20 4f access to the O
2c90: 70 65 6e 53 53 4c 20 63 72 79 70 74 6f 67 72 61 penSSL cryptogra
2ca0: 70 68 79 20 66 75 6e 63 74 69 6f 6e 73 2e 3c 2f phy functions.</
2cb0: 70 3e 0a 0a 3c 64 6c 3e 0a 0a 3c 68 34 3e 49 6e p>..<dl>..<h4>In
2cc0: 66 6f 20 43 6f 6d 6d 61 6e 64 73 3c 2f 68 34 3e fo Commands</h4>
2cd0: 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d .. <dt><a nam
2ce0: 65 3d 22 74 6c 73 3a 3a 63 69 70 68 65 72 22 3e e="tls::cipher">
2cf0: 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 63 69 70 <strong>tls::cip
2d00: 68 65 72 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d her</strong> <em
2d10: 3e 6e 61 6d 65 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f >name</em></a></
2d20: 64 74 3e 0a 20 20 20 20 3c 64 64 3e 52 65 74 75 dt>. <dd>Retu
2d30: 72 6e 20 61 20 6c 69 73 74 20 6f 66 20 70 72 6f rn a list of pro
2d40: 70 65 72 74 79 20 6e 61 6d 65 73 20 61 6e 64 20 perty names and
2d50: 76 61 6c 75 65 73 20 64 65 73 63 72 69 62 69 6e values describin
2d60: 67 20 63 69 70 68 65 72 0a 09 3c 69 3e 6e 61 6d g cipher..<i>nam
2d70: 65 3c 2f 69 3e 2e 20 50 72 6f 70 65 72 74 69 65 e</i>. Propertie
2d80: 73 20 69 6e 63 6c 75 64 65 20 6e 61 6d 65 2c 20 s include name,
2d90: 64 65 73 63 72 69 70 74 69 6f 6e 2c 20 62 6c 6f description, blo
2da0: 63 6b 5f 73 69 7a 65 2c 0a 09 6b 65 79 5f 6c 65 ck_size,..key_le
2db0: 6e 67 74 68 2c 20 69 76 5f 6c 65 6e 67 74 68 2c ngth, iv_length,
2dc0: 20 74 79 70 65 2c 20 61 6e 64 20 6d 6f 64 65 20 type, and mode
2dd0: 6c 69 73 74 2e 20 49 66 20 62 6c 6f 63 6b 2d 73 list. If block-s
2de0: 69 7a 65 20 69 73 20 31 2c 0a 09 74 68 65 6e 20 ize is 1,..then
2df0: 69 74 27 73 20 61 20 73 74 72 65 61 6d 20 63 69 it's a stream ci
2e00: 70 68 65 72 2c 20 6f 74 68 65 72 77 69 73 65 20 pher, otherwise
2e10: 69 74 27 73 20 61 20 62 6c 6f 63 6b 20 63 69 70 it's a block cip
2e20: 68 65 72 2e 3c 2f 64 64 3e 0a 0a 20 20 20 20 3c her.</dd>.. <
2e30: 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 3a dt><a name="tls:
2e40: 3a 63 69 70 68 65 72 73 22 3e 3c 73 74 72 6f 6e :ciphers"><stron
2e50: 67 3e 74 6c 73 3a 3a 63 69 70 68 65 72 73 3c 2f g>tls::ciphers</
2e60: 73 74 72 6f 6e 67 3e 0a 20 20 20 20 3c 65 6d 3e strong>. <em>
2e70: 3f 70 72 6f 74 6f 63 6f 6c 3f 20 3f 76 65 72 62 ?protocol? ?verb
2e80: 6f 73 65 3f 20 3f 73 75 70 70 6f 72 74 65 64 3f ose? ?supported?
2e90: 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 </em></a></dt>.
2ea0: 20 20 20 3c 64 64 3e 57 69 74 68 6f 75 74 20 61 <dd>Without a
2eb0: 6e 79 20 61 72 67 73 2c 20 72 65 74 75 72 6e 73 ny args, returns
2ec0: 20 61 20 6c 69 73 74 20 6f 66 20 61 6c 6c 20 73 a list of all s
2ed0: 79 6d 6d 65 74 72 69 63 20 63 69 70 68 65 72 73 ymmetric ciphers
2ee0: 20 66 6f 72 20 75 73 65 20 77 69 74 68 0a 09 74 for use with..t
2ef0: 68 65 20 3c 61 20 68 72 65 66 3d 22 23 2d 63 69 he <a href="#-ci
2f00: 70 68 65 72 22 3e 3c 62 3e 2d 63 69 70 68 65 72 pher"><b>-cipher
2f10: 3c 2f 62 3e 3c 2f 61 3e 20 6f 70 74 69 6f 6e 2e </b></a> option.
2f20: 20 57 69 74 68 20 3c 65 6d 3e 70 72 6f 74 6f 63 With <em>protoc
2f30: 6f 6c 3c 2f 65 6d 3e 2c 0a 09 6f 6e 6c 79 20 74 ol</em>,..only t
2f40: 68 65 20 63 69 70 68 65 72 73 20 73 75 70 70 6f he ciphers suppo
2f50: 72 74 65 64 20 66 6f 72 20 74 68 61 74 20 70 72 rted for that pr
2f60: 6f 74 6f 63 6f 6c 20 61 72 65 20 72 65 74 75 72 otocol are retur
2f70: 6e 65 64 2e 20 53 65 65 0a 09 3c 62 3e 74 6c 73 ned. See..<b>tls
2f80: 3a 3a 70 72 6f 74 6f 63 6f 6c 73 3c 2f 62 3e 20 ::protocols</b>
2f90: 63 6f 6d 6d 61 6e 64 20 66 6f 72 20 74 68 65 20 command for the
2fa0: 73 75 70 70 6f 72 74 65 64 20 70 72 6f 74 6f 63 supported protoc
2fb0: 6f 6c 73 2e 20 49 66 0a 09 3c 65 6d 3e 76 65 72 ols. If..<em>ver
2fc0: 62 6f 73 65 3c 2f 65 6d 3e 20 69 73 20 73 70 65 bose</em> is spe
2fd0: 63 69 66 69 65 64 20 61 73 20 74 72 75 65 20 74 cified as true t
2fe0: 68 65 6e 20 61 20 76 65 72 62 6f 73 65 2c 20 68 hen a verbose, h
2ff0: 75 6d 61 6e 20 72 65 61 64 61 62 6c 65 0a 09 6c uman readable..l
3000: 69 73 74 20 69 73 20 72 65 74 75 72 6e 65 64 20 ist is returned
3010: 77 69 74 68 20 61 64 64 69 74 69 6f 6e 61 6c 20 with additional
3020: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 information on t
3030: 68 65 20 63 69 70 68 65 72 2e 20 49 66 0a 09 3c he cipher. If..<
3040: 65 6d 3e 73 75 70 70 6f 72 74 65 64 3c 2f 65 6d em>supported</em
3050: 3e 20 69 73 20 73 70 65 63 69 66 69 65 64 20 61 > is specified a
3060: 73 20 74 72 75 65 2c 20 74 68 65 6e 20 6f 6e 6c s true, then onl
3070: 79 20 74 68 65 20 63 69 70 68 65 72 73 0a 09 73 y the ciphers..s
3080: 75 70 70 6f 72 74 65 64 20 66 6f 72 20 70 72 6f upported for pro
3090: 74 6f 63 6f 6c 20 77 69 6c 6c 20 62 65 20 6c 69 tocol will be li
30a0: 73 74 65 64 2e 3c 2f 64 64 3e 0a 0a 20 20 20 20 sted.</dd>..
30b0: 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 <dt><a name="tls
30c0: 3a 3a 64 69 67 65 73 74 73 22 3e 3c 73 74 72 6f ::digests"><stro
30d0: 6e 67 3e 74 6c 73 3a 3a 64 69 67 65 73 74 73 3c ng>tls::digests<
30e0: 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 3f 6e 61 /strong> <em>?na
30f0: 6d 65 3f 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 me?</em></a></dt
3100: 3e 0a 20 20 20 20 3c 64 64 3e 57 69 74 68 6f 75 >. <dd>Withou
3110: 74 20 3c 65 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e 2c t <em>name</em>,
3120: 20 72 65 74 75 72 6e 73 20 61 20 6c 69 73 74 20 returns a list
3130: 6f 66 20 74 68 65 20 73 75 70 70 6f 72 74 65 64 of the supported
3140: 20 6d 65 73 73 61 67 65 20 64 69 67 65 73 74 73 message digests
3150: 0a 09 28 61 6b 61 20 68 61 73 68 20 61 6c 67 6f ..(aka hash algo
3160: 72 69 74 68 6d 73 29 20 66 6f 72 20 75 73 65 20 rithms) for use
3170: 77 69 74 68 20 74 68 65 20 3c 61 20 68 72 65 66 with the <a href
3180: 3d 22 23 2d 64 69 67 65 73 74 22 3e 3c 62 3e 2d ="#-digest"><b>-
3190: 64 69 67 65 73 74 3c 2f 62 3e 3c 2f 61 3e 0a 09 digest</b></a>..
31a0: 6f 70 74 69 6f 6e 2e 20 57 69 74 68 20 3c 65 6d option. With <em
31b0: 3e 6e 61 6d 65 3c 2f 65 6d 3e 2c 20 72 65 74 75 >name</em>, retu
31c0: 72 6e 73 20 61 20 6c 69 73 74 20 6f 66 0a 09 70 rns a list of..p
31d0: 72 6f 70 65 72 74 79 20 6e 61 6d 65 73 20 61 6e roperty names an
31e0: 64 20 76 61 6c 75 65 73 20 64 65 73 63 72 69 62 d values describ
31f0: 69 6e 67 20 6d 65 73 73 61 67 65 20 64 69 67 65 ing message dige
3200: 73 74 20 3c 69 3e 6e 61 6d 65 3c 2f 69 3e 2e 20 st <i>name</i>.
3210: 50 72 6f 70 65 72 74 69 65 73 0a 09 69 6e 63 6c Properties..incl
3220: 75 64 65 20 6e 61 6d 65 2c 20 64 65 73 63 72 69 ude name, descri
3230: 70 74 69 6f 6e 2c 20 73 69 7a 65 2c 20 62 6c 6f ption, size, blo
3240: 63 6b 5f 73 69 7a 65 2c 20 74 79 70 65 2c 20 61 ck_size, type, a
3250: 6e 64 20 66 6c 61 67 73 20 6c 69 73 74 2e 3c 2f nd flags list.</
3260: 64 64 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 dd>.. <dt><a
3270: 6e 61 6d 65 3d 22 74 6c 73 3a 3a 6b 64 66 73 22 name="tls::kdfs"
3280: 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 6b 64 ><strong>tls::kd
3290: 66 73 3c 2f 73 74 72 6f 6e 67 3e 3c 2f 61 3e 3c fs</strong></a><
32a0: 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 52 65 74 /dt>. <dd>Ret
32b0: 75 72 6e 73 20 61 20 6c 69 73 74 20 6f 66 20 74 urns a list of t
32c0: 68 65 20 61 76 61 69 6c 61 62 6c 65 20 4b 65 79 he available Key
32d0: 20 44 65 72 69 76 61 74 69 6f 6e 20 46 75 6e 63 Derivation Func
32e0: 74 69 6f 6e 20 28 4b 44 46 29 0a 09 61 6c 67 6f tion (KDF)..algo
32f0: 72 69 74 68 6d 73 2e 3c 2f 64 64 3e 0a 0a 20 20 rithms.</dd>..
3300: 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 <dt><a name="t
3310: 6c 73 3a 3a 6d 61 63 73 22 3e 3c 73 74 72 6f 6e ls::macs"><stron
3320: 67 3e 74 6c 73 3a 3a 6d 61 63 73 3c 2f 73 74 72 g>tls::macs</str
3330: 6f 6e 67 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 ong></a></dt>.
3340: 20 20 3c 64 64 3e 52 65 74 75 72 6e 73 20 61 20 <dd>Returns a
3350: 6c 69 73 74 20 6f 66 20 74 68 65 20 61 76 61 69 list of the avai
3360: 6c 61 62 6c 65 20 4d 65 73 73 61 67 65 20 41 75 lable Message Au
3370: 74 68 65 6e 74 69 63 61 74 69 6f 6e 20 43 6f 64 thentication Cod
3380: 65 73 20 28 4d 41 43 29 0a 09 66 6f 72 20 75 73 es (MAC)..for us
3390: 65 20 77 69 74 68 20 74 68 65 20 3c 61 20 68 72 e with the <a hr
33a0: 65 66 3d 22 23 2d 6b 65 79 22 3e 3c 62 3e 2d 6b ef="#-key"><b>-k
33b0: 65 79 3c 2f 62 3e 3c 2f 61 3e 20 6f 70 74 69 6f ey</b></a> optio
33c0: 6e 2e 3c 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 n.</dd>.. <dt
33d0: 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 70 ><a name="tls::p
33e0: 72 6f 74 6f 63 6f 6c 73 22 3e 3c 73 74 72 6f 6e rotocols"><stron
33f0: 67 3e 74 6c 73 3a 3a 70 72 6f 74 6f 63 6f 6c 73 g>tls::protocols
3400: 3c 2f 73 74 72 6f 6e 67 3e 3c 2f 61 3e 3c 2f 64 </strong></a></d
3410: 74 3e 0a 20 20 20 20 3c 64 64 3e 52 65 74 75 72 t>. <dd>Retur
3420: 6e 73 20 61 20 6c 69 73 74 20 6f 66 20 73 75 70 ns a list of sup
3430: 70 6f 72 74 65 64 20 70 72 6f 74 6f 63 6f 6c 73 ported protocols
3440: 2e 20 56 61 6c 69 64 20 76 61 6c 75 65 73 20 61 . Valid values a
3450: 72 65 3a 0a 09 3c 62 3e 73 73 6c 32 3c 2f 62 3e re:..<b>ssl2</b>
3460: 2c 20 3c 62 3e 73 73 6c 33 3c 2f 62 3e 2c 20 3c , <b>ssl3</b>, <
3470: 62 3e 74 6c 73 31 3c 2f 62 3e 2c 20 3c 62 3e 74 b>tls1</b>, <b>t
3480: 6c 73 31 2e 31 3c 2f 62 3e 2c 20 3c 62 3e 74 6c ls1.1</b>, <b>tl
3490: 73 31 2e 32 3c 2f 62 3e 2c 0a 09 61 6e 64 20 3c s1.2</b>,..and <
34a0: 62 3e 74 6c 73 31 2e 33 3c 2f 62 3e 2e 20 45 78 b>tls1.3</b>. Ex
34b0: 61 63 74 20 6c 69 73 74 20 64 65 70 65 6e 64 73 act list depends
34c0: 20 6f 6e 20 4f 70 65 6e 53 53 4c 20 76 65 72 73 on OpenSSL vers
34d0: 69 6f 6e 20 61 6e 64 0a 09 63 6f 6d 70 69 6c 65 ion and..compile
34e0: 20 74 69 6d 65 20 66 6c 61 67 73 2e 3c 2f 64 64 time flags.</dd
34f0: 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 >.. <dt><a na
3500: 6d 65 3d 22 74 6c 73 3a 3a 76 65 72 73 69 6f 6e me="tls::version
3510: 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 76 "><strong>tls::v
3520: 65 72 73 69 6f 6e 3c 2f 73 74 72 6f 6e 67 3e 3c ersion</strong><
3530: 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 /a></dt>. <dd
3540: 3e 52 65 74 75 72 6e 73 20 74 68 65 20 4f 70 65 >Returns the Ope
3550: 6e 53 53 4c 20 76 65 72 73 69 6f 6e 20 73 74 72 nSSL version str
3560: 69 6e 67 2e 3c 2f 64 64 3e 0a 0a 3c 62 72 3e 0a ing.</dd>..<br>.
3570: 0a 3c 68 34 3e 4d 65 73 73 61 67 65 20 44 69 67 .<h4>Message Dig
3580: 65 73 74 20 28 4d 44 29 20 61 6e 64 20 4d 65 73 est (MD) and Mes
3590: 73 61 67 65 20 41 75 74 68 65 6e 74 69 63 61 74 sage Authenticat
35a0: 69 6f 6e 20 43 6f 64 65 20 28 4d 41 43 29 20 43 ion Code (MAC) C
35b0: 6f 6d 6d 61 6e 64 73 3c 2f 68 34 3e 0a 0a 20 20 ommands</h4>..
35c0: 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 <dt><a name="t
35d0: 6c 73 3a 3a 63 6d 61 63 22 3e 3c 73 74 72 6f 6e ls::cmac"><stron
35e0: 67 3e 74 6c 73 3a 3a 63 6d 61 63 3c 2f 73 74 72 g>tls::cmac</str
35f0: 6f 6e 67 3e 0a 09 3c 65 6d 3e 3f 3c 2f 65 6d 3e ong>..<em>?</em>
3600: 3c 62 3e 2d 63 69 70 68 65 72 3c 2f 62 3e 3c 65 <b>-cipher</b><e
3610: 6d 3e 3f 20 6e 61 6d 65 3c 2f 65 6d 3e 0a 09 3c m>? name</em>..<
3620: 62 3e 2d 6b 65 79 3c 2f 62 3e 20 3c 65 6d 3e 6b b>-key</b> <em>k
3630: 65 79 20 3f 3c 2f 65 6d 3e 3c 62 3e 2d 62 69 6e ey ?</em><b>-bin
3640: 3c 2f 62 3e 7c 3c 62 3e 2d 68 65 78 3c 2f 62 3e </b>|<b>-hex</b>
3650: 3c 65 6d 3e 3f 0a 09 5b 3c 2f 65 6d 3e 3c 62 3e <em>?..[</em><b>
3660: 2d 63 68 61 6e 3c 2f 62 3e 20 3c 65 6d 3e 63 68 -chan</b> <em>ch
3670: 61 6e 6e 65 6c 49 64 20 7c 3c 2f 65 6d 3e 20 3c annelId |</em> <
3680: 62 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f 62 3e 20 3c b>-command</b> <
3690: 65 6d 3e 63 6d 64 4e 61 6d 65 20 7c 3c 2f 65 6d em>cmdName |</em
36a0: 3e 0a 09 3c 62 3e 2d 66 69 6c 65 3c 2f 62 3e 20 >..<b>-file</b>
36b0: 3c 65 6d 3e 66 69 6c 65 6e 61 6d 65 20 7c 20 3f <em>filename | ?
36c0: 3c 2f 65 6d 3e 3c 62 3e 2d 64 61 74 61 3c 2f 62 </em><b>-data</b
36d0: 3e 3c 65 6d 3e 3f 20 64 61 74 61 5d 3c 2f 65 6d ><em>? data]</em
36e0: 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c ></a></dt>. <
36f0: 64 64 3e 43 61 6c 63 75 6c 61 74 65 20 74 68 65 dd>Calculate the
3700: 20 43 69 70 68 65 72 2d 62 61 73 65 64 20 4d 65 Cipher-based Me
3710: 73 73 61 67 65 20 41 75 74 68 65 6e 74 69 63 61 ssage Authentica
3720: 74 69 6f 6e 20 43 6f 64 65 20 28 43 4d 41 43 29 tion Code (CMAC)
3730: 20 77 68 65 72 65 0a 09 3c 65 6d 3e 6b 65 79 3c where..<em>key<
3740: 2f 65 6d 3e 20 69 73 20 61 20 73 68 61 72 65 64 /em> is a shared
3750: 20 6b 65 79 20 61 6e 64 20 6f 75 74 70 75 74 20 key and output
3760: 74 68 65 20 72 65 73 75 6c 74 20 70 65 72 20 74 the result per t
3770: 68 65 20 49 2f 4f 20 6f 70 74 69 6f 6e 73 0a 09 he I/O options..
3780: 69 6e 20 74 68 65 20 73 70 65 63 69 66 69 65 64 in the specified
3790: 20 66 6f 72 6d 61 74 2e 20 4d 41 43 73 20 61 72 format. MACs ar
37a0: 65 20 75 73 65 64 20 74 6f 20 65 6e 73 75 72 65 e used to ensure
37b0: 20 61 75 74 68 65 6e 74 69 63 69 74 79 20 61 6e authenticity an
37c0: 64 20 74 68 65 0a 09 69 6e 74 65 67 72 69 74 79 d the..integrity
37d0: 20 6f 66 20 64 61 74 61 2e 20 53 65 65 20 3c 61 of data. See <a
37e0: 20 68 72 65 66 3d 22 23 4f 50 54 49 4f 4e 53 22 href="#OPTIONS"
37f0: 3e 3c 62 3e 6f 70 74 69 6f 6e 73 3c 2f 62 3e 3c ><b>options</b><
3800: 2f 61 3e 20 66 6f 72 20 75 73 61 67 65 0a 09 69 /a> for usage..i
3810: 6e 66 6f 2e 20 4f 70 74 69 6f 6e 20 3c 62 3e 2d nfo. Option <b>-
3820: 6b 65 79 3c 2f 62 3e 20 69 73 20 6f 6e 6c 79 20 key</b> is only
3830: 75 73 65 64 20 66 6f 72 20 73 6f 6d 65 20 63 69 used for some ci
3840: 70 68 65 72 73 2e 3c 2f 64 64 3e 0a 0a 20 20 20 phers.</dd>..
3850: 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c <dt><a name="tl
3860: 73 3a 3a 68 6d 61 63 22 3e 3c 73 74 72 6f 6e 67 s::hmac"><strong
3870: 3e 74 6c 73 3a 3a 68 6d 61 63 3c 2f 73 74 72 6f >tls::hmac</stro
3880: 6e 67 3e 0a 09 3c 65 6d 3e 3f 3c 2f 65 6d 3e 3c ng>..<em>?</em><
3890: 62 3e 2d 64 69 67 65 73 74 3c 2f 62 3e 3c 65 6d b>-digest</b><em
38a0: 3e 3f 20 6e 61 6d 65 3c 2f 65 6d 3e 0a 09 3c 62 >? name</em>..<b
38b0: 3e 2d 6b 65 79 3c 2f 62 3e 20 3c 65 6d 3e 6b 65 >-key</b> <em>ke
38c0: 79 20 3f 3c 2f 65 6d 3e 3c 62 3e 2d 62 69 6e 3c y ?</em><b>-bin<
38d0: 2f 62 3e 7c 3c 62 3e 2d 68 65 78 3c 2f 62 3e 3c /b>|<b>-hex</b><
38e0: 65 6d 3e 3f 0a 09 5b 3c 2f 65 6d 3e 3c 62 3e 2d em>?..[</em><b>-
38f0: 63 68 61 6e 3c 2f 62 3e 20 3c 65 6d 3e 63 68 61 chan</b> <em>cha
3900: 6e 6e 65 6c 49 64 20 7c 3c 2f 65 6d 3e 20 3c 62 nnelId |</em> <b
3910: 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f 62 3e 20 3c 65 >-command</b> <e
3920: 6d 3e 63 6d 64 4e 61 6d 65 20 7c 3c 2f 65 6d 3e m>cmdName |</em>
3930: 0a 09 3c 62 3e 2d 66 69 6c 65 3c 2f 62 3e 20 3c ..<b>-file</b> <
3940: 65 6d 3e 66 69 6c 65 6e 61 6d 65 20 7c 20 3f 3c em>filename | ?<
3950: 2f 65 6d 3e 3c 62 3e 2d 64 61 74 61 3c 2f 62 3e /em><b>-data</b>
3960: 3c 65 6d 3e 3f 20 64 61 74 61 5d 3c 2f 65 6d 3e <em>? data]</em>
3970: 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 </a></dt>. <d
3980: 64 3e 43 61 6c 63 75 6c 61 74 65 20 74 68 65 20 d>Calculate the
3990: 48 61 73 68 2d 62 61 73 65 64 20 4d 65 73 73 61 Hash-based Messa
39a0: 67 65 20 41 75 74 68 65 6e 74 69 63 61 74 69 6f ge Authenticatio
39b0: 6e 20 43 6f 64 65 20 28 48 4d 41 43 29 20 77 68 n Code (HMAC) wh
39c0: 65 72 65 0a 09 3c 65 6d 3e 6b 65 79 3c 2f 65 6d ere..<em>key</em
39d0: 3e 20 69 73 20 61 20 73 68 61 72 65 64 20 73 65 > is a shared se
39e0: 63 72 65 74 20 6b 65 79 20 61 6e 64 20 6f 75 74 cret key and out
39f0: 70 75 74 20 74 68 65 20 72 65 73 75 6c 74 20 70 put the result p
3a00: 65 72 20 74 68 65 20 49 2f 4f 0a 09 6f 70 74 69 er the I/O..opti
3a10: 6f 6e 73 20 69 6e 20 74 68 65 20 73 70 65 63 69 ons in the speci
3a20: 66 69 65 64 20 66 6f 72 6d 61 74 2e 20 54 68 65 fied format. The
3a30: 20 63 72 79 70 74 6f 67 72 61 70 68 69 63 20 73 cryptographic s
3a40: 74 72 65 6e 67 74 68 20 64 65 70 65 6e 64 73 0a trength depends.
3a50: 09 75 70 6f 6e 20 74 68 65 20 73 69 7a 65 20 6f .upon the size o
3a60: 66 20 74 68 65 20 6b 65 79 20 61 6e 64 20 74 68 f the key and th
3a70: 65 20 73 65 63 75 72 69 74 79 20 6f 66 20 74 68 e security of th
3a80: 65 20 68 61 73 68 20 66 75 6e 63 74 69 6f 6e 20 e hash function
3a90: 75 73 65 64 2e 0a 09 53 65 65 20 3c 61 20 68 72 used...See <a hr
3aa0: 65 66 3d 22 23 4f 50 54 49 4f 4e 53 22 3e 3c 62 ef="#OPTIONS"><b
3ab0: 3e 6f 70 74 69 6f 6e 73 3c 2f 62 3e 3c 2f 61 3e >options</b></a>
3ac0: 20 66 6f 72 20 75 73 61 67 65 20 69 6e 66 6f 2e for usage info.
3ad0: 3c 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c </dd>.. <dt><
3ae0: 61 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 6d 61 63 a name="tls::mac
3af0: 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 6d "><strong>tls::m
3b00: 61 63 3c 2f 73 74 72 6f 6e 67 3e 0a 09 3c 65 6d ac</strong>..<em
3b10: 3e 3f 3c 2f 65 6d 3e 3c 62 3e 2d 6d 61 63 3c 2f >?</em><b>-mac</
3b20: 62 3e 3c 65 6d 3e 3f 20 6e 61 6d 65 3c 2f 65 6d b><em>? name</em
3b30: 3e 20 3c 62 3e 2d 63 69 70 68 65 72 3c 2f 62 3e > <b>-cipher</b>
3b40: 20 3c 65 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e 0a 09 <em>name</em>..
3b50: 3c 62 3e 2d 64 69 67 65 73 74 3c 2f 62 3e 20 3c <b>-digest</b> <
3b60: 65 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e 20 3c 62 3e em>name</em> <b>
3b70: 2d 6b 65 79 3c 2f 62 3e 20 3c 65 6d 3e 6b 65 79 -key</b> <em>key
3b80: 20 3f 3c 2f 65 6d 3e 0a 09 3c 62 3e 2d 62 69 6e ?</em>..<b>-bin
3b90: 3c 2f 62 3e 7c 3c 62 3e 2d 68 65 78 3c 2f 62 3e </b>|<b>-hex</b>
3ba0: 3c 65 6d 3e 3f 0a 09 5b 3c 2f 65 6d 3e 3c 62 3e <em>?..[</em><b>
3bb0: 2d 63 68 61 6e 3c 2f 62 3e 20 3c 65 6d 3e 63 68 -chan</b> <em>ch
3bc0: 61 6e 6e 65 6c 49 64 20 7c 3c 2f 65 6d 3e 20 3c annelId |</em> <
3bd0: 62 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f 62 3e 20 3c b>-command</b> <
3be0: 65 6d 3e 63 6d 64 4e 61 6d 65 20 7c 3c 2f 65 6d em>cmdName |</em
3bf0: 3e 0a 09 3c 62 3e 2d 66 69 6c 65 3c 2f 62 3e 20 >..<b>-file</b>
3c00: 3c 65 6d 3e 66 69 6c 65 6e 61 6d 65 20 7c 20 3f <em>filename | ?
3c10: 3c 2f 65 6d 3e 3c 62 3e 2d 64 61 74 61 3c 2f 62 </em><b>-data</b
3c20: 3e 3c 65 6d 3e 3f 20 64 61 74 61 5d 3c 2f 65 6d ><em>? data]</em
3c30: 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c ></a></dt>. <
3c40: 64 64 3e 28 4f 70 65 6e 53 53 4c 20 33 2e 30 2b dd>(OpenSSL 3.0+
3c50: 29 20 43 61 6c 63 75 6c 61 74 65 20 74 68 65 20 ) Calculate the
3c60: 4d 65 73 73 61 67 65 20 41 75 74 68 65 6e 74 69 Message Authenti
3c70: 63 61 74 69 6f 6e 20 43 6f 64 65 20 28 4d 41 43 cation Code (MAC
3c80: 29 20 77 68 65 72 65 0a 09 3c 65 6d 3e 6b 65 79 ) where..<em>key
3c90: 3c 2f 65 6d 3e 20 69 73 20 61 20 73 68 61 72 65 </em> is a share
3ca0: 64 20 6b 65 79 20 61 6e 64 20 6f 75 74 70 75 74 d key and output
3cb0: 20 74 68 65 20 72 65 73 75 6c 74 20 70 65 72 20 the result per
3cc0: 74 68 65 20 49 2f 4f 20 6f 70 74 69 6f 6e 73 0a the I/O options.
3cd0: 09 69 6e 20 74 68 65 20 73 70 65 63 69 66 69 65 .in the specifie
3ce0: 64 20 66 6f 72 6d 61 74 2e 20 4d 41 43 73 20 61 d format. MACs a
3cf0: 72 65 20 75 73 65 64 20 74 6f 20 65 6e 73 75 72 re used to ensur
3d00: 65 20 61 75 74 68 65 6e 74 69 63 69 74 79 20 61 e authenticity a
3d10: 6e 64 0a 09 74 68 65 20 69 6e 74 65 67 72 69 74 nd..the integrit
3d20: 79 20 6f 66 20 64 61 74 61 2e 20 53 65 65 20 3c y of data. See <
3d30: 61 20 68 72 65 66 3d 22 23 4f 50 54 49 4f 4e 53 a href="#OPTIONS
3d40: 22 3e 3c 62 3e 6f 70 74 69 6f 6e 73 3c 2f 62 3e "><b>options</b>
3d50: 3c 2f 61 3e 0a 09 66 6f 72 20 75 73 61 67 65 20 </a>..for usage
3d60: 69 6e 66 6f 2e 3c 2f 64 64 3e 0a 0a 20 20 20 20 info.</dd>..
3d70: 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 <dt><a name="tls
3d80: 3a 3a 6d 64 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c ::md"><strong>tl
3d90: 73 3a 3a 6d 64 3c 2f 73 74 72 6f 6e 67 3e 0a 09 s::md</strong>..
3da0: 3c 65 6d 3e 3f 3c 2f 65 6d 3e 3c 62 3e 2d 64 69 <em>?</em><b>-di
3db0: 67 65 73 74 3c 2f 62 3e 3c 65 6d 3e 3f 20 6e 61 gest</b><em>? na
3dc0: 6d 65 20 3f 3c 2f 65 6d 3e 3c 62 3e 2d 62 69 6e me ?</em><b>-bin
3dd0: 3c 2f 62 3e 7c 3c 62 3e 2d 68 65 78 3c 2f 62 3e </b>|<b>-hex</b>
3de0: 3c 65 6d 3e 3f 0a 09 5b 3c 2f 65 6d 3e 3c 62 3e <em>?..[</em><b>
3df0: 2d 63 68 61 6e 3c 2f 62 3e 20 3c 65 6d 3e 63 68 -chan</b> <em>ch
3e00: 61 6e 6e 65 6c 49 64 20 7c 3c 2f 65 6d 3e 20 3c annelId |</em> <
3e10: 62 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f 62 3e 20 3c b>-command</b> <
3e20: 65 6d 3e 63 6d 64 4e 61 6d 65 20 7c 3c 2f 65 6d em>cmdName |</em
3e30: 3e 0a 09 3c 62 3e 2d 66 69 6c 65 3c 2f 62 3e 20 >..<b>-file</b>
3e40: 3c 65 6d 3e 66 69 6c 65 6e 61 6d 65 20 7c 20 3f <em>filename | ?
3e50: 3c 2f 65 6d 3e 3c 62 3e 2d 64 61 74 61 3c 2f 62 </em><b>-data</b
3e60: 3e 3c 65 6d 3e 3f 20 64 61 74 61 5d 3c 2f 65 6d ><em>? data]</em
3e70: 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c ></a></dt>. <
3e80: 64 64 3e 43 61 6c 63 75 6c 61 74 65 20 74 68 65 dd>Calculate the
3e90: 20 6d 65 73 73 61 67 65 20 64 69 67 65 73 74 20 message digest
3ea0: 28 4d 44 29 20 75 73 69 6e 67 20 68 61 73 68 20 (MD) using hash
3eb0: 66 75 6e 63 74 69 6f 6e 20 3c 65 6d 3e 6e 61 6d function <em>nam
3ec0: 65 3c 2f 65 6d 3e 0a 09 61 6e 64 20 6f 75 74 70 e</em>..and outp
3ed0: 75 74 20 74 68 65 20 72 65 73 75 6c 74 20 70 65 ut the result pe
3ee0: 72 20 74 68 65 20 49 2f 4f 20 6f 70 74 69 6f 6e r the I/O option
3ef0: 73 20 69 6e 20 74 68 65 20 73 70 65 63 69 66 69 s in the specifi
3f00: 65 64 20 66 6f 72 6d 61 74 2e 0a 09 4d 44 73 20 ed format...MDs
3f10: 61 72 65 20 75 73 65 64 20 74 6f 20 65 6e 73 75 are used to ensu
3f20: 72 65 20 74 68 65 20 69 6e 74 65 67 72 69 74 79 re the integrity
3f30: 20 6f 66 20 64 61 74 61 2e 20 53 65 65 0a 09 3c of data. See..<
3f40: 61 20 68 72 65 66 3d 22 23 4f 50 54 49 4f 4e 53 a href="#OPTIONS
3f50: 22 3e 3c 62 3e 6f 70 74 69 6f 6e 73 3c 2f 62 3e "><b>options</b>
3f60: 3c 2f 61 3e 20 66 6f 72 20 75 73 61 67 65 20 69 </a> for usage i
3f70: 6e 66 6f 2e 3c 2f 64 64 3e 0a 0a 20 20 20 20 3c nfo.</dd>.. <
3f80: 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 3a dt><a name="tls:
3f90: 3a 6d 64 34 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c :md4"><strong>tl
3fa0: 73 3a 3a 6d 64 34 3c 2f 73 74 72 6f 6e 67 3e 20 s::md4</strong>
3fb0: 3c 65 6d 3e 64 61 74 61 3c 2f 65 6d 3e 3c 2f 61 <em>data</em></a
3fc0: 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 52 ></dt>. <dd>R
3fd0: 65 74 75 72 6e 73 20 74 68 65 20 4d 44 34 20 6d eturns the MD4 m
3fe0: 65 73 73 61 67 65 2d 64 69 67 65 73 74 20 66 6f essage-digest fo
3ff0: 72 20 3c 65 6d 3e 64 61 74 61 3c 2f 65 6d 3e 20 r <em>data</em>
4000: 61 73 20 61 20 68 65 78 20 73 74 72 69 6e 67 2e as a hex string.
4010: 3c 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c </dd>.. <dt><
4020: 61 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 6d 64 35 a name="tls::md5
4030: 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 6d "><strong>tls::m
4040: 64 35 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e d5</strong> <em>
4050: 64 61 74 61 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 data</em></a></d
4060: 74 3e 0a 20 20 20 20 3c 64 64 3e 52 65 74 75 72 t>. <dd>Retur
4070: 6e 73 20 74 68 65 20 4d 44 35 20 6d 65 73 73 61 ns the MD5 messa
4080: 67 65 2d 64 69 67 65 73 74 20 66 6f 72 20 3c 65 ge-digest for <e
4090: 6d 3e 64 61 74 61 3c 2f 65 6d 3e 20 61 73 20 61 m>data</em> as a
40a0: 20 68 65 78 20 73 74 72 69 6e 67 2e 3c 2f 64 64 hex string.</dd
40b0: 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 >.. <dt><a na
40c0: 6d 65 3d 22 74 6c 73 3a 3a 73 68 61 31 22 3e 3c me="tls::sha1"><
40d0: 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 73 68 61 31 strong>tls::sha1
40e0: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 64 61 </strong> <em>da
40f0: 74 61 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e ta</em></a></dt>
4100: 0a 20 20 20 20 3c 64 64 3e 52 65 74 75 72 6e 73 . <dd>Returns
4110: 20 74 68 65 20 53 48 41 31 20 73 65 63 75 72 65 the SHA1 secure
4120: 20 68 61 73 68 20 61 6c 67 6f 72 69 74 68 6d 20 hash algorithm
4130: 64 69 67 65 73 74 20 66 6f 72 20 3c 65 6d 3e 64 digest for <em>d
4140: 61 74 61 3c 2f 65 6d 3e 20 61 73 20 61 20 68 65 ata</em> as a he
4150: 78 20 73 74 72 69 6e 67 2e 3c 2f 64 64 3e 0a 0a x string.</dd>..
4160: 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d <dt><a name=
4170: 22 74 6c 73 3a 3a 73 68 61 32 35 36 22 3e 3c 73 "tls::sha256"><s
4180: 74 72 6f 6e 67 3e 74 6c 73 3a 3a 73 68 61 32 35 trong>tls::sha25
4190: 36 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 64 6</strong> <em>d
41a0: 61 74 61 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 ata</em></a></dt
41b0: 3e 0a 20 20 20 20 3c 64 64 3e 52 65 74 75 72 6e >. <dd>Return
41c0: 73 20 74 68 65 20 53 48 41 2d 32 20 53 48 41 32 s the SHA-2 SHA2
41d0: 35 36 20 73 65 63 75 72 65 20 68 61 73 68 20 61 56 secure hash a
41e0: 6c 67 6f 72 69 74 68 6d 20 64 69 67 65 73 74 20 lgorithm digest
41f0: 66 6f 72 20 3c 65 6d 3e 64 61 74 61 3c 2f 65 6d for <em>data</em
4200: 3e 20 61 73 20 61 20 68 65 78 20 73 74 72 69 6e > as a hex strin
4210: 67 2e 3c 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 g.</dd>.. <dt
4220: 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 73 ><a name="tls::s
4230: 68 61 35 31 32 22 3e 3c 73 74 72 6f 6e 67 3e 74 ha512"><strong>t
4240: 6c 73 3a 3a 73 68 61 35 31 32 3c 2f 73 74 72 6f ls::sha512</stro
4250: 6e 67 3e 20 3c 65 6d 3e 64 61 74 61 3c 2f 65 6d ng> <em>data</em
4260: 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c ></a></dt>. <
4270: 64 64 3e 52 65 74 75 72 6e 73 20 74 68 65 20 53 dd>Returns the S
4280: 48 41 2d 32 20 53 48 41 35 31 32 20 73 65 63 75 HA-2 SHA512 secu
4290: 72 65 20 68 61 73 68 20 61 6c 67 6f 72 69 74 68 re hash algorith
42a0: 6d 20 64 69 67 65 73 74 20 66 6f 72 20 3c 65 6d m digest for <em
42b0: 3e 64 61 74 61 3c 2f 65 6d 3e 20 61 73 20 61 20 >data</em> as a
42c0: 68 65 78 20 73 74 72 69 6e 67 2e 3c 2f 64 64 3e hex string.</dd>
42d0: 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d .. <dt><a nam
42e0: 65 3d 22 74 6c 73 3a 3a 75 6e 73 74 61 63 6b 22 e="tls::unstack"
42f0: 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 75 6e ><strong>tls::un
4300: 73 74 61 63 6b 3c 2f 73 74 72 6f 6e 67 3e 20 3c stack</strong> <
4310: 65 6d 3e 63 68 61 6e 6e 65 6c 49 64 3c 2f 65 6d em>channelId</em
4320: 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c ></a></dt>. <
4330: 64 64 3e 52 65 6d 6f 76 65 73 20 74 68 65 20 74 dd>Removes the t
4340: 6f 70 20 6c 65 76 65 6c 20 63 72 79 70 74 6f 67 op level cryptog
4350: 72 61 70 68 69 63 20 74 72 61 6e 73 66 6f 72 6d raphic transform
4360: 20 66 72 6f 6d 20 63 68 61 6e 6e 65 6c 20 3c 65 from channel <e
4370: 6d 3e 63 68 61 6e 6e 65 6c 49 64 3c 2f 65 6d 3e m>channelId</em>
4380: 2e 3c 2f 64 64 3e 0a 0a 3c 62 72 3e 0a 0a 3c 68 .</dd>..<br>..<h
4390: 34 3e 45 6e 63 72 79 70 74 69 6f 6e 20 61 6e 64 4>Encryption and
43a0: 20 44 65 63 72 79 70 74 69 6f 6e 20 43 6f 6d 6d Decryption Comm
43b0: 61 6e 64 73 3c 2f 68 34 3e 0a 0a 20 20 20 20 3c ands</h4>.. <
43c0: 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 3a dt><a name="tls:
43d0: 3a 65 6e 63 72 79 70 74 22 3e 3c 73 74 72 6f 6e :encrypt"><stron
43e0: 67 3e 74 6c 73 3a 3a 65 6e 63 72 79 70 74 3c 2f g>tls::encrypt</
43f0: 73 74 72 6f 6e 67 3e 0a 09 3c 65 6d 3e 3f 3c 2f strong>..<em>?</
4400: 65 6d 3e 3c 62 3e 2d 63 69 70 68 65 72 3c 2f 62 em><b>-cipher</b
4410: 3e 3c 65 6d 3e 3f 20 6e 61 6d 65 3c 2f 65 6d 3e ><em>? name</em>
4420: 20 3c 62 3e 2d 6b 65 79 3c 2f 62 3e 20 3c 65 6d <b>-key</b> <em
4430: 3e 6b 65 79 20 3f 3c 2f 65 6d 3e 3c 62 3e 2d 69 >key ?</em><b>-i
4440: 76 3c 2f 62 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 v</b> <em>string
4450: 3f 0a 09 5b 3c 2f 65 6d 3e 3c 62 3e 2d 63 68 61 ?..[</em><b>-cha
4460: 6e 3c 2f 62 3e 20 3c 65 6d 3e 63 68 61 6e 6e 65 n</b> <em>channe
4470: 6c 49 64 20 7c 3c 2f 65 6d 3e 20 3c 62 3e 2d 63 lId |</em> <b>-c
4480: 6f 6d 6d 61 6e 64 3c 2f 62 3e 20 3c 65 6d 3e 63 ommand</b> <em>c
4490: 6d 64 4e 61 6d 65 20 7c 3c 2f 65 6d 3e 0a 09 3c mdName |</em>..<
44a0: 62 3e 2d 69 6e 66 69 6c 65 3c 2f 62 3e 20 3c 65 b>-infile</b> <e
44b0: 6d 3e 66 69 6c 65 6e 61 6d 65 3c 2f 65 6d 3e 20 m>filename</em>
44c0: 3c 62 3e 2d 6f 75 74 66 69 6c 65 3c 2f 62 3e 20 <b>-outfile</b>
44d0: 3c 65 6d 3e 66 69 6c 65 6e 61 6d 65 20 7c 3c 2f <em>filename |</
44e0: 65 6d 3e 0a 09 3c 62 3e 2d 64 61 74 61 3c 2f 62 em>..<b>-data</b
44f0: 3e 3c 65 6d 3e 20 64 61 74 61 5d 3c 2f 65 6d 3e ><em> data]</em>
4500: 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 </a></dt>. <d
4510: 64 3e 45 6e 63 72 79 70 74 20 74 68 65 20 64 61 d>Encrypt the da
4520: 74 61 20 75 73 69 6e 67 20 63 69 70 68 65 72 20 ta using cipher
4530: 3c 65 6d 3e 63 69 70 68 65 72 3c 2f 65 6d 3e 20 <em>cipher</em>
4540: 61 6e 64 20 6f 75 74 70 75 74 20 74 68 65 20 72 and output the r
4550: 65 73 75 6c 74 20 70 65 72 0a 09 74 68 65 20 49 esult per..the I
4560: 2f 4f 20 6f 70 74 69 6f 6e 73 2e 20 43 69 70 68 /O options. Ciph
4570: 65 72 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 ers are used to
4580: 63 72 65 61 74 65 20 74 68 65 20 63 69 70 68 65 create the ciphe
4590: 72 20 74 65 78 74 20 66 72 6f 6d 20 74 68 65 0a r text from the.
45a0: 09 69 6e 70 75 74 20 64 61 74 61 2e 20 53 65 65 .input data. See
45b0: 20 3c 61 20 68 72 65 66 3d 22 23 4f 50 54 49 4f <a href="#OPTIO
45c0: 4e 53 22 3e 3c 62 3e 6f 70 74 69 6f 6e 73 3c 2f NS"><b>options</
45d0: 62 3e 3c 2f 61 3e 20 66 6f 72 20 75 73 61 67 65 b></a> for usage
45e0: 0a 09 69 6e 66 6f 2e 20 4f 70 74 69 6f 6e 20 3c ..info. Option <
45f0: 62 3e 2d 69 76 3c 2f 62 3e 20 69 73 20 6f 6e 6c b>-iv</b> is onl
4600: 79 20 75 73 65 64 20 66 6f 72 20 73 6f 6d 65 20 y used for some
4610: 63 69 70 68 65 72 73 2e 20 53 65 65 20 74 68 65 ciphers. See the
4620: 0a 09 26 71 75 6f 74 3b 3c 62 3e 74 6c 73 3a 3a .."<b>tls::
4630: 63 69 70 68 65 72 3c 2f 62 3e 20 3c 65 6d 3e 63 cipher</b> <em>c
4640: 69 70 68 65 72 3c 2f 65 6d 3e 26 71 75 6f 74 3b ipher</em>"
4650: 20 63 6f 6d 6d 61 6e 64 20 66 6f 72 20 6b 65 79 command for key
4660: 20 61 6e 64 20 69 76 0a 09 73 69 7a 65 73 20 61 and iv..sizes a
4670: 6e 64 20 77 68 65 6e 20 74 68 65 20 69 76 20 69 nd when the iv i
4680: 73 20 75 73 65 64 20 28 69 76 5f 6c 65 6e 67 74 s used (iv_lengt
4690: 68 20 26 67 74 3b 20 30 29 2e 3c 2f 64 64 3e 0a h > 0).</dd>.
46a0: 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 . <dt><a name
46b0: 3d 22 74 6c 73 3a 3a 64 65 63 72 79 70 74 22 3e ="tls::decrypt">
46c0: 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 64 65 63 <strong>tls::dec
46d0: 72 79 70 74 3c 2f 73 74 72 6f 6e 67 3e 0a 09 3c rypt</strong>..<
46e0: 65 6d 3e 3f 3c 2f 65 6d 3e 3c 62 3e 2d 63 69 70 em>?</em><b>-cip
46f0: 68 65 72 3c 2f 62 3e 3c 65 6d 3e 3f 20 6e 61 6d her</b><em>? nam
4700: 65 3c 2f 65 6d 3e 20 3c 62 3e 2d 6b 65 79 3c 2f e</em> <b>-key</
4710: 62 3e 20 3c 65 6d 3e 6b 65 79 20 3f 3c 2f 65 6d b> <em>key ?</em
4720: 3e 3c 62 3e 2d 69 76 3c 2f 62 3e 20 3c 65 6d 3e ><b>-iv</b> <em>
4730: 73 74 72 69 6e 67 3f 0a 09 5b 3c 2f 65 6d 3e 3c string?..[</em><
4740: 62 3e 2d 63 68 61 6e 3c 2f 62 3e 20 3c 65 6d 3e b>-chan</b> <em>
4750: 63 68 61 6e 6e 65 6c 49 64 20 7c 3c 2f 65 6d 3e channelId |</em>
4760: 20 3c 62 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f 62 3e <b>-command</b>
4770: 20 3c 65 6d 3e 63 6d 64 4e 61 6d 65 20 7c 3c 2f <em>cmdName |</
4780: 65 6d 3e 0a 09 3c 62 3e 2d 69 6e 66 69 6c 65 3c em>..<b>-infile<
4790: 2f 62 3e 20 3c 65 6d 3e 66 69 6c 65 6e 61 6d 65 /b> <em>filename
47a0: 3c 2f 65 6d 3e 20 3c 62 3e 2d 6f 75 74 66 69 6c </em> <b>-outfil
47b0: 65 3c 2f 62 3e 20 3c 65 6d 3e 66 69 6c 65 6e 61 e</b> <em>filena
47c0: 6d 65 20 7c 3c 2f 65 6d 3e 0a 09 3c 62 3e 2d 64 me |</em>..<b>-d
47d0: 61 74 61 3c 2f 62 3e 3c 65 6d 3e 20 64 61 74 61 ata</b><em> data
47e0: 5d 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a ]</em></a></dt>.
47f0: 20 20 20 20 3c 64 64 3e 44 65 63 72 79 70 74 20 <dd>Decrypt
4800: 74 68 65 20 64 61 74 61 20 75 73 69 6e 67 20 63 the data using c
4810: 69 70 68 65 72 20 3c 65 6d 3e 63 69 70 68 65 72 ipher <em>cipher
4820: 3c 2f 65 6d 3e 20 61 6e 64 20 6f 75 74 70 75 74 </em> and output
4830: 20 74 68 65 20 72 65 73 75 6c 74 20 70 65 72 0a the result per.
4840: 09 74 68 65 20 49 2f 4f 20 6f 70 74 69 6f 6e 73 .the I/O options
4850: 2e 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 69 . This command i
4860: 73 20 74 68 65 20 6f 70 70 6f 73 69 74 65 20 6f s the opposite o
4870: 66 20 74 68 65 20 3c 62 3e 74 6c 73 3a 3a 65 6e f the <b>tls::en
4880: 63 72 79 70 74 3c 2f 62 3e 0a 09 63 6f 6d 6d 61 crypt</b>..comma
4890: 6e 64 2e 20 53 65 65 20 3c 61 20 68 72 65 66 3d nd. See <a href=
48a0: 22 23 4f 50 54 49 4f 4e 53 22 3e 3c 62 3e 6f 70 "#OPTIONS"><b>op
48b0: 74 69 6f 6e 73 3c 2f 62 3e 3c 2f 61 3e 20 66 6f tions</b></a> fo
48c0: 72 20 75 73 61 67 65 0a 09 69 6e 66 6f 2e 20 4f r usage..info. O
48d0: 70 74 69 6f 6e 20 3c 62 3e 2d 69 76 3c 2f 62 3e ption <b>-iv</b>
48e0: 20 69 73 20 6f 6e 6c 79 20 75 73 65 64 20 66 6f is only used fo
48f0: 72 20 73 6f 6d 65 20 63 69 70 68 65 72 73 2e 20 r some ciphers.
4900: 53 65 65 20 74 68 65 0a 09 26 71 75 6f 74 3b 3c See the.."<
4910: 62 3e 74 6c 73 3a 3a 63 69 70 68 65 72 3c 2f 62 b>tls::cipher</b
4920: 3e 20 3c 65 6d 3e 63 69 70 68 65 72 3c 2f 65 6d > <em>cipher</em
4930: 3e 26 71 75 6f 74 3b 20 63 6f 6d 6d 61 6e 64 20 >" command
4940: 66 6f 72 20 6b 65 79 20 61 6e 64 20 69 76 0a 09 for key and iv..
4950: 73 69 7a 65 73 20 61 6e 64 20 77 68 65 6e 20 74 sizes and when t
4960: 68 65 20 69 76 20 69 73 20 75 73 65 64 20 28 69 he iv is used (i
4970: 76 5f 6c 65 6e 67 74 68 20 26 67 74 3b 20 30 29 v_length > 0)
4980: 2e 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 62 .</dd>.</dl>..<b
4990: 72 3e 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 r>.<h3><a name="
49a0: 47 4c 4f 53 53 41 52 59 22 3e 47 4c 4f 53 53 41 GLOSSARY">GLOSSA
49b0: 52 59 3c 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e RY</a></h3>..<p>
49c0: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 73 The following is
49d0: 20 61 20 6c 69 73 74 20 6f 66 20 74 68 65 20 74 a list of the t
49e0: 65 72 6d 69 6e 6f 6c 6f 67 79 20 75 73 65 64 20 erminology used
49f0: 69 6e 20 74 68 69 73 20 70 61 63 6b 61 67 65 20 in this package
4a00: 61 6c 6f 6e 67 20 77 69 74 68 0a 62 72 69 65 66 along with.brief
4a10: 20 64 65 66 69 6e 69 74 69 6f 6e 73 2e 20 46 6f definitions. Fo
4a20: 72 20 6d 6f 72 65 20 64 65 74 61 69 6c 73 2c 20 r more details,
4a30: 70 6c 65 61 73 65 20 63 6f 6e 73 75 6c 74 20 77 please consult w
4a40: 69 74 68 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 ith the OpenSSL
4a50: 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 2e 3c 2f documentation.</
4a60: 70 3e 0a 0a 0a 3c 62 72 3e 0a 3c 68 33 3e 3c 61 p>...<br>.<h3><a
4a70: 20 6e 61 6d 65 3d 22 45 58 41 4d 50 4c 45 53 22 name="EXAMPLES"
4a80: 3e 45 58 41 4d 50 4c 45 53 3c 2f 61 3e 3c 2f 68 >EXAMPLES</a></h
4a90: 33 3e 0a 0a 3c 70 3e 54 42 53 3c 2f 70 3e 0a 0a 3>..<p>TBS</p>..
4aa0: 3c 70 72 65 3e 3c 63 6f 64 65 3e 0a 70 61 63 6b <pre><code>.pack
4ab0: 61 67 65 20 72 65 71 75 69 72 65 20 68 74 74 70 age require http
4ac0: 0a 70 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 .package require
4ad0: 20 74 6c 73 0a 0a 68 74 74 70 3a 3a 72 65 67 69 tls..http::regi
4ae0: 73 74 65 72 20 68 74 74 70 73 20 34 34 33 20 5b ster https 443 [
4af0: 6c 69 73 74 20 3a 3a 74 6c 73 3a 3a 73 6f 63 6b list ::tls::sock
4b00: 65 74 20 2d 61 75 74 6f 73 65 72 76 65 72 6e 61 et -autoserverna
4b10: 6d 65 20 74 72 75 65 20 2d 72 65 71 75 69 72 65 me true -require
4b20: 20 74 72 75 65 20 2d 63 61 64 69 72 20 2f 65 74 true -cadir /et
4b30: 63 2f 73 73 6c 2f 63 65 72 74 73 5d 0a 0a 73 65 c/ssl/certs]..se
4b40: 74 20 74 6f 6b 20 5b 68 74 74 70 3a 3a 67 65 74 t tok [http::get
4b50: 75 72 6c 20 68 74 74 70 73 3a 2f 2f 77 77 77 2e url https://www.
4b60: 74 63 6c 2e 74 6b 2f 5d 0a 3c 2f 63 6f 64 65 3e tcl.tk/].</code>
4b70: 3c 2f 70 72 65 3e 0a 0a 3c 62 72 3e 0a 3c 68 33 </pre>..<br>.<h3
4b80: 3e 3c 61 20 6e 61 6d 65 3d 22 53 50 45 43 49 41 ><a name="SPECIA
4b90: 4c 22 3e 53 50 45 43 49 41 4c 20 43 4f 4e 53 49 L">SPECIAL CONSI
4ba0: 44 45 52 41 54 49 4f 4e 53 3c 2f 61 3e 3c 2f 68 DERATIONS</a></h
4bb0: 33 3e 0a 0a 3c 70 3e 54 68 65 20 63 61 70 61 62 3>..<p>The capab
4bc0: 69 6c 69 74 69 65 73 20 6f 66 20 74 68 69 73 20 ilities of this
4bd0: 70 61 63 6b 61 67 65 20 63 61 6e 20 76 61 72 79 package can vary
4be0: 20 65 6e 6f 72 6d 6f 75 73 6c 79 20 62 61 73 65 enormously base
4bf0: 64 20 75 70 6f 6e 20 68 6f 77 20 79 6f 75 72 0a d upon how your.
4c00: 4f 70 65 6e 53 53 4c 20 6c 69 62 72 61 72 79 20 OpenSSL library
4c10: 77 61 73 20 63 6f 6e 66 69 67 75 72 65 64 20 61 was configured a
4c20: 6e 64 20 62 75 69 6c 74 2e 20 4e 65 77 20 76 65 nd built. New ve
4c30: 72 73 69 6f 6e 73 20 6d 61 79 20 6f 62 73 6f 6c rsions may obsol
4c40: 65 74 65 20 6f 6c 64 65 72 0a 63 69 70 68 65 72 ete older.cipher
4c50: 73 2c 20 64 69 67 65 73 74 73 2c 20 4d 41 43 73 s, digests, MACs
4c60: 2c 20 65 74 63 2e 20 6f 72 20 63 68 61 6e 67 65 , etc. or change
4c70: 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 73 2e default values.
4c80: 20 55 73 65 20 74 68 65 0a 69 6e 66 6f 20 63 6f Use the.info co
4c90: 6d 6d 61 6e 64 73 20 74 6f 20 6f 62 74 61 69 6e mmands to obtain
4ca0: 20 74 68 65 20 73 75 70 70 6f 72 74 65 64 20 76 the supported v
4cb0: 61 6c 75 65 73 2e 3c 2f 70 3e 0a 3c 62 72 3e 0a alues.</p>.<br>.
4cc0: 0a 3c 70 72 65 3e 0a 43 6f 70 79 72 69 67 68 74 .<pre>.Copyright
4cd0: 20 26 63 6f 70 79 3b 20 32 30 32 33 20 42 72 69 © 2023 Bri
4ce0: 61 6e 20 4f 27 48 61 67 61 6e 2e 0a 3c 2f 70 72 an O'Hagan..</pr
4cf0: 65 3e 0a 3c 2f 62 6f 64 79 3e 0a 3c 2f 68 74 6d e>.</body>.</htm
4d00: 6c 3e 0a l>.