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 6b 64 66 73 <dd><b>tls::kdfs
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 6d 61 63 73 3c dd><b>tls::macs<
03a0: 2f 62 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 /b></dd>.. <d
03b0: 64 3e 3c 62 3e 74 6c 73 3a 3a 70 72 6f 74 6f 63 d><b>tls::protoc
03c0: 6f 6c 73 3c 2f 62 3e 3c 2f 64 64 3e 0a 09 20 20 ols</b></dd>..
03d0: 20 20 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 76 65 <dd><b>tls::ve
03e0: 72 73 69 6f 6e 3c 2f 62 3e 3c 2f 64 64 3e 0a 09 rsion</b></dd>..
03f0: 20 20 20 20 3c 64 74 3e 26 6e 62 73 70 3b 3c 2f <dt> </
0400: 64 74 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 3e dt>.. <dd><b>
0410: 74 6c 73 3a 3a 63 6d 61 63 3c 2f 62 3e 20 3c 62 tls::cmac</b> <b
0420: 3e 2d 63 69 70 68 65 72 3c 2f 62 3e 20 3c 65 6d >-cipher</b> <em
0430: 3e 6e 61 6d 65 3c 2f 65 6d 3e 20 3c 62 3e 2d 6b >name</em> <b>-k
0440: 65 79 3c 2f 62 3e 20 3c 65 6d 3e 6b 65 79 20 3f ey</b> <em>key ?
0450: 6f 70 74 69 6f 6e 73 3f 3c 2f 65 6d 3e 3c 2f 64 options?</em></d
0460: 64 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 3e 74 d>.. <dd><b>t
0470: 6c 73 3a 3a 68 6d 61 63 3c 2f 62 3e 20 3c 62 3e ls::hmac</b> <b>
0480: 2d 64 69 67 65 73 74 3c 2f 62 3e 20 3c 65 6d 3e -digest</b> <em>
0490: 6e 61 6d 65 3c 2f 65 6d 3e 20 3c 62 3e 2d 6b 65 name</em> <b>-ke
04a0: 79 3c 2f 62 3e 20 3c 65 6d 3e 6b 65 79 20 3f 6f y</b> <em>key ?o
04b0: 70 74 69 6f 6e 73 3f 3c 2f 65 6d 3e 3c 2f 64 64 ptions?</em></dd
04c0: 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 3e 74 6c >.. <dd><b>tl
04d0: 73 3a 3a 6d 64 3c 2f 62 3e 20 3c 62 3e 2d 64 69 s::md</b> <b>-di
04e0: 67 65 73 74 3c 2f 62 3e 20 3c 65 6d 3e 6e 61 6d gest</b> <em>nam
04f0: 65 20 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 65 6d 3e e ?options?</em>
0500: 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 64 3e 3c </dd>.. <dd><
0510: 62 3e 74 6c 73 3a 3a 6d 64 34 3c 2f 62 3e 20 3c b>tls::md4</b> <
0520: 65 6d 3e 64 61 74 61 3c 2f 65 6d 3e 3c 2f 64 64 em>data</em></dd
0530: 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 3e 74 6c >.. <dd><b>tl
0540: 73 3a 3a 6d 64 35 3c 2f 62 3e 20 3c 65 6d 3e 64 s::md5</b> <em>d
0550: 61 74 61 3c 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 20 ata</em></dd>..
0560: 20 20 20 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 73 <dd><b>tls::s
0570: 68 61 31 3c 2f 62 3e 20 3c 65 6d 3e 64 61 74 61 ha1</b> <em>data
0580: 3c 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 </em></dd>..
0590: 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 73 68 61 32 <dd><b>tls::sha2
05a0: 35 36 3c 2f 62 3e 20 3c 65 6d 3e 64 61 74 61 3c 56</b> <em>data<
05b0: 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 3c /em></dd>.. <
05c0: 64 64 3e 3c 62 3e 74 6c 73 3a 3a 73 68 61 35 31 dd><b>tls::sha51
05d0: 32 3c 2f 62 3e 20 3c 65 6d 3e 64 61 74 61 3c 2f 2</b> <em>data</
05e0: 65 6d 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 em></dd>.. <d
05f0: 64 3e 3c 62 3e 74 6c 73 3a 3a 75 6e 73 74 61 63 d><b>tls::unstac
0600: 6b 3c 2f 62 3e 20 3c 65 6d 3e 63 68 61 6e 6e 65 k</b> <em>channe
0610: 6c 49 64 3c 2f 65 6d 3e 3c 2f 64 64 3e 0a 09 20 lId</em></dd>..
0620: 20 20 20 3c 64 74 3e 26 6e 62 73 70 3b 3c 2f 64 <dt> </d
0630: 74 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 3e 74 t>.. <dd><b>t
0640: 6c 73 3a 3a 65 6e 63 72 79 70 74 3c 2f 62 3e 20 ls::encrypt</b>
0650: 3c 62 3e 2d 63 69 70 68 65 72 3c 2f 62 3e 20 3c <b>-cipher</b> <
0660: 65 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e 20 3c 62 3e em>name</em> <b>
0670: 2d 6b 65 79 3c 2f 62 3e 20 3c 65 6d 3e 6b 65 79 -key</b> <em>key
0680: 20 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 65 6d 3e 3c ?options?</em><
0690: 2f 64 64 3e 0a 09 20 20 20 20 3c 64 64 3e 3c 62 /dd>.. <dd><b
06a0: 3e 74 6c 73 3a 3a 64 65 63 72 79 70 74 3c 2f 62 >tls::decrypt</b
06b0: 3e 20 3c 62 3e 2d 63 69 70 68 65 72 3c 2f 62 3e > <b>-cipher</b>
06c0: 20 3c 65 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e 20 3c <em>name</em> <
06d0: 62 3e 2d 6b 65 79 3c 2f 62 3e 20 3c 65 6d 3e 6b b>-key</b> <em>k
06e0: 65 79 20 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 65 6d ey ?options?</em
06f0: 3e 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 74 3e ></dd>.. <dt>
0700: 26 6e 62 73 70 3b 3c 2f 64 74 3e 0a 09 20 20 20 </dt>..
0710: 20 3c 64 64 3e 3c 62 3e 74 6c 73 3a 3a 68 6b 64 <dd><b>tls::hkd
0720: 66 20 2d 64 69 67 65 73 74 3c 2f 62 3e 20 3c 65 f -digest</b> <e
0730: 6d 3e 64 69 67 65 73 74 3c 2f 65 6d 3e 20 3c 62 m>digest</em> <b
0740: 3e 2d 6b 65 79 3c 2f 62 3e 20 3c 65 6d 3e 6b 65 >-key</b> <em>ke
0750: 79 20 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 65 6d 3e y ?options?</em>
0760: 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 64 3e 3c </dd>.. <dd><
0770: 62 3e 74 6c 73 3a 3a 70 62 6b 64 66 32 20 2d 73 b>tls::pbkdf2 -s
0780: 69 7a 65 3c 2f 62 3e 20 3c 65 6d 3e 6c 65 6e 67 ize</b> <em>leng
0790: 74 68 3c 2f 65 6d 3e 20 3c 62 3e 2d 64 69 67 65 th</em> <b>-dige
07a0: 73 74 3c 2f 62 3e 20 3c 65 6d 3e 64 69 67 65 73 st</b> <em>diges
07b0: 74 20 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 65 6d 3e t ?options?</em>
07c0: 3c 2f 64 64 3e 0a 09 20 20 20 20 3c 64 64 3e 3c </dd>.. <dd><
07d0: 62 3e 74 6c 73 3a 3a 73 63 72 79 70 74 20 2d 70 b>tls::scrypt -p
07e0: 61 73 73 77 6f 72 64 3c 2f 62 3e 20 3c 65 6d 3e assword</b> <em>
07f0: 73 74 72 69 6e 67 3c 2f 65 6d 3e 20 3c 62 3e 2d string</em> <b>-
0800: 73 61 6c 74 3c 2f 62 3e 20 3c 65 6d 3e 73 74 72 salt</b> <em>str
0810: 69 6e 67 20 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 65 ing ?options?</e
0820: 6d 3e 3c 2f 64 64 3e 0a 09 3c 2f 64 6c 3e 0a 20 m></dd>..</dl>.
0830: 20 20 20 3c 2f 64 64 3e 0a 20 20 20 20 3c 64 64 </dd>. <dd
0840: 3e 3c 61 20 68 72 65 66 3d 22 23 4f 50 54 49 4f ><a href="#OPTIO
0850: 4e 53 22 3e 4f 50 54 49 4f 4e 53 3c 2f 61 3e 3c NS">OPTIONS</a><
0860: 2f 64 64 3e 0a 20 20 20 20 3c 64 64 3e 3c 61 20 /dd>. <dd><a
0870: 68 72 65 66 3d 22 23 43 4f 4d 4d 41 4e 44 53 22 href="#COMMANDS"
0880: 3e 43 4f 4d 4d 41 4e 44 53 3c 2f 61 3e 3c 2f 64 >COMMANDS</a></d
0890: 64 3e 0a 20 20 20 20 3c 64 64 3e 3c 61 20 68 72 d>. <dd><a hr
08a0: 65 66 3d 22 23 47 4c 4f 53 53 41 52 59 22 3e 47 ef="#GLOSSARY">G
08b0: 4c 4f 53 53 41 52 59 3c 2f 61 3e 20 3c 2f 64 64 LOSSARY</a> </dd
08c0: 3e 0a 20 20 20 20 3c 64 64 3e 3c 61 20 68 72 65 >. <dd><a hre
08d0: 66 3d 22 23 45 58 41 4d 50 4c 45 53 22 3e 45 58 f="#EXAMPLES">EX
08e0: 41 4d 50 4c 45 53 3c 2f 61 3e 3c 2f 64 64 3e 0a AMPLES</a></dd>.
08f0: 20 20 20 20 3c 64 64 3e 3c 61 20 68 72 65 66 3d <dd><a href=
0900: 22 23 53 50 45 43 49 41 4c 22 3e 53 50 45 43 49 "#SPECIAL">SPECI
0910: 41 4c 20 43 4f 4e 53 49 44 45 52 41 54 49 4f 4e AL CONSIDERATION
0920: 53 3c 2f 61 3e 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e S</a></dd>.</dl>
0930: 0a 0a 3c 62 72 3e 0a 0a 3c 68 33 3e 3c 61 20 6e ..<br>..<h3><a n
0940: 61 6d 65 3d 22 4e 41 4d 45 22 3e 4e 41 4d 45 3c ame="NAME">NAME<
0950: 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 3c 73 74 /a></h3>..<p><st
0960: 72 6f 6e 67 3e 74 6c 73 3c 2f 73 74 72 6f 6e 67 rong>tls</strong
0970: 3e 20 2d 20 62 69 6e 64 69 6e 67 20 74 6f 20 3c > - binding to <
0980: 73 74 72 6f 6e 67 3e 4f 70 65 6e 53 53 4c 3c 2f strong>OpenSSL</
0990: 73 74 72 6f 6e 67 3e 20 74 6f 6f 6c 6b 69 74 2e strong> toolkit.
09a0: 3c 2f 70 3e 0a 0a 3c 68 33 3e 3c 61 20 6e 61 6d </p>..<h3><a nam
09b0: 65 3d 22 44 45 53 43 52 49 50 54 49 4f 4e 22 3e e="DESCRIPTION">
09c0: 44 45 53 43 52 49 50 54 49 4f 4e 3c 2f 61 3e 3c DESCRIPTION</a><
09d0: 2f 68 33 3e 0a 0a 3c 70 3e 54 68 69 73 20 65 78 /h3>..<p>This ex
09e0: 74 65 6e 73 69 6f 6e 20 70 72 6f 76 69 64 65 73 tension provides
09f0: 20 61 20 67 65 6e 65 72 69 63 20 69 6e 74 65 72 a generic inter
0a00: 66 61 63 65 20 74 6f 20 74 68 65 0a 3c 61 20 68 face to the.<a h
0a10: 72 65 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e ref="http://www.
0a20: 6f 70 65 6e 73 73 6c 2e 6f 72 67 2f 22 3e 4f 70 openssl.org/">Op
0a30: 65 6e 53 53 4c 3c 2f 61 3e 20 63 72 79 70 74 6f enSSL</a> crypto
0a40: 67 72 61 70 68 79 20 66 75 6e 63 74 69 6f 6e 73 graphy functions
0a50: 2e 20 54 68 65 0a 70 72 6f 76 69 64 65 64 20 63 . The.provided c
0a60: 6f 6d 6d 61 6e 64 73 20 63 61 6e 20 62 65 20 75 ommands can be u
0a70: 73 65 64 20 74 6f 20 65 6e 73 75 72 65 20 74 68 sed to ensure th
0a80: 65 20 63 6f 6e 66 69 64 65 6e 74 69 61 6c 69 74 e confidentialit
0a90: 79 2c 20 61 75 74 68 65 6e 74 69 63 69 74 79 2c y, authenticity,
0aa0: 0a 61 6e 64 20 69 6e 74 65 67 72 69 74 79 20 6f .and integrity o
0ab0: 66 20 6d 65 73 73 61 67 65 73 20 61 6e 64 20 64 f messages and d
0ac0: 61 74 61 2e 3c 2f 70 3e 0a 0a 3c 62 72 3e 0a 3c ata.</p>..<br>.<
0ad0: 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 53 59 4e 4f h3><a name="SYNO
0ae0: 50 53 49 53 22 3e 53 59 4e 4f 50 53 49 53 3c 2f PSIS">SYNOPSIS</
0af0: 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 3c 62 3e 70 a></h3>..<p><b>p
0b00: 61 63 6b 61 67 65 20 72 65 71 75 69 72 65 20 54 ackage require T
0b10: 63 6c 20 38 2e 35 2d 3c 2f 62 3e 3c 62 72 3e 0a cl 8.5-</b><br>.
0b20: 3c 62 3e 70 61 63 6b 61 67 65 20 72 65 71 75 69 <b>package requi
0b30: 72 65 20 74 6c 73 3c 2f 62 3e 3c 62 72 3e 0a 3c re tls</b><br>.<
0b40: 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c br>.<a href="#tl
0b50: 73 3a 3a 63 69 70 68 65 72 22 3e 3c 62 3e 74 6c s::cipher"><b>tl
0b60: 73 3a 3a 63 69 70 68 65 72 3c 2f 62 3e 20 3c 69 s::cipher</b> <i
0b70: 3e 6e 61 6d 65 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 >name</i></a><br
0b80: 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a >.<a href="#tls:
0b90: 3a 63 69 70 68 65 72 73 22 3e 3c 62 3e 74 6c 73 :ciphers"><b>tls
0ba0: 3a 3a 63 69 70 68 65 72 73 3c 2f 62 3e 20 3c 69 ::ciphers</b> <i
0bb0: 3e 3f 70 72 6f 74 6f 63 6f 6c 3f 20 3f 76 65 72 >?protocol? ?ver
0bc0: 62 6f 73 65 3f 20 3f 73 75 70 70 6f 72 74 65 64 bose? ?supported
0bd0: 3f 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 ?</i></a><br>.<a
0be0: 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a 64 69 67 href="#tls::dig
0bf0: 65 73 74 73 22 3e 3c 62 3e 74 6c 73 3a 3a 64 69 ests"><b>tls::di
0c00: 67 65 73 74 73 3c 2f 62 3e 20 3c 69 3e 3f 6e 61 gests</b> <i>?na
0c10: 6d 65 3f 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e 0a me?</i></a><br>.
0c20: 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a 6b <a href="#tls::k
0c30: 64 66 73 22 3e 3c 62 3e 74 6c 73 3a 3a 6b 64 66 dfs"><b>tls::kdf
0c40: 73 3c 2f 62 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 s</b></a><br>.<a
0c50: 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a 6d 61 63 href="#tls::mac
0c60: 73 22 3e 3c 62 3e 74 6c 73 3a 3a 6d 61 63 73 3c s"><b>tls::macs<
0c70: 2f 62 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 /b></a><br>.<a h
0c80: 72 65 66 3d 22 23 74 6c 73 3a 3a 70 72 6f 74 6f ref="#tls::proto
0c90: 63 6f 6c 73 22 3e 3c 62 3e 74 6c 73 3a 3a 70 72 cols"><b>tls::pr
0ca0: 6f 74 6f 63 6f 6c 73 3c 2f 62 3e 3c 2f 61 3e 3c otocols</b></a><
0cb0: 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c br>.<a href="#tl
0cc0: 73 3a 3a 76 65 72 73 69 6f 6e 22 3e 3c 62 3e 74 s::version"><b>t
0cd0: 6c 73 3a 3a 76 65 72 73 69 6f 6e 3c 2f 62 3e 3c ls::version</b><
0ce0: 2f 61 3e 3c 62 72 3e 0a 3c 62 72 3e 0a 3c 61 20 /a><br>.<br>.<a
0cf0: 68 72 65 66 3d 22 23 74 6c 73 3a 3a 63 6d 61 63 href="#tls::cmac
0d00: 22 3e 3c 62 3e 74 6c 73 3a 3a 63 6d 61 63 3c 2f "><b>tls::cmac</
0d10: 62 3e 20 3c 62 3e 2d 63 69 70 68 65 72 3c 2f 62 b> <b>-cipher</b
0d20: 3e 20 3c 69 3e 6e 61 6d 65 3c 2f 69 3e 20 3c 62 > <i>name</i> <b
0d30: 3e 2d 6b 65 79 3c 2f 62 3e 20 3c 69 3e 6b 65 79 >-key</b> <i>key
0d40: 20 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 69 3e 3c 2f ?options?</i></
0d50: 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 a><br>.<a href="
0d60: 23 74 6c 73 3a 3a 68 6d 61 63 22 3e 3c 62 3e 74 #tls::hmac"><b>t
0d70: 6c 73 3a 3a 68 6d 61 63 3c 2f 62 3e 20 3c 62 3e ls::hmac</b> <b>
0d80: 2d 64 69 67 65 73 74 3c 2f 62 3e 20 3c 69 3e 6e -digest</b> <i>n
0d90: 61 6d 65 3c 2f 69 3e 20 3c 62 3e 2d 6b 65 79 3c ame</i> <b>-key<
0da0: 2f 62 3e 20 3c 69 3e 6b 65 79 20 3f 6f 70 74 69 /b> <i>key ?opti
0db0: 6f 6e 73 3f 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e ons?</i></a><br>
0dc0: 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a .<a href="#tls::
0dd0: 6d 64 22 3e 3c 62 3e 74 6c 73 3a 3a 6d 64 3c 2f md"><b>tls::md</
0de0: 62 3e 20 3c 62 3e 2d 64 69 67 65 73 74 3c 2f 62 b> <b>-digest</b
0df0: 3e 20 3c 69 3e 6e 61 6d 65 20 3f 6f 70 74 69 6f > <i>name ?optio
0e00: 6e 73 3f 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e 0a ns?</i></a><br>.
0e10: 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a 6d <a href="#tls::m
0e20: 64 34 22 3e 3c 62 3e 74 6c 73 3a 3a 6d 64 34 3c d4"><b>tls::md4<
0e30: 2f 62 3e 20 3c 69 3e 64 61 74 61 3c 2f 69 3e 3c /b> <i>data</i><
0e40: 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d /a><br>.<a href=
0e50: 22 23 74 6c 73 3a 3a 6d 64 35 22 3e 3c 62 3e 74 "#tls::md5"><b>t
0e60: 6c 73 3a 3a 6d 64 35 3c 2f 62 3e 20 3c 69 3e 64 ls::md5</b> <i>d
0e70: 61 74 61 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e 0a ata</i></a><br>.
0e80: 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a 73 <a href="#tls::s
0e90: 68 61 31 22 3e 3c 62 3e 74 6c 73 3a 3a 73 68 61 ha1"><b>tls::sha
0ea0: 31 3c 2f 62 3e 20 3c 69 3e 64 61 74 61 3c 2f 69 1</b> <i>data</i
0eb0: 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 ></a><br>.<a hre
0ec0: 66 3d 22 23 74 6c 73 3a 3a 73 68 61 32 35 36 22 f="#tls::sha256"
0ed0: 3e 3c 62 3e 74 6c 73 3a 3a 73 68 61 32 35 36 3c ><b>tls::sha256<
0ee0: 2f 62 3e 20 3c 69 3e 64 61 74 61 3c 2f 69 3e 3c /b> <i>data</i><
0ef0: 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d /a><br>.<a href=
0f00: 22 23 74 6c 73 3a 3a 73 68 61 35 31 32 22 3e 3c "#tls::sha512"><
0f10: 62 3e 74 6c 73 3a 3a 73 68 61 35 31 32 3c 2f 62 b>tls::sha512</b
0f20: 3e 20 3c 69 3e 64 61 74 61 3c 2f 69 3e 3c 2f 61 > <i>data</i></a
0f30: 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 ><br>.<a href="#
0f40: 74 6c 73 3a 3a 75 6e 73 74 61 63 6b 22 3e 3c 62 tls::unstack"><b
0f50: 3e 74 6c 73 3a 3a 75 6e 73 74 61 63 6b 3c 2f 62 >tls::unstack</b
0f60: 3e 20 3c 69 3e 63 68 61 6e 6e 65 6c 49 64 3c 2f > <i>channelId</
0f70: 69 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 62 72 3e 0a i></a><br>.<br>.
0f80: 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a 65 <a href="#tls::e
0f90: 6e 63 72 79 70 74 22 3e 3c 62 3e 74 6c 73 3a 3a ncrypt"><b>tls::
0fa0: 65 6e 63 72 79 70 74 3c 2f 62 3e 20 3c 62 3e 2d encrypt</b> <b>-
0fb0: 63 69 70 68 65 72 3c 2f 62 3e 20 3c 69 3e 6e 61 cipher</b> <i>na
0fc0: 6d 65 3c 2f 69 3e 20 3c 62 3e 2d 6b 65 79 3c 2f me</i> <b>-key</
0fd0: 62 3e 20 3c 69 3e 6b 65 79 20 3f 6f 70 74 69 6f b> <i>key ?optio
0fe0: 6e 73 3f 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e 0a ns?</i></a><br>.
0ff0: 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a 64 <a href="#tls::d
1000: 65 63 72 79 70 74 22 3e 3c 62 3e 74 6c 73 3a 3a ecrypt"><b>tls::
1010: 64 65 63 72 79 70 74 3c 2f 62 3e 20 3c 62 3e 2d decrypt</b> <b>-
1020: 63 69 70 68 65 72 3c 2f 62 3e 20 3c 69 3e 6e 61 cipher</b> <i>na
1030: 6d 65 3c 2f 69 3e 20 3c 62 3e 2d 6b 65 79 3c 2f me</i> <b>-key</
1040: 62 3e 20 3c 69 3e 6b 65 79 20 3f 6f 70 74 69 6f b> <i>key ?optio
1050: 6e 73 3f 3c 2f 69 3e 3c 2f 61 3e 3c 62 72 3e 0a ns?</i></a><br>.
1060: 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 23 74 <br>.<a href="#t
1070: 6c 73 3a 3a 68 6b 64 66 22 3e 3c 62 3e 74 6c 73 ls::hkdf"><b>tls
1080: 3a 3a 68 6b 64 66 20 2d 64 69 67 65 73 74 3c 2f ::hkdf -digest</
1090: 62 3e 20 3c 69 3e 64 69 67 65 73 74 3c 2f 69 3e b> <i>digest</i>
10a0: 20 3c 62 3e 2d 6b 65 79 3c 2f 62 3e 20 3c 69 3e <b>-key</b> <i>
10b0: 6b 65 79 20 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 69 key ?options?</i
10c0: 3e 3c 2f 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 ></a><br>.<a hre
10d0: 66 3d 22 23 74 6c 73 3a 3a 70 62 6b 64 66 32 22 f="#tls::pbkdf2"
10e0: 3e 3c 62 3e 74 6c 73 3a 3a 70 62 6b 64 66 32 20 ><b>tls::pbkdf2
10f0: 2d 73 69 7a 65 3c 2f 62 3e 20 3c 69 3e 6c 65 6e -size</b> <i>len
1100: 67 74 68 3c 2f 69 3e 20 3c 62 3e 2d 64 69 67 65 gth</i> <b>-dige
1110: 73 74 3c 2f 62 3e 20 3c 69 3e 64 69 67 65 73 74 st</b> <i>digest
1120: 20 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 69 3e 3c 2f ?options?</i></
1130: 61 3e 3c 62 72 3e 0a 3c 61 20 68 72 65 66 3d 22 a><br>.<a href="
1140: 23 74 6c 73 3a 3a 73 63 72 79 70 74 22 3e 3c 62 #tls::scrypt"><b
1150: 3e 74 6c 73 3a 3a 73 63 72 79 70 74 20 2d 70 61 >tls::scrypt -pa
1160: 73 73 77 6f 72 64 3c 2f 62 3e 20 3c 69 3e 73 74 ssword</b> <i>st
1170: 72 69 6e 67 3c 2f 69 3e 20 3c 62 3e 2d 73 61 6c ring</i> <b>-sal
1180: 74 3c 2f 62 3e 20 3c 69 3e 73 74 72 69 6e 67 20 t</b> <i>string
1190: 3f 6f 70 74 69 6f 6e 73 3f 3c 2f 69 3e 3c 2f 61 ?options?</i></a
11a0: 3e 3c 62 72 3e 0a 3c 2f 70 3e 0a 0a 3c 62 72 3e ><br>.</p>..<br>
11b0: 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 4f 50 .<h3><a name="OP
11c0: 54 49 4f 4e 53 22 3e 4f 50 54 49 4f 4e 53 3c 2f TIONS">OPTIONS</
11d0: 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 54 68 65 20 a></h3>..<p>The
11e0: 66 6f 6c 6c 6f 77 69 6e 67 20 6f 70 74 69 6f 6e following option
11f0: 73 20 61 72 65 20 75 73 65 64 20 62 79 20 74 68 s are used by th
1200: 65 20 63 72 79 70 74 6f 67 72 61 70 68 79 20 63 e cryptography c
1210: 6f 6d 6d 61 6e 64 73 2e 3c 2f 70 3e 0a 3c 62 72 ommands.</p>.<br
1220: 3e 0a 3c 68 34 3e 43 72 79 70 74 6f 67 72 61 70 >.<h4>Cryptograp
1230: 68 69 63 20 4f 70 74 69 6f 6e 73 3c 2f 68 34 3e hic Options</h4>
1240: 0a 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c ..<dl>. <dt><
1250: 61 20 6e 61 6d 65 3d 22 2d 61 61 64 5f 64 61 74 a name="-aad_dat
1260: 61 22 3e 3c 73 74 72 6f 6e 67 3e 2d 61 61 64 5f a"><strong>-aad_
1270: 64 61 74 61 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 data</strong> <e
1280: 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c 2f 61 m>string</em></a
1290: 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 41 ></dt>. <dd>A
12a0: 64 64 69 74 69 6f 6e 61 6c 20 41 75 74 68 65 6e dditional Authen
12b0: 74 69 63 61 74 65 64 20 44 61 74 61 20 28 41 41 ticated Data (AA
12c0: 44 29 2e 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a D).</dd>.</dl>..
12d0: 3c 64 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 20 <dl>. <dt><a
12e0: 6e 61 6d 65 3d 22 2d 63 69 70 68 65 72 22 3e 3c name="-cipher"><
12f0: 73 74 72 6f 6e 67 3e 2d 63 69 70 68 65 72 3c 2f strong>-cipher</
1300: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6e 61 6d 65 strong> <em>name
1310: 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 </em></a></dt>.
1320: 20 20 20 3c 64 64 3e 4e 61 6d 65 20 6f 66 20 73 <dd>Name of s
1330: 79 6d 6d 65 74 72 69 63 20 63 69 70 68 65 72 20 ymmetric cipher
1340: 74 6f 20 75 73 65 2e 20 55 73 65 64 20 62 79 20 to use. Used by
1350: 65 6e 63 72 79 70 74 2f 64 65 63 72 79 70 74 20 encrypt/decrypt
1360: 63 6f 6d 6d 61 6e 64 0a 20 20 20 20 61 6e 64 20 command. and
1370: 43 4d 41 43 20 26 61 6d 70 3b 20 47 4d 41 43 20 CMAC & GMAC
1380: 68 61 73 68 20 61 6c 67 6f 72 69 74 68 6d 73 2e hash algorithms.
1390: 20 46 6f 72 20 43 4d 41 43 2c 20 69 74 20 6d 75 For CMAC, it mu
13a0: 73 74 20 62 65 20 6f 6e 65 20 6f 66 0a 20 20 20 st be one of.
13b0: 20 3c 62 3e 41 45 53 2d 31 32 38 2d 43 42 43 3c <b>AES-128-CBC<
13c0: 2f 62 3e 2c 20 3c 62 3e 41 45 53 2d 31 39 32 2d /b>, <b>AES-192-
13d0: 43 42 43 3c 2f 62 3e 2c 20 3c 62 3e 41 45 53 2d CBC</b>, <b>AES-
13e0: 32 35 36 2d 43 42 43 3c 2f 62 3e 2c 20 6f 72 0a 256-CBC</b>, or.
13f0: 20 20 20 20 3c 62 3e 44 45 53 2d 45 44 45 33 2d <b>DES-EDE3-
1400: 43 42 43 3c 2f 62 3e 2e 20 46 6f 72 20 47 4d 41 CBC</b>. For GMA
1410: 43 20 69 74 20 73 68 6f 75 6c 64 20 62 65 20 61 C it should be a
1420: 20 47 43 4d 20 6d 6f 64 65 20 63 69 70 68 65 72 GCM mode cipher
1430: 20 28 65 2e 67 2e 0a 20 20 20 20 41 45 53 2d 31 (e.g.. AES-1
1440: 32 38 2d 47 43 4d 29 2e 20 53 65 65 20 3c 61 20 28-GCM). See <a
1450: 68 72 65 66 3d 22 23 74 6c 73 3a 3a 63 69 70 68 href="#tls::ciph
1460: 65 72 73 22 3e 3c 62 3e 74 6c 73 3a 3a 63 69 70 ers"><b>tls::cip
1470: 68 65 72 73 3c 2f 62 3e 3c 2f 61 3e 0a 20 20 20 hers</b></a>.
1480: 20 63 6f 6d 6d 61 6e 64 20 66 6f 72 20 74 68 65 command for the
1490: 20 76 61 6c 69 64 20 76 61 6c 75 65 73 2e 20 4f valid values. O
14a0: 6e 6c 79 20 43 43 4d 20 61 6e 64 20 47 43 4d 20 nly CCM and GCM
14b0: 6d 6f 64 65 73 20 28 61 6c 73 6f 20 20 6b 6e 6f modes (also kno
14c0: 77 6e 20 61 73 20 41 75 74 68 65 6e 74 69 63 61 wn as Authentica
14d0: 74 65 64 0a 20 20 20 20 45 6e 63 72 79 70 74 69 ted. Encrypti
14e0: 6f 6e 20 77 69 74 68 20 41 73 73 6f 63 69 61 74 on with Associat
14f0: 65 64 20 44 61 74 61 20 28 41 45 41 44 29 20 6d ed Data (AEAD) m
1500: 6f 64 65 73 29 20 70 72 6f 76 69 64 65 20 62 6f odes) provide bo
1510: 74 68 20 63 6f 6e 66 69 64 65 6e 74 69 61 6c 6c th confidentiall
1520: 79 0a 20 20 20 20 61 6e 64 20 69 6e 74 65 67 72 y. and integr
1530: 69 74 79 20 70 72 6f 74 65 63 74 69 6f 6e 2e 3c ity protection.<
1540: 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 64 6c 3e /dd>.</dl>..<dl>
1550: 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 . <dt><a name
1560: 3d 22 2d 64 69 67 65 73 74 22 3e 3c 73 74 72 6f ="-digest"><stro
1570: 6e 67 3e 2d 64 69 67 65 73 74 3c 2f 73 74 72 6f ng>-digest</stro
1580: 6e 67 3e 20 3c 65 6d 3e 6e 61 6d 65 3c 2f 65 6d ng> <em>name</em
1590: 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c ></a></dt>. <
15a0: 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 2d 68 61 73 dt><a name="-has
15b0: 68 22 3e 3c 73 74 72 6f 6e 67 3e 2d 68 61 73 68 h"><strong>-hash
15c0: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 6e 61 </strong> <em>na
15d0: 6d 65 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e me</em></a></dt>
15e0: 0a 20 20 20 20 3c 64 64 3e 4e 61 6d 65 20 6f 66 . <dd>Name of
15f0: 20 68 61 73 68 20 66 75 6e 63 74 69 6f 6e 20 28 hash function (
1600: 61 6b 61 20 6d 65 73 73 61 67 65 20 64 69 67 65 aka message dige
1610: 73 74 29 20 74 6f 20 75 73 65 2e 0a 20 20 20 20 st) to use..
1620: 53 65 65 20 3c 61 20 68 72 65 66 3d 22 23 74 6c See <a href="#tl
1630: 73 3a 3a 64 69 67 65 73 74 73 22 3e 3c 62 3e 74 s::digests"><b>t
1640: 6c 73 3a 3a 64 69 67 65 73 74 73 3c 2f 62 3e 3c ls::digests</b><
1650: 2f 61 3e 20 63 6f 6d 6d 61 6e 64 20 66 6f 72 20 /a> command for
1660: 74 68 65 20 76 61 6c 69 64 20 76 61 6c 75 65 73 the valid values
1670: 2e 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 64 .</dd>.</dl>..<d
1680: 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 l>. <dt><a na
1690: 6d 65 3d 22 2d 69 6e 66 6f 22 3e 3c 73 74 72 6f me="-info"><stro
16a0: 6e 67 3e 2d 69 6e 66 6f 3c 2f 73 74 72 6f 6e 67 ng>-info</strong
16b0: 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d > <em>string</em
16c0: 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c ></a></dt>. <
16d0: 64 64 3e 4f 70 74 69 6f 6e 61 6c 20 63 6f 6e 74 dd>Optional cont
16e0: 65 78 74 20 61 6e 64 20 61 70 70 6c 69 63 61 74 ext and applicat
16f0: 69 6f 6e 20 73 70 65 63 69 66 69 63 20 69 6e 66 ion specific inf
1700: 6f 72 6d 61 74 69 6f 6e 2e 20 43 61 6e 20 62 65 ormation. Can be
1710: 20 61 20 62 69 6e 61 72 79 0a 20 20 20 20 6f 72 a binary. or
1720: 20 74 65 78 74 20 73 74 72 69 6e 67 2e 20 3c 2f text string. </
1730: 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 64 6c 3e 0a dd>.</dl>..<dl>.
1740: 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d <dt><a name=
1750: 22 2d 69 74 65 72 61 74 69 6f 6e 73 22 3e 3c 73 "-iterations"><s
1760: 74 72 6f 6e 67 3e 2d 69 74 65 72 61 74 69 6f 6e trong>-iteration
1770: 73 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 63 s</strong> <em>c
1780: 6f 75 6e 74 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 ount</em></a></d
1790: 74 3e 0a 20 20 20 20 3c 64 64 3e 4e 75 6d 62 65 t>. <dd>Numbe
17a0: 72 20 28 69 6e 74 65 67 65 72 20 26 67 74 3b 20 r (integer >
17b0: 30 29 20 6f 66 20 69 74 65 72 61 74 69 6f 6e 73 0) of iterations
17c0: 20 74 6f 20 75 73 65 20 69 6e 20 64 65 72 69 76 to use in deriv
17d0: 69 6e 67 20 74 68 65 20 65 6e 63 72 79 70 74 69 ing the encrypti
17e0: 6f 6e 0a 20 20 20 20 6b 65 79 2e 20 44 65 66 61 on. key. Defa
17f0: 75 6c 74 20 69 73 20 32 30 34 38 2e 20 53 6f 6d ult is 2048. Som
1800: 65 20 3c 61 20 68 72 65 66 3d 22 23 4b 44 46 22 e <a href="#KDF"
1810: 3e 3c 62 3e 4b 44 46 3c 2f 62 3e 3c 2f 61 3e 20 ><b>KDF</b></a>
1820: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 0a implementations.
1830: 20 20 20 20 72 65 71 75 69 72 65 20 61 6e 20 69 require an i
1840: 74 65 72 61 74 69 6f 6e 20 63 6f 75 6e 74 2e 3c teration count.<
1850: 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 64 6c 3e /dd>.</dl>..<dl>
1860: 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 . <dt><a name
1870: 3d 22 2d 69 76 22 3e 3c 73 74 72 6f 6e 67 3e 2d ="-iv"><strong>-
1880: 69 76 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e iv</strong> <em>
1890: 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c 2f 61 3e 3c string</em></a><
18a0: 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 49 6e 69 /dt>. <dd>Ini
18b0: 74 69 61 6c 69 7a 61 74 69 6f 6e 20 76 65 63 74 tialization vect
18c0: 6f 72 20 28 49 56 29 20 74 6f 20 75 73 65 2e 20 or (IV) to use.
18d0: 52 65 71 75 69 72 65 64 20 66 6f 72 20 73 6f 6d Required for som
18e0: 65 20 63 69 70 68 65 72 73 20 61 6e 64 20 47 4d e ciphers and GM
18f0: 41 43 2e 0a 20 20 20 20 43 69 70 68 65 72 20 6d AC.. Cipher m
1900: 6f 64 65 73 20 43 42 43 2c 20 43 46 42 2c 20 61 odes CBC, CFB, a
1910: 6e 64 20 4f 46 42 20 61 6c 6c 20 6e 65 65 64 20 nd OFB all need
1920: 61 6e 20 49 56 20 77 68 69 6c 65 20 45 43 42 20 an IV while ECB
1930: 61 6e 64 20 43 54 52 20 6d 6f 64 65 73 20 64 6f and CTR modes do
1940: 20 6e 6f 74 2e 0a 20 20 20 20 41 20 6e 65 77 2c not.. A new,
1950: 20 72 61 6e 64 6f 6d 20 49 56 20 73 68 6f 75 6c random IV shoul
1960: 64 20 62 65 20 63 72 65 61 74 65 64 20 66 6f 72 d be created for
1970: 20 65 61 63 68 20 75 73 65 2e 20 54 68 69 6e 6b each use. Think
1980: 20 6f 66 20 74 68 65 20 49 56 20 61 73 20 61 20 of the IV as a
1990: 6e 6f 6e 63 65 0a 20 20 20 20 28 6e 75 6d 62 65 nonce. (numbe
19a0: 72 20 75 73 65 64 20 6f 6e 63 65 29 2c 20 69 74 r used once), it
19b0: 27 73 20 70 75 62 6c 69 63 20 62 75 74 20 72 61 's public but ra
19c0: 6e 64 6f 6d 20 61 6e 64 20 75 6e 70 72 65 64 69 ndom and unpredi
19d0: 63 74 61 62 6c 65 2e 20 53 65 65 20 74 68 65 0a ctable. See the.
19e0: 20 20 20 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 <a href="#tls
19f0: 3a 3a 63 69 70 68 65 72 22 3e 3c 62 3e 74 6c 73 ::cipher"><b>tls
1a00: 3a 3a 63 69 70 68 65 72 3c 2f 62 3e 3c 2f 61 3e ::cipher</b></a>
1a10: 20 66 6f 72 20 69 76 5f 6c 65 6e 67 74 68 20 61 for iv_length a
1a20: 6e 64 20 77 68 65 6e 0a 20 20 20 72 65 71 75 69 nd when. requi
1a30: 72 65 64 20 28 6c 65 6e 67 74 68 20 3e 20 30 29 red (length > 0)
1a40: 2e 20 4d 61 78 20 69 73 20 31 36 20 62 79 74 65 . Max is 16 byte
1a50: 73 2e 20 49 66 20 6e 6f 74 20 73 65 74 2c 20 69 s. If not set, i
1a60: 74 20 77 69 6c 6c 20 64 65 66 61 75 6c 74 20 74 t will default t
1a70: 6f 20 5c 78 30 30 0a 20 20 20 66 69 6c 6c 20 64 o \x00. fill d
1a80: 61 74 61 2e 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a ata.</dd>.</dl>.
1a90: 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 .<dl>. <dt><a
1aa0: 20 6e 61 6d 65 3d 22 2d 6b 65 79 22 3e 3c 73 74 name="-key"><st
1ab0: 72 6f 6e 67 3e 2d 6b 65 79 3c 2f 73 74 72 6f 6e rong>-key</stron
1ac0: 67 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 3c 2f 65 g> <em>string</e
1ad0: 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 m></a></dt>.
1ae0: 3c 64 64 3e 45 6e 63 72 79 70 74 69 6f 6e 20 6b <dd>Encryption k
1af0: 65 79 20 74 6f 20 75 73 65 20 66 6f 72 20 63 72 ey to use for cr
1b00: 79 70 74 6f 67 72 61 70 68 79 20 66 75 6e 63 74 yptography funct
1b10: 69 6f 6e 2e 20 43 61 6e 20 62 65 20 61 20 62 69 ion. Can be a bi
1b20: 6e 61 72 79 20 6f 72 0a 20 20 20 20 74 65 78 74 nary or. text
1b30: 20 73 74 72 69 6e 67 2e 20 4c 6f 6e 67 65 72 20 string. Longer
1b40: 6b 65 79 73 20 70 72 6f 76 69 64 65 20 62 65 74 keys provide bet
1b50: 74 65 72 20 70 72 6f 74 65 63 74 69 6f 6e 2e 20 ter protection.
1b60: 55 73 65 64 20 62 79 20 63 69 70 68 65 72 73 2c Used by ciphers,
1b70: 20 48 4d 41 43 2c 0a 20 20 20 20 73 6f 6d 65 20 HMAC,. some
1b80: 43 4d 41 43 2c 20 61 6e 64 20 73 6f 6d 65 20 4b CMAC, and some K
1b90: 44 46 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f DF implementatio
1ba0: 6e 73 2e 20 49 66 20 74 68 65 20 6c 65 6e 67 74 ns. If the lengt
1bb0: 68 20 6f 66 20 74 68 65 20 6b 65 79 20 69 73 20 h of the key is
1bc0: 26 6c 74 3b 0a 20 20 20 20 3c 62 3e 6b 65 79 5f <. <b>key_
1bd0: 6c 65 6e 67 74 68 3c 2f 62 3e 20 69 74 20 77 69 length</b> it wi
1be0: 6c 6c 20 62 65 20 70 61 64 64 65 64 2e 20 4d 61 ll be padded. Ma
1bf0: 78 20 69 73 20 36 34 20 62 79 74 65 73 2e 20 49 x is 64 bytes. I
1c00: 66 20 26 67 74 3b 20 6b 65 79 5f 6c 65 6e 67 74 f > key_lengt
1c10: 68 2c 20 69 74 20 77 69 6c 6c 20 62 65 20 72 65 h, it will be re
1c20: 6a 65 63 74 65 64 2e 0a 20 20 20 20 53 65 65 20 jected.. See
1c30: 74 68 65 20 3c 61 20 68 72 65 66 3d 22 23 74 6c the <a href="#tl
1c40: 73 3a 3a 63 69 70 68 65 72 22 3e 3c 62 3e 74 6c s::cipher"><b>tl
1c50: 73 3a 3a 63 69 70 68 65 72 3c 2f 62 3e 3c 2f 61 s::cipher</b></a
1c60: 3e 20 66 6f 72 20 6b 65 79 5f 6c 65 6e 67 74 68 > for key_length
1c70: 2e 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 64 .</dd>.</dl>..<d
1c80: 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 l>. <dt><a na
1c90: 6d 65 3d 22 2d 6d 61 63 22 3e 3c 73 74 72 6f 6e me="-mac"><stron
1ca0: 67 3e 2d 6d 61 63 3c 2f 73 74 72 6f 6e 67 3e 20 g>-mac</strong>
1cb0: 3c 65 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e 3c 2f 61 <em>name</em></a
1cc0: 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 4e ></dt>. <dd>N
1cd0: 61 6d 65 20 6f 66 20 4d 65 73 73 61 67 65 20 41 ame of Message A
1ce0: 75 74 68 65 6e 74 69 63 61 74 69 6f 6e 20 43 6f uthentication Co
1cf0: 64 65 20 28 4d 41 43 29 20 74 6f 20 75 73 65 2e de (MAC) to use.
1d00: 0a 20 20 20 20 53 65 65 20 3c 61 20 68 72 65 66 . See <a href
1d10: 3d 22 23 74 6c 73 3a 3a 6d 61 63 22 3e 3c 62 3e ="#tls::mac"><b>
1d20: 74 6c 73 3a 3a 6d 61 63 73 3c 2f 62 3e 3c 2f 61 tls::macs</b></a
1d30: 3e 20 63 6f 6d 6d 61 6e 64 20 66 6f 72 20 74 68 > command for th
1d40: 65 20 76 61 6c 69 64 20 76 61 6c 75 65 73 2e 3c e valid values.<
1d50: 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 64 6c 3e /dd>.</dl>..<dl>
1d60: 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 . <dt><a name
1d70: 3d 22 2d 70 61 73 73 77 6f 72 64 22 3e 3c 73 74 ="-password"><st
1d80: 72 6f 6e 67 3e 2d 70 61 73 73 77 6f 72 64 3c 2f rong>-password</
1d90: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 72 69 strong> <em>stri
1da0: 6e 67 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e ng</em></a></dt>
1db0: 0a 20 20 20 20 3c 64 64 3e 50 61 73 73 77 6f 72 . <dd>Passwor
1dc0: 64 20 74 6f 20 75 73 65 20 66 6f 72 20 73 6f 6d d to use for som
1dd0: 65 20 4b 44 46 20 66 75 6e 63 74 69 6f 6e 73 2e e KDF functions.
1de0: 20 49 66 20 6e 6f 74 20 73 70 65 63 69 66 69 65 If not specifie
1df0: 64 2c 20 74 68 65 20 64 65 66 61 75 6c 74 0a 20 d, the default.
1e00: 20 20 20 76 61 6c 75 65 20 69 73 20 75 73 65 64 value is used
1e10: 2e 20 43 61 6e 20 62 65 20 61 20 62 69 6e 61 72 . Can be a binar
1e20: 79 20 6f 72 20 74 65 78 74 20 73 74 72 69 6e 67 y or text string
1e30: 2e 20 46 6f 72 20 4b 44 46 20 63 6f 6d 6d 61 6e . For KDF comman
1e40: 64 73 2c 20 74 68 69 73 20 69 73 0a 20 20 20 20 ds, this is.
1e50: 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 65 20 the same as the
1e60: 3c 62 3e 2d 6b 65 79 3c 2f 62 3e 20 6f 70 74 69 <b>-key</b> opti
1e70: 6f 6e 2e 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a on.</dd>.</dl>..
1e80: 3c 64 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 20 <dl>. <dt><a
1e90: 6e 61 6d 65 3d 22 2d 70 72 6f 70 65 72 74 69 65 name="-propertie
1ea0: 73 22 3e 3c 73 74 72 6f 6e 67 3e 2d 70 72 6f 70 s"><strong>-prop
1eb0: 65 72 74 69 65 73 3c 2f 73 74 72 6f 6e 67 3e 20 erties</strong>
1ec0: 3c 65 6d 3e 6c 69 73 74 3c 2f 65 6d 3e 3c 2f 61 <em>list</em></a
1ed0: 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 4c ></dt>. <dd>L
1ee0: 69 73 74 20 6f 66 20 61 64 64 69 74 69 6f 6e 61 ist of additiona
1ef0: 6c 20 70 72 6f 70 65 72 74 69 65 73 20 74 6f 20 l properties to
1f00: 70 61 73 73 20 74 6f 20 63 72 79 70 74 6f 67 72 pass to cryptogr
1f10: 61 70 68 69 63 20 66 75 6e 63 74 69 6f 6e 2e 3c aphic function.<
1f20: 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 64 6c 3e /dd>.</dl>..<dl>
1f30: 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 . <dt><a name
1f40: 3d 22 2d 73 61 6c 74 22 3e 3c 73 74 72 6f 6e 67 ="-salt"><strong
1f50: 3e 2d 73 61 6c 74 3c 2f 73 74 72 6f 6e 67 3e 20 >-salt</strong>
1f60: 3c 65 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c <em>string</em><
1f70: 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 /a></dt>. <dd
1f80: 3e 53 70 65 63 69 66 69 65 73 20 73 61 6c 74 20 >Specifies salt
1f90: 76 61 6c 75 65 20 74 6f 20 75 73 65 20 77 68 65 value to use whe
1fa0: 6e 20 65 6e 63 72 79 70 74 69 6e 67 20 64 61 74 n encrypting dat
1fb0: 61 2e 20 43 61 6e 20 62 65 20 61 20 62 69 6e 61 a. Can be a bina
1fc0: 72 79 20 6f 72 0a 20 20 20 20 74 65 78 74 20 73 ry or. text s
1fd0: 74 72 69 6e 67 2e 20 44 65 66 61 75 6c 74 20 69 tring. Default i
1fe0: 73 20 74 6f 20 75 73 65 20 61 20 73 74 72 69 6e s to use a strin
1ff0: 67 20 6f 66 20 5c 30 27 73 2e 20 49 74 20 69 73 g of \0's. It is
2000: 20 62 65 73 74 20 74 6f 20 75 73 65 20 61 0a 20 best to use a.
2010: 20 20 20 75 6e 69 71 75 65 6c 79 20 61 6e 64 20 uniquely and
2020: 72 61 6e 64 6f 6d 6c 79 20 67 65 6e 65 72 61 74 randomly generat
2030: 65 64 20 76 61 6c 75 65 2e 20 54 68 69 73 20 6f ed value. This o
2040: 70 74 69 6f 6e 20 69 73 20 75 73 65 64 20 62 79 ption is used by
2050: 20 42 4c 41 4b 45 32 20 4d 41 43 0a 20 20 20 20 BLAKE2 MAC.
2060: 61 6e 64 20 73 6f 6d 65 20 4b 44 46 20 69 6d 70 and some KDF imp
2070: 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 20 75 73 65 lementations use
2080: 20 61 20 6e 6f 6e 2d 73 65 63 72 65 74 20 75 6e a non-secret un
2090: 69 71 75 65 20 63 72 79 70 74 6f 67 72 61 70 68 ique cryptograph
20a0: 69 63 20 73 61 6c 74 2e 3c 2f 64 64 3e 0a 3c 2f ic salt.</dd>.</
20b0: 64 6c 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 dl>..<dl>. <d
20c0: 74 3e 3c 61 20 6e 61 6d 65 3d 22 2d 6c 65 6e 67 t><a name="-leng
20d0: 74 68 22 3e 3c 73 74 72 6f 6e 67 3e 2d 6c 65 6e th"><strong>-len
20e0: 67 74 68 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d gth</strong> <em
20f0: 3e 69 6e 74 65 67 65 72 3c 2f 65 6d 3e 3c 2f 61 >integer</em></a
2100: 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 74 3e 3c ></dt>. <dt><
2110: 61 20 6e 61 6d 65 3d 22 2d 73 69 7a 65 22 3e 3c a name="-size"><
2120: 73 74 72 6f 6e 67 3e 2d 73 69 7a 65 3c 2f 73 74 strong>-size</st
2130: 72 6f 6e 67 3e 20 3c 65 6d 3e 69 6e 74 65 67 65 rong> <em>intege
2140: 72 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a r</em></a></dt>.
2150: 20 20 20 20 3c 64 64 3e 53 65 74 20 74 68 65 20 <dd>Set the
2160: 6f 75 74 70 75 74 20 68 61 73 68 20 6f 72 20 4b output hash or K
2170: 44 46 20 6c 65 6e 67 74 68 20 69 6e 20 62 79 74 DF length in byt
2180: 65 73 2e 20 55 73 65 64 20 62 79 20 4b 44 46 73 es. Used by KDFs
2190: 2c 20 4b 4d 41 43 31 32 38 2c 20 61 6e 64 0a 20 , KMAC128, and.
21a0: 20 20 20 4b 4d 41 43 32 35 36 20 74 6f 20 73 70 KMAC256 to sp
21b0: 65 63 69 66 79 20 61 6e 20 6f 75 74 70 75 74 20 ecify an output
21c0: 6c 65 6e 67 74 68 20 69 6e 20 62 79 74 65 73 2e length in bytes.
21d0: 20 54 68 65 20 64 65 66 61 75 6c 74 20 73 69 7a The default siz
21e0: 65 0a 20 20 20 20 66 6f 72 20 4b 4d 41 43 31 32 e. for KMAC12
21f0: 38 20 69 73 20 33 32 20 62 79 74 65 73 20 61 6e 8 is 32 bytes an
2200: 64 20 4b 4d 41 43 32 35 36 20 69 73 20 36 34 20 d KMAC256 is 64
2210: 62 79 74 65 73 2e 3c 2f 64 64 3e 0a 3c 2f 64 6c bytes.</dd>.</dl
2220: 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 74 3e >..<dl>. <dt>
2230: 3c 61 20 6e 61 6d 65 3d 22 2d 61 75 74 68 5f 74 <a name="-auth_t
2240: 61 67 22 3e 3c 73 74 72 6f 6e 67 3e 2d 74 61 67 ag"><strong>-tag
2250: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 73 74 </strong> <em>st
2260: 72 69 6e 67 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 ring</em></a></d
2270: 74 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 t>. <dt><a na
2280: 6d 65 3d 22 2d 74 61 67 22 3e 3c 73 74 72 6f 6e me="-tag"><stron
2290: 67 3e 2d 74 61 67 3c 2f 73 74 72 6f 6e 67 3e 20 g>-tag</strong>
22a0: 3c 65 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c <em>string</em><
22b0: 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 /a></dt>. <dd
22c0: 3e 41 75 74 68 65 6e 74 69 63 61 74 65 64 20 45 >Authenticated E
22d0: 6e 63 72 79 70 74 69 6f 6e 20 61 6e 64 20 41 75 ncryption and Au
22e0: 74 68 65 6e 74 69 63 61 74 65 64 20 44 61 74 61 thenticated Data
22f0: 20 28 41 45 41 44 29 20 74 61 67 2e 0a 20 20 20 (AEAD) tag..
2300: 20 43 61 6e 20 62 65 20 61 20 62 69 6e 61 72 79 Can be a binary
2310: 20 6f 72 20 74 65 78 74 20 73 74 72 69 6e 67 2e or text string.
2320: 20 4d 61 78 20 69 73 20 31 36 20 62 79 74 65 73 Max is 16 bytes
2330: 2e 20 41 20 6d 69 6e 69 6d 75 6d 20 6f 66 20 31 . A minimum of 1
2340: 32 0a 20 20 20 20 62 79 74 65 73 20 69 73 20 72 2. bytes is r
2350: 65 63 6f 6d 6d 65 6e 64 65 64 2e 3c 2f 64 64 3e ecommended.</dd>
2360: 0a 3c 2f 64 6c 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 .</dl>..<dl>.
2370: 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 2d 78 <dt><a name="-x
2380: 6f 66 22 3e 3c 73 74 72 6f 6e 67 3e 2d 78 6f 66 of"><strong>-xof
2390: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 62 6f </strong> <em>bo
23a0: 6f 6c 65 61 6e 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f olean</em></a></
23b0: 64 74 3e 0a 20 20 20 20 3c 64 64 3e 53 65 74 20 dt>. <dd>Set
23c0: 77 68 65 74 68 65 72 20 74 6f 20 75 73 65 20 58 whether to use X
23d0: 4f 46 2e 20 54 68 69 73 20 6f 70 74 69 6f 6e 20 OF. This option
23e0: 69 73 20 75 73 65 64 20 62 79 20 4b 4d 41 43 2e is used by KMAC.
23f0: 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 62 72 </dd>.</dl>..<br
2400: 3e 0a 3c 68 34 3e 49 6e 70 75 74 2f 4f 75 74 70 >.<h4>Input/Outp
2410: 75 74 20 4f 70 74 69 6f 6e 73 3c 2f 68 34 3e 0a ut Options</h4>.
2420: 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 .<dl>. <dt><a
2430: 20 6e 61 6d 65 3d 22 2d 63 68 61 6e 22 3e 3c 73 name="-chan"><s
2440: 74 72 6f 6e 67 3e 2d 63 68 61 6e 3c 2f 73 74 72 trong>-chan</str
2450: 6f 6e 67 3e 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c ong> <em>channel
2460: 49 64 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e Id</em></a></dt>
2470: 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 . <dt><a name
2480: 3d 22 2d 63 68 61 6e 22 3e 3c 73 74 72 6f 6e 67 ="-chan"><strong
2490: 3e 2d 63 68 61 6e 6e 65 6c 3c 2f 73 74 72 6f 6e >-channel</stron
24a0: 67 3e 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c 49 64 g> <em>channelId
24b0: 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 </em></a></dt>.
24c0: 20 20 20 3c 64 64 3e 41 64 64 20 74 68 65 20 63 <dd>Add the c
24d0: 72 79 70 74 6f 67 72 61 70 68 69 63 20 74 72 61 ryptographic tra
24e0: 6e 73 66 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 nsformation on t
24f0: 6f 70 20 6f 66 20 63 68 61 6e 6e 65 6c 0a 09 3c op of channel..<
2500: 65 6d 3e 63 68 61 6e 6e 65 6c 49 64 3c 2f 65 6d em>channelId</em
2510: 3e 2e 20 41 75 74 6f 6d 61 74 69 63 61 6c 6c 79 >. Automatically
2520: 20 73 65 74 73 20 63 68 61 6e 6e 65 6c 20 74 6f sets channel to
2530: 20 62 69 6e 61 72 79 20 6d 6f 64 65 2e 20 57 6f binary mode. Wo
2540: 72 6b 73 0a 09 6c 69 6b 65 20 3c 62 3e 63 68 61 rks..like <b>cha
2550: 6e 20 70 75 73 68 3c 2f 62 3e 20 74 6f 20 63 72 n push</b> to cr
2560: 65 61 74 65 20 61 20 73 74 61 63 6b 65 64 20 63 eate a stacked c
2570: 68 61 6e 6e 65 6c 2e 20 49 66 20 74 68 65 20 63 hannel. If the c
2580: 6f 6d 6d 61 6e 64 0a 09 3c 62 3e 66 69 6c 65 65 ommand..<b>filee
2590: 76 65 6e 74 3c 2f 62 3e 20 69 73 20 74 6f 20 62 vent</b> is to b
25a0: 65 20 75 73 65 64 20 66 6f 72 20 63 68 61 6e 6e e used for chann
25b0: 65 6c 20 65 76 65 6e 74 20 6d 6f 6e 69 74 6f 72 el event monitor
25c0: 69 6e 67 2c 20 61 6c 6c 0a 09 63 68 61 6e 6e 65 ing, all..channe
25d0: 6c 73 20 69 6e 20 74 68 65 20 73 74 61 63 6b 20 ls in the stack
25e0: 73 68 6f 75 6c 64 20 62 65 20 73 65 74 20 74 6f should be set to
25f0: 20 6e 6f 6e 2d 62 6c 6f 63 6b 69 6e 67 20 6d 6f non-blocking mo
2600: 64 65 2e 20 49 66 20 6e 6f 74 2c 0a 09 74 68 65 de. If not,..the
2610: 20 73 79 73 74 65 6d 20 6d 61 79 20 68 61 6e 67 system may hang
2620: 20 77 68 69 6c 65 20 77 61 69 74 69 6e 67 20 66 while waiting f
2630: 6f 72 20 64 61 74 61 2e 20 57 68 65 6e 20 64 6f or data. When do
2640: 6e 65 2c 20 75 73 65 20 65 69 74 68 65 72 20 74 ne, use either t
2650: 68 65 0a 09 63 6c 6f 73 65 20 63 6f 6d 6d 61 6e he..close comman
2660: 64 20 6f 72 20 3c 61 20 68 72 65 66 3d 22 23 74 d or <a href="#t
2670: 6c 73 3a 3a 75 6e 73 74 61 63 6b 22 3e 3c 73 74 ls::unstack"><st
2680: 72 6f 6e 67 3e 74 6c 73 3a 3a 75 6e 73 74 61 63 rong>tls::unstac
2690: 6b 3c 2f 73 74 72 6f 6e 67 3e 3c 2f 61 3e 0a 09 k</strong></a>..
26a0: 74 6f 20 72 65 6d 6f 76 65 20 74 68 65 20 74 72 to remove the tr
26b0: 61 6e 73 66 6f 72 6d 20 66 72 6f 6d 20 74 68 65 ansform from the
26c0: 20 63 68 61 6e 6e 65 6c 2e 20 41 64 64 69 74 69 channel. Additi
26d0: 6f 6e 61 6c 20 74 72 61 6e 73 66 6f 72 6d 73 20 onal transforms
26e0: 63 61 6e 6e 6f 74 0a 09 62 65 20 61 64 64 65 64 cannot..be added
26f0: 20 74 6f 20 63 68 61 6e 6e 65 6c 2e 20 45 78 61 to channel. Exa
2700: 6d 70 6c 65 20 63 6f 64 65 3a 3c 2f 64 64 3e 3c mple code:</dd><
2710: 2f 64 6c 3e 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 /dl>. <blockq
2720: 75 6f 74 65 3e 3c 63 6f 64 65 3e 0a 09 09 73 65 uote><code>...se
2730: 74 20 63 68 20 5b 6f 70 65 6e 20 74 65 73 74 5f t ch [open test_
2740: 66 69 6c 65 2e 74 78 74 20 72 62 5d 3c 62 72 3e file.txt rb]<br>
2750: 0a 09 09 3a 3a 74 6c 73 3a 3a 64 69 67 65 73 74 ...::tls::digest
2760: 20 2d 64 69 67 65 73 74 20 73 68 61 32 35 36 20 -digest sha256
2770: 2d 63 68 61 6e 20 24 63 68 3c 62 72 3e 0a 09 09 -chan $ch<br>...
2780: 73 65 74 20 64 61 74 61 20 22 22 3c 62 72 3e 0a set data ""<br>.
2790: 09 09 77 68 69 6c 65 20 7b 21 5b 65 6f 66 20 24 ..while {![eof $
27a0: 63 68 5d 7d 20 7b 61 70 70 65 6e 64 20 64 61 74 ch]} {append dat
27b0: 61 20 5b 72 65 61 64 20 24 63 68 20 34 30 39 36 a [read $ch 4096
27c0: 5d 7d 3c 62 72 3e 0a 09 09 63 6c 6f 73 65 20 24 ]}<br>...close $
27d0: 63 68 3c 62 72 3e 0a 09 09 70 75 74 73 20 24 64 ch<br>...puts $d
27e0: 61 74 61 0a 20 20 20 20 3c 2f 63 6f 64 65 3e 3c ata. </code><
27f0: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 64 /blockquote>..<d
2800: 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 l>. <dt><a na
2810: 6d 65 3d 22 2d 63 6f 6d 6d 61 6e 64 22 3e 3c 73 me="-command"><s
2820: 74 72 6f 6e 67 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f trong>-command</
2830: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 63 6d 64 4e strong> <em>cmdN
2840: 61 6d 65 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 ame</em></a></dt
2850: 3e 0a 20 20 20 20 3c 64 64 3e 43 72 65 61 74 65 >. <dd>Create
2860: 20 61 6e 64 20 72 65 74 75 72 6e 20 3c 65 6d 3e and return <em>
2870: 63 6d 64 4e 61 6d 65 3c 2f 65 6d 3e 20 77 68 69 cmdName</em> whi
2880: 63 68 20 69 73 20 75 73 65 64 20 74 6f 20 69 6e ch is used to in
2890: 63 72 65 6d 65 6e 74 61 6c 6c 79 20 61 64 64 0a crementally add.
28a0: 09 64 61 74 61 20 74 6f 20 61 20 63 72 79 70 74 .data to a crypt
28b0: 6f 67 72 61 70 68 69 63 20 66 75 6e 63 74 69 6f ographic functio
28c0: 6e 2e 20 54 6f 20 61 64 64 20 64 61 74 61 20 74 n. To add data t
28d0: 6f 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 2c 20 o the function,
28e0: 63 61 6c 6c 0a 09 26 71 75 6f 74 3b 3c 65 6d 3e call.."<em>
28f0: 63 6d 64 4e 61 6d 65 3c 2f 65 6d 3e 20 3c 62 3e cmdName</em> <b>
2900: 75 70 64 61 74 65 3c 2f 62 3e 20 3c 65 6d 3e 64 update</b> <em>d
2910: 61 74 61 3c 2f 65 6d 3e 26 71 75 6f 74 3b 2c 20 ata</em>",
2920: 77 68 65 72 65 0a 09 3c 65 6d 3e 64 61 74 61 3c where..<em>data<
2930: 2f 65 6d 3e 20 69 73 20 74 68 65 20 64 61 74 61 /em> is the data
2940: 20 74 6f 20 61 64 64 2e 20 57 68 65 6e 20 64 6f to add. When do
2950: 6e 65 2c 20 63 61 6c 6c 0a 09 26 71 75 6f 74 3b ne, call.."
2960: 3c 65 6d 3e 63 6d 64 4e 61 6d 65 3c 2f 65 6d 3e <em>cmdName</em>
2970: 20 3c 62 3e 66 69 6e 61 6c 69 7a 65 3c 2f 62 3e <b>finalize</b>
2980: 26 71 75 6f 74 3b 20 74 6f 20 72 65 74 75 72 6e " to return
2990: 20 74 68 65 20 72 65 73 75 6c 74 69 6e 67 0a 09 the resulting..
29a0: 76 61 6c 75 65 20 61 6e 64 20 64 65 6c 65 74 65 value and delete
29b0: 20 3c 65 6d 3e 63 6d 64 4e 61 6d 65 3c 2f 65 6d <em>cmdName</em
29c0: 3e 2e 20 45 78 61 6d 70 6c 65 20 63 6f 64 65 3a >. Example code:
29d0: 3c 2f 64 64 3e 3c 2f 64 6c 3e 0a 20 20 20 20 3c </dd></dl>. <
29e0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 63 6f 64 65 blockquote><code
29f0: 3e 0a 09 09 73 65 74 20 63 6d 64 20 5b 3a 3a 74 >...set cmd [::t
2a00: 6c 73 3a 3a 64 69 67 65 73 74 20 2d 64 69 67 65 ls::digest -dige
2a10: 73 74 20 73 68 61 32 35 36 20 2d 63 6f 6d 6d 61 st sha256 -comma
2a20: 6e 64 20 3a 3a 74 6c 73 3a 3a 74 65 6d 70 5d 3c nd ::tls::temp]<
2a30: 62 72 3e 0a 09 09 73 65 74 20 64 61 74 61 20 22 br>...set data "
2a40: 22 3c 62 72 3e 0a 09 09 61 70 70 65 6e 64 20 64 "<br>...append d
2a50: 61 74 61 20 5b 24 63 6d 64 20 75 70 64 61 74 65 ata [$cmd update
2a60: 20 22 53 6f 6d 65 20 64 61 74 61 2e 20 22 5d 3c "Some data. "]<
2a70: 62 72 3e 0a 09 09 61 70 70 65 6e 64 20 64 61 74 br>...append dat
2a80: 61 20 5b 24 63 6d 64 20 75 70 64 61 74 65 20 22 a [$cmd update "
2a90: 4d 6f 72 65 20 64 61 74 61 2e 22 5d 3c 62 72 3e More data."]<br>
2aa0: 0a 09 09 61 70 70 65 6e 64 20 64 61 74 61 20 5b ...append data [
2ab0: 24 63 6d 64 20 66 69 6e 61 6c 69 7a 65 5d 3c 62 $cmd finalize]<b
2ac0: 72 3e 0a 09 09 70 75 74 73 20 24 64 61 74 61 0a r>...puts $data.
2ad0: 20 20 20 20 3c 2f 63 6f 64 65 3e 3c 2f 62 6c 6f </code></blo
2ae0: 63 6b 71 75 6f 74 65 3e 0a 0a 3c 64 6c 3e 0a 20 ckquote>..<dl>.
2af0: 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 <dt><a name="
2b00: 2d 64 61 74 61 22 3e 3c 73 74 72 6f 6e 67 3e 2d -data"><strong>-
2b10: 64 61 74 61 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 data</strong> <e
2b20: 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d 3e 3c 2f 61 m>string</em></a
2b30: 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 50 ></dt>. <dd>P
2b40: 65 72 66 6f 72 6d 20 74 68 65 20 63 72 79 70 74 erform the crypt
2b50: 6f 67 72 61 70 68 69 63 20 66 75 6e 63 74 69 6f ographic functio
2b60: 6e 20 6f 6e 20 3c 65 6d 3e 64 61 74 61 3c 2f 65 n on <em>data</e
2b70: 6d 3e 20 61 6e 64 20 72 65 74 75 72 6e 20 74 68 m> and return th
2b80: 65 0a 20 20 20 20 72 65 73 75 6c 74 2e 20 45 78 e. result. Ex
2b90: 61 6d 70 6c 65 20 63 6f 64 65 3a 3c 2f 64 64 3e ample code:</dd>
2ba0: 3c 2f 64 6c 3e 0a 20 20 20 20 3c 62 6c 6f 63 6b </dl>. <block
2bb0: 71 75 6f 74 65 3e 3c 63 6f 64 65 3e 0a 09 09 73 quote><code>...s
2bc0: 65 74 20 6d 64 20 5b 3a 3a 74 6c 73 3a 3a 64 69 et md [::tls::di
2bd0: 67 65 73 74 20 73 68 61 32 35 36 20 22 53 6f 6d gest sha256 "Som
2be0: 65 20 65 78 61 6d 70 6c 65 20 64 61 74 61 2e 22 e example data."
2bf0: 5d 3c 62 72 3e 0a 09 09 70 75 74 73 20 24 6d 64 ]<br>...puts $md
2c00: 0a 20 20 20 20 3c 2f 63 6f 64 65 3e 3c 2f 62 6c . </code></bl
2c10: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 64 6c 3e 0a ockquote>..<dl>.
2c20: 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d <dt><a name=
2c30: 22 2d 66 69 6c 65 22 3e 3c 73 74 72 6f 6e 67 3e "-file"><strong>
2c40: 2d 66 69 6c 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c -file</strong> <
2c50: 65 6d 3e 66 69 6c 65 6e 61 6d 65 3c 2f 65 6d 3e em>filename</em>
2c60: 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 </a></dt>. <d
2c70: 74 3e 3c 61 20 6e 61 6d 65 3d 22 2d 66 69 6c 65 t><a name="-file
2c80: 22 3e 3c 73 74 72 6f 6e 67 3e 2d 66 69 6c 65 6e "><strong>-filen
2c90: 61 6d 65 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d ame</strong> <em
2ca0: 3e 66 69 6c 65 6e 61 6d 65 3c 2f 65 6d 3e 3c 2f >filename</em></
2cb0: 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e a></dt>. <dd>
2cc0: 50 65 72 66 6f 72 6d 20 74 68 65 20 63 72 79 70 Perform the cryp
2cd0: 74 6f 67 72 61 70 68 69 63 20 66 75 6e 63 74 69 tographic functi
2ce0: 6f 6e 20 6f 6e 20 66 69 6c 65 20 3c 65 6d 3e 66 on on file <em>f
2cf0: 69 6c 65 6e 61 6d 65 3c 2f 65 6d 3e 20 61 6e 64 ilename</em> and
2d00: 20 72 65 74 75 72 6e 0a 20 20 20 20 74 68 65 20 return. the
2d10: 72 65 73 75 6c 74 2e 20 54 68 69 73 20 6f 70 65 result. This ope
2d20: 72 61 74 69 6f 6e 20 77 69 6c 6c 20 6f 70 65 6e ration will open
2d30: 20 66 69 6c 65 2c 20 72 65 61 64 20 74 68 65 20 file, read the
2d40: 66 69 6c 65 20 64 61 74 61 2c 20 63 6c 6f 73 65 file data, close
2d50: 20 74 68 65 0a 20 20 20 20 66 69 6c 65 2c 20 61 the. file, a
2d60: 6e 64 20 72 65 74 75 72 6e 20 74 68 65 20 72 65 nd return the re
2d70: 73 75 6c 74 20 75 73 69 6e 67 20 74 68 65 20 54 sult using the T
2d80: 43 4c 20 66 69 6c 65 20 41 50 49 73 2c 20 73 6f CL file APIs, so
2d90: 20 56 46 53 20 66 69 6c 65 73 20 61 72 65 0a 20 VFS files are.
2da0: 20 20 20 73 75 70 70 6f 72 74 65 64 2e 20 45 78 supported. Ex
2db0: 61 6d 70 6c 65 20 63 6f 64 65 3a 3c 2f 64 64 3e ample code:</dd>
2dc0: 3c 2f 64 6c 3e 0a 20 20 20 20 3c 62 6c 6f 63 6b </dl>. <block
2dd0: 71 75 6f 74 65 3e 3c 63 6f 64 65 3e 0a 09 09 73 quote><code>...s
2de0: 65 74 20 6d 64 20 5b 3a 3a 74 6c 73 3a 3a 64 69 et md [::tls::di
2df0: 67 65 73 74 20 2d 64 69 67 65 73 74 20 73 68 61 gest -digest sha
2e00: 32 35 36 20 2d 66 69 6c 65 20 74 65 73 74 5f 66 256 -file test_f
2e10: 69 6c 65 2e 74 78 74 5d 3c 62 72 3e 0a 09 09 70 ile.txt]<br>...p
2e20: 75 74 73 20 24 6d 64 0a 20 20 20 20 3c 2f 63 6f uts $md. </co
2e30: 64 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e de></blockquote>
2e40: 0a 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c ..<dl>. <dt><
2e50: 61 20 6e 61 6d 65 3d 22 2d 69 6e 66 69 6c 65 22 a name="-infile"
2e60: 3e 3c 73 74 72 6f 6e 67 3e 2d 69 6e 66 69 6c 65 ><strong>-infile
2e70: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 66 69 </strong> <em>fi
2e80: 6c 65 6e 61 6d 65 3c 2f 65 6d 3e 3c 2f 61 3e 3c lename</em></a><
2e90: 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 53 70 65 /dt>. <dd>Spe
2ea0: 63 69 66 69 65 73 20 74 68 65 20 66 69 6c 65 20 cifies the file
2eb0: 74 6f 20 75 73 65 20 61 73 20 64 61 74 61 20 69 to use as data i
2ec0: 6e 70 75 74 20 73 6f 75 72 63 65 2e 20 54 68 69 nput source. Thi
2ed0: 73 20 6f 70 74 69 6f 6e 20 75 73 65 73 20 74 68 s option uses th
2ee0: 65 0a 20 20 20 20 54 43 4c 20 66 69 6c 65 20 41 e. TCL file A
2ef0: 50 49 73 2c 20 73 6f 20 56 46 53 20 66 69 6c 65 PIs, so VFS file
2f00: 73 20 61 72 65 20 73 75 70 70 6f 72 74 65 64 2e s are supported.
2f10: 20 45 78 61 6d 70 6c 65 20 63 6f 64 65 3a 3c 2f Example code:</
2f20: 64 64 3e 3c 2f 64 6c 3e 0a 20 20 20 20 3c 62 6c dd></dl>. <bl
2f30: 6f 63 6b 71 75 6f 74 65 3e 3c 63 6f 64 65 3e 0a ockquote><code>.
2f40: 09 09 3a 3a 74 6c 73 3a 3a 65 6e 63 72 79 70 74 ..::tls::encrypt
2f50: 20 2d 63 69 70 68 65 72 20 61 65 73 2d 31 32 38 -cipher aes-128
2f60: 2d 63 62 63 20 2d 6b 65 79 20 22 54 65 73 74 20 -cbc -key "Test
2f70: 6b 65 79 22 0a 09 09 2d 69 6e 66 69 6c 65 20 75 key"...-infile u
2f80: 6e 65 6e 63 72 79 70 74 65 64 2e 74 78 74 20 2d nencrypted.txt -
2f90: 6f 75 74 66 69 6c 65 20 65 6e 63 72 79 70 74 65 outfile encrypte
2fa0: 64 2e 64 61 74 0a 20 20 20 20 3c 2f 63 6f 64 65 d.dat. </code
2fb0: 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a ></blockquote>..
2fc0: 3c 64 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 20 <dl>. <dt><a
2fd0: 6e 61 6d 65 3d 22 2d 6f 75 74 66 69 6c 65 22 3e name="-outfile">
2fe0: 3c 73 74 72 6f 6e 67 3e 2d 6f 75 74 66 69 6c 65 <strong>-outfile
2ff0: 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 66 69 </strong> <em>fi
3000: 6c 65 6e 61 6d 65 3c 2f 65 6d 3e 3c 2f 61 3e 3c lename</em></a><
3010: 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 53 70 65 /dt>. <dd>Spe
3020: 63 69 66 69 65 73 20 74 68 65 20 66 69 6c 65 20 cifies the file
3030: 74 6f 20 6f 75 74 70 75 74 20 74 68 65 20 65 6e to output the en
3040: 63 72 79 70 74 69 6f 6e 20 72 65 73 75 6c 74 73 cryption results
3050: 20 74 6f 2e 20 54 68 69 73 20 6f 70 74 69 6f 6e to. This option
3060: 0a 20 20 20 20 75 73 65 73 20 74 68 65 20 54 43 . uses the TC
3070: 4c 20 66 69 6c 65 20 41 50 49 73 2c 20 73 6f 20 L file APIs, so
3080: 56 46 53 20 66 69 6c 65 73 20 61 72 65 20 73 75 VFS files are su
3090: 70 70 6f 72 74 65 64 2e 20 45 78 61 6d 70 6c 65 pported. Example
30a0: 20 63 6f 64 65 3a 3c 2f 64 64 3e 3c 2f 64 6c 3e code:</dd></dl>
30b0: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 . <blockquote
30c0: 3e 3c 63 6f 64 65 3e 0a 09 09 3a 3a 74 6c 73 3a ><code>...::tls:
30d0: 3a 64 65 63 72 79 70 74 20 2d 63 69 70 68 65 72 :decrypt -cipher
30e0: 20 61 65 73 2d 31 32 38 2d 63 62 63 20 2d 6b 65 aes-128-cbc -ke
30f0: 79 20 22 54 65 73 74 20 6b 65 79 22 0a 09 09 2d y "Test key"...-
3100: 69 6e 66 69 6c 65 20 65 6e 63 72 79 70 74 65 64 infile encrypted
3110: 2e 64 61 74 20 2d 6f 75 74 66 69 6c 65 20 75 6e .dat -outfile un
3120: 65 6e 63 72 79 70 74 65 64 2e 74 78 74 0a 20 20 encrypted.txt.
3130: 20 20 3c 2f 63 6f 64 65 3e 3c 2f 62 6c 6f 63 6b </code></block
3140: 71 75 6f 74 65 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 quote>..<dl>.
3150: 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 2d 6b <dt><a name="-k
3160: 65 79 66 69 6c 65 22 3e 3c 73 74 72 6f 6e 67 3e eyfile"><strong>
3170: 2d 6b 65 79 66 69 6c 65 3c 2f 73 74 72 6f 6e 67 -keyfile</strong
3180: 3e 20 3c 65 6d 3e 66 69 6c 65 6e 61 6d 65 3c 2f > <em>filename</
3190: 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 em></a></dt>.
31a0: 20 3c 64 64 3e 53 70 65 63 69 66 69 65 73 20 74 <dd>Specifies t
31b0: 68 65 20 66 69 6c 65 20 74 6f 20 67 65 74 20 74 he file to get t
31c0: 68 65 20 65 6e 63 72 79 70 74 69 6f 6e 20 6b 65 he encryption ke
31d0: 79 20 66 72 6f 6d 2e 3c 2f 64 64 3e 3c 2f 64 6c y from.</dd></dl
31e0: 3e 0a 0a 3c 62 72 3e 0a 0a 3c 68 34 3e 46 6f 72 >..<br>..<h4>For
31f0: 6d 61 74 20 4f 70 74 69 6f 6e 73 3c 2f 68 34 3e mat Options</h4>
3200: 0a 0a 3c 64 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c ..<dl>. <dt><
3210: 61 20 6e 61 6d 65 3d 22 2d 62 61 73 65 36 34 22 a name="-base64"
3220: 3e 3c 73 74 72 6f 6e 67 3e 2d 62 61 73 65 36 34 ><strong>-base64
3230: 3c 2f 73 74 72 6f 6e 67 3e 3c 2f 61 3e 3c 2f 64 </strong></a></d
3240: 74 3e 0a 20 20 20 20 3c 64 64 3e 42 61 73 65 36 t>. <dd>Base6
3250: 34 20 65 6e 63 6f 64 65 20 64 61 74 61 20 61 66 4 encode data af
3260: 74 65 72 20 65 6e 63 72 79 70 74 69 6f 6e 20 6f ter encryption o
3270: 72 20 64 65 63 6f 64 65 20 62 65 66 6f 72 65 20 r decode before
3280: 64 65 63 72 79 70 74 69 6f 6e 2e 3c 2f 64 64 3e decryption.</dd>
3290: 0a 3c 2f 64 6c 3e 0a 0a 3c 64 6c 3e 0a 20 20 20 .</dl>..<dl>.
32a0: 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 2d 62 <dt><a name="-b
32b0: 69 6e 22 3e 3c 73 74 72 6f 6e 67 3e 2d 62 69 6e in"><strong>-bin
32c0: 3c 2f 73 74 72 6f 6e 67 3e 3c 2f 61 3e 3c 2f 64 </strong></a></d
32d0: 74 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 t>. <dt><a na
32e0: 6d 65 3d 22 2d 62 69 6e 22 3e 3c 73 74 72 6f 6e me="-bin"><stron
32f0: 67 3e 2d 62 69 6e 61 72 79 3c 2f 73 74 72 6f 6e g>-binary</stron
3300: 67 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 g></a></dt>.
3310: 3c 64 64 3e 4f 75 74 70 75 74 20 72 65 73 75 6c <dd>Output resul
3320: 74 20 6f 66 20 66 75 6e 63 74 69 6f 6e 20 61 73 t of function as
3330: 20 61 20 62 69 6e 61 72 79 20 73 74 72 69 6e 67 a binary string
3340: 2e 3c 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 64 .</dd>.</dl>..<d
3350: 6c 3e 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 l>. <dt><a na
3360: 6d 65 3d 22 2d 68 65 78 22 3e 3c 73 74 72 6f 6e me="-hex"><stron
3370: 67 3e 2d 68 65 78 3c 2f 73 74 72 6f 6e 67 3e 3c g>-hex</strong><
3380: 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 74 /a></dt>. <dt
3390: 3e 3c 61 20 6e 61 6d 65 3d 22 2d 68 65 78 22 3e ><a name="-hex">
33a0: 3c 73 74 72 6f 6e 67 3e 2d 68 65 78 61 64 65 63 <strong>-hexadec
33b0: 69 6d 61 6c 3c 2f 73 74 72 6f 6e 67 3e 3c 2f 61 imal</strong></a
33c0: 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 4f ></dt>. <dd>O
33d0: 75 74 70 75 74 20 72 65 73 75 6c 74 20 6f 66 20 utput result of
33e0: 66 75 6e 63 74 69 6f 6e 20 61 73 20 61 20 68 65 function as a he
33f0: 78 61 64 65 63 69 6d 61 6c 20 73 74 72 69 6e 67 xadecimal string
3400: 2e 20 54 68 69 73 20 69 73 20 74 68 65 20 64 65 . This is the de
3410: 66 61 75 6c 74 0a 09 6f 70 74 69 6f 6e 20 75 6e fault..option un
3420: 6c 65 73 73 20 6f 74 68 65 72 77 69 73 65 20 73 less otherwise s
3430: 70 65 63 69 66 69 65 64 2e 3c 2f 64 64 3e 0a 3c pecified.</dd>.<
3440: 2f 64 6c 3e 0a 0a 3c 62 72 3e 0a 3c 68 33 3e 3c /dl>..<br>.<h3><
3450: 61 20 6e 61 6d 65 3d 22 43 4f 4d 4d 41 4e 44 53 a name="COMMANDS
3460: 22 3e 43 4f 4d 4d 41 4e 44 53 3c 2f 61 3e 3c 2f ">COMMANDS</a></
3470: 68 33 3e 0a 0a 3c 70 3e 54 68 65 20 66 6f 6c 6c h3>..<p>The foll
3480: 6f 77 69 6e 67 20 63 6f 6d 6d 61 6e 64 73 20 70 owing commands p
3490: 72 6f 76 69 64 65 20 61 63 63 65 73 73 20 74 6f rovide access to
34a0: 20 74 68 65 20 4f 70 65 6e 53 53 4c 20 63 72 79 the OpenSSL cry
34b0: 70 74 6f 67 72 61 70 68 79 20 66 75 6e 63 74 69 ptography functi
34c0: 6f 6e 73 2e 3c 2f 70 3e 0a 0a 3c 64 6c 3e 0a 0a ons.</p>..<dl>..
34d0: 3c 68 34 3e 3c 61 20 6e 61 6d 65 3d 22 49 6e 66 <h4><a name="Inf
34e0: 6f 22 3e 49 6e 66 6f 20 43 6f 6d 6d 61 6e 64 73 o">Info Commands
34f0: 3c 2f 61 3e 3c 2f 68 34 3e 0a 0a 20 20 20 20 3c </a></h4>.. <
3500: 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 3a dt><a name="tls:
3510: 3a 63 69 70 68 65 72 22 3e 3c 73 74 72 6f 6e 67 :cipher"><strong
3520: 3e 74 6c 73 3a 3a 63 69 70 68 65 72 3c 2f 73 74 >tls::cipher</st
3530: 72 6f 6e 67 3e 20 3c 65 6d 3e 6e 61 6d 65 3c 2f rong> <em>name</
3540: 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 em></a></dt>.
3550: 20 3c 64 64 3e 52 65 74 75 72 6e 73 20 61 20 6c <dd>Returns a l
3560: 69 73 74 20 6f 66 20 70 72 6f 70 65 72 74 79 20 ist of property
3570: 6e 61 6d 65 20 61 6e 64 20 76 61 6c 75 65 20 70 name and value p
3580: 61 69 72 73 20 64 65 73 63 72 69 62 69 6e 67 20 airs describing
3590: 63 69 70 68 65 72 0a 09 3c 69 3e 6e 61 6d 65 3c cipher..<i>name<
35a0: 2f 69 3e 2e 20 50 72 6f 70 65 72 74 69 65 73 20 /i>. Properties
35b0: 61 72 65 3a 3c 2f 64 64 3e 0a 20 20 20 20 3c 62 are:</dd>. <b
35c0: 6c 6f 63 6b 71 75 6f 74 65 3e 3c 74 61 62 6c 65 lockquote><table
35d0: 3e 0a 09 3c 74 72 3e 3c 74 64 3e 3c 62 3e 6e 69 >..<tr><td><b>ni
35e0: 64 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 3e 49 6e d</b></td><td>In
35f0: 74 65 72 6e 61 6c 20 69 64 20 6f 66 20 63 69 70 ternal id of cip
3600: 68 65 72 2e 20 54 68 69 73 20 69 73 20 74 68 65 her. This is the
3610: 20 73 61 6d 65 20 61 73 20 3c 69 3e 6e 61 6d 65 same as <i>name
3620: 3c 2f 69 3e 2e 3c 74 64 3e 3c 2f 74 72 3e 0a 09 </i>.<td></tr>..
3630: 3c 74 72 3e 3c 74 64 3e 3c 62 3e 6e 61 6d 65 3c <tr><td><b>name<
3640: 2f 62 3e 3c 2f 74 64 3e 3c 74 64 3e 4e 61 6d 65 /b></td><td>Name
3650: 20 6f 72 20 61 6c 69 61 73 20 6f 66 20 74 68 65 or alias of the
3660: 20 63 69 70 68 65 72 2e 3c 74 64 3e 3c 2f 74 72 cipher.<td></tr
3670: 3e 0a 09 3c 74 72 3e 3c 74 64 3e 3c 62 3e 64 65 >..<tr><td><b>de
3680: 73 63 72 69 70 74 69 6f 6e 3c 2f 62 3e 3c 2f 74 scription</b></t
3690: 64 3e 3c 74 64 3e 44 65 73 63 72 69 70 74 69 6f d><td>Descriptio
36a0: 6e 20 6f 66 20 74 68 65 20 63 69 70 68 65 72 2e n of the cipher.
36b0: 20 4f 70 65 6e 53 53 4c 20 33 2e 30 2b 20 6f 6e OpenSSL 3.0+ on
36c0: 6c 79 2e 3c 74 64 3e 3c 2f 74 72 3e 0a 09 3c 74 ly.<td></tr>..<t
36d0: 72 3e 3c 74 64 3e 3c 62 3e 62 6c 6f 63 6b 5f 73 r><td><b>block_s
36e0: 69 7a 65 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 3e ize</b></td><td>
36f0: 42 6c 6f 63 6b 20 73 69 7a 65 20 6f 66 20 74 68 Block size of th
3700: 65 20 63 69 70 68 65 72 2e 20 53 74 72 65 61 6d e cipher. Stream
3710: 20 63 69 70 68 65 72 73 20 61 72 65 20 73 65 74 ciphers are set
3720: 20 74 6f 20 31 2e 3c 74 64 3e 3c 2f 74 72 3e 0a to 1.<td></tr>.
3730: 09 3c 74 72 3e 3c 74 64 3e 3c 62 3e 6b 65 79 5f .<tr><td><b>key_
3740: 6c 65 6e 67 74 68 3c 2f 62 3e 3c 2f 74 64 3e 3c length</b></td><
3750: 74 64 3e 6b 65 79 20 6c 65 6e 67 74 68 20 6f 66 td>key length of
3760: 20 61 20 63 69 70 68 65 72 20 69 6e 20 62 79 74 a cipher in byt
3770: 65 73 2e 3c 74 64 3e 3c 2f 74 72 3e 0a 09 3c 74 es.<td></tr>..<t
3780: 72 3e 3c 74 64 3e 3c 62 3e 69 76 5f 6c 65 6e 67 r><td><b>iv_leng
3790: 74 68 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 3e 49 th</b></td><td>I
37a0: 56 20 6c 65 6e 67 74 68 20 6f 66 20 61 20 63 69 V length of a ci
37b0: 70 68 65 72 20 69 6e 20 62 79 74 65 73 20 6f 72 pher in bytes or
37c0: 20 30 20 69 66 20 6e 6f 74 20 75 73 65 64 2e 3c 0 if not used.<
37d0: 74 64 3e 3c 2f 74 72 3e 0a 09 3c 74 72 3e 3c 74 td></tr>..<tr><t
37e0: 64 3e 3c 62 3e 74 79 70 65 3c 2f 62 3e 3c 2f 74 d><b>type</b></t
37f0: 64 3e 3c 74 64 3e 42 61 73 65 20 74 79 70 65 20 d><td>Base type
3800: 6f 66 20 74 68 69 73 20 63 69 70 68 65 72 20 6f of this cipher o
3810: 72 20 75 6e 64 65 66 69 6e 65 64 20 69 66 20 6e r undefined if n
3820: 6f 6e 65 2e 3c 74 64 3e 3c 2f 74 72 3e 0a 09 3c one.<td></tr>..<
3830: 74 72 3e 3c 74 64 3e 3c 62 3e 70 72 6f 76 69 64 tr><td><b>provid
3840: 65 72 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 3e 50 er</b></td><td>P
3850: 72 6f 76 69 64 65 72 20 6f 66 20 74 68 65 20 63 rovider of the c
3860: 69 70 68 65 72 2e 20 4f 70 65 6e 53 53 4c 20 33 ipher. OpenSSL 3
3870: 2e 30 2b 20 6f 6e 6c 79 2e 3c 74 64 3e 3c 2f 74 .0+ only.<td></t
3880: 72 3e 0a 09 3c 74 72 3e 3c 74 64 3e 3c 62 3e 6d r>..<tr><td><b>m
3890: 6f 64 65 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 3e ode</b></td><td>
38a0: 42 6c 6f 63 6b 20 63 69 70 68 65 72 20 6d 6f 64 Block cipher mod
38b0: 65 20 6f 72 20 3c 62 3e 73 74 72 65 61 6d 3c 2f e or <b>stream</
38c0: 62 3e 20 66 6f 72 20 61 20 73 74 72 65 61 6d 20 b> for a stream
38d0: 63 69 70 68 65 72 2e 3c 74 64 3e 3c 2f 74 72 3e cipher.<td></tr>
38e0: 0a 09 3c 74 72 3e 3c 74 64 3e 3c 62 3e 66 6c 61 ..<tr><td><b>fla
38f0: 67 73 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 3e 46 gs</b></td><td>F
3900: 6c 61 67 73 20 61 73 73 6f 63 69 61 74 65 64 20 lags associated
3910: 77 69 74 68 20 74 68 65 20 63 69 70 68 65 72 2e with the cipher.
3920: 20 49 6e 63 6c 75 64 65 73 3a 20 56 61 72 69 61 Includes: Varia
3930: 62 6c 65 20 4c 65 6e 67 74 68 2c 20 41 45 41 44 ble Length, AEAD
3940: 20 43 69 70 68 65 72 2c 20 4e 6f 6e 20 46 49 50 Cipher, Non FIP
3950: 53 20 41 6c 6c 6f 77 2c 20 65 74 63 2e 3c 74 64 S Allow, etc.<td
3960: 3e 3c 2f 74 72 3e 0a 20 20 20 20 3c 2f 74 61 62 ></tr>. </tab
3970: 6c 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e le></blockquote>
3980: 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d .. <dt><a nam
3990: 65 3d 22 74 6c 73 3a 3a 63 69 70 68 65 72 73 22 e="tls::ciphers"
39a0: 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 63 69 ><strong>tls::ci
39b0: 70 68 65 72 73 3c 2f 73 74 72 6f 6e 67 3e 0a 20 phers</strong>.
39c0: 20 20 20 3c 65 6d 3e 3f 70 72 6f 74 6f 63 6f 6c <em>?protocol
39d0: 3f 20 3f 76 65 72 62 6f 73 65 3f 20 3f 73 75 70 ? ?verbose? ?sup
39e0: 70 6f 72 74 65 64 3f 3c 2f 65 6d 3e 3c 2f 61 3e ported?</em></a>
39f0: 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 57 69 </dt>. <dd>Wi
3a00: 74 68 6f 75 74 20 61 6e 79 20 61 72 67 73 2c 20 thout any args,
3a10: 72 65 74 75 72 6e 73 20 61 20 6c 69 73 74 20 6f returns a list o
3a20: 66 20 61 6c 6c 20 73 79 6d 6d 65 74 72 69 63 20 f all symmetric
3a30: 63 69 70 68 65 72 73 20 66 6f 72 20 75 73 65 20 ciphers for use
3a40: 77 69 74 68 0a 09 74 68 65 20 3c 61 20 68 72 65 with..the <a hre
3a50: 66 3d 22 23 2d 63 69 70 68 65 72 22 3e 3c 62 3e f="#-cipher"><b>
3a60: 2d 63 69 70 68 65 72 3c 2f 62 3e 3c 2f 61 3e 20 -cipher</b></a>
3a70: 6f 70 74 69 6f 6e 2e 20 57 69 74 68 20 3c 65 6d option. With <em
3a80: 3e 70 72 6f 74 6f 63 6f 6c 3c 2f 65 6d 3e 2c 0a >protocol</em>,.
3a90: 09 6f 6e 6c 79 20 74 68 65 20 63 69 70 68 65 72 .only the cipher
3aa0: 73 20 73 75 70 70 6f 72 74 65 64 20 66 6f 72 20 s supported for
3ab0: 74 68 61 74 20 70 72 6f 74 6f 63 6f 6c 20 61 72 that protocol ar
3ac0: 65 20 72 65 74 75 72 6e 65 64 2e 20 53 65 65 0a e returned. See.
3ad0: 09 20 3c 61 20 68 72 65 66 3d 22 23 74 6c 73 3a . <a href="#tls:
3ae0: 3a 70 72 6f 74 6f 63 6f 6c 73 22 3e 3c 62 3e 74 :protocols"><b>t
3af0: 6c 73 3a 3a 70 72 6f 74 6f 63 6f 6c 73 3c 2f 62 ls::protocols</b
3b00: 3e 3c 2f 61 3e 20 63 6f 6d 6d 61 6e 64 20 66 6f ></a> command fo
3b10: 72 20 74 68 65 20 73 75 70 70 6f 72 74 65 64 20 r the supported
3b20: 70 72 6f 74 6f 63 6f 6c 73 2e 20 49 66 0a 09 3c protocols. If..<
3b30: 65 6d 3e 76 65 72 62 6f 73 65 3c 2f 65 6d 3e 20 em>verbose</em>
3b40: 69 73 20 73 70 65 63 69 66 69 65 64 20 61 73 20 is specified as
3b50: 74 72 75 65 20 74 68 65 6e 20 61 20 76 65 72 62 true then a verb
3b60: 6f 73 65 2c 20 68 75 6d 61 6e 20 72 65 61 64 61 ose, human reada
3b70: 62 6c 65 0a 09 6c 69 73 74 20 69 73 20 72 65 74 ble..list is ret
3b80: 75 72 6e 65 64 20 77 69 74 68 20 61 64 64 69 74 urned with addit
3b90: 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f ional informatio
3ba0: 6e 20 6f 6e 20 74 68 65 20 63 69 70 68 65 72 2e n on the cipher.
3bb0: 20 49 66 0a 09 3c 65 6d 3e 73 75 70 70 6f 72 74 If..<em>support
3bc0: 65 64 3c 2f 65 6d 3e 20 69 73 20 73 70 65 63 69 ed</em> is speci
3bd0: 66 69 65 64 20 61 73 20 74 72 75 65 2c 20 74 68 fied as true, th
3be0: 65 6e 20 6f 6e 6c 79 20 74 68 65 20 63 69 70 68 en only the ciph
3bf0: 65 72 73 0a 09 73 75 70 70 6f 72 74 65 64 20 66 ers..supported f
3c00: 6f 72 20 70 72 6f 74 6f 63 6f 6c 20 77 69 6c 6c or protocol will
3c10: 20 62 65 20 6c 69 73 74 65 64 2e 3c 2f 64 64 3e be listed.</dd>
3c20: 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d .. <dt><a nam
3c30: 65 3d 22 74 6c 73 3a 3a 64 69 67 65 73 74 73 22 e="tls::digests"
3c40: 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 64 69 ><strong>tls::di
3c50: 67 65 73 74 73 3c 2f 73 74 72 6f 6e 67 3e 20 3c gests</strong> <
3c60: 65 6d 3e 3f 6e 61 6d 65 3f 3c 2f 65 6d 3e 3c 2f em>?name?</em></
3c70: 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e a></dt>. <dd>
3c80: 57 69 74 68 6f 75 74 20 3c 65 6d 3e 6e 61 6d 65 Without <em>name
3c90: 3c 2f 65 6d 3e 2c 20 72 65 74 75 72 6e 73 20 61 </em>, returns a
3ca0: 20 6c 69 73 74 20 6f 66 20 74 68 65 20 73 75 70 list of the sup
3cb0: 70 6f 72 74 65 64 20 6d 65 73 73 61 67 65 20 64 ported message d
3cc0: 69 67 65 73 74 73 0a 09 28 61 6b 61 20 68 61 73 igests..(aka has
3cd0: 68 20 61 6c 67 6f 72 69 74 68 6d 73 29 20 66 6f h algorithms) fo
3ce0: 72 20 75 73 65 20 77 69 74 68 20 74 68 65 20 3c r use with the <
3cf0: 61 20 68 72 65 66 3d 22 23 2d 64 69 67 65 73 74 a href="#-digest
3d00: 22 3e 3c 62 3e 2d 64 69 67 65 73 74 3c 2f 62 3e "><b>-digest</b>
3d10: 3c 2f 61 3e 0a 09 6f 70 74 69 6f 6e 2e 20 57 69 </a>..option. Wi
3d20: 74 68 20 3c 65 6d 3e 6e 61 6d 65 3c 2f 65 6d 3e th <em>name</em>
3d30: 2c 20 72 65 74 75 72 6e 73 20 61 20 6c 69 73 74 , returns a list
3d40: 20 6f 66 20 70 72 6f 70 65 72 74 79 20 6e 61 6d of property nam
3d50: 65 20 61 6e 64 20 76 61 6c 75 65 0a 09 70 61 69 e and value..pai
3d60: 72 73 20 64 65 73 63 72 69 62 69 6e 67 20 6d 65 rs describing me
3d70: 73 73 61 67 65 20 64 69 67 65 73 74 20 3c 69 3e ssage digest <i>
3d80: 6e 61 6d 65 3c 2f 69 3e 2e 20 50 72 6f 70 65 72 name</i>. Proper
3d90: 74 69 65 73 20 61 72 65 3a 3c 2f 64 64 3e 0a 20 ties are:</dd>.
3da0: 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c <blockquote><
3db0: 74 61 62 6c 65 3e 0a 09 3c 74 72 3e 3c 74 64 3e table>..<tr><td>
3dc0: 3c 62 3e 6e 61 6d 65 3c 2f 62 3e 3c 2f 74 64 3e <b>name</b></td>
3dd0: 3c 74 64 3e 4e 61 6d 65 20 6f 72 20 61 6c 69 61 <td>Name or alia
3de0: 73 20 6f 66 20 74 68 65 20 64 69 67 65 73 74 2e s of the digest.
3df0: 3c 74 64 3e 3c 2f 74 72 3e 0a 09 3c 74 72 3e 3c <td></tr>..<tr><
3e00: 74 64 3e 3c 62 3e 64 65 73 63 72 69 70 74 69 6f td><b>descriptio
3e10: 6e 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 3e 44 65 n</b></td><td>De
3e20: 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 scription of the
3e30: 20 64 69 67 65 73 74 2e 20 4f 70 65 6e 53 53 4c digest. OpenSSL
3e40: 20 33 2e 30 2b 20 6f 6e 6c 79 2e 3c 74 64 3e 3c 3.0+ only.<td><
3e50: 2f 74 72 3e 0a 09 3c 74 72 3e 3c 74 64 3e 3c 62 /tr>..<tr><td><b
3e60: 3e 73 69 7a 65 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 >size</b></td><t
3e70: 64 3e 53 69 7a 65 20 6f 66 20 74 68 65 20 64 69 d>Size of the di
3e80: 67 65 73 74 20 69 6e 20 62 69 74 73 2e 3c 74 64 gest in bits.<td
3e90: 3e 3c 2f 74 72 3e 0a 09 3c 74 72 3e 3c 74 64 3e ></tr>..<tr><td>
3ea0: 3c 62 3e 62 6c 6f 63 6b 5f 73 69 7a 65 3c 2f 62 <b>block_size</b
3eb0: 3e 3c 2f 74 64 3e 3c 74 64 3e 42 6c 6f 63 6b 20 ></td><td>Block
3ec0: 73 69 7a 65 20 6f 66 20 64 69 67 65 73 74 20 69 size of digest i
3ed0: 6e 20 62 79 74 65 73 2e 3c 74 64 3e 3c 2f 74 72 n bytes.<td></tr
3ee0: 3e 0a 09 3c 74 72 3e 3c 74 64 3e 3c 62 3e 70 72 >..<tr><td><b>pr
3ef0: 6f 76 69 64 65 72 3c 2f 62 3e 3c 2f 74 64 3e 3c ovider</b></td><
3f00: 74 64 3e 50 72 6f 76 69 64 65 72 20 6f 66 20 74 td>Provider of t
3f10: 68 65 20 64 69 67 65 73 74 2e 20 4f 70 65 6e 53 he digest. OpenS
3f20: 53 4c 20 33 2e 30 2b 20 6f 6e 6c 79 2e 3c 74 64 SL 3.0+ only.<td
3f30: 3e 3c 2f 74 72 3e 0a 09 3c 74 72 3e 3c 74 64 3e ></tr>..<tr><td>
3f40: 3c 62 3e 74 79 70 65 3c 2f 62 3e 3c 2f 74 64 3e <b>type</b></td>
3f50: 3c 74 64 3e 42 61 73 65 20 74 79 70 65 20 6f 66 <td>Base type of
3f60: 20 74 68 69 73 20 64 69 67 65 73 74 20 6f 72 20 this digest or
3f70: 75 6e 64 65 66 69 6e 65 64 20 69 66 20 6e 6f 6e undefined if non
3f80: 65 2e 3c 74 64 3e 3c 2f 74 72 3e 0a 09 3c 74 72 e.<td></tr>..<tr
3f90: 3e 3c 74 64 3e 3c 62 3e 70 6b 65 79 5f 74 79 70 ><td><b>pkey_typ
3fa0: 65 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 3e 50 6b e</b></td><td>Pk
3fb0: 65 79 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 ey associated wi
3fc0: 74 68 20 64 69 67 65 73 74 2e 3c 74 64 3e 3c 2f th digest.<td></
3fd0: 74 72 3e 0a 09 3c 74 72 3e 3c 74 64 3e 3c 62 3e tr>..<tr><td><b>
3fe0: 66 6c 61 67 73 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 flags</b></td><t
3ff0: 64 3e 46 6c 61 67 73 20 61 73 73 6f 63 69 61 74 d>Flags associat
4000: 65 64 20 77 69 74 68 20 74 68 65 20 64 69 67 65 ed with the dige
4010: 73 74 2e 20 49 6e 63 6c 75 64 65 73 3a 20 4f 6e st. Includes: On
4020: 65 2d 73 68 6f 74 2c 20 58 4f 46 2c 20 65 74 63 e-shot, XOF, etc
4030: 2e 3c 74 64 3e 3c 2f 74 72 3e 0a 20 20 20 20 3c .<td></tr>. <
4040: 2f 74 61 62 6c 65 3e 3c 2f 62 6c 6f 63 6b 71 75 /table></blockqu
4050: 6f 74 65 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 ote>.. <dt><a
4060: 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 6b 64 66 73 name="tls::kdfs
4070: 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 6b "><strong>tls::k
4080: 64 66 73 3c 2f 73 74 72 6f 6e 67 3e 3c 2f 61 3e dfs</strong></a>
4090: 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 52 65 </dt>. <dd>Re
40a0: 74 75 72 6e 73 20 61 20 6c 69 73 74 20 6f 66 20 turns a list of
40b0: 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 4b 65 the available Ke
40c0: 79 20 44 65 72 69 76 61 74 69 6f 6e 20 46 75 6e y Derivation Fun
40d0: 63 74 69 6f 6e 20 28 4b 44 46 29 0a 09 61 6c 67 ction (KDF)..alg
40e0: 6f 72 69 74 68 6d 73 2e 20 45 61 63 68 20 69 74 orithms. Each it
40f0: 65 6d 20 69 6e 20 74 68 65 20 6c 69 73 74 20 63 em in the list c
4100: 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 61 20 orresponds to a
4110: 63 6f 6d 6d 61 6e 64 20 77 69 74 68 20 74 68 65 command with the
4120: 20 73 61 6d 65 20 6e 61 6d 65 2e 3c 2f 64 64 3e same name.</dd>
4130: 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d .. <dt><a nam
4140: 65 3d 22 74 6c 73 3a 3a 6d 61 63 73 22 3e 3c 73 e="tls::macs"><s
4150: 74 72 6f 6e 67 3e 74 6c 73 3a 3a 6d 61 63 73 3c trong>tls::macs<
4160: 2f 73 74 72 6f 6e 67 3e 3c 2f 61 3e 3c 2f 64 74 /strong></a></dt
4170: 3e 0a 20 20 20 20 3c 64 64 3e 52 65 74 75 72 6e >. <dd>Return
4180: 73 20 61 20 6c 69 73 74 20 6f 66 20 74 68 65 20 s a list of the
4190: 61 76 61 69 6c 61 62 6c 65 20 4d 65 73 73 61 67 available Messag
41a0: 65 20 41 75 74 68 65 6e 74 69 63 61 74 69 6f 6e e Authentication
41b0: 20 43 6f 64 65 73 20 28 4d 41 43 29 2e 0a 09 45 Codes (MAC)...E
41c0: 61 63 68 20 69 74 65 6d 20 69 6e 20 74 68 65 20 ach item in the
41d0: 6c 69 73 74 20 63 6f 72 72 65 73 70 6f 6e 64 73 list corresponds
41e0: 20 74 6f 20 61 20 63 6f 6d 6d 61 6e 64 20 77 69 to a command wi
41f0: 74 68 20 74 68 65 20 73 61 6d 65 20 6e 61 6d 65 th the same name
4200: 2e 3c 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 3e .</dd>.. <dt>
4210: 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 70 72 <a name="tls::pr
4220: 6f 74 6f 63 6f 6c 73 22 3e 3c 73 74 72 6f 6e 67 otocols"><strong
4230: 3e 74 6c 73 3a 3a 70 72 6f 74 6f 63 6f 6c 73 3c >tls::protocols<
4240: 2f 73 74 72 6f 6e 67 3e 3c 2f 61 3e 3c 2f 64 74 /strong></a></dt
4250: 3e 0a 20 20 20 20 3c 64 64 3e 52 65 74 75 72 6e >. <dd>Return
4260: 73 20 61 20 6c 69 73 74 20 6f 66 20 73 75 70 70 s a list of supp
4270: 6f 72 74 65 64 20 70 72 6f 74 6f 63 6f 6c 73 2e orted protocols.
4280: 20 56 61 6c 69 64 20 76 61 6c 75 65 73 20 61 72 Valid values ar
4290: 65 3a 0a 09 3c 62 3e 73 73 6c 32 3c 2f 62 3e 2c e:..<b>ssl2</b>,
42a0: 20 3c 62 3e 73 73 6c 33 3c 2f 62 3e 2c 20 3c 62 <b>ssl3</b>, <b
42b0: 3e 74 6c 73 31 3c 2f 62 3e 2c 20 3c 62 3e 74 6c >tls1</b>, <b>tl
42c0: 73 31 2e 31 3c 2f 62 3e 2c 20 3c 62 3e 74 6c 73 s1.1</b>, <b>tls
42d0: 31 2e 32 3c 2f 62 3e 2c 0a 09 61 6e 64 20 3c 62 1.2</b>,..and <b
42e0: 3e 74 6c 73 31 2e 33 3c 2f 62 3e 2e 20 45 78 61 >tls1.3</b>. Exa
42f0: 63 74 20 6c 69 73 74 20 64 65 70 65 6e 64 73 20 ct list depends
4300: 6f 6e 20 4f 70 65 6e 53 53 4c 20 76 65 72 73 69 on OpenSSL versi
4310: 6f 6e 20 61 6e 64 0a 09 63 6f 6d 70 69 6c 65 20 on and..compile
4320: 74 69 6d 65 20 66 6c 61 67 73 2e 3c 2f 64 64 3e time flags.</dd>
4330: 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d .. <dt><a nam
4340: 65 3d 22 74 6c 73 3a 3a 76 65 72 73 69 6f 6e 22 e="tls::version"
4350: 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 76 65 ><strong>tls::ve
4360: 72 73 69 6f 6e 3c 2f 73 74 72 6f 6e 67 3e 3c 2f rsion</strong></
4370: 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e a></dt>. <dd>
4380: 52 65 74 75 72 6e 73 20 74 68 65 20 4f 70 65 6e Returns the Open
4390: 53 53 4c 20 76 65 72 73 69 6f 6e 20 73 74 72 69 SSL version stri
43a0: 6e 67 2e 3c 2f 64 64 3e 0a 0a 3c 62 72 3e 0a 0a ng.</dd>..<br>..
43b0: 3c 68 34 3e 3c 61 20 6e 61 6d 65 3d 22 4d 44 5f <h4><a name="MD_
43c0: 4d 41 43 22 3e 4d 65 73 73 61 67 65 20 44 69 67 MAC">Message Dig
43d0: 65 73 74 20 28 4d 44 29 20 61 6e 64 20 4d 65 73 est (MD) and Mes
43e0: 73 61 67 65 20 41 75 74 68 65 6e 74 69 63 61 74 sage Authenticat
43f0: 69 6f 6e 20 43 6f 64 65 20 28 4d 41 43 29 20 43 ion Code (MAC) C
4400: 6f 6d 6d 61 6e 64 73 3c 2f 61 3e 3c 2f 68 34 3e ommands</a></h4>
4410: 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d .. <dt><a nam
4420: 65 3d 22 74 6c 73 3a 3a 63 6d 61 63 22 3e 3c 73 e="tls::cmac"><s
4430: 74 72 6f 6e 67 3e 74 6c 73 3a 3a 63 6d 61 63 3c trong>tls::cmac<
4440: 2f 73 74 72 6f 6e 67 3e 0a 09 3c 65 6d 3e 3f 3c /strong>..<em>?<
4450: 2f 65 6d 3e 3c 62 3e 2d 63 69 70 68 65 72 3c 2f /em><b>-cipher</
4460: 62 3e 3c 65 6d 3e 3f 20 6e 61 6d 65 3c 2f 65 6d b><em>? name</em
4470: 3e 0a 09 3c 62 3e 2d 6b 65 79 3c 2f 62 3e 20 3c >..<b>-key</b> <
4480: 65 6d 3e 6b 65 79 20 3f 3c 2f 65 6d 3e 0a 09 3c em>key ?</em>..<
4490: 62 3e 2d 62 69 6e 3c 2f 62 3e 7c 3c 62 3e 2d 68 b>-bin</b>|<b>-h
44a0: 65 78 3c 2f 62 3e 0a 09 3c 65 6d 3e 3f 5b 3c 2f ex</b>..<em>?[</
44b0: 65 6d 3e 3c 62 3e 2d 63 68 61 6e 3c 2f 62 3e 20 em><b>-chan</b>
44c0: 3c 65 6d 3e 63 68 61 6e 6e 65 6c 49 64 20 7c 3c <em>channelId |<
44d0: 2f 65 6d 3e 20 3c 62 3e 2d 63 6f 6d 6d 61 6e 64 /em> <b>-command
44e0: 3c 2f 62 3e 20 3c 65 6d 3e 63 6d 64 4e 61 6d 65 </b> <em>cmdName
44f0: 20 7c 3c 2f 65 6d 3e 0a 09 3c 62 3e 2d 66 69 6c |</em>..<b>-fil
4500: 65 3c 2f 62 3e 20 3c 65 6d 3e 66 69 6c 65 6e 61 e</b> <em>filena
4510: 6d 65 20 7c 20 3f 3c 2f 65 6d 3e 3c 62 3e 2d 64 me | ?</em><b>-d
4520: 61 74 61 3c 2f 62 3e 3c 65 6d 3e 3f 20 64 61 74 ata</b><em>? dat
4530: 61 5d 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e a]</em></a></dt>
4540: 0a 20 20 20 20 3c 64 64 3e 43 61 6c 63 75 6c 61 . <dd>Calcula
4550: 74 65 20 74 68 65 20 43 69 70 68 65 72 2d 62 61 te the Cipher-ba
4560: 73 65 64 20 4d 65 73 73 61 67 65 20 41 75 74 68 sed Message Auth
4570: 65 6e 74 69 63 61 74 69 6f 6e 20 43 6f 64 65 20 entication Code
4580: 28 43 4d 41 43 29 20 77 68 65 72 65 0a 09 3c 65 (CMAC) where..<e
4590: 6d 3e 6b 65 79 3c 2f 65 6d 3e 20 69 73 20 61 20 m>key</em> is a
45a0: 73 68 61 72 65 64 20 6b 65 79 20 61 6e 64 20 6f shared key and o
45b0: 75 74 70 75 74 20 74 68 65 20 72 65 73 75 6c 74 utput the result
45c0: 20 70 65 72 20 74 68 65 20 49 2f 4f 20 6f 70 74 per the I/O opt
45d0: 69 6f 6e 73 0a 09 69 6e 20 74 68 65 20 73 70 65 ions..in the spe
45e0: 63 69 66 69 65 64 20 66 6f 72 6d 61 74 2e 20 4d cified format. M
45f0: 41 43 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 ACs are used to
4600: 65 6e 73 75 72 65 20 61 75 74 68 65 6e 74 69 63 ensure authentic
4610: 69 74 79 20 61 6e 64 20 74 68 65 0a 09 69 6e 74 ity and the..int
4620: 65 67 72 69 74 79 20 6f 66 20 64 61 74 61 2e 20 egrity of data.
4630: 53 65 65 20 3c 61 20 68 72 65 66 3d 22 23 4f 50 See <a href="#OP
4640: 54 49 4f 4e 53 22 3e 3c 62 3e 6f 70 74 69 6f 6e TIONS"><b>option
4650: 73 3c 2f 62 3e 3c 2f 61 3e 20 66 6f 72 20 75 73 s</b></a> for us
4660: 61 67 65 0a 09 69 6e 66 6f 2e 20 4f 70 74 69 6f age..info. Optio
4670: 6e 20 3c 62 3e 2d 6b 65 79 3c 2f 62 3e 20 69 73 n <b>-key</b> is
4680: 20 6f 6e 6c 79 20 75 73 65 64 20 66 6f 72 20 73 only used for s
4690: 6f 6d 65 20 63 69 70 68 65 72 73 2e 3c 2f 64 64 ome ciphers.</dd
46a0: 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 >.. <dt><a na
46b0: 6d 65 3d 22 74 6c 73 3a 3a 68 6d 61 63 22 3e 3c me="tls::hmac"><
46c0: 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 68 6d 61 63 strong>tls::hmac
46d0: 3c 2f 73 74 72 6f 6e 67 3e 0a 09 3c 65 6d 3e 3f </strong>..<em>?
46e0: 3c 2f 65 6d 3e 3c 62 3e 2d 64 69 67 65 73 74 3c </em><b>-digest<
46f0: 2f 62 3e 3c 65 6d 3e 3f 20 6e 61 6d 65 3c 2f 65 /b><em>? name</e
4700: 6d 3e 0a 09 3c 62 3e 2d 6b 65 79 3c 2f 62 3e 20 m>..<b>-key</b>
4710: 3c 65 6d 3e 6b 65 79 20 3f 3c 2f 65 6d 3e 0a 09 <em>key ?</em>..
4720: 3c 62 3e 2d 62 69 6e 3c 2f 62 3e 7c 3c 62 3e 2d <b>-bin</b>|<b>-
4730: 68 65 78 3c 2f 62 3e 0a 09 3c 65 6d 3e 3f 5b 3c hex</b>..<em>?[<
4740: 2f 65 6d 3e 3c 62 3e 2d 63 68 61 6e 3c 2f 62 3e /em><b>-chan</b>
4750: 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c 49 64 20 7c <em>channelId |
4760: 3c 2f 65 6d 3e 20 3c 62 3e 2d 63 6f 6d 6d 61 6e </em> <b>-comman
4770: 64 3c 2f 62 3e 20 3c 65 6d 3e 63 6d 64 4e 61 6d d</b> <em>cmdNam
4780: 65 20 7c 3c 2f 65 6d 3e 0a 09 3c 62 3e 2d 66 69 e |</em>..<b>-fi
4790: 6c 65 3c 2f 62 3e 20 3c 65 6d 3e 66 69 6c 65 6e le</b> <em>filen
47a0: 61 6d 65 20 7c 20 3f 3c 2f 65 6d 3e 3c 62 3e 2d ame | ?</em><b>-
47b0: 64 61 74 61 3c 2f 62 3e 3c 65 6d 3e 3f 20 64 61 data</b><em>? da
47c0: 74 61 5d 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 ta]</em></a></dt
47d0: 3e 0a 20 20 20 20 3c 64 64 3e 43 61 6c 63 75 6c >. <dd>Calcul
47e0: 61 74 65 20 74 68 65 20 48 61 73 68 2d 62 61 73 ate the Hash-bas
47f0: 65 64 20 4d 65 73 73 61 67 65 20 41 75 74 68 65 ed Message Authe
4800: 6e 74 69 63 61 74 69 6f 6e 20 43 6f 64 65 20 28 ntication Code (
4810: 48 4d 41 43 29 20 77 68 65 72 65 0a 09 3c 65 6d HMAC) where..<em
4820: 3e 6b 65 79 3c 2f 65 6d 3e 20 69 73 20 61 20 73 >key</em> is a s
4830: 68 61 72 65 64 20 73 65 63 72 65 74 20 6b 65 79 hared secret key
4840: 20 61 6e 64 20 6f 75 74 70 75 74 20 74 68 65 20 and output the
4850: 72 65 73 75 6c 74 20 70 65 72 20 74 68 65 20 49 result per the I
4860: 2f 4f 0a 09 6f 70 74 69 6f 6e 73 20 69 6e 20 74 /O..options in t
4870: 68 65 20 73 70 65 63 69 66 69 65 64 20 66 6f 72 he specified for
4880: 6d 61 74 2e 20 54 68 65 20 63 72 79 70 74 6f 67 mat. The cryptog
4890: 72 61 70 68 69 63 20 73 74 72 65 6e 67 74 68 20 raphic strength
48a0: 64 65 70 65 6e 64 73 0a 09 75 70 6f 6e 20 74 68 depends..upon th
48b0: 65 20 73 69 7a 65 20 6f 66 20 74 68 65 20 6b 65 e size of the ke
48c0: 79 20 61 6e 64 20 74 68 65 20 73 65 63 75 72 69 y and the securi
48d0: 74 79 20 6f 66 20 74 68 65 20 68 61 73 68 20 66 ty of the hash f
48e0: 75 6e 63 74 69 6f 6e 20 75 73 65 64 2e 0a 09 53 unction used...S
48f0: 65 65 20 3c 61 20 68 72 65 66 3d 22 23 4f 50 54 ee <a href="#OPT
4900: 49 4f 4e 53 22 3e 3c 62 3e 6f 70 74 69 6f 6e 73 IONS"><b>options
4910: 3c 2f 62 3e 3c 2f 61 3e 20 66 6f 72 20 75 73 61 </b></a> for usa
4920: 67 65 20 69 6e 66 6f 2e 3c 2f 64 64 3e 0a 0a 20 ge info.</dd>..
4930: 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 <dt><a name="
4940: 74 6c 73 3a 3a 6d 61 63 22 3e 3c 73 74 72 6f 6e tls::mac"><stron
4950: 67 3e 74 6c 73 3a 3a 6d 61 63 3c 2f 73 74 72 6f g>tls::mac</stro
4960: 6e 67 3e 0a 09 3c 65 6d 3e 3f 3c 2f 65 6d 3e 3c ng>..<em>?</em><
4970: 62 3e 2d 6d 61 63 3c 2f 62 3e 3c 65 6d 3e 3f 20 b>-mac</b><em>?
4980: 6e 61 6d 65 3c 2f 65 6d 3e 0a 09 3c 62 3e 2d 63 name</em>..<b>-c
4990: 69 70 68 65 72 3c 2f 62 3e 20 3c 65 6d 3e 6e 61 ipher</b> <em>na
49a0: 6d 65 3c 2f 65 6d 3e 0a 09 3c 62 3e 2d 64 69 67 me</em>..<b>-dig
49b0: 65 73 74 3c 2f 62 3e 20 3c 65 6d 3e 6e 61 6d 65 est</b> <em>name
49c0: 3c 2f 65 6d 3e 0a 09 3c 62 3e 2d 6b 65 79 3c 2f </em>..<b>-key</
49d0: 62 3e 20 3c 65 6d 3e 6b 65 79 20 3f 3c 2f 65 6d b> <em>key ?</em
49e0: 3e 0a 09 3c 62 3e 2d 62 69 6e 3c 2f 62 3e 7c 3c >..<b>-bin</b>|<
49f0: 62 3e 2d 68 65 78 3c 2f 62 3e 0a 09 3c 65 6d 3e b>-hex</b>..<em>
4a00: 3f 5b 3c 2f 65 6d 3e 3c 62 3e 2d 63 68 61 6e 3c ?[</em><b>-chan<
4a10: 2f 62 3e 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c 49 /b> <em>channelI
4a20: 64 20 7c 3c 2f 65 6d 3e 20 3c 62 3e 2d 63 6f 6d d |</em> <b>-com
4a30: 6d 61 6e 64 3c 2f 62 3e 20 3c 65 6d 3e 63 6d 64 mand</b> <em>cmd
4a40: 4e 61 6d 65 20 7c 3c 2f 65 6d 3e 0a 09 3c 62 3e Name |</em>..<b>
4a50: 2d 66 69 6c 65 3c 2f 62 3e 20 3c 65 6d 3e 66 69 -file</b> <em>fi
4a60: 6c 65 6e 61 6d 65 20 7c 20 3f 3c 2f 65 6d 3e 3c lename | ?</em><
4a70: 62 3e 2d 64 61 74 61 3c 2f 62 3e 3c 65 6d 3e 3f b>-data</b><em>?
4a80: 20 64 61 74 61 5d 3c 2f 65 6d 3e 3c 2f 61 3e 3c data]</em></a><
4a90: 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 28 4f 70 /dt>. <dd>(Op
4aa0: 65 6e 53 53 4c 20 33 2e 30 2b 29 20 43 61 6c 63 enSSL 3.0+) Calc
4ab0: 75 6c 61 74 65 20 74 68 65 20 4d 65 73 73 61 67 ulate the Messag
4ac0: 65 20 41 75 74 68 65 6e 74 69 63 61 74 69 6f 6e e Authentication
4ad0: 20 43 6f 64 65 20 28 4d 41 43 29 20 77 68 65 72 Code (MAC) wher
4ae0: 65 0a 09 3c 65 6d 3e 6b 65 79 3c 2f 65 6d 3e 20 e..<em>key</em>
4af0: 69 73 20 61 20 73 68 61 72 65 64 20 6b 65 79 20 is a shared key
4b00: 61 6e 64 20 6f 75 74 70 75 74 20 74 68 65 20 72 and output the r
4b10: 65 73 75 6c 74 20 70 65 72 20 74 68 65 20 49 2f esult per the I/
4b20: 4f 20 6f 70 74 69 6f 6e 73 0a 09 69 6e 20 74 68 O options..in th
4b30: 65 20 73 70 65 63 69 66 69 65 64 20 66 6f 72 6d e specified form
4b40: 61 74 2e 20 4d 41 43 73 20 61 72 65 20 75 73 65 at. MACs are use
4b50: 64 20 74 6f 20 65 6e 73 75 72 65 20 61 75 74 68 d to ensure auth
4b60: 65 6e 74 69 63 69 74 79 20 61 6e 64 0a 09 74 68 enticity and..th
4b70: 65 20 69 6e 74 65 67 72 69 74 79 20 6f 66 20 64 e integrity of d
4b80: 61 74 61 2e 20 53 65 65 20 3c 61 20 68 72 65 66 ata. See <a href
4b90: 3d 22 23 4f 50 54 49 4f 4e 53 22 3e 3c 62 3e 6f ="#OPTIONS"><b>o
4ba0: 70 74 69 6f 6e 73 3c 2f 62 3e 3c 2f 61 3e 0a 09 ptions</b></a>..
4bb0: 66 6f 72 20 75 73 61 67 65 20 69 6e 66 6f 2e 3c for usage info.<
4bc0: 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 /dd>.. <dt><a
4bd0: 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 6d 64 22 3e name="tls::md">
4be0: 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 6d 64 3c <strong>tls::md<
4bf0: 2f 73 74 72 6f 6e 67 3e 0a 09 3c 65 6d 3e 3f 3c /strong>..<em>?<
4c00: 2f 65 6d 3e 3c 62 3e 2d 64 69 67 65 73 74 3c 2f /em><b>-digest</
4c10: 62 3e 3c 65 6d 3e 3f 20 6e 61 6d 65 3c 2f 65 6d b><em>? name</em
4c20: 3e 0a 09 3c 65 6d 3e 3f 3c 2f 65 6d 3e 3c 62 3e >..<em>?</em><b>
4c30: 2d 62 69 6e 3c 2f 62 3e 7c 3c 62 3e 2d 68 65 78 -bin</b>|<b>-hex
4c40: 3c 2f 62 3e 0a 09 3c 65 6d 3e 3f 5b 3c 2f 65 6d </b>..<em>?[</em
4c50: 3e 3c 62 3e 2d 63 68 61 6e 3c 2f 62 3e 20 3c 65 ><b>-chan</b> <e
4c60: 6d 3e 63 68 61 6e 6e 65 6c 49 64 20 7c 3c 2f 65 m>channelId |</e
4c70: 6d 3e 20 3c 62 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f m> <b>-command</
4c80: 62 3e 20 3c 65 6d 3e 63 6d 64 4e 61 6d 65 20 7c b> <em>cmdName |
4c90: 3c 2f 65 6d 3e 0a 09 3c 62 3e 2d 66 69 6c 65 3c </em>..<b>-file<
4ca0: 2f 62 3e 20 3c 65 6d 3e 66 69 6c 65 6e 61 6d 65 /b> <em>filename
4cb0: 20 7c 20 3f 3c 2f 65 6d 3e 3c 62 3e 2d 64 61 74 | ?</em><b>-dat
4cc0: 61 3c 2f 62 3e 3c 65 6d 3e 3f 20 64 61 74 61 5d a</b><em>? data]
4cd0: 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 </em></a></dt>.
4ce0: 20 20 20 3c 64 64 3e 43 61 6c 63 75 6c 61 74 65 <dd>Calculate
4cf0: 20 74 68 65 20 6d 65 73 73 61 67 65 20 64 69 67 the message dig
4d00: 65 73 74 20 28 4d 44 29 20 75 73 69 6e 67 20 68 est (MD) using h
4d10: 61 73 68 20 66 75 6e 63 74 69 6f 6e 20 3c 65 6d ash function <em
4d20: 3e 6e 61 6d 65 3c 2f 65 6d 3e 0a 09 61 6e 64 20 >name</em>..and
4d30: 6f 75 74 70 75 74 20 74 68 65 20 72 65 73 75 6c output the resul
4d40: 74 20 70 65 72 20 74 68 65 20 49 2f 4f 20 6f 70 t per the I/O op
4d50: 74 69 6f 6e 73 20 69 6e 20 74 68 65 20 73 70 65 tions in the spe
4d60: 63 69 66 69 65 64 20 66 6f 72 6d 61 74 2e 0a 09 cified format...
4d70: 4d 44 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 MDs are used to
4d80: 65 6e 73 75 72 65 20 74 68 65 20 69 6e 74 65 67 ensure the integ
4d90: 72 69 74 79 20 6f 66 20 64 61 74 61 2e 20 53 65 rity of data. Se
4da0: 65 0a 09 3c 61 20 68 72 65 66 3d 22 23 4f 50 54 e..<a href="#OPT
4db0: 49 4f 4e 53 22 3e 3c 62 3e 6f 70 74 69 6f 6e 73 IONS"><b>options
4dc0: 3c 2f 62 3e 3c 2f 61 3e 20 66 6f 72 20 75 73 61 </b></a> for usa
4dd0: 67 65 20 69 6e 66 6f 2e 3c 2f 64 64 3e 0a 0a 20 ge info.</dd>..
4de0: 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 <dt><a name="
4df0: 74 6c 73 3a 3a 6d 64 34 22 3e 3c 73 74 72 6f 6e tls::md4"><stron
4e00: 67 3e 74 6c 73 3a 3a 6d 64 34 3c 2f 73 74 72 6f g>tls::md4</stro
4e10: 6e 67 3e 20 3c 65 6d 3e 64 61 74 61 3c 2f 65 6d ng> <em>data</em
4e20: 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c ></a></dt>. <
4e30: 64 64 3e 52 65 74 75 72 6e 73 20 74 68 65 20 4d dd>Returns the M
4e40: 44 34 20 6d 65 73 73 61 67 65 2d 64 69 67 65 73 D4 message-diges
4e50: 74 20 66 6f 72 20 3c 65 6d 3e 64 61 74 61 3c 2f t for <em>data</
4e60: 65 6d 3e 20 61 73 20 61 20 68 65 78 20 73 74 72 em> as a hex str
4e70: 69 6e 67 2e 3c 2f 64 64 3e 0a 0a 20 20 20 20 3c ing.</dd>.. <
4e80: 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 3a dt><a name="tls:
4e90: 3a 6d 64 35 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c :md5"><strong>tl
4ea0: 73 3a 3a 6d 64 35 3c 2f 73 74 72 6f 6e 67 3e 20 s::md5</strong>
4eb0: 3c 65 6d 3e 64 61 74 61 3c 2f 65 6d 3e 3c 2f 61 <em>data</em></a
4ec0: 3e 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 52 ></dt>. <dd>R
4ed0: 65 74 75 72 6e 73 20 74 68 65 20 4d 44 35 20 6d eturns the MD5 m
4ee0: 65 73 73 61 67 65 2d 64 69 67 65 73 74 20 66 6f essage-digest fo
4ef0: 72 20 3c 65 6d 3e 64 61 74 61 3c 2f 65 6d 3e 20 r <em>data</em>
4f00: 61 73 20 61 20 68 65 78 20 73 74 72 69 6e 67 2e as a hex string.
4f10: 3c 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c </dd>.. <dt><
4f20: 61 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 73 68 61 a name="tls::sha
4f30: 31 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 1"><strong>tls::
4f40: 73 68 61 31 3c 2f 73 74 72 6f 6e 67 3e 20 3c 65 sha1</strong> <e
4f50: 6d 3e 64 61 74 61 3c 2f 65 6d 3e 3c 2f 61 3e 3c m>data</em></a><
4f60: 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 52 65 74 /dt>. <dd>Ret
4f70: 75 72 6e 73 20 74 68 65 20 53 48 41 31 20 73 65 urns the SHA1 se
4f80: 63 75 72 65 20 68 61 73 68 20 61 6c 67 6f 72 69 cure hash algori
4f90: 74 68 6d 20 64 69 67 65 73 74 20 66 6f 72 20 3c thm digest for <
4fa0: 65 6d 3e 64 61 74 61 3c 2f 65 6d 3e 20 61 73 20 em>data</em> as
4fb0: 61 20 68 65 78 20 73 74 72 69 6e 67 2e 3c 2f 64 a hex string.</d
4fc0: 64 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e d>.. <dt><a n
4fd0: 61 6d 65 3d 22 74 6c 73 3a 3a 73 68 61 32 35 36 ame="tls::sha256
4fe0: 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 73 "><strong>tls::s
4ff0: 68 61 32 35 36 3c 2f 73 74 72 6f 6e 67 3e 20 3c ha256</strong> <
5000: 65 6d 3e 64 61 74 61 3c 2f 65 6d 3e 3c 2f 61 3e em>data</em></a>
5010: 3c 2f 64 74 3e 0a 20 20 20 20 3c 64 64 3e 52 65 </dt>. <dd>Re
5020: 74 75 72 6e 73 20 74 68 65 20 53 48 41 2d 32 20 turns the SHA-2
5030: 53 48 41 32 35 36 20 73 65 63 75 72 65 20 68 61 SHA256 secure ha
5040: 73 68 20 61 6c 67 6f 72 69 74 68 6d 20 64 69 67 sh algorithm dig
5050: 65 73 74 20 66 6f 72 20 3c 65 6d 3e 64 61 74 61 est for <em>data
5060: 3c 2f 65 6d 3e 20 61 73 20 61 20 68 65 78 20 73 </em> as a hex s
5070: 74 72 69 6e 67 2e 3c 2f 64 64 3e 0a 0a 20 20 20 tring.</dd>..
5080: 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c <dt><a name="tl
5090: 73 3a 3a 73 68 61 35 31 32 22 3e 3c 73 74 72 6f s::sha512"><stro
50a0: 6e 67 3e 74 6c 73 3a 3a 73 68 61 35 31 32 3c 2f ng>tls::sha512</
50b0: 73 74 72 6f 6e 67 3e 20 3c 65 6d 3e 64 61 74 61 strong> <em>data
50c0: 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 </em></a></dt>.
50d0: 20 20 20 3c 64 64 3e 52 65 74 75 72 6e 73 20 74 <dd>Returns t
50e0: 68 65 20 53 48 41 2d 32 20 53 48 41 35 31 32 20 he SHA-2 SHA512
50f0: 73 65 63 75 72 65 20 68 61 73 68 20 61 6c 67 6f secure hash algo
5100: 72 69 74 68 6d 20 64 69 67 65 73 74 20 66 6f 72 rithm digest for
5110: 20 3c 65 6d 3e 64 61 74 61 3c 2f 65 6d 3e 20 61 <em>data</em> a
5120: 73 20 61 20 68 65 78 20 73 74 72 69 6e 67 2e 3c s a hex string.<
5130: 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 /dd>.. <dt><a
5140: 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 75 6e 73 74 name="tls::unst
5150: 61 63 6b 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 ack"><strong>tls
5160: 3a 3a 75 6e 73 74 61 63 6b 3c 2f 73 74 72 6f 6e ::unstack</stron
5170: 67 3e 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c 49 64 g> <em>channelId
5180: 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 </em></a></dt>.
5190: 20 20 20 3c 64 64 3e 52 65 6d 6f 76 65 73 20 74 <dd>Removes t
51a0: 68 65 20 74 6f 70 20 6c 65 76 65 6c 20 63 72 79 he top level cry
51b0: 70 74 6f 67 72 61 70 68 69 63 20 74 72 61 6e 73 ptographic trans
51c0: 66 6f 72 6d 20 66 72 6f 6d 20 63 68 61 6e 6e 65 form from channe
51d0: 6c 20 3c 65 6d 3e 63 68 61 6e 6e 65 6c 49 64 3c l <em>channelId<
51e0: 2f 65 6d 3e 2e 3c 2f 64 64 3e 0a 0a 3c 62 72 3e /em>.</dd>..<br>
51f0: 0a 0a 3c 68 34 3e 3c 61 20 6e 61 6d 65 3d 22 43 ..<h4><a name="C
5200: 69 70 68 65 72 22 3e 45 6e 63 72 79 70 74 69 6f ipher">Encryptio
5210: 6e 20 61 6e 64 20 44 65 63 72 79 70 74 69 6f 6e n and Decryption
5220: 20 43 6f 6d 6d 61 6e 64 73 3c 2f 61 3e 3c 2f 68 Commands</a></h
5230: 34 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 4>.. <dt><a n
5240: 61 6d 65 3d 22 74 6c 73 3a 3a 65 6e 63 72 79 70 ame="tls::encryp
5250: 74 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a t"><strong>tls::
5260: 65 6e 63 72 79 70 74 3c 2f 73 74 72 6f 6e 67 3e encrypt</strong>
5270: 0a 09 3c 65 6d 3e 3f 3c 2f 65 6d 3e 3c 62 3e 2d ..<em>?</em><b>-
5280: 63 69 70 68 65 72 3c 2f 62 3e 3c 65 6d 3e 3f 20 cipher</b><em>?
5290: 6e 61 6d 65 3c 2f 65 6d 3e 0a 09 3c 62 3e 2d 64 name</em>..<b>-d
52a0: 69 67 65 73 74 3c 2f 62 3e 20 3c 65 6d 3e 6e 61 igest</b> <em>na
52b0: 6d 65 3c 2f 65 6d 3e 0a 09 3c 62 3e 2d 6b 65 79 me</em>..<b>-key
52c0: 3c 2f 62 3e 20 3c 65 6d 3e 6b 65 79 20 3f 3c 2f </b> <em>key ?</
52d0: 65 6d 3e 0a 09 3c 62 3e 2d 69 76 3c 2f 62 3e 20 em>..<b>-iv</b>
52e0: 3c 65 6d 3e 73 74 72 69 6e 67 3f 3c 2f 65 6d 3e <em>string?</em>
52f0: 0a 09 3c 65 6d 3e 5b 3c 2f 65 6d 3e 3c 62 3e 2d ..<em>[</em><b>-
5300: 63 68 61 6e 3c 2f 62 3e 20 3c 65 6d 3e 63 68 61 chan</b> <em>cha
5310: 6e 6e 65 6c 49 64 20 7c 3c 2f 65 6d 3e 20 3c 62 nnelId |</em> <b
5320: 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f 62 3e 20 3c 65 >-command</b> <e
5330: 6d 3e 63 6d 64 4e 61 6d 65 20 7c 3c 2f 65 6d 3e m>cmdName |</em>
5340: 0a 09 3c 62 3e 2d 69 6e 66 69 6c 65 3c 2f 62 3e ..<b>-infile</b>
5350: 20 3c 65 6d 3e 66 69 6c 65 6e 61 6d 65 3c 2f 65 <em>filename</e
5360: 6d 3e 20 3c 62 3e 2d 6f 75 74 66 69 6c 65 3c 2f m> <b>-outfile</
5370: 62 3e 20 3c 65 6d 3e 66 69 6c 65 6e 61 6d 65 20 b> <em>filename
5380: 7c 3c 2f 65 6d 3e 0a 09 3c 62 3e 2d 64 61 74 61 |</em>..<b>-data
5390: 3c 2f 62 3e 3c 65 6d 3e 20 64 61 74 61 5d 3c 2f </b><em> data]</
53a0: 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 em></a></dt>.
53b0: 20 3c 64 64 3e 45 6e 63 72 79 70 74 20 74 68 65 <dd>Encrypt the
53c0: 20 64 61 74 61 20 75 73 69 6e 67 20 63 69 70 68 data using ciph
53d0: 65 72 20 3c 65 6d 3e 63 69 70 68 65 72 3c 2f 65 er <em>cipher</e
53e0: 6d 3e 20 61 6e 64 20 6f 75 74 70 75 74 20 74 68 m> and output th
53f0: 65 20 72 65 73 75 6c 74 20 70 65 72 0a 09 74 68 e result per..th
5400: 65 20 49 2f 4f 20 6f 70 74 69 6f 6e 73 2e 20 43 e I/O options. C
5410: 69 70 68 65 72 73 20 61 72 65 20 75 73 65 64 20 iphers are used
5420: 74 6f 20 63 72 65 61 74 65 20 74 68 65 20 63 69 to create the ci
5430: 70 68 65 72 20 74 65 78 74 20 66 72 6f 6d 20 74 pher text from t
5440: 68 65 0a 09 69 6e 70 75 74 20 64 61 74 61 2e 20 he..input data.
5450: 53 65 65 20 3c 61 20 68 72 65 66 3d 22 23 4f 50 See <a href="#OP
5460: 54 49 4f 4e 53 22 3e 3c 62 3e 6f 70 74 69 6f 6e TIONS"><b>option
5470: 73 3c 2f 62 3e 3c 2f 61 3e 20 66 6f 72 20 75 73 s</b></a> for us
5480: 61 67 65 0a 09 69 6e 66 6f 2e 20 4f 70 74 69 6f age..info. Optio
5490: 6e 20 3c 62 3e 2d 69 76 3c 2f 62 3e 20 69 73 20 n <b>-iv</b> is
54a0: 6f 6e 6c 79 20 75 73 65 64 20 66 6f 72 20 73 6f only used for so
54b0: 6d 65 20 63 69 70 68 65 72 73 2e 20 53 65 65 20 me ciphers. See
54c0: 74 68 65 0a 09 3c 61 20 68 72 65 66 3d 22 23 74 the..<a href="#t
54d0: 6c 73 3a 3a 63 69 70 68 65 72 22 3e 3c 62 3e 74 ls::cipher"><b>t
54e0: 6c 73 3a 3a 63 69 70 68 65 72 3c 2f 62 3e 3c 2f ls::cipher</b></
54f0: 61 3e 20 63 6f 6d 6d 61 6e 64 20 66 6f 72 20 6b a> command for k
5500: 65 79 20 61 6e 64 20 69 76 0a 09 73 69 7a 65 73 ey and iv..sizes
5510: 20 61 6e 64 20 66 6f 72 20 77 68 65 6e 20 74 68 and for when th
5520: 65 20 3c 62 3e 2d 69 76 3c 2f 62 3e 20 6f 70 74 e <b>-iv</b> opt
5530: 69 6f 6e 20 69 73 20 75 73 65 64 20 28 69 76 5f ion is used (iv_
5540: 6c 65 6e 67 74 68 20 26 67 74 3b 20 30 29 2e 3c length > 0).<
5550: 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 /dd>.. <dt><a
5560: 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 64 65 63 72 name="tls::decr
5570: 79 70 74 22 3e 3c 73 74 72 6f 6e 67 3e 74 6c 73 ypt"><strong>tls
5580: 3a 3a 64 65 63 72 79 70 74 3c 2f 73 74 72 6f 6e ::decrypt</stron
5590: 67 3e 0a 09 3c 65 6d 3e 3f 3c 2f 65 6d 3e 3c 62 g>..<em>?</em><b
55a0: 3e 2d 63 69 70 68 65 72 3c 2f 62 3e 3c 65 6d 3e >-cipher</b><em>
55b0: 3f 20 6e 61 6d 65 3c 2f 65 6d 3e 0a 09 3c 62 3e ? name</em>..<b>
55c0: 2d 6b 65 79 3c 2f 62 3e 20 3c 65 6d 3e 6b 65 79 -key</b> <em>key
55d0: 20 3f 3c 2f 65 6d 3e 0a 09 3c 62 3e 2d 69 76 3c ?</em>..<b>-iv<
55e0: 2f 62 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 3f 3c /b> <em>string?<
55f0: 2f 65 6d 3e 0a 09 3c 65 6d 3e 5b 3c 2f 65 6d 3e /em>..<em>[</em>
5600: 3c 62 3e 2d 63 68 61 6e 3c 2f 62 3e 20 3c 65 6d <b>-chan</b> <em
5610: 3e 63 68 61 6e 6e 65 6c 49 64 20 7c 3c 2f 65 6d >channelId |</em
5620: 3e 20 3c 62 3e 2d 63 6f 6d 6d 61 6e 64 3c 2f 62 > <b>-command</b
5630: 3e 20 3c 65 6d 3e 63 6d 64 4e 61 6d 65 20 7c 3c > <em>cmdName |<
5640: 2f 65 6d 3e 0a 09 3c 62 3e 2d 69 6e 66 69 6c 65 /em>..<b>-infile
5650: 3c 2f 62 3e 20 3c 65 6d 3e 66 69 6c 65 6e 61 6d </b> <em>filenam
5660: 65 3c 2f 65 6d 3e 20 3c 62 3e 2d 6f 75 74 66 69 e</em> <b>-outfi
5670: 6c 65 3c 2f 62 3e 20 3c 65 6d 3e 66 69 6c 65 6e le</b> <em>filen
5680: 61 6d 65 20 7c 3c 2f 65 6d 3e 0a 09 3c 62 3e 2d ame |</em>..<b>-
5690: 64 61 74 61 3c 2f 62 3e 3c 65 6d 3e 20 64 61 74 data</b><em> dat
56a0: 61 5d 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e a]</em></a></dt>
56b0: 0a 20 20 20 20 3c 64 64 3e 44 65 63 72 79 70 74 . <dd>Decrypt
56c0: 20 74 68 65 20 64 61 74 61 20 75 73 69 6e 67 20 the data using
56d0: 63 69 70 68 65 72 20 3c 65 6d 3e 63 69 70 68 65 cipher <em>ciphe
56e0: 72 3c 2f 65 6d 3e 20 61 6e 64 20 6f 75 74 70 75 r</em> and outpu
56f0: 74 20 74 68 65 20 72 65 73 75 6c 74 20 70 65 72 t the result per
5700: 0a 09 74 68 65 20 49 2f 4f 20 6f 70 74 69 6f 6e ..the I/O option
5710: 73 2e 20 54 68 69 73 20 63 6f 6d 6d 61 6e 64 20 s. This command
5720: 69 73 20 74 68 65 20 6f 70 70 6f 73 69 74 65 20 is the opposite
5730: 6f 66 20 74 68 65 20 3c 62 3e 74 6c 73 3a 3a 65 of the <b>tls::e
5740: 6e 63 72 79 70 74 3c 2f 62 3e 0a 09 63 6f 6d 6d ncrypt</b>..comm
5750: 61 6e 64 2e 20 53 65 65 20 3c 61 20 68 72 65 66 and. See <a href
5760: 3d 22 23 4f 50 54 49 4f 4e 53 22 3e 3c 62 3e 6f ="#OPTIONS"><b>o
5770: 70 74 69 6f 6e 73 3c 2f 62 3e 3c 2f 61 3e 20 66 ptions</b></a> f
5780: 6f 72 20 75 73 61 67 65 20 69 6e 66 6f 2e 0a 09 or usage info...
5790: 54 68 65 20 3c 62 3e 2d 69 76 3c 2f 62 3e 20 6f The <b>-iv</b> o
57a0: 70 74 69 6f 6e 20 69 73 20 6f 6e 6c 79 20 75 73 ption is only us
57b0: 65 64 20 66 6f 72 20 73 6f 6d 65 20 63 69 70 68 ed for some ciph
57c0: 65 72 73 2e 20 53 65 65 20 74 68 65 0a 09 3c 61 ers. See the..<a
57d0: 20 68 72 65 66 3d 22 23 74 6c 73 3a 3a 63 69 70 href="#tls::cip
57e0: 68 65 72 22 3e 3c 62 3e 74 6c 73 3a 3a 63 69 70 her"><b>tls::cip
57f0: 68 65 72 3c 2f 62 3e 3c 2f 61 3e 20 63 6f 6d 6d her</b></a> comm
5800: 61 6e 64 20 66 6f 72 20 6b 65 79 20 61 6e 64 20 and for key and
5810: 69 76 0a 09 73 69 7a 65 73 20 61 6e 64 20 66 6f iv..sizes and fo
5820: 72 20 77 68 65 6e 20 74 68 65 20 3c 62 3e 2d 69 r when the <b>-i
5830: 76 3c 2f 62 3e 20 6f 70 74 69 6f 6e 20 69 73 20 v</b> option is
5840: 75 73 65 64 20 28 69 76 5f 6c 65 6e 67 74 68 20 used (iv_length
5850: 26 67 74 3b 20 30 29 2e 3c 2f 64 64 3e 0a 0a 3c > 0).</dd>..<
5860: 62 72 3e 0a 0a 3c 68 34 3e 3c 61 20 6e 61 6d 65 br>..<h4><a name
5870: 3d 22 4b 44 46 22 3e 4b 65 79 20 44 65 72 69 76 ="KDF">Key Deriv
5880: 61 74 69 6f 6e 20 46 75 6e 63 74 69 6f 6e 20 28 ation Function (
5890: 4b 44 46 29 20 43 6f 6d 6d 61 6e 64 73 3c 2f 61 KDF) Commands</a
58a0: 3e 3c 2f 68 34 3e 0a 54 68 65 73 65 20 63 6f 6d ></h4>.These com
58b0: 6d 61 6e 64 73 20 61 72 65 20 61 20 6d 6f 72 65 mands are a more
58c0: 20 73 65 63 75 72 65 20 77 61 79 20 74 6f 20 67 secure way to g
58d0: 65 6e 65 72 61 74 65 20 6b 65 79 73 20 61 6e 64 enerate keys and
58e0: 20 69 76 73 20 66 6f 72 20 75 73 65 20 62 79 20 ivs for use by
58f0: 74 68 65 0a 3c 61 20 68 72 65 66 3d 22 23 74 6c the.<a href="#tl
5900: 73 3a 3a 65 6e 63 72 79 70 74 22 3e 3c 62 3e 74 s::encrypt"><b>t
5910: 6c 73 3a 3a 65 6e 63 72 79 70 74 3c 2f 62 3e 3c ls::encrypt</b><
5920: 2f 61 3e 20 63 6f 6d 6d 61 6e 64 20 74 68 65 6e /a> command then
5930: 20 72 65 67 75 6c 61 72 20 73 74 72 69 6e 67 73 regular strings
5940: 20 61 6e 64 20 72 61 6e 64 6f 6d 20 76 61 6c 75 and random valu
5950: 65 73 2e 0a 3c 62 72 3e 0a 3c 62 72 3e 0a 20 20 es..<br>.<br>.
5960: 20 20 3c 64 74 3e 3c 61 20 6e 61 6d 65 3d 22 74 <dt><a name="t
5970: 6c 73 3a 3a 68 6b 64 66 22 3e 3c 73 74 72 6f 6e ls::hkdf"><stron
5980: 67 3e 74 6c 73 3a 3a 68 6b 64 66 3c 2f 73 74 72 g>tls::hkdf</str
5990: 6f 6e 67 3e 0a 09 3c 62 3e 2d 64 69 67 65 73 74 ong>..<b>-digest
59a0: 3c 2f 62 3e 20 3c 65 6d 3e 64 69 67 65 73 74 3c </b> <em>digest<
59b0: 2f 65 6d 3e 0a 09 3c 62 3e 2d 6b 65 79 3c 2f 62 /em>..<b>-key</b
59c0: 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 3c 2f 65 6d > <em>string</em
59d0: 3e 0a 09 3c 65 6d 3e 3f 3c 2f 65 6d 3e 3c 62 3e >..<em>?</em><b>
59e0: 2d 69 6e 66 6f 3c 2f 62 3e 20 3c 65 6d 3e 73 74 -info</b> <em>st
59f0: 72 69 6e 67 3f 3c 2f 65 6d 3e 0a 09 3c 65 6d 3e ring?</em>..<em>
5a00: 3f 3c 2f 65 6d 3e 3c 62 3e 2d 73 61 6c 74 3c 2f ?</em><b>-salt</
5a10: 62 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 3f 3c 2f b> <em>string?</
5a20: 65 6d 3e 0a 09 3c 65 6d 3e 3f 3c 2f 65 6d 3e 3c em>..<em>?</em><
5a30: 62 3e 2d 73 69 7a 65 3c 2f 62 3e 20 3c 65 6d 3e b>-size</b> <em>
5a40: 64 65 72 69 76 65 64 5f 6c 65 6e 67 74 68 3f 3c derived_length?<
5a50: 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 /em></a></dt>.
5a60: 20 20 3c 64 64 3e 44 65 72 69 76 65 20 61 20 6b <dd>Derive a k
5a70: 65 79 20 6f 66 20 73 69 7a 65 20 3c 69 3e 73 69 ey of size <i>si
5a80: 7a 65 3c 2f 69 3e 20 75 73 69 6e 67 20 74 68 65 ze</i> using the
5a90: 20 48 4d 41 43 2d 62 61 73 65 64 20 45 78 74 72 HMAC-based Extr
5aa0: 61 63 74 2d 61 6e 64 2d 45 78 70 61 6e 64 0a 09 act-and-Expand..
5ab0: 4b 65 79 20 44 65 72 69 76 61 74 69 6f 6e 20 46 Key Derivation F
5ac0: 75 6e 63 74 69 6f 6e 20 28 48 4b 44 46 29 2e 0a unction (HKDF)..
5ad0: 09 53 65 65 20 3c 61 20 68 72 65 66 3d 22 23 4f .See <a href="#O
5ae0: 50 54 49 4f 4e 53 22 3e 3c 62 3e 6f 70 74 69 6f PTIONS"><b>optio
5af0: 6e 73 3c 2f 62 3e 3c 2f 61 3e 20 66 6f 72 20 75 ns</b></a> for u
5b00: 73 61 67 65 20 69 6e 66 6f 2e 20 3c 2f 64 64 3e sage info. </dd>
5b10: 0a 0a 20 20 20 20 3c 64 74 3e 3c 61 20 6e 61 6d .. <dt><a nam
5b20: 65 3d 22 74 6c 73 3a 3a 70 62 6b 64 66 32 22 3e e="tls::pbkdf2">
5b30: 3c 73 74 72 6f 6e 67 3e 74 6c 73 3a 3a 70 62 6b <strong>tls::pbk
5b40: 64 66 32 3c 2f 73 74 72 6f 6e 67 3e 0a 09 3c 65 df2</strong>..<e
5b50: 6d 3e 5b 3c 2f 65 6d 3e 3c 62 3e 2d 63 69 70 68 m>[</em><b>-ciph
5b60: 65 72 3c 2f 62 3e 20 3c 65 6d 3e 63 69 70 68 65 er</b> <em>ciphe
5b70: 72 20 7c 3c 2f 65 6d 3e 0a 09 3c 62 3e 2d 73 69 r |</em>..<b>-si
5b80: 7a 65 3c 2f 62 3e 20 3c 65 6d 3e 64 65 72 69 76 ze</b> <em>deriv
5b90: 65 64 5f 6c 65 6e 67 74 68 5d 3c 2f 65 6d 3e 0a ed_length]</em>.
5ba0: 09 3c 62 3e 2d 64 69 67 65 73 74 3c 2f 62 3e 20 .<b>-digest</b>
5bb0: 3c 65 6d 3e 64 69 67 65 73 74 3c 2f 65 6d 3e 0a <em>digest</em>.
5bc0: 09 3c 65 6d 3e 3f 3c 2f 65 6d 3e 3c 62 3e 2d 69 .<em>?</em><b>-i
5bd0: 74 65 72 61 74 69 6f 6e 73 3c 2f 62 3e 20 3c 65 terations</b> <e
5be0: 6d 3e 63 6f 75 6e 74 3f 3c 2f 65 6d 3e 0a 09 3c m>count?</em>..<
5bf0: 65 6d 3e 3f 3c 2f 65 6d 3e 3c 62 3e 2d 70 61 73 em>?</em><b>-pas
5c00: 73 77 6f 72 64 3c 2f 62 3e 20 3c 65 6d 3e 73 74 sword</b> <em>st
5c10: 72 69 6e 67 3f 3c 2f 65 6d 3e 0a 09 3c 65 6d 3e ring?</em>..<em>
5c20: 3f 3c 2f 65 6d 3e 3c 62 3e 2d 73 61 6c 74 3c 2f ?</em><b>-salt</
5c30: 62 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 3f 3c 2f b> <em>string?</
5c40: 65 6d 3e 3c 2f 61 3e 3c 2f 64 74 3e 0a 20 20 20 em></a></dt>.
5c50: 20 3c 64 64 3e 44 65 72 69 76 65 20 61 20 6b 65 <dd>Derive a ke
5c60: 79 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 7a 61 y and initializa
5c70: 74 69 6f 6e 20 76 65 63 74 6f 72 20 28 69 76 29 tion vector (iv)
5c80: 20 66 72 6f 6d 20 61 20 70 61 73 73 77 6f 72 64 from a password
5c90: 20 61 6e 64 20 73 61 6c 74 0a 09 76 61 6c 75 65 and salt..value
5ca0: 20 75 73 69 6e 67 20 50 4b 43 53 35 5f 50 42 4b using PKCS5_PBK
5cb0: 44 46 32 5f 48 4d 41 43 2e 20 0a 09 53 65 65 20 DF2_HMAC. ..See
5cc0: 3c 61 20 68 72 65 66 3d 22 23 4f 50 54 49 4f 4e <a href="#OPTION
5cd0: 53 22 3e 3c 62 3e 6f 70 74 69 6f 6e 73 3c 2f 62 S"><b>options</b
5ce0: 3e 3c 2f 61 3e 20 66 6f 72 20 75 73 61 67 65 20 ></a> for usage
5cf0: 69 6e 66 6f 2e 20 49 66 20 3c 62 3e 2d 63 69 70 info. If <b>-cip
5d00: 68 65 72 3c 2f 62 3e 0a 09 69 73 20 73 70 65 63 her</b>..is spec
5d10: 69 66 69 65 64 2c 20 74 68 65 6e 20 74 68 65 20 ified, then the
5d20: 64 65 72 69 76 65 64 20 6b 65 79 20 61 6e 64 20 derived key and
5d30: 69 76 20 73 69 7a 65 64 20 66 6f 72 20 74 68 61 iv sized for tha
5d40: 74 20 63 69 70 68 65 72 20 61 72 65 0a 09 72 65 t cipher are..re
5d50: 74 75 72 6e 65 64 20 61 73 20 61 20 6b 65 79 2d turned as a key-
5d60: 76 61 6c 75 65 20 6c 69 73 74 2e 20 49 66 20 6e value list. If n
5d70: 6f 74 20 6f 72 20 69 66 20 3c 62 3e 2d 73 69 7a ot or if <b>-siz
5d80: 65 3c 2f 62 3e 20 69 73 20 73 70 65 63 69 66 69 e</b> is specifi
5d90: 65 64 2c 0a 09 74 68 65 6e 20 74 68 65 20 64 65 ed,..then the de
5da0: 72 69 76 65 64 20 6b 65 79 20 28 44 4b 29 20 6f rived key (DK) o
5db0: 66 20 3c 65 6d 3e 73 69 7a 65 3c 2f 65 6d 3e 20 f <em>size</em>
5dc0: 62 79 74 65 73 20 69 73 20 72 65 74 75 72 6e 65 bytes is returne
5dd0: 64 2e 3c 2f 64 64 3e 0a 0a 20 20 20 20 3c 64 74 d.</dd>.. <dt
5de0: 3e 3c 61 20 6e 61 6d 65 3d 22 74 6c 73 3a 3a 73 ><a name="tls::s
5df0: 63 72 79 70 74 22 3e 3c 73 74 72 6f 6e 67 3e 74 crypt"><strong>t
5e00: 6c 73 3a 3a 73 63 72 79 70 74 3c 2f 73 74 72 6f ls::scrypt</stro
5e10: 6e 67 3e 0a 09 3c 62 3e 2d 70 61 73 73 77 6f 72 ng>..<b>-passwor
5e20: 64 3c 2f 62 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 d</b> <em>string
5e30: 3c 2f 65 6d 3e 0a 09 3c 62 3e 2d 73 61 6c 74 3c </em>..<b>-salt<
5e40: 2f 62 3e 20 3c 65 6d 3e 73 74 72 69 6e 67 3c 2f /b> <em>string</
5e50: 65 6d 3e 0a 09 3c 65 6d 3e 3f 3c 2f 65 6d 3e 3c em>..<em>?</em><
5e60: 62 3e 2d 4e 3c 2f 62 3e 20 3c 65 6d 3e 63 6f 73 b>-N</b> <em>cos
5e70: 74 50 61 72 61 6d 65 74 65 72 3f 3c 2f 65 6d 3e tParameter?</em>
5e80: 0a 09 3c 65 6d 3e 3f 3c 2f 65 6d 3e 3c 62 3e 2d ..<em>?</em><b>-
5e90: 72 3c 2f 62 3e 20 3c 65 6d 3e 62 6c 6f 63 6b 53 r</b> <em>blockS
5ea0: 69 7a 65 3f 3c 2f 65 6d 3e 0a 09 3c 65 6d 3e 3f ize?</em>..<em>?
5eb0: 3c 2f 65 6d 3e 3c 62 3e 2d 70 3c 2f 62 3e 20 3c </em><b>-p</b> <
5ec0: 65 6d 3e 70 61 72 61 6c 6c 65 6c 69 7a 61 74 69 em>parallelizati
5ed0: 6f 6e 3f 3c 2f 65 6d 3e 0a 09 3c 65 6d 3e 3f 3c on?</em>..<em>?<
5ee0: 2f 65 6d 3e 3c 62 3e 2d 73 69 7a 65 3c 2f 62 3e /em><b>-size</b>
5ef0: 20 3c 65 6d 3e 64 65 72 69 76 65 64 5f 6c 65 6e <em>derived_len
5f00: 67 74 68 3f 3c 2f 65 6d 3e 3c 2f 61 3e 3c 2f 64 gth?</em></a></d
5f10: 74 3e 0a 20 20 20 20 3c 64 64 3e 44 65 72 69 76 t>. <dd>Deriv
5f20: 65 20 61 20 6b 65 79 20 6f 66 20 73 69 7a 65 20 e a key of size
5f30: 3c 69 3e 73 69 7a 65 3c 2f 69 3e 20 75 73 69 6e <i>size</i> usin
5f40: 67 20 74 68 65 20 73 63 72 79 70 74 20 70 61 73 g the scrypt pas
5f50: 73 77 6f 72 64 20 62 61 73 65 64 20 6b 65 79 20 sword based key
5f60: 64 65 72 69 76 61 74 69 6f 6e 20 66 75 6e 63 74 derivation funct
5f70: 69 6f 6e 2e 0a 09 53 65 65 20 3c 61 20 68 72 65 ion...See <a hre
5f80: 66 3d 22 23 4f 50 54 49 4f 4e 53 22 3e 3c 62 3e f="#OPTIONS"><b>
5f90: 6f 70 74 69 6f 6e 73 3c 2f 62 3e 3c 2f 61 3e 20 options</b></a>
5fa0: 66 6f 72 20 75 73 61 67 65 20 69 6e 66 6f 2e 20 for usage info.
5fb0: 0a 09 53 65 65 20 52 46 43 20 37 39 31 34 20 66 ..See RFC 7914 f
5fc0: 6f 72 20 6d 6f 72 65 20 64 65 74 61 69 6c 73 2e or more details.
5fd0: 20 43 61 6e 20 63 6f 6e 73 75 6d 65 20 61 20 6c Can consume a l
5fe0: 61 72 67 65 20 61 6d 6f 75 6e 74 20 6f 66 20 6d arge amount of m
5ff0: 65 6d 6f 72 79 2e 0a 09 52 41 4d 20 75 73 65 64 emory...RAM used
6000: 20 69 73 20 72 6f 75 67 68 6c 79 20 28 31 32 38 is roughly (128
6010: 20 2a 20 4e 20 2a 20 72 20 2a 20 70 29 20 62 79 * N * r * p) by
6020: 74 65 73 2e 20 4d 65 6d 6f 72 79 20 69 73 20 6c tes. Memory is l
6030: 69 6d 69 74 65 64 20 74 6f 0a 09 31 30 32 35 20 imited to..1025
6040: 4d 69 42 2e 20 54 68 65 20 63 75 73 74 6f 6d 20 MiB. The custom
6050: 6f 70 74 69 6f 6e 73 20 61 72 65 3a 3c 2f 64 64 options are:</dd
6060: 3e 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 >. <blockquot
6070: 65 3e 3c 74 61 62 6c 65 3e 0a 09 3c 74 72 3e 3c e><table>..<tr><
6080: 74 64 3e 3c 62 3e 2d 4e 3c 2f 62 3e 3c 2f 74 64 td><b>-N</b></td
6090: 3e 3c 74 64 3e 54 68 65 20 43 50 55 2f 4d 65 6d ><td>The CPU/Mem
60a0: 6f 72 79 20 63 6f 73 74 20 70 61 72 61 6d 65 74 ory cost paramet
60b0: 65 72 0a 09 6d 75 73 74 20 62 65 20 6c 61 72 67 er..must be larg
60c0: 65 72 20 74 68 61 6e 20 31 2c 20 61 20 70 6f 77 er than 1, a pow
60d0: 65 72 20 6f 66 20 32 2c 20 61 6e 64 20 6c 65 73 er of 2, and les
60e0: 73 20 74 68 61 6e 0a 09 32 5e 28 31 32 38 20 2a s than..2^(128 *
60f0: 20 72 20 2f 20 38 29 2e 20 44 65 66 61 75 6c 74 r / 8). Default
6100: 20 69 73 20 31 30 34 38 35 37 36 2e 3c 74 64 3e is 1048576.<td>
6110: 3c 2f 74 72 3e 0a 09 3c 74 72 3e 3c 74 64 3e 3c </tr>..<tr><td><
6120: 62 3e 2d 72 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 b>-r</b></td><td
6130: 3e 54 68 65 20 62 6c 6f 63 6b 53 69 7a 65 20 70 >The blockSize p
6140: 61 72 61 6d 65 74 65 72 20 73 70 65 63 69 66 69 arameter specifi
6150: 65 73 20 74 68 65 0a 09 62 6c 6f 63 6b 20 73 69 es the..block si
6160: 7a 65 2e 20 4d 75 73 74 20 62 65 20 67 72 65 61 ze. Must be grea
6170: 74 65 72 20 74 68 61 6e 20 30 2e 20 44 65 66 61 ter than 0. Defa
6180: 75 6c 74 20 69 73 20 38 2e 3c 74 64 3e 3c 2f 74 ult is 8.<td></t
6190: 72 3e 0a 09 3c 74 72 3e 3c 74 64 3e 3c 62 3e 2d r>..<tr><td><b>-
61a0: 70 3c 2f 62 3e 3c 2f 74 64 3e 3c 74 64 3e 54 68 p</b></td><td>Th
61b0: 65 20 70 61 72 61 6c 6c 65 6c 69 7a 61 74 69 6f e parallelizatio
61c0: 6e 20 70 61 72 61 6d 65 74 65 72 0a 09 6d 75 73 n parameter..mus
61d0: 74 20 62 65 20 61 20 70 6f 73 69 74 69 76 65 20 t be a positive
61e0: 69 6e 74 65 67 65 72 20 6c 65 73 73 20 74 68 61 integer less tha
61f0: 6e 20 6f 72 20 65 71 75 61 6c 0a 09 74 6f 20 28 n or equal..to (
6200: 28 32 5e 33 32 2d 31 29 20 2a 20 33 32 29 20 2f (2^32-1) * 32) /
6210: 20 28 31 32 38 20 2a 20 72 29 2e 20 44 65 66 61 (128 * r). Defa
6220: 75 6c 74 20 69 73 20 31 2e 3c 74 64 3e 3c 2f 74 ult is 1.<td></t
6230: 72 3e 0a 20 20 20 20 3c 2f 74 61 62 6c 65 3e 3c r>. </table><
6240: 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 3c 2f 64 /blockquote>.</d
6250: 6c 3e 0a 0a 3c 62 72 3e 0a 3c 68 33 3e 3c 61 20 l>..<br>.<h3><a
6260: 6e 61 6d 65 3d 22 47 4c 4f 53 53 41 52 59 22 3e name="GLOSSARY">
6270: 47 4c 4f 53 53 41 52 59 3c 2f 61 3e 3c 2f 68 33 GLOSSARY</a></h3
6280: 3e 0a 0a 3c 70 3e 54 68 65 20 66 6f 6c 6c 6f 77 >..<p>The follow
6290: 69 6e 67 20 69 73 20 61 20 6c 69 73 74 20 6f 66 ing is a list of
62a0: 20 74 68 65 20 74 65 72 6d 69 6e 6f 6c 6f 67 79 the terminology
62b0: 20 75 73 65 64 20 69 6e 20 74 68 69 73 20 70 61 used in this pa
62c0: 63 6b 61 67 65 20 61 6c 6f 6e 67 20 77 69 74 68 ckage along with
62d0: 0a 62 72 69 65 66 20 64 65 66 69 6e 69 74 69 6f .brief definitio
62e0: 6e 73 2e 20 46 6f 72 20 6d 6f 72 65 20 64 65 74 ns. For more det
62f0: 61 69 6c 73 2c 20 70 6c 65 61 73 65 20 63 6f 6e ails, please con
6300: 73 75 6c 74 20 77 69 74 68 20 74 68 65 20 4f 70 sult with the Op
6310: 65 6e 53 53 4c 20 64 6f 63 75 6d 65 6e 74 61 74 enSSL documentat
6320: 69 6f 6e 2e 3c 2f 70 3e 0a 0a 0a 3c 62 72 3e 0a ion.</p>...<br>.
6330: 3c 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 45 58 41 <h3><a name="EXA
6340: 4d 50 4c 45 53 22 3e 45 58 41 4d 50 4c 45 53 3c MPLES">EXAMPLES<
6350: 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 54 42 53 /a></h3>..<p>TBS
6360: 3c 2f 70 3e 0a 0a 3c 70 72 65 3e 3c 63 6f 64 65 </p>..<pre><code
6370: 3e 0a 70 61 63 6b 61 67 65 20 72 65 71 75 69 72 >.package requir
6380: 65 20 68 74 74 70 0a 70 61 63 6b 61 67 65 20 72 e http.package r
6390: 65 71 75 69 72 65 20 74 6c 73 0a 0a 68 74 74 70 equire tls..http
63a0: 3a 3a 72 65 67 69 73 74 65 72 20 68 74 74 70 73 ::register https
63b0: 20 34 34 33 20 5b 6c 69 73 74 20 3a 3a 74 6c 73 443 [list ::tls
63c0: 3a 3a 73 6f 63 6b 65 74 20 2d 61 75 74 6f 73 65 ::socket -autose
63d0: 72 76 65 72 6e 61 6d 65 20 74 72 75 65 20 2d 72 rvername true -r
63e0: 65 71 75 69 72 65 20 74 72 75 65 20 2d 63 61 64 equire true -cad
63f0: 69 72 20 2f 65 74 63 2f 73 73 6c 2f 63 65 72 74 ir /etc/ssl/cert
6400: 73 5d 0a 0a 73 65 74 20 74 6f 6b 20 5b 68 74 74 s]..set tok [htt
6410: 70 3a 3a 67 65 74 75 72 6c 20 68 74 74 70 73 3a p::geturl https:
6420: 2f 2f 77 77 77 2e 74 63 6c 2e 74 6b 2f 5d 0a 3c //www.tcl.tk/].<
6430: 2f 63 6f 64 65 3e 3c 2f 70 72 65 3e 0a 0a 3c 62 /code></pre>..<b
6440: 72 3e 0a 3c 68 33 3e 3c 61 20 6e 61 6d 65 3d 22 r>.<h3><a name="
6450: 53 50 45 43 49 41 4c 22 3e 53 50 45 43 49 41 4c SPECIAL">SPECIAL
6460: 20 43 4f 4e 53 49 44 45 52 41 54 49 4f 4e 53 3c CONSIDERATIONS<
6470: 2f 61 3e 3c 2f 68 33 3e 0a 0a 3c 70 3e 54 68 65 /a></h3>..<p>The
6480: 20 63 61 70 61 62 69 6c 69 74 69 65 73 20 6f 66 capabilities of
6490: 20 74 68 69 73 20 70 61 63 6b 61 67 65 20 63 61 this package ca
64a0: 6e 20 76 61 72 79 20 65 6e 6f 72 6d 6f 75 73 6c n vary enormousl
64b0: 79 20 62 61 73 65 64 20 75 70 6f 6e 20 68 6f 77 y based upon how
64c0: 20 79 6f 75 72 0a 4f 70 65 6e 53 53 4c 20 6c 69 your.OpenSSL li
64d0: 62 72 61 72 79 20 77 61 73 20 63 6f 6e 66 69 67 brary was config
64e0: 75 72 65 64 20 61 6e 64 20 62 75 69 6c 74 2e 20 ured and built.
64f0: 4e 65 77 20 76 65 72 73 69 6f 6e 73 20 6d 61 79 New versions may
6500: 20 6f 62 73 6f 6c 65 74 65 20 6f 6c 64 65 72 0a obsolete older.
6510: 63 69 70 68 65 72 73 2c 20 64 69 67 65 73 74 73 ciphers, digests
6520: 2c 20 4d 41 43 73 2c 20 65 74 63 2e 20 6f 72 20 , MACs, etc. or
6530: 63 68 61 6e 67 65 20 64 65 66 61 75 6c 74 20 76 change default v
6540: 61 6c 75 65 73 2e 20 55 73 65 20 74 68 65 0a 69 alues. Use the.i
6550: 6e 66 6f 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 nfo commands to
6560: 6f 62 74 61 69 6e 20 74 68 65 20 73 75 70 70 6f obtain the suppo
6570: 72 74 65 64 20 76 61 6c 75 65 73 2e 3c 2f 70 3e rted values.</p>
6580: 0a 3c 62 72 3e 0a 0a 3c 70 72 65 3e 0a 43 6f 70 .<br>..<pre>.Cop
6590: 79 72 69 67 68 74 20 26 63 6f 70 79 3b 20 32 30 yright © 20
65a0: 32 33 20 42 72 69 61 6e 20 4f 27 48 61 67 61 6e 23 Brian O'Hagan
65b0: 2e 0a 3c 2f 70 72 65 3e 0a 3c 2f 62 6f 64 79 3e ..</pre>.</body>
65c0: 0a 3c 2f 68 74 6d 6c 3e 0a .</html>.