0000: 23 0a 23 20 43 6f 70 79 72 69 67 68 74 20 28 43 #.# Copyright (C
0010: 29 20 31 39 39 37 2d 32 30 30 30 20 4d 61 74 74 ) 1997-2000 Matt
0020: 20 4e 65 77 6d 61 6e 20 3c 6d 61 74 74 40 6e 6f Newman <matt@no
0030: 76 61 64 69 67 6d 2e 63 6f 6d 3e 20 0a 23 0a 23 vadigm.com> .#.#
0040: 20 24 48 65 61 64 65 72 3a 20 2f 68 6f 6d 65 2f $Header: /home/
0050: 72 6b 65 65 6e 65 2f 74 6d 70 2f 63 76 73 32 66 rkeene/tmp/cvs2f
0060: 6f 73 73 69 6c 2f 2e 2e 2f 74 63 6c 74 6c 73 2f ossil/../tcltls/
0070: 74 6c 73 2f 74 6c 73 2f 74 6c 73 2e 74 63 6c 2c tls/tls/tls.tcl,
0080: 76 20 31 2e 31 31 20 32 30 30 39 2f 30 34 2f 32 v 1.11 2009/04/2
0090: 33 20 32 33 3a 31 32 3a 30 37 20 68 6f 62 62 73 3 23:12:07 hobbs
00a0: 32 20 45 78 70 20 24 0a 23 0a 6e 61 6d 65 73 70 2 Exp $.#.namesp
00b0: 61 63 65 20 65 76 61 6c 20 74 6c 73 20 7b 0a 20 ace eval tls {.
00c0: 20 20 20 76 61 72 69 61 62 6c 65 20 6c 6f 67 63 variable logc
00d0: 6d 64 20 74 63 6c 4c 6f 67 0a 20 20 20 20 76 61 md tclLog. va
00e0: 72 69 61 62 6c 65 20 64 65 62 75 67 20 30 0a 20 riable debug 0.
00f0: 0a 20 20 20 20 23 20 44 65 66 61 75 6c 74 20 66 . # Default f
0100: 6c 61 67 73 20 70 61 73 73 65 64 20 74 6f 20 74 lags passed to t
0110: 6c 73 3a 3a 69 6d 70 6f 72 74 0a 20 20 20 20 76 ls::import. v
0120: 61 72 69 61 62 6c 65 20 64 65 66 61 75 6c 74 73 ariable defaults
0130: 20 7b 7d 0a 0a 20 20 20 20 23 20 4d 61 70 73 20 {}.. # Maps
0140: 55 49 44 20 74 6f 20 53 65 72 76 65 72 20 53 6f UID to Server So
0150: 63 6b 65 74 0a 20 20 20 20 76 61 72 69 61 62 6c cket. variabl
0160: 65 20 73 72 76 6d 61 70 0a 20 20 20 20 76 61 72 e srvmap. var
0170: 69 61 62 6c 65 20 73 72 76 75 69 64 20 30 0a 0a iable srvuid 0..
0180: 20 20 20 20 23 20 4f 76 65 72 2d 72 69 64 65 20 # Over-ride
0190: 74 68 69 73 20 69 66 20 79 6f 75 20 61 72 65 20 this if you are
01a0: 75 73 69 6e 67 20 61 20 64 69 66 66 65 72 65 6e using a differen
01b0: 74 20 73 6f 63 6b 65 74 20 63 6f 6d 6d 61 6e 64 t socket command
01c0: 0a 20 20 20 20 76 61 72 69 61 62 6c 65 20 73 6f . variable so
01d0: 63 6b 65 74 43 6d 64 0a 20 20 20 20 69 66 20 7b cketCmd. if {
01e0: 21 5b 69 6e 66 6f 20 65 78 69 73 74 73 20 73 6f ![info exists so
01f0: 63 6b 65 74 43 6d 64 5d 7d 20 7b 0a 20 20 20 20 cketCmd]} {.
0200: 20 20 20 20 73 65 74 20 73 6f 63 6b 65 74 43 6d set socketCm
0210: 64 20 5b 69 6e 66 6f 20 63 6f 6d 6d 61 6e 64 20 d [info command
0220: 3a 3a 73 6f 63 6b 65 74 5d 0a 20 20 20 20 7d 0a ::socket]. }.
0230: 7d 0a 0a 70 72 6f 63 20 74 6c 73 3a 3a 69 6e 69 }..proc tls::ini
0240: 74 6c 69 62 20 7b 64 69 72 20 64 6c 6c 7d 20 7b tlib {dir dll} {
0250: 0a 20 20 20 20 23 20 50 61 63 6b 61 67 65 20 69 . # Package i
0260: 6e 64 65 78 20 63 64 27 73 20 69 6e 74 6f 20 74 ndex cd's into t
0270: 68 65 20 70 61 63 6b 61 67 65 20 64 69 72 65 63 he package direc
0280: 74 6f 72 79 20 66 6f 72 20 6c 6f 61 64 69 6e 67 tory for loading
0290: 2e 0a 20 20 20 20 23 20 49 72 72 65 6c 65 76 61 .. # Irreleva
02a0: 6e 74 20 74 6f 20 75 6e 69 78 6f 69 64 73 2c 20 nt to unixoids,
02b0: 62 75 74 20 66 6f 72 20 57 69 6e 64 6f 77 73 20 but for Windows
02c0: 74 68 69 73 20 65 6e 61 62 6c 65 73 20 74 68 65 this enables the
02d0: 20 4f 53 20 74 6f 20 66 69 6e 64 0a 20 20 20 20 OS to find.
02e0: 23 20 74 68 65 20 64 65 70 65 6e 64 65 6e 74 20 # the dependent
02f0: 44 4c 4c 27 73 20 69 6e 20 74 68 65 20 43 57 44 DLL's in the CWD
0300: 2c 20 77 68 65 72 65 20 74 68 65 79 20 6d 61 79 , where they may
0310: 20 62 65 2e 0a 20 20 20 20 73 65 74 20 63 77 64 be.. set cwd
0320: 20 5b 70 77 64 5d 0a 20 20 20 20 63 61 74 63 68 [pwd]. catch
0330: 20 7b 63 64 20 24 64 69 72 7d 0a 20 20 20 20 69 {cd $dir}. i
0340: 66 20 7b 5b 73 74 72 69 6e 67 20 65 71 75 61 6c f {[string equal
0350: 20 24 3a 3a 74 63 6c 5f 70 6c 61 74 66 6f 72 6d $::tcl_platform
0360: 28 70 6c 61 74 66 6f 72 6d 29 20 22 77 69 6e 64 (platform) "wind
0370: 6f 77 73 22 5d 20 26 26 0a 09 21 5b 73 74 72 69 ows"] &&..![stri
0380: 6e 67 20 65 71 75 61 6c 20 5b 6c 69 6e 64 65 78 ng equal [lindex
0390: 20 5b 66 69 6c 65 20 73 79 73 74 65 6d 20 24 64 [file system $d
03a0: 69 72 5d 20 30 5d 20 22 6e 61 74 69 76 65 22 5d ir] 0] "native"]
03b0: 7d 20 7b 0a 09 23 20 49 66 20 69 74 20 69 73 20 } {..# If it is
03c0: 61 20 77 72 61 70 70 65 64 20 65 78 65 63 75 74 a wrapped execut
03d0: 61 62 6c 65 20 72 75 6e 6e 69 6e 67 20 6f 6e 20 able running on
03e0: 77 69 6e 64 6f 77 73 2c 20 74 68 65 20 6f 70 65 windows, the ope
03f0: 6e 73 73 6c 0a 09 23 20 64 6c 6c 73 20 6d 75 73 nssl..# dlls mus
0400: 74 20 62 65 20 63 6f 70 69 65 64 20 6f 75 74 20 t be copied out
0410: 6f 66 20 74 68 65 20 76 69 72 74 75 61 6c 20 66 of the virtual f
0420: 69 6c 65 73 79 73 74 65 6d 20 74 6f 20 74 68 65 ilesystem to the
0430: 20 64 69 73 6b 0a 09 23 20 77 68 65 72 65 20 57 disk..# where W
0440: 69 6e 64 6f 77 73 20 77 69 6c 6c 20 66 69 6e 64 indows will find
0450: 20 74 68 65 6d 20 77 68 65 6e 20 72 65 73 6f 6c them when resol
0460: 76 69 6e 67 20 74 68 65 20 64 65 70 65 6e 64 65 ving the depende
0470: 6e 63 79 20 69 6e 0a 09 23 20 74 68 65 20 74 6c ncy in..# the tl
0480: 73 20 64 6c 6c 2e 20 57 65 20 63 68 6f 6f 73 65 s dll. We choose
0490: 20 74 6f 20 6d 61 6b 65 20 74 68 65 6d 20 73 69 to make them si
04a0: 62 6c 69 6e 67 73 20 6f 66 20 74 68 65 20 65 78 blings of the ex
04b0: 65 63 75 74 61 62 6c 65 2e 0a 09 70 61 63 6b 61 ecutable...packa
04c0: 67 65 20 72 65 71 75 69 72 65 20 73 74 61 72 6b ge require stark
04d0: 69 74 0a 09 73 65 74 20 64 73 74 20 5b 66 69 6c it..set dst [fil
04e0: 65 20 6e 61 74 69 76 65 6e 61 6d 65 20 5b 66 69 e nativename [fi
04f0: 6c 65 20 64 69 72 6e 61 6d 65 20 24 73 74 61 72 le dirname $star
0500: 6b 69 74 3a 3a 74 6f 70 64 69 72 5d 5d 0a 09 66 kit::topdir]]..f
0510: 6f 72 65 61 63 68 20 73 64 6c 6c 20 5b 67 6c 6f oreach sdll [glo
0520: 62 20 2d 6e 6f 63 6f 6d 70 6c 61 69 6e 20 2d 64 b -nocomplain -d
0530: 69 72 65 63 74 6f 72 79 20 24 64 69 72 20 2d 74 irectory $dir -t
0540: 61 69 6c 73 20 2a 65 61 79 33 32 2e 64 6c 6c 5d ails *eay32.dll]
0550: 20 7b 0a 09 20 20 20 20 63 61 74 63 68 20 7b 66 {.. catch {f
0560: 69 6c 65 20 64 65 6c 65 74 65 20 2d 66 6f 72 63 ile delete -forc
0570: 65 20 20 20 20 20 20 20 20 20 20 20 20 24 64 73 e $ds
0580: 74 2f 24 73 64 6c 6c 7d 0a 09 20 20 20 20 63 61 t/$sdll}.. ca
0590: 74 63 68 20 7b 66 69 6c 65 20 63 6f 70 79 20 20 tch {file copy
05a0: 20 2d 66 6f 72 63 65 20 24 64 69 72 2f 24 73 64 -force $dir/$sd
05b0: 6c 6c 20 24 64 73 74 2f 24 73 64 6c 6c 7d 0a 09 ll $dst/$sdll}..
05c0: 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 65 74 20 }. }. set
05d0: 72 65 73 20 5b 63 61 74 63 68 20 7b 75 70 6c 65 res [catch {uple
05e0: 76 65 6c 20 23 30 20 5b 6c 69 73 74 20 6c 6f 61 vel #0 [list loa
05f0: 64 20 5b 66 69 6c 65 20 6a 6f 69 6e 20 5b 70 77 d [file join [pw
0600: 64 5d 20 24 64 6c 6c 5d 5d 7d 20 65 72 72 5d 0a d] $dll]]} err].
0610: 20 20 20 20 63 61 74 63 68 20 7b 63 64 20 24 63 catch {cd $c
0620: 77 64 7d 0a 20 20 20 20 69 66 20 7b 24 72 65 73 wd}. if {$res
0630: 7d 20 7b 0a 09 6e 61 6d 65 73 70 61 63 65 20 65 } {..namespace e
0640: 76 61 6c 20 5b 6e 61 6d 65 73 70 61 63 65 20 70 val [namespace p
0650: 61 72 65 6e 74 5d 20 7b 6e 61 6d 65 73 70 61 63 arent] {namespac
0660: 65 20 64 65 6c 65 74 65 20 74 6c 73 7d 0a 09 72 e delete tls}..r
0670: 65 74 75 72 6e 20 2d 63 6f 64 65 20 24 72 65 73 eturn -code $res
0680: 20 24 65 72 72 0a 20 20 20 20 7d 0a 20 20 20 20 $err. }.
0690: 72 65 6e 61 6d 65 20 74 6c 73 3a 3a 69 6e 69 74 rename tls::init
06a0: 6c 69 62 20 7b 7d 0a 7d 0a 0a 23 0a 23 20 42 61 lib {}.}..#.# Ba
06b0: 63 6b 77 61 72 64 73 20 63 6f 6d 70 61 74 69 62 ckwards compatib
06c0: 69 6c 69 74 79 2c 20 61 6c 73 6f 20 75 73 65 64 ility, also used
06d0: 20 74 6f 20 73 65 74 20 74 68 65 20 64 65 66 61 to set the defa
06e0: 75 6c 74 0a 23 20 63 6f 6e 74 65 78 74 20 6f 70 ult.# context op
06f0: 74 69 6f 6e 73 0a 23 0a 70 72 6f 63 20 74 6c 73 tions.#.proc tls
0700: 3a 3a 69 6e 69 74 20 7b 61 72 67 73 7d 20 7b 0a ::init {args} {.
0710: 20 20 20 20 76 61 72 69 61 62 6c 65 20 64 65 66 variable def
0720: 61 75 6c 74 73 0a 0a 20 20 20 20 73 65 74 20 64 aults.. set d
0730: 65 66 61 75 6c 74 73 20 24 61 72 67 73 0a 7d 0a efaults $args.}.
0740: 23 0a 23 20 48 65 6c 70 65 72 20 66 75 6e 63 74 #.# Helper funct
0750: 69 6f 6e 20 2d 20 62 65 68 61 76 65 73 20 65 78 ion - behaves ex
0760: 61 63 74 6c 79 20 61 73 20 74 68 65 20 6e 61 74 actly as the nat
0770: 69 76 65 20 73 6f 63 6b 65 74 20 63 6f 6d 6d 61 ive socket comma
0780: 6e 64 2e 0a 23 0a 70 72 6f 63 20 74 6c 73 3a 3a nd..#.proc tls::
0790: 73 6f 63 6b 65 74 20 7b 61 72 67 73 7d 20 7b 0a socket {args} {.
07a0: 20 20 20 20 76 61 72 69 61 62 6c 65 20 73 6f 63 variable soc
07b0: 6b 65 74 43 6d 64 0a 20 20 20 20 76 61 72 69 61 ketCmd. varia
07c0: 62 6c 65 20 64 65 66 61 75 6c 74 73 0a 20 20 20 ble defaults.
07d0: 20 73 65 74 20 69 64 78 20 5b 6c 73 65 61 72 63 set idx [lsearc
07e0: 68 20 24 61 72 67 73 20 2d 73 65 72 76 65 72 5d h $args -server]
07f0: 0a 20 20 20 20 69 66 20 7b 24 69 64 78 20 21 3d . if {$idx !=
0800: 20 2d 31 7d 20 7b 0a 09 73 65 74 20 73 65 72 76 -1} {..set serv
0810: 65 72 20 31 0a 09 73 65 74 20 63 61 6c 6c 62 61 er 1..set callba
0820: 63 6b 20 5b 6c 69 6e 64 65 78 20 24 61 72 67 73 ck [lindex $args
0830: 20 5b 65 78 70 72 20 7b 24 69 64 78 2b 31 7d 5d [expr {$idx+1}]
0840: 5d 0a 09 73 65 74 20 61 72 67 73 20 5b 6c 72 65 ]..set args [lre
0850: 70 6c 61 63 65 20 24 61 72 67 73 20 24 69 64 78 place $args $idx
0860: 20 5b 65 78 70 72 20 7b 24 69 64 78 2b 31 7d 5d [expr {$idx+1}]
0870: 5d 0a 0a 09 73 65 74 20 75 73 61 67 65 20 22 77 ]...set usage "w
0880: 72 6f 6e 67 20 23 20 61 72 67 73 3a 20 73 68 6f rong # args: sho
0890: 75 6c 64 20 62 65 20 5c 22 74 6c 73 3a 3a 73 6f uld be \"tls::so
08a0: 63 6b 65 74 20 2d 73 65 72 76 65 72 20 63 6f 6d cket -server com
08b0: 6d 61 6e 64 20 3f 6f 70 74 69 6f 6e 73 3f 20 70 mand ?options? p
08c0: 6f 72 74 5c 22 22 0a 09 73 65 74 20 6f 70 74 69 ort\""..set opti
08d0: 6f 6e 73 20 22 2d 63 61 64 69 72 2c 20 2d 63 61 ons "-cadir, -ca
08e0: 66 69 6c 65 2c 20 2d 63 65 72 74 66 69 6c 65 2c file, -certfile,
08f0: 20 2d 63 69 70 68 65 72 2c 20 2d 63 6f 6d 6d 61 -cipher, -comma
0900: 6e 64 2c 20 2d 6b 65 79 66 69 6c 65 2c 20 2d 6d nd, -keyfile, -m
0910: 79 61 64 64 72 2c 20 2d 70 61 73 73 77 6f 72 64 yaddr, -password
0920: 2c 20 2d 72 65 71 75 65 73 74 2c 20 2d 72 65 71 , -request, -req
0930: 75 69 72 65 2c 20 2d 73 73 6c 32 2c 20 2d 73 73 uire, -ssl2, -ss
0940: 6c 33 2c 20 6f 72 20 2d 74 6c 73 31 22 0a 20 20 l3, or -tls1".
0950: 20 20 7d 20 65 6c 73 65 20 7b 0a 09 73 65 74 20 } else {..set
0960: 73 65 72 76 65 72 20 30 0a 0a 09 73 65 74 20 75 server 0...set u
0970: 73 61 67 65 20 22 77 72 6f 6e 67 20 23 20 61 72 sage "wrong # ar
0980: 67 73 3a 20 73 68 6f 75 6c 64 20 62 65 20 5c 22 gs: should be \"
0990: 74 6c 73 3a 3a 73 6f 63 6b 65 74 20 3f 6f 70 74 tls::socket ?opt
09a0: 69 6f 6e 73 3f 20 68 6f 73 74 20 70 6f 72 74 5c ions? host port\
09b0: 22 22 0a 09 73 65 74 20 6f 70 74 69 6f 6e 73 20 ""..set options
09c0: 22 2d 61 73 79 6e 63 2c 20 2d 63 61 64 69 72 2c "-async, -cadir,
09d0: 20 2d 63 61 66 69 6c 65 2c 20 2d 63 65 72 74 66 -cafile, -certf
09e0: 69 6c 65 2c 20 2d 63 69 70 68 65 72 2c 20 2d 63 ile, -cipher, -c
09f0: 6f 6d 6d 61 6e 64 2c 20 2d 6b 65 79 66 69 6c 65 ommand, -keyfile
0a00: 2c 20 2d 6d 79 61 64 64 72 2c 20 2d 6d 79 70 6f , -myaddr, -mypo
0a10: 72 74 2c 20 2d 70 61 73 73 77 6f 72 64 2c 20 2d rt, -password, -
0a20: 72 65 71 75 65 73 74 2c 20 2d 72 65 71 75 69 72 request, -requir
0a30: 65 2c 20 2d 73 73 6c 32 2c 20 2d 73 73 6c 33 2c e, -ssl2, -ssl3,
0a40: 20 6f 72 20 2d 74 6c 73 31 22 0a 20 20 20 20 7d or -tls1". }
0a50: 0a 20 20 20 20 73 65 74 20 61 72 67 63 20 5b 6c . set argc [l
0a60: 6c 65 6e 67 74 68 20 24 61 72 67 73 5d 0a 20 20 length $args].
0a70: 20 20 73 65 74 20 73 6f 70 74 73 20 7b 7d 0a 20 set sopts {}.
0a80: 20 20 20 73 65 74 20 69 6f 70 74 73 20 5b 63 6f set iopts [co
0a90: 6e 63 61 74 20 5b 6c 69 73 74 20 2d 73 65 72 76 ncat [list -serv
0aa0: 65 72 20 24 73 65 72 76 65 72 5d 20 24 64 65 66 er $server] $def
0ab0: 61 75 6c 74 73 5d 09 3b 23 20 49 6d 70 6f 72 74 aults].;# Import
0ac0: 20 6f 70 74 69 6f 6e 73 0a 0a 20 20 20 20 66 6f options.. fo
0ad0: 72 20 7b 73 65 74 20 69 64 78 20 30 7d 20 7b 24 r {set idx 0} {$
0ae0: 69 64 78 20 3c 20 24 61 72 67 63 7d 20 7b 69 6e idx < $argc} {in
0af0: 63 72 20 69 64 78 7d 20 7b 0a 09 73 65 74 20 61 cr idx} {..set a
0b00: 72 67 20 5b 6c 69 6e 64 65 78 20 24 61 72 67 73 rg [lindex $args
0b10: 20 24 69 64 78 5d 0a 09 73 77 69 74 63 68 20 2d $idx]..switch -
0b20: 67 6c 6f 62 20 2d 2d 20 24 73 65 72 76 65 72 2c glob -- $server,
0b30: 24 61 72 67 20 7b 0a 09 20 20 20 20 30 2c 2d 61 $arg {.. 0,-a
0b40: 73 79 6e 63 09 7b 6c 61 70 70 65 6e 64 20 73 6f sync.{lappend so
0b50: 70 74 73 20 24 61 72 67 7d 0a 09 20 20 20 20 30 pts $arg}.. 0
0b60: 2c 2d 6d 79 70 6f 72 74 09 2d 0a 09 20 20 20 20 ,-myport.-..
0b70: 2a 2c 2d 6d 79 61 64 64 72 09 7b 6c 61 70 70 65 *,-myaddr.{lappe
0b80: 6e 64 20 73 6f 70 74 73 20 24 61 72 67 20 5b 6c nd sopts $arg [l
0b90: 69 6e 64 65 78 20 24 61 72 67 73 20 5b 69 6e 63 index $args [inc
0ba0: 72 20 69 64 78 5d 5d 7d 0a 09 20 20 20 20 2a 2c r idx]]}.. *,
0bb0: 2d 63 61 64 69 72 09 2d 0a 09 20 20 20 20 2a 2c -cadir.-.. *,
0bc0: 2d 63 61 66 69 6c 65 09 2d 0a 09 20 20 20 20 2a -cafile.-.. *
0bd0: 2c 2d 63 65 72 74 66 69 6c 65 09 2d 0a 09 20 20 ,-certfile.-..
0be0: 20 20 2a 2c 2d 63 69 70 68 65 72 09 2d 0a 09 20 *,-cipher.-..
0bf0: 20 20 20 2a 2c 2d 63 6f 6d 6d 61 6e 64 09 2d 0a *,-command.-.
0c00: 09 20 20 20 20 2a 2c 2d 6b 65 79 66 69 6c 65 09 . *,-keyfile.
0c10: 2d 0a 09 20 20 20 20 2a 2c 2d 70 61 73 73 77 6f -.. *,-passwo
0c20: 72 64 09 2d 0a 09 20 20 20 20 2a 2c 2d 72 65 71 rd.-.. *,-req
0c30: 75 65 73 74 09 2d 0a 09 20 20 20 20 2a 2c 2d 72 uest.-.. *,-r
0c40: 65 71 75 69 72 65 09 2d 0a 09 20 20 20 20 2a 2c equire.-.. *,
0c50: 2d 73 73 6c 32 09 2d 0a 09 20 20 20 20 2a 2c 2d -ssl2.-.. *,-
0c60: 73 73 6c 33 09 2d 0a 09 20 20 20 20 2a 2c 2d 74 ssl3.-.. *,-t
0c70: 6c 73 31 09 7b 6c 61 70 70 65 6e 64 20 69 6f 70 ls1.{lappend iop
0c80: 74 73 20 24 61 72 67 20 5b 6c 69 6e 64 65 78 20 ts $arg [lindex
0c90: 24 61 72 67 73 20 5b 69 6e 63 72 20 69 64 78 5d $args [incr idx]
0ca0: 5d 7d 0a 09 20 20 20 20 2d 2a 09 09 7b 72 65 74 ]}.. -*..{ret
0cb0: 75 72 6e 20 2d 63 6f 64 65 20 65 72 72 6f 72 20 urn -code error
0cc0: 22 62 61 64 20 6f 70 74 69 6f 6e 20 5c 22 24 61 "bad option \"$a
0cd0: 72 67 5c 22 3a 20 6d 75 73 74 20 62 65 20 6f 6e rg\": must be on
0ce0: 65 20 6f 66 20 24 6f 70 74 69 6f 6e 73 22 7d 0a e of $options"}.
0cf0: 09 20 20 20 20 64 65 66 61 75 6c 74 09 7b 62 72 . default.{br
0d00: 65 61 6b 7d 0a 09 7d 0a 20 20 20 20 7d 0a 20 20 eak}..}. }.
0d10: 20 20 69 66 20 7b 24 73 65 72 76 65 72 7d 20 7b if {$server} {
0d20: 0a 09 69 66 20 7b 28 24 69 64 78 20 2b 20 31 29 ..if {($idx + 1)
0d30: 20 21 3d 20 24 61 72 67 63 7d 20 7b 0a 09 20 20 != $argc} {..
0d40: 20 20 72 65 74 75 72 6e 20 2d 63 6f 64 65 20 65 return -code e
0d50: 72 72 6f 72 20 24 75 73 61 67 65 0a 09 7d 0a 09 rror $usage..}..
0d60: 73 65 74 20 75 69 64 20 5b 69 6e 63 72 20 3a 3a set uid [incr ::
0d70: 74 6c 73 3a 3a 73 72 76 75 69 64 5d 0a 0a 09 73 tls::srvuid]...s
0d80: 65 74 20 70 6f 72 74 20 5b 6c 69 6e 64 65 78 20 et port [lindex
0d90: 24 61 72 67 73 20 5b 65 78 70 72 20 7b 24 61 72 $args [expr {$ar
0da0: 67 63 2d 31 7d 5d 5d 0a 09 6c 61 70 70 65 6e 64 gc-1}]]..lappend
0db0: 20 73 6f 70 74 73 20 24 70 6f 72 74 0a 09 23 73 sopts $port..#s
0dc0: 65 74 20 73 6f 70 74 73 20 5b 6c 69 6e 73 65 72 et sopts [linser
0dd0: 74 20 24 73 6f 70 74 73 20 30 20 2d 73 65 72 76 t $sopts 0 -serv
0de0: 65 72 20 24 63 61 6c 6c 62 61 63 6b 5d 0a 09 73 er $callback]..s
0df0: 65 74 20 73 6f 70 74 73 20 5b 6c 69 6e 73 65 72 et sopts [linser
0e00: 74 20 24 73 6f 70 74 73 20 30 20 2d 73 65 72 76 t $sopts 0 -serv
0e10: 65 72 20 5b 6c 69 73 74 20 74 6c 73 3a 3a 5f 61 er [list tls::_a
0e20: 63 63 65 70 74 20 24 69 6f 70 74 73 20 24 63 61 ccept $iopts $ca
0e30: 6c 6c 62 61 63 6b 5d 5d 0a 09 23 73 65 74 20 73 llback]]..#set s
0e40: 6f 70 74 73 20 5b 6c 69 6e 73 65 72 74 20 24 73 opts [linsert $s
0e50: 6f 70 74 73 20 30 20 2d 73 65 72 76 65 72 20 5b opts 0 -server [
0e60: 6c 69 73 74 20 74 6c 73 3a 3a 5f 61 63 63 65 70 list tls::_accep
0e70: 74 20 24 75 69 64 20 24 63 61 6c 6c 62 61 63 6b t $uid $callback
0e80: 5d 5d 0a 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a ]]. } else {.
0e90: 09 69 66 20 7b 28 24 69 64 78 20 2b 20 32 29 20 .if {($idx + 2)
0ea0: 21 3d 20 24 61 72 67 63 7d 20 7b 0a 09 20 20 20 != $argc} {..
0eb0: 20 72 65 74 75 72 6e 20 2d 63 6f 64 65 20 65 72 return -code er
0ec0: 72 6f 72 20 24 75 73 61 67 65 0a 09 7d 0a 09 73 ror $usage..}..s
0ed0: 65 74 20 68 6f 73 74 20 5b 6c 69 6e 64 65 78 20 et host [lindex
0ee0: 24 61 72 67 73 20 5b 65 78 70 72 20 7b 24 61 72 $args [expr {$ar
0ef0: 67 63 2d 32 7d 5d 5d 0a 09 73 65 74 20 70 6f 72 gc-2}]]..set por
0f00: 74 20 5b 6c 69 6e 64 65 78 20 24 61 72 67 73 20 t [lindex $args
0f10: 5b 65 78 70 72 20 7b 24 61 72 67 63 2d 31 7d 5d [expr {$argc-1}]
0f20: 5d 0a 09 6c 61 70 70 65 6e 64 20 73 6f 70 74 73 ]..lappend sopts
0f30: 20 24 68 6f 73 74 20 24 70 6f 72 74 0a 20 20 20 $host $port.
0f40: 20 7d 0a 20 20 20 20 23 0a 20 20 20 20 23 20 43 }. #. # C
0f50: 72 65 61 74 65 20 54 43 50 2f 49 50 20 73 6f 63 reate TCP/IP soc
0f60: 6b 65 74 0a 20 20 20 20 23 0a 20 20 20 20 73 65 ket. #. se
0f70: 74 20 63 68 61 6e 20 5b 65 76 61 6c 20 24 73 6f t chan [eval $so
0f80: 63 6b 65 74 43 6d 64 20 24 73 6f 70 74 73 5d 0a cketCmd $sopts].
0f90: 20 20 20 20 69 66 20 7b 21 24 73 65 72 76 65 72 if {!$server
0fa0: 20 26 26 20 5b 63 61 74 63 68 20 7b 0a 09 23 0a && [catch {..#.
0fb0: 09 23 20 50 75 73 68 20 53 53 4c 20 6c 61 79 65 .# Push SSL laye
0fc0: 72 20 6f 6e 74 6f 20 73 6f 63 6b 65 74 0a 09 23 r onto socket..#
0fd0: 0a 09 65 76 61 6c 20 5b 6c 69 73 74 20 74 6c 73 ..eval [list tls
0fe0: 3a 3a 69 6d 70 6f 72 74 5d 20 24 63 68 61 6e 20 ::import] $chan
0ff0: 24 69 6f 70 74 73 0a 20 20 20 20 7d 20 65 72 72 $iopts. } err
1000: 5d 7d 20 7b 0a 09 73 65 74 20 69 6e 66 6f 20 24 ]} {..set info $
1010: 7b 3a 3a 65 72 72 6f 72 49 6e 66 6f 7d 0a 09 63 {::errorInfo}..c
1020: 61 74 63 68 20 7b 63 6c 6f 73 65 20 24 63 68 61 atch {close $cha
1030: 6e 7d 0a 09 72 65 74 75 72 6e 20 2d 63 6f 64 65 n}..return -code
1040: 20 65 72 72 6f 72 20 2d 65 72 72 6f 72 69 6e 66 error -errorinf
1050: 6f 20 24 69 6e 66 6f 20 24 65 72 72 0a 20 20 20 o $info $err.
1060: 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 24 63 }. return $c
1070: 68 61 6e 0a 7d 0a 0a 23 20 74 6c 73 3a 3a 5f 61 han.}..# tls::_a
1080: 63 63 65 70 74 20 2d 2d 0a 23 0a 23 20 20 20 54 ccept --.#.# T
1090: 68 69 73 20 69 73 20 74 68 65 20 61 63 74 75 61 his is the actua
10a0: 6c 20 61 63 63 65 70 74 20 74 68 61 74 20 54 4c l accept that TL
10b0: 53 20 73 6f 63 6b 65 74 73 20 75 73 65 2c 20 77 S sockets use, w
10c0: 68 69 63 68 20 74 68 65 6e 20 63 61 6c 6c 73 0a hich then calls.
10d0: 23 20 20 20 74 68 65 20 63 61 6c 6c 62 61 63 6b # the callback
10e0: 20 72 65 67 69 73 74 65 72 65 64 20 62 79 20 74 registered by t
10f0: 6c 73 3a 3a 73 6f 63 6b 65 74 2e 0a 23 0a 23 20 ls::socket..#.#
1100: 41 72 67 75 6d 65 6e 74 73 3a 0a 23 20 20 20 69 Arguments:.# i
1110: 6f 70 74 73 09 74 6c 73 3a 3a 69 6d 70 6f 72 74 opts.tls::import
1120: 20 6f 70 74 73 0a 23 20 20 20 63 61 6c 6c 62 61 opts.# callba
1130: 63 6b 09 73 65 72 76 65 72 20 63 61 6c 6c 62 61 ck.server callba
1140: 63 6b 20 74 6f 20 69 6e 76 6f 6b 65 0a 23 20 20 ck to invoke.#
1150: 20 63 68 61 6e 09 73 6f 63 6b 65 74 20 63 68 61 chan.socket cha
1160: 6e 6e 65 6c 20 74 6f 20 61 63 63 65 70 74 2f 64 nnel to accept/d
1170: 65 6e 79 0a 23 20 20 20 69 70 61 64 64 72 09 63 eny.# ipaddr.c
1180: 61 6c 6c 69 6e 67 20 49 50 20 61 64 64 72 65 73 alling IP addres
1190: 73 0a 23 20 20 20 70 6f 72 74 09 63 61 6c 6c 69 s.# port.calli
11a0: 6e 67 20 70 6f 72 74 0a 23 0a 23 20 52 65 73 75 ng port.#.# Resu
11b0: 6c 74 73 3a 0a 23 20 20 20 52 65 74 75 72 6e 73 lts:.# Returns
11c0: 20 61 6e 20 65 72 72 6f 72 20 69 66 20 74 68 65 an error if the
11d0: 20 63 61 6c 6c 62 61 63 6b 20 74 68 72 6f 77 73 callback throws
11e0: 20 6f 6e 65 2e 0a 23 0a 70 72 6f 63 20 74 6c 73 one..#.proc tls
11f0: 3a 3a 5f 61 63 63 65 70 74 20 7b 20 69 6f 70 74 ::_accept { iopt
1200: 73 20 63 61 6c 6c 62 61 63 6b 20 63 68 61 6e 20 s callback chan
1210: 69 70 61 64 64 72 20 70 6f 72 74 20 7d 20 7b 0a ipaddr port } {.
1220: 20 20 20 20 6c 6f 67 20 32 20 5b 6c 69 73 74 20 log 2 [list
1230: 74 6c 73 3a 3a 5f 61 63 63 65 70 74 20 24 69 6f tls::_accept $io
1240: 70 74 73 20 24 63 61 6c 6c 62 61 63 6b 20 24 63 pts $callback $c
1250: 68 61 6e 20 24 69 70 61 64 64 72 20 24 70 6f 72 han $ipaddr $por
1260: 74 5d 0a 0a 20 20 20 20 73 65 74 20 63 68 61 6e t].. set chan
1270: 20 5b 65 76 61 6c 20 5b 6c 69 73 74 20 74 6c 73 [eval [list tls
1280: 3a 3a 69 6d 70 6f 72 74 20 24 63 68 61 6e 5d 20 ::import $chan]
1290: 24 69 6f 70 74 73 5d 0a 0a 20 20 20 20 6c 61 70 $iopts].. lap
12a0: 70 65 6e 64 20 63 61 6c 6c 62 61 63 6b 20 24 63 pend callback $c
12b0: 68 61 6e 20 24 69 70 61 64 64 72 20 24 70 6f 72 han $ipaddr $por
12c0: 74 0a 20 20 20 20 69 66 20 7b 5b 63 61 74 63 68 t. if {[catch
12d0: 20 7b 0a 09 75 70 6c 65 76 65 6c 20 23 30 20 24 {..uplevel #0 $
12e0: 63 61 6c 6c 62 61 63 6b 0a 20 20 20 20 7d 20 65 callback. } e
12f0: 72 72 5d 7d 20 7b 0a 09 6c 6f 67 20 31 20 22 74 rr]} {..log 1 "t
1300: 6c 73 3a 3a 5f 61 63 63 65 70 74 20 65 72 72 6f ls::_accept erro
1310: 72 3a 20 24 7b 3a 3a 65 72 72 6f 72 49 6e 66 6f r: ${::errorInfo
1320: 7d 22 0a 09 63 6c 6f 73 65 20 24 63 68 61 6e 0a }"..close $chan.
1330: 09 65 72 72 6f 72 20 24 65 72 72 20 24 3a 3a 65 .error $err $::e
1340: 72 72 6f 72 49 6e 66 6f 20 24 3a 3a 65 72 72 6f rrorInfo $::erro
1350: 72 43 6f 64 65 0a 20 20 20 20 7d 20 65 6c 73 65 rCode. } else
1360: 20 7b 0a 09 6c 6f 67 20 32 20 22 74 6c 73 3a 3a {..log 2 "tls::
1370: 5f 61 63 63 65 70 74 20 2d 20 63 61 6c 6c 65 64 _accept - called
1380: 20 5c 22 24 63 61 6c 6c 62 61 63 6b 5c 22 20 73 \"$callback\" s
1390: 75 63 63 65 65 64 65 64 22 0a 20 20 20 20 7d 0a ucceeded". }.
13a0: 7d 0a 23 0a 23 20 53 61 6d 70 6c 65 20 63 61 6c }.#.# Sample cal
13b0: 6c 62 61 63 6b 20 66 6f 72 20 68 6f 6f 6b 69 6e lback for hookin
13c0: 67 3a 20 2d 0a 23 0a 23 20 65 72 72 6f 72 0a 23 g: -.#.# error.#
13d0: 20 76 65 72 69 66 79 0a 23 20 69 6e 66 6f 0a 23 verify.# info.#
13e0: 0a 70 72 6f 63 20 74 6c 73 3a 3a 63 61 6c 6c 62 .proc tls::callb
13f0: 61 63 6b 20 7b 6f 70 74 69 6f 6e 20 61 72 67 73 ack {option args
1400: 7d 20 7b 0a 20 20 20 20 76 61 72 69 61 62 6c 65 } {. variable
1410: 20 64 65 62 75 67 0a 0a 20 20 20 20 23 6c 6f 67 debug.. #log
1420: 20 32 20 5b 63 6f 6e 63 61 74 20 24 6f 70 74 69 2 [concat $opti
1430: 6f 6e 20 24 61 72 67 73 5d 0a 0a 20 20 20 20 73 on $args].. s
1440: 77 69 74 63 68 20 2d 2d 20 24 6f 70 74 69 6f 6e witch -- $option
1450: 20 7b 0a 09 22 65 72 72 6f 72 22 09 7b 0a 09 20 {.."error".{..
1460: 20 20 20 66 6f 72 65 61 63 68 20 7b 63 68 61 6e foreach {chan
1470: 20 6d 73 67 7d 20 24 61 72 67 73 20 62 72 65 61 msg} $args brea
1480: 6b 0a 0a 09 20 20 20 20 6c 6f 67 20 30 20 22 54 k... log 0 "T
1490: 4c 53 2f 24 63 68 61 6e 3a 20 65 72 72 6f 72 3a LS/$chan: error:
14a0: 20 24 6d 73 67 22 0a 09 7d 0a 09 22 76 65 72 69 $msg"..}.."veri
14b0: 66 79 22 09 7b 0a 09 20 20 20 20 23 20 70 6f 6f fy".{.. # poo
14c0: 72 20 6d 61 6e 27 73 20 6c 61 73 73 69 67 6e 0a r man's lassign.
14d0: 09 20 20 20 20 66 6f 72 65 61 63 68 20 7b 63 68 . foreach {ch
14e0: 61 6e 20 64 65 70 74 68 20 63 65 72 74 20 72 63 an depth cert rc
14f0: 20 65 72 72 7d 20 24 61 72 67 73 20 62 72 65 61 err} $args brea
1500: 6b 0a 0a 09 20 20 20 20 61 72 72 61 79 20 73 65 k... array se
1510: 74 20 63 20 24 63 65 72 74 0a 0a 09 20 20 20 20 t c $cert...
1520: 69 66 20 7b 24 72 63 20 21 3d 20 22 31 22 7d 20 if {$rc != "1"}
1530: 7b 0a 09 09 6c 6f 67 20 31 20 22 54 4c 53 2f 24 {...log 1 "TLS/$
1540: 63 68 61 6e 3a 20 76 65 72 69 66 79 2f 24 64 65 chan: verify/$de
1550: 70 74 68 3a 20 42 61 64 20 43 65 72 74 3a 20 24 pth: Bad Cert: $
1560: 65 72 72 20 28 72 63 20 3d 20 24 72 63 29 22 0a err (rc = $rc)".
1570: 09 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 09 09 . } else {...
1580: 6c 6f 67 20 32 20 22 54 4c 53 2f 24 63 68 61 6e log 2 "TLS/$chan
1590: 3a 20 76 65 72 69 66 79 2f 24 64 65 70 74 68 3a : verify/$depth:
15a0: 20 24 63 28 73 75 62 6a 65 63 74 29 22 0a 09 20 $c(subject)"..
15b0: 20 20 20 7d 0a 09 20 20 20 20 69 66 20 7b 24 64 }.. if {$d
15c0: 65 62 75 67 20 3e 20 30 7d 20 7b 0a 09 09 72 65 ebug > 0} {...re
15d0: 74 75 72 6e 20 31 3b 09 23 20 46 4f 52 43 45 20 turn 1;.# FORCE
15e0: 4f 4b 0a 09 20 20 20 20 7d 20 65 6c 73 65 20 7b OK.. } else {
15f0: 0a 09 09 72 65 74 75 72 6e 20 24 72 63 0a 09 20 ...return $rc..
1600: 20 20 20 7d 0a 09 7d 0a 09 22 69 6e 66 6f 22 09 }..}.."info".
1610: 7b 0a 09 20 20 20 20 23 20 70 6f 6f 72 20 6d 61 {.. # poor ma
1620: 6e 27 73 20 6c 61 73 73 69 67 6e 0a 09 20 20 20 n's lassign..
1630: 20 66 6f 72 65 61 63 68 20 7b 63 68 61 6e 20 6d foreach {chan m
1640: 61 6a 6f 72 20 6d 69 6e 6f 72 20 73 74 61 74 65 ajor minor state
1650: 20 6d 73 67 7d 20 24 61 72 67 73 20 62 72 65 61 msg} $args brea
1660: 6b 0a 0a 09 20 20 20 20 69 66 20 7b 24 6d 73 67 k... if {$msg
1670: 20 21 3d 20 22 22 7d 20 7b 0a 09 09 61 70 70 65 != ""} {...appe
1680: 6e 64 20 73 74 61 74 65 20 22 3a 20 24 6d 73 67 nd state ": $msg
1690: 22 0a 09 20 20 20 20 7d 0a 09 20 20 20 20 23 20 ".. }.. #
16a0: 46 6f 72 20 74 72 61 63 69 6e 67 0a 09 20 20 20 For tracing..
16b0: 20 75 70 76 61 72 20 23 30 20 74 6c 73 3a 3a 24 upvar #0 tls::$
16c0: 63 68 61 6e 20 63 62 0a 09 20 20 20 20 73 65 74 chan cb.. set
16d0: 20 63 62 28 24 6d 61 6a 6f 72 29 20 24 6d 69 6e cb($major) $min
16e0: 6f 72 0a 0a 09 20 20 20 20 6c 6f 67 20 32 20 22 or... log 2 "
16f0: 54 4c 53 2f 24 63 68 61 6e 3a 20 24 6d 61 6a 6f TLS/$chan: $majo
1700: 72 2f 24 6d 69 6e 6f 72 3a 20 24 73 74 61 74 65 r/$minor: $state
1710: 22 0a 09 7d 0a 09 64 65 66 61 75 6c 74 09 7b 0a "..}..default.{.
1720: 09 20 20 20 20 72 65 74 75 72 6e 20 2d 63 6f 64 . return -cod
1730: 65 20 65 72 72 6f 72 20 22 62 61 64 20 6f 70 74 e error "bad opt
1740: 69 6f 6e 20 5c 22 24 6f 70 74 69 6f 6e 5c 22 3a ion \"$option\":
1750: 5c 0a 09 09 20 20 20 20 6d 75 73 74 20 62 65 20 \... must be
1760: 6f 6e 65 20 6f 66 20 65 72 72 6f 72 2c 20 69 6e one of error, in
1770: 66 6f 2c 20 6f 72 20 76 65 72 69 66 79 22 0a 09 fo, or verify"..
1780: 7d 0a 20 20 20 20 7d 0a 7d 0a 0a 70 72 6f 63 20 }. }.}..proc
1790: 74 6c 73 3a 3a 78 68 61 6e 64 73 68 61 6b 65 20 tls::xhandshake
17a0: 7b 63 68 61 6e 7d 20 7b 0a 20 20 20 20 75 70 76 {chan} {. upv
17b0: 61 72 20 23 30 20 74 6c 73 3a 3a 24 63 68 61 6e ar #0 tls::$chan
17c0: 20 63 62 0a 0a 20 20 20 20 69 66 20 7b 5b 69 6e cb.. if {[in
17d0: 66 6f 20 65 78 69 73 74 73 20 63 62 28 68 61 6e fo exists cb(han
17e0: 64 73 68 61 6b 65 29 5d 20 26 26 20 5c 0a 09 24 dshake)] && \..$
17f0: 63 62 28 68 61 6e 64 73 68 61 6b 65 29 20 3d 3d cb(handshake) ==
1800: 20 22 64 6f 6e 65 22 7d 20 7b 0a 09 72 65 74 75 "done"} {..retu
1810: 72 6e 20 31 0a 20 20 20 20 7d 0a 20 20 20 20 77 rn 1. }. w
1820: 68 69 6c 65 20 7b 31 7d 20 7b 0a 09 76 77 61 69 hile {1} {..vwai
1830: 74 20 74 6c 73 3a 3a 24 7b 63 68 61 6e 7d 28 68 t tls::${chan}(h
1840: 61 6e 64 73 68 61 6b 65 29 0a 09 69 66 20 7b 21 andshake)..if {!
1850: 5b 69 6e 66 6f 20 65 78 69 73 74 73 20 63 62 28 [info exists cb(
1860: 68 61 6e 64 73 68 61 6b 65 29 5d 7d 20 7b 0a 09 handshake)]} {..
1870: 20 20 20 20 72 65 74 75 72 6e 20 30 0a 09 7d 0a return 0..}.
1880: 09 69 66 20 7b 24 63 62 28 68 61 6e 64 73 68 61 .if {$cb(handsha
1890: 6b 65 29 20 3d 3d 20 22 64 6f 6e 65 22 7d 20 7b ke) == "done"} {
18a0: 0a 09 20 20 20 20 72 65 74 75 72 6e 20 31 0a 09 .. return 1..
18b0: 7d 0a 20 20 20 20 7d 0a 7d 0a 0a 70 72 6f 63 20 }. }.}..proc
18c0: 74 6c 73 3a 3a 70 61 73 73 77 6f 72 64 20 7b 7d tls::password {}
18d0: 20 7b 0a 20 20 20 20 6c 6f 67 20 30 20 22 54 4c {. log 0 "TL
18e0: 53 2f 50 61 73 73 77 6f 72 64 3a 20 64 69 64 20 S/Password: did
18f0: 79 6f 75 20 66 6f 72 67 65 74 20 74 6f 20 73 65 you forget to se
1900: 74 20 79 6f 75 72 20 70 61 73 73 77 64 21 22 0a t your passwd!".
1910: 20 20 20 20 23 20 52 65 74 75 72 6e 20 74 68 65 # Return the
1920: 20 77 6f 72 6c 64 73 20 62 65 73 74 20 6b 65 70 worlds best kep
1930: 74 20 73 65 63 72 65 74 20 70 61 73 73 77 6f 72 t secret passwor
1940: 64 2e 0a 20 20 20 20 72 65 74 75 72 6e 20 22 73 d.. return "s
1950: 65 63 72 65 74 22 0a 7d 0a 0a 70 72 6f 63 20 74 ecret".}..proc t
1960: 6c 73 3a 3a 6c 6f 67 20 7b 6c 65 76 65 6c 20 6d ls::log {level m
1970: 73 67 7d 20 7b 0a 20 20 20 20 76 61 72 69 61 62 sg} {. variab
1980: 6c 65 20 64 65 62 75 67 0a 20 20 20 20 76 61 72 le debug. var
1990: 69 61 62 6c 65 20 6c 6f 67 63 6d 64 0a 0a 20 20 iable logcmd..
19a0: 20 20 69 66 20 7b 24 6c 65 76 65 6c 20 3e 20 24 if {$level > $
19b0: 64 65 62 75 67 20 7c 7c 20 24 6c 6f 67 63 6d 64 debug || $logcmd
19c0: 20 3d 3d 20 22 22 7d 20 7b 0a 09 72 65 74 75 72 == ""} {..retur
19d0: 6e 0a 20 20 20 20 7d 0a 20 20 20 20 73 65 74 20 n. }. set
19e0: 63 6d 64 20 24 6c 6f 67 63 6d 64 0a 20 20 20 20 cmd $logcmd.
19f0: 6c 61 70 70 65 6e 64 20 63 6d 64 20 24 6d 73 67 lappend cmd $msg
1a00: 0a 20 20 20 20 75 70 6c 65 76 65 6c 20 23 30 20 . uplevel #0
1a10: 24 63 6d 64 0a 7d 0a 0a $cmd.}..