%!PS-Adobe-2.0 %%Creator: dvips(k) 5.95a Copyright 2005 Radical Eye Software %%Title: sockets.dvi %%Pages: 35 %%PageOrder: Ascend %%BoundingBox: 0 0 596 842 %%EndComments %DVIPSWebPage: (www.radicaleye.com) %DVIPSCommandLine: dvips sockets -o sockets.ps %DVIPSParameters: dpi=600, compressed %DVIPSSource: TeX output 2005.08.23:0903 %%BeginProcSet: texc.pro 0 0 %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S N}B/A{dup}B/TR{translate}N/isls false N/vsize 11 72 mul N/hsize 8.5 72 mul N/landplus90{false}def/@rigin{isls{[0 landplus90{1 -1}{-1 1}ifelse 0 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{ landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize mul 0}ifelse TR}if Resolution VResolution vsize -72 div 1 add mul TR[ matrix currentmatrix{A A round sub abs 0.00001 lt{round}if}forall round exch round exch]setmatrix}N/@landscape{/isls true N}B/@manualfeed{ statusdict/manualfeed true put}B/@copies{/#copies X}B/FMat[1 0 0 -1 0 0] N/FBB[0 0 0 0]N/nn 0 N/IEn 0 N/ctr 0 N/df-tail{/nn 8 dict N nn begin /FontType 3 N/FontMatrix fntrx N/FontBBox FBB N string/base X array /BitMaps X/BuildChar{CharBuilder}N/Encoding IEn N end A{/foo setfont}2 array copy cvx N load 0 nn put/ctr 0 N[}B/sf 0 N/df{/sf 1 N/fntrx FMat N df-tail}B/dfs{div/sf X/fntrx[sf 0 0 sf neg 0 0]N df-tail}B/E{pop nn A definefont setfont}B/Cw{Cd A length 5 sub get}B/Ch{Cd A length 4 sub get }B/Cx{128 Cd A length 3 sub get sub}B/Cy{Cd A length 2 sub get 127 sub} B/Cdx{Cd A length 1 sub get}B/Ci{Cd A type/stringtype ne{ctr get/ctr ctr 1 add N}if}B/id 0 N/rw 0 N/rc 0 N/gp 0 N/cp 0 N/G 0 N/CharBuilder{save 3 1 roll S A/base get 2 index get S/BitMaps get S get/Cd X pop/ctr 0 N Cdx 0 Cx Cy Ch sub Cx Cw add Cy setcachedevice Cw Ch true[1 0 0 -1 -.1 Cx sub Cy .1 sub]/id Ci N/rw Cw 7 add 8 idiv string N/rc 0 N/gp 0 N/cp 0 N{ rc 0 ne{rc 1 sub/rc X rw}{G}ifelse}imagemask restore}B/G{{id gp get/gp gp 1 add N A 18 mod S 18 idiv pl S get exec}loop}B/adv{cp add/cp X}B /chg{rw cp id gp 4 index getinterval putinterval A gp add/gp X adv}B/nd{ /cp 0 N rw exit}B/lsh{rw cp 2 copy get A 0 eq{pop 1}{A 255 eq{pop 254}{ A A add 255 and S 1 and or}ifelse}ifelse put 1 adv}B/rsh{rw cp 2 copy get A 0 eq{pop 128}{A 255 eq{pop 127}{A 2 idiv S 128 and or}ifelse} ifelse put 1 adv}B/clr{rw cp 2 index string putinterval adv}B/set{rw cp fillstr 0 4 index getinterval putinterval adv}B/fillstr 18 string 0 1 17 {2 copy 255 put pop}for N/pl[{adv 1 chg}{adv 1 chg nd}{1 add chg}{1 add chg nd}{adv lsh}{adv lsh nd}{adv rsh}{adv rsh nd}{1 add adv}{/rc X nd}{ 1 add set}{1 add clr}{adv 2 chg}{adv 2 chg nd}{pop nd}]A{bind pop} forall N/D{/cc X A type/stringtype ne{]}if nn/base get cc ctr put nn /BitMaps get S ctr S sf 1 ne{A A length 1 sub A 2 index S get sf div put }if put/ctr ctr 1 add N}B/I{cc 1 add D}B/bop{userdict/bop-hook known{ bop-hook}if/SI save N @rigin 0 0 moveto/V matrix currentmatrix A 1 get A mul exch 0 get A mul add .99 lt{/QV}{/RV}ifelse load def pop pop}N/eop{ SI restore userdict/eop-hook known{eop-hook}if showpage}N/@start{ userdict/start-hook known{start-hook}if pop/VResolution X/Resolution X 1000 div/DVImag X/IEn 256 array N 2 string 0 1 255{IEn S A 360 add 36 4 index cvrs cvn put}for pop 65781.76 div/vsize X 65781.76 div/hsize X}N /p{show}N/RMat[1 0 0 -1 0 0]N/BDot 260 string N/Rx 0 N/Ry 0 N/V{}B/RV/v{ /Ry X/Rx X V}B statusdict begin/product where{pop false[(Display)(NeXT) (LaserWriter 16/600)]{A length product length le{A length product exch 0 exch getinterval eq{pop true exit}if}{pop}ifelse}forall}{false}ifelse end{{gsave TR -.1 .1 TR 1 1 scale Rx Ry false RMat{BDot}imagemask grestore}}{{gsave TR -.1 .1 TR Rx Ry scale 1 1 false RMat{BDot} imagemask grestore}}ifelse B/QV{gsave newpath transform round exch round exch itransform moveto Rx 0 rlineto 0 Ry neg rlineto Rx neg 0 rlineto fill grestore}B/a{moveto}B/delta 0 N/tail{A/delta X 0 rmoveto}B/M{S p delta add tail}B/b{S p tail}B/c{-4 M}B/d{-3 M}B/e{-2 M}B/f{-1 M}B/g{0 M} B/h{1 M}B/i{2 M}B/j{3 M}B/k{4 M}B/w{0 rmoveto}B/l{p -4 w}B/m{p -3 w}B/n{ p -2 w}B/o{p -1 w}B/q{p 1 w}B/r{p 2 w}B/s{p 3 w}B/t{p 4 w}B/x{0 S rmoveto}B/y{3 2 roll p a}B/bos{/SS save N}B/eos{SS restore}B end %%EndProcSet TeXDict begin 39158280 55380996 1000 600 600 (sockets.dvi) @start %DVIPSBitmapFont: Fa cmss12 12 34 /Fa 34 123 df<14F0497EA2805CA50018EC0180007CEC03E000FFEC0FF00181131F01C1 133F01F113FF267FF9F913E0001FB612800007ECFE00000114F86C5C013F13C0010F90C7 FCA2013F13C090B512F04880000714FE001FECFF80267FF9F913E026FFF1F813F001C113 3F0181131F0101130F007CEC03E00018EC0180000091C7FCA5805CA26D5A242C7ACA31> 42 D<12FFA8080877871B>46 D67 D72 D76 DII 80 D82 DI85 D87 D97 DIIII103 DII107 D<12FFB3B3B3AF084579C4 17>IIIII< 141F00FE13FF13035B131F5B5BEBFFF0148038FFFE005B5B5B5B5BA25BA390C7FCB3A818 2D79AC21>114 DIII119 DI< B415FFA27F007FEC01FE7F123FED03FC7F001FEC07F87F120FED0FF07F12076DEB1FE012 0316C06C6C133FA216806C6C137FA26D14006E5A5D133F14C1011F5BA2ECE1F8EB0FE3A2 01075B14F3A2903803F7E0A201015BA2EB00FF5DA2147F92C7FCA2147E14FEA25C1301A2 5C13035C13075CEA400F38781FC0EA7FFF5C91C8FC5B5BEA0FF028407EAB2D>I<007FB6 12E0A516C0C8138016005C4A5A4A5AA24A5A4A5A4A5AA24A5A4A5A92C7FC5B495A495AA2 495A495A5C133F495A495AA24890C8FC485A485AA2485A485A5B123F48B612E0B7FCA523 2C7DAB2A>I E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fb cmtt12 14.4 6 /Fb 6 117 df<383FFF805AB57EA37E7EEA003FAEED07FC92383FFF8092B512E002C314 F802CF8002DF8091B7FCDBF80F1380DBC00113C092C713E04A143F4AEC1FF04A15F84A14 0F4AEC07FCA217034A15FE1701A318FF83A95F18FEA280170318FC6E140718F86E140FEF 1FF06E143F6EEC7FE06EECFFC0DBC0031380EDF01F92B6120002DF14FC02CF5C02C35CD9 1F8114C090260F807F90C7FC90C7EA0FF8384A7FC83E>98 D<923803FFF85D4B7FA38181 ED0003AEEC1FF0ECFFFE0103EBFF83010F14E34914F3017F14FB90B7FC48EBF80F48EBC0 0191C7FC4848143F4848141F5B4848140F491407123F491403127F5BA312FF90C8FCA97F 127FA216077F123F6D140FA26C6C141F6D143F000F157F6C6C14FF01FF5B6C6D5A6CD9F0 1FEBFFFC6C90B500FB13FE6D02F313FF6D14E3010F14C36D020113FE010101FC14FC9026 003FE0C8FC384A7CC83E>100 D103 D107 D<903901FFF00F011F9038FE1F8090B612BF000315FF5A5A5A393FFE003F01F013 07D87FC0130190C8FC5A48157FA47EEE3F00D87FC091C7FC13F0EA3FFE381FFFF06CEBFF C06C14FE6C6E7EC615E0013F14F8010780D9003F7F02007F03071380030013C0003EED3F E0007F151F48150F17F06D1407A37FA26D140F6D15E0161F01FCEC3FC06D14FF9026FFC0 0F138091B612005E485D013F5C6D14E0D8FC0714802778007FF8C7FC2C3677B43E>115 D<147C14FC497EAD003FB712FC5AB87EA36C5EA2260001FEC9FCB3A6173FA2EF7F80A76E 14FF6D16006F5A9238C007FE91387FF01F92B55A6E5C6E5C6E5C6E1480020149C7FC9138 003FF031437DC13E>I E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fc cmbx12 14.4 43 /Fc 43 122 df<151E153E157E15FCEC01F8EC07F0EC0FE0EC1FC01580143FEC7F0014FE 1301495A5C1307495AA2495A133F5C137FA2495AA24890C7FCA25A5BA21207A2485AA312 1F5BA3123FA25BA3127FA55B12FFB3A3127F7FA5123FA37FA2121FA37F120FA36C7EA212 03A27F7EA26C7FA26D7EA2133F80131F6D7EA26D7E1303806D7E1300147FEC3F80141F15 C0EC0FE0EC07F0EC01F8EC00FC157E153E151E1F7973D934>40 D<127012F8127C127E7E EA1FC06C7E6C7E12037F6C7E6C7E7F6D7E133F806D7EA26D7E80130780A26D7EA26D7EA2 15807FA215C0A2EC7FE0A315F0143FA315F8A2141FA315FCA5140F15FEB3A315FC141FA5 15F8A3143FA215F0A3147F15E0A3ECFFC0A21580A25B1500A2495AA2495AA25C130F5C49 5AA2495A5C137F49C7FC5B485A485A5B1207485A485A48C8FC127E127C5A12701F7979D9 34>I45 DI<157815FC14031407141F14FF130F0007B5FCB6FCA2147F13 F0EAF800C7FCB3B3B3A6007FB712FEA52F4E76CD43>49 DI<91380FFFC091B512FC0107ECFF80011F15E090263FF8077F9026FF800113FC4848 C76C7ED803F86E7E491680D807FC8048B416C080486D15E0A4805CA36C17C06C5B6C90C7 5AD801FC1680C9FC4C13005FA24C5A4B5B4B5B4B13C04B5BDBFFFEC7FC91B512F816E016 FCEEFF80DA000713E0030113F89238007FFE707E7013807013C018E07013F0A218F8A270 13FCA218FEA2EA03E0EA0FF8487E487E487EB57EA318FCA25E18F891C7FC6C17F0495C6C 4816E001F04A13C06C484A1380D80FF84A13006CB44A5A6CD9F0075BC690B612F06D5D01 1F1580010302FCC7FCD9001F1380374F7ACD43>I<177C17FEA2160116031607160FA216 1F163F167FA216FF5D5DA25D5DED1FBFED3F3F153E157C15FCEC01F815F0EC03E01407EC 0FC01580EC1F005C147E147C5C1301495A495A5C495A131F49C7FC133E5B13FC485A5B48 5A1207485A485A90C8FC123E127E5ABA12C0A5C96C48C7FCAF020FB712C0A53A4F7CCE43 >III<91380FFF8091B512F8010314FE010F6E7E49 01037F90267FF8007F4948EB3FF048496D7E484980486F7E484980824817805A91C714C0 5A7013E0A218F0B5FCA318F8A618FCA46C5DA37EA25E6C7F6C5DA26C5D6C7F6C6D137B6C 6D13F390387FF803011FB512E36D14C30103028313F89039007FFE03EC00401500A218F0 5EA3D801F816E0487E486C16C0487E486D491380A218005E5F4C5A91C7FC6C484A5A494A 5A49495B6C48495BD803FC010F5B9027FF807FFEC7FC6C90B55A6C6C14F06D14C0010F49 C8FC010013F0364F7ACD43>57 D68 D<932601FFFCEC01C0047FD9FFC013030307B600F81307033F03FE13 1F92B8EA803F0203DAE003EBC07F020F01FCC7383FF0FF023F01E0EC0FF94A01800203B5 FC494848C9FC4901F8824949824949824949824949824990CA7E494883A2484983485B1B 7F485B481A3FA24849181FA3485B1B0FA25AA298C8FC5CA2B5FCAE6C057FB712E0A280A3 6C94C7003FEBC000A36C7FA36C7FA27E6C7FA26C7F6C7FA26D7E6D7F6D7F6D6D5E6D7F6D 01FC93B5FC6D13FF6D6C6D5C6E01F0EC07FB020F01FEEC1FF10203903AFFF001FFE00200 91B6EAC07F033FEE001F030703FC1307DB007F02E01301040149CAFC5B5479D26A>71 DI77 D<93380FFFC00303B6FC031F15E092B712FC0203D9FC0013FF020F01C0010F13C0023F90 C7000313F0DA7FFC02007F494848ED7FFE4901E0ED1FFF49496F7F49496F7F4990C96C7F 49854948707F4948707FA24849717E48864A83481B804A83481BC0A2481BE04A83A2481B F0A348497113F8A5B51AFCAF6C1BF86E5FA46C1BF0A26E5F6C1BE0A36C6D4D13C0A26C6D 4D1380A26C1B006C6D4D5A6E5E6C626D6C4C5B6D6D4B5B6D6D4B5B6D6D4B5B6D6D4B5B6D 6D4B90C7FC6D6D4B5A6D01FF02035B023F01E0011F13F0020F01FC90B512C0020390B7C8 FC020016FC031F15E0030392C9FCDB001F13E0565479D265>79 DI82 D<91260FFF80130791B500F85B010702FF5B011FEDC0 3F49EDF07F9026FFFC006D5A4801E0EB0FFD4801800101B5FC4848C87E48488149150F00 1F824981123F4981007F82A28412FF84A27FA26D82A27F7F6D93C7FC14C06C13F014FF15 F86CECFF8016FC6CEDFFC017F06C16FC6C16FF6C17C06C836C836D826D82010F82130301 0082021F16801400030F15C0ED007F040714E01600173F050F13F08383A200788200F882 A3187FA27EA219E07EA26CEFFFC0A27F6D4B13806D17006D5D01FC4B5A01FF4B5A02C04A 5A02F8EC7FF0903B1FFFC003FFE0486C90B65AD8FC0393C7FC48C66C14FC48010F14F048 D9007F90C8FC3C5479D24B>I<003FBC1280A59126C0003F9038C0007F49C71607D87FF8 060113C001E08449197F49193F90C8171FA2007E1A0FA3007C1A07A500FC1BE0481A03A6 C994C7FCB3B3AC91B912F0A553517BD05E>IIII97 D<913801FFF8021FEBFF 8091B612F0010315FC010F9038C00FFE903A1FFE0001FFD97FFC491380D9FFF05B4817C0 48495B5C5A485BA2486F138091C7FC486F1300705A4892C8FC5BA312FFAD127F7FA27EA2 EF03E06C7F17076C6D15C07E6E140F6CEE1F806C6DEC3F006C6D147ED97FFE5C6D6CEB03 F8010F9038E01FF0010390B55A01001580023F49C7FC020113E033387CB63C>99 D<4DB47E0407B5FCA5EE001F1707B3A4913801FFE0021F13FC91B6FC010315C7010F9038 E03FE74990380007F7D97FFC0101B5FC49487F4849143F484980485B83485B5A91C8FC5A A3485AA412FFAC127FA36C7EA37EA26C7F5F6C6D5C7E6C6D5C6C6D49B5FC6D6C4914E0D9 3FFED90FEFEBFF80903A0FFFC07FCF6D90B5128F0101ECFE0FD9003F13F8020301C049C7 FC41547CD24B>I<913803FFC0023F13FC49B6FC010715C04901817F903A3FFC007FF849 486D7E49486D7E4849130F48496D7E48178048497F18C0488191C7FC4817E0A248815B18 F0A212FFA490B8FCA318E049CAFCA6127FA27F7EA218E06CEE01F06E14037E6C6DEC07E0 A26C6DEC0FC06C6D141F6C6DEC3F806D6CECFF00D91FFEEB03FE903A0FFFC03FF8010390 B55A010015C0021F49C7FC020113F034387CB63D>II< DA3FFF14FF0103B5D8F00713C0010FDAFC1F13E0013FECFF7F90267FFC0F9038FF9FF090 26FFE001EBF83F48496C13E0484990387FF01F4890C7D83FF813E0489338FC0FC0F00780 48486E6CC7FCA2003F82A9001F5EA26C6C4A5AA26C5E6C6D495A6C6D495A6C6D485BDAFC 0F5B4890B6C8FCD803EF14FC01C314F02607C03F90C9FC91CBFCA2120FA37FA213F813FE 90B7FC6C16F817FF18C06C836C836C836D828448B9FC12074848C700031480D81FF8EC00 3F4848150748486F13C083485A83A56D5D007F18806D5D003F18006C6C4B5AD80FFEED1F FC6C6C6CEC7FF86C01E049485A6C01FE011F5B6C6CB71280010F03FCC7FC010115E0D900 0F01FCC8FC3C4F7CB543>II<137F497E000313E0487FA2487FA7 6C5BA26C5BC613806DC7FC90C8FCADEB3FF0B5FCA512017EB3B3A6B612E0A51B547BD325 >I108 DII<913801FFE0021F13FE91B612C0010315F0010F9038 807FFC903A1FFC000FFED97FF86D6C7E49486D7F48496D7F48496D7F4A147F48834890C8 6C7EA24883A248486F7EA3007F1880A400FF18C0AC007F1880A3003F18006D5DA26C5FA2 6C5F6E147F6C5F6C6D4A5A6C6D495B6C6D495B6D6C495BD93FFE011F90C7FC903A0FFF80 7FFC6D90B55A010015C0023F91C8FC020113E03A387CB643>I<903A3FF001FFE0B5010F 13FE033FEBFFC092B612F002F301017F913AF7F8007FFE0003D9FFE0EB1FFFC602806D7F 92C76C7F4A824A6E7F4A6E7FA2717FA285187F85A4721380AC1A0060A36118FFA2615F61 6E4A5BA26E4A5B6E4A5B6F495B6F4990C7FC03F0EBFFFC9126FBFE075B02F8B612E06F14 80031F01FCC8FC030313C092CBFCB1B612F8A5414D7BB54B>I<90397FE003FEB590380F FF80033F13E04B13F09238FE1FF89139E1F83FFC0003D9E3E013FEC6ECC07FECE78014EF 150014EE02FEEB3FFC5CEE1FF8EE0FF04A90C7FCA55CB3AAB612FCA52F367CB537>114 D<903903FFF00F013FEBFE1F90B7FC120348EB003FD80FF81307D81FE0130148487F4980 127F90C87EA24881A27FA27F01F091C7FC13FCEBFFC06C13FF15F86C14FF16C06C15F06C 816C816C81C681013F1580010F15C01300020714E0EC003F030713F015010078EC007F00 F8153F161F7E160FA27E17E07E6D141F17C07F6DEC3F8001F8EC7F0001FEEB01FE9039FF C00FFC6DB55AD8FC1F14E0D8F807148048C601F8C7FC2C387CB635>I<143EA6147EA414 FEA21301A313031307A2130F131F133F13FF5A000F90B6FCB8FCA426003FFEC8FCB3A9EE 07C0AB011FEC0F8080A26DEC1F0015806DEBC03E6DEBF0FC6DEBFFF86D6C5B021F5B0203 13802A4D7ECB34>II119 D<007FB500F090387FFFFEA5C66C48C7000F90C7FC6D6CEC07 F86D6D5C6D6D495A6D4B5A6F495A6D6D91C8FC6D6D137E6D6D5B91387FFE014C5A6E6C48 5A6EEB8FE06EEBCFC06EEBFF806E91C9FCA26E5B6E5B6F7E6F7EA26F7F834B7F4B7F92B5 FCDA01FD7F03F87F4A486C7E4A486C7E020F7FDA1FC0804A486C7F4A486C7F02FE6D7F4A 6D7F495A49486D7F01076F7E49486E7E49486E7FEBFFF0B500FE49B612C0A542357EB447 >II E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fd cmmi12 12 1 /Fd 1 60 df<121EEA7F8012FF13C0A213E0A3127FEA1E601200A413E013C0A312011380 120313005A1206120E5A5A5A12600B1D78891B>59 D E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fe cmti12 12 52 /Fe 52 122 df<4CB414FC040F9039C003FF80933B3F81F00783C0933B7C00781F01E04C 9038F83F03923C01F001FC3E07F003030103EB7E0F922607E007EB7C1F19FCDB0FC001F8 14E0943A03F0F80FC0DD01E1EB0780031FD9000190C7FC5E180361153F93C7FCA2180761 5D157EA2180F6115FE91B912F0A3DA00FCC7D81F80C7FC1401A25D183F96C8FCA214035D A260187E14075DA218FE60140F5DA2170160141F5DA2170360143F92C7FCA21707605C14 7EA2170F6014FE5CA24D5AA2495A95C9FC5F5C0103153E177E001CEBE038007F02FE137C 26FF07E114FC02C15C4C5AEB0F8100FE903901FC03E0D8F81F9038F007C03B701E00E00F 80D8783CD9F83ECAFCD81FF0EB3FF8D807C0EB0FE04C5A83C53C>11 DI I<01F013783903F801FC3907FC03FE000F1307A63903CC01E639001C000E0118130CA201 38131C01301318A201701338491370491360000114E04913C0000313013907000380000E EB070048130E485B485B485B4813601F1D6FC432>34 D<167016E0ED01C0ED0380ED0700 150E153C5D15F85D4A5A4A5A4A5A140F4AC7FC141E143E5C147814F8495A5C1303495AA2 495AA249C8FCA25B133E137E137CA25BA212015BA212035BA212075BA2120FA25BA2121F A290C9FCA25AA2123EA3127EA2127CA65AAB1278A6127C123CA47EA2120E120FA27E6C7E A26C7EA26C7E1360246472CA28>40 D<1560A2157081A281151E150E150FA2811680A3ED 03C0A516E0A21501A71503A91507A216C0A4150FA21680A2151FA21600A25DA2153EA215 7EA2157C15FCA25D1401A25D14035DA214075D140F5DA24AC7FCA2143EA25C147814F849 5AA2495A5C1307495A91C8FC131E133E5B13785B485A485A485A48C9FC121E5A5A12E05A 23647FCA28>II<13F0EA03FC1207A2EA0FFEA4EA07FCEA03CCEA000C131C1318A2 133813301370136013E0EA01C013801203EA0700120E5A5A5A5A5A0F1D7A891E>44 D<007FB5FCB6FCA214FEA21805789723>I<120FEA3FC0127FA212FFA31380EA7F00123C 0A0A76891E>I<14F0EB01FC1303EB07FE130FA214FCEB07F814F0EB01E090C7FCB3A513 F0EA03F8487EA2120FA46C5AEA03D8EA001813381330A21370136013E05B12015B120348 C7FC1206120E5A5A5A5A5A173E7AAA1E>59 D63 D65 D67 D<91B912C0A30201902680000313806E90C8127F4A16 3F191F4B150FA30203EE07005DA314074B5D190EA2140F4B1307A25F021F020E90C7FC5D A2171E023F141C4B133C177C17FC027FEB03F892B5FCA39139FF8003F0ED00011600A249 5D5CA2160101034B13705C19F061010791C8FC4A1501611803010F5F4A150796C7FC6013 1F4A151E183E183C013F167C4A15FC4D5A017F1503EF0FF04A143F01FF913803FFE0B9FC A26042447AC342>69 D<91B91280A30201902680000713006E90C8FC4A163FA24B81A302 03160E5DA314074B151E191CA2140F5D17075F021F020E90C7FC5DA2171E023F141C4B13 3CA2177C027F5CED800392B5FCA291B65AED00071601A2496E5A5CA2160101035D5CA216 0301075D4A90CAFCA3130F5CA3131F5CA3133F5CA2137FA313FFB612E0A341447AC340> I<91B6D8803FB512E0A302010180C7387FE0006E90C86C5A4A167FA24B5EA219FF14034B 93C7FCA26014074B5DA21803140F4B5DA21807141F4B5DA2180F143F4B5DA2181F147F92 B75AA3DAFF80C7123F92C85BA2187F5B4A5EA218FF13034A93C8FCA25F13074A5DA21703 130F4A5DA21707131F4A5DA2170F133F4A5DA2017F151FA24A5D496C4A7EB6D8803FB512 E0A34B447AC348>72 D<91B612F0A25F020101C0C7FC6E5B4A90C8FCA25DA314035DA314 075DA3140F5DA3141F5DA3143F5DA3147F5DA314FF92C9FCA35B5CA3010316104A1538A2 1878010716705C18F018E0010F15015C18C01703011F15074A1580170FA2013FED1F004A 5C5F017F15FE16034A130F01FFEC7FFCB8FCA25F35447AC33D>76 D<91B56C93387FFFC08298B5FC02014DEBC0006E614A5FA203DF4C6CC7FC1A0E63912603 CFE05D038F5F1A381A711407030FEEE1FCA2F101C3020FEE0383020E60F107036F6C1507 021E160E021C60191CF1380F143C023804705BA2F1E01F0278ED01C091267003F85EF003 801A3F02F0ED070002E0030E5CA24E137F130102C04B91C8FC606201036D6C5B02805F4D 5A943803800113070200DA07005BA2050E1303495D010E606F6C5A1907011E5D011C4B5C A27048130F133C01384B5C017892C7FC191F01F85C486C027E5DD807FE027C4A7EB500F0 0178013FB512C0A216705A447AC357>I<91B56C49B512E0A28202009239000FFC00F107 F0706E5A4A5F15DF705D1907EC03CFDB8FF892C7FCA203875D02077F0303150EA270141E EC0F01020E161C826F153C141E021C6E1338167F1978023C800238013F1470A27113F002 78131F02705E83040F130102F014F84A5E1607EFFC0313014A01035C17FE180701031401 4A02FF90C8FCA2705B0107168F91C8138E177F18DE5B010EED3FDC18FCA2011E151F011C 5EA2170F133C01386F5A1378A201F81503486C5EEA07FEB500F01401A2604B447AC348> II<91B712F018FEF0FF800201903980007FE06E90C7EA1FF04AED07F818034B15FC F001FE1403A24B15FFA21407A25DA2140FF003FE5DA2021F16FC18074B15F8180F023F16 F0F01FE04B15C0F03F80027FED7F0018FE4BEB03FCEF0FF002FFEC7FC092B6C7FC17F892 CAFC5BA25CA21303A25CA21307A25CA2130FA25CA2131FA25CA2133FA25CA2137FA25C49 7EB67EA340447AC342>I<91B77E18F818FE020190398001FF806E90C7EA3FC04AED1FE0 F00FF04BEC07F8180319FC14034B15FEA314075DA3020FED07FC5DA2F00FF8141F4B15F0 F01FE0F03FC0023F16804BEC7F0018FEEF03F8027F4A5A4BEB1FC04CB4C7FC92B512F891 B612E092380003F8EE00FE177F496F7E4A6E7EA28413034A140FA2171F13075CA2173F13 0F5CA24D5A131F5CA3013F170E5CA2017FEE801E191C4A163C496C1638B66C90383FC070 051F13F094380FE1E0CA3803FF80943800FE003F467AC347>82 DI<48B912F85AA2913B0007FC001FF0D807F84A130701 E0010F140349160148485C90C71500A2001E021F15E05E121C123C0038143F4C13010078 18C0127000F0147F485DA3C800FF91C7FC93C9FCA35C5DA314035DA314075DA3140F5DA3 141F5DA3143F5DA3147F5DA314FF92CAFCA35B5CA21303A21307497E007FB612C0A25E3D 446FC346>I<001FB500F090383FFFFCA326003FF0C7000113806D48913800FE00013F16 7C18785C187018F0017F5E5CA2170101FF5E91C8FCA21703485F5BA21707000394C7FC5B A25F0007160E5BA2171E120F49151CA2173C121F491538A21778123F491570A217F0127F 495DA2160100FF5E90C8FCA216035F16074893C8FC5E160E161E5E007E1538007F15785E 6C4A5A6D495A001F4A5A6D49C9FC6C6C133E6C6C13F83903FC07F0C6B512C0013F90CAFC EB07F83E466DC348>I<010C1306011C130E49131C491338491370484813E04913C00003 13013907000380000EEB0700000C1306001C130E0018130C0038131C0030131800701338 00601330A200E0137000CFEB678039FFC07FE0A6018013C0397F003F80003CEB1E001F1D 65C432>92 D97 DIIIII<15FCEC03FF91 390F83838091393E01CFC091387C00EF4A13FF4948137F010315804948133F495A131F4A 1400133F91C75A5B167E13FE16FE1201495CA215011203495CA21503A2495CA21507A25E A2150F151F5E0001143F157F6C6C13FF913801DF8090387C039F90383E0F3FEB0FFCD903 F090C7FC90C7FC5DA2157EA215FEA25DA2001C495A127F48495A14074A5A485C023FC8FC 00F8137E387C01F8381FFFE0000390C9FC2A407BAB2D>I<14FE137FA3EB01FC13001301 A25CA21303A25CA21307A25CA2130FA25CA2131FA25C157F90393F83FFC091388F81F091 381E00F802387F4948137C5C4A137EA2495A91C7FCA25B484814FE5E5BA2000314015E5B A2000714035E5B1507000F5DA249130F5E001F1678031F1370491480A2003F023F13F0EE 00E090C7FC160148023E13C01603007E1680EE070000FEEC1E0FED1F1E48EC0FF80038EC 03E02D467AC432>I<143C147E14FE1301A3EB00FC14701400AE137C48B4FC3803C78038 0703C0000F13E0120E121C13071238A21278EA700F14C0131F00F0138012E0EA003F1400 A25B137EA213FE5B12015BA212035B141E0007131C13E0A2000F133CEBC038A21478EB80 7014F014E0EB81C0EA0783EBC7803803FE00EA00F8174378C11E>I<16F0ED03F8A21507 A316F0ED01C092C7FCAEEC01F0EC07FCEC1E1EEC380F0270138014E0130114C0EB038001 07131F1400A2130E153F131E011C140090C7FC5DA2157EA215FEA25DA21401A25DA21403 A25DA21407A25DA2140FA25DA2141FA25DA2143FA292C7FCA25C147EA214FE001C5B127F 48485A495AA248485A495AD8F81FC8FCEA707EEA3FF8EA0FC0255683C11E>I<14FE137F A3EB01FC13001301A25CA21303A25CA21307A25CA2130FA25CA2131FA25C167E013F49B4 FC92380783C09138000E07ED3C1F491370ED603F017E13E0EC01C09026FE038013809139 07000E00D9FC0E90C7FC5C00015B5C495AEBF9C03803FB8001FFC9FCA214F03807F3FCEB F07F9038E01FC06E7E000F130781EBC003A2001F150FA20180140EA2003F151E161C0100 13E0A2485DA2007E1578167000FE01015B15F1489038007F800038021FC7FC2A467AC42D >IIIIII<91381F800C91387FE01C903901F0703C903907C038789039 0F801CF890381F001D013E130F017E14F05B48481307A2484814E012075B000F140F16C0 485AA2003F141F491480A3007F143F90C71300A35D00FE147EA315FE5DA2007E1301A24A 5A1407003E130FA26C495A143B380F80F33807C3E73901FF87E038007E071300140F5DA3 141F5DA3143F92C7FCA25CA25C017F13FEA25D263F76AB2D>III<1470EB01F8A313035CA313075CA3130F5C A3131F5CA2007FB512E0B6FC15C0D8003FC7FCA25B137EA313FE5BA312015BA312035BA3 12075BA3120F5BA2EC0780001F140013805C140E003F131EEB001C143C14385C6C13F049 5A6C485AEB8780D807FEC7FCEA01F81B3F78BD20>I<137C48B414072603C780EB1F8038 0703C0000F7F000E153F121C0107150012385E1278D8700F147E5C011F14FE00F05B00E0 5DEA003FEC0001A2495C137E150313FE495CA215071201495CA2030F13380003167849EC C070A3031F13F0EE80E0153F00011581037F13C06DEBEF8300000101148090397C03C787 903A3E0F07C70090391FFE01FE903903F000782D2D78AB34>I<017C143848B414FC3A03 C78001FE380703C0000F13E0120E001C14000107147E1238163E1278D8700F141E5C131F 00F049131C12E0EA003F91C7123C16385B137E167801FE14705BA216F0000115E05B1501 16C0A24848EB0380A2ED0700A2150E12015D6D5B000014786D5B90387C01E090383F0780 D90FFFC7FCEB03F8272D78AB2D>I<017CEE038048B4020EEB0FC02603C780013FEB1FE0 380703C0000E7F5E001C037E130F01071607123804FE130300785DEA700F4A1501011F13 0100F001804914C012E0EA003FDA000314034C14805B137E0307140701FE1700495CA203 0F5C0001170E495CA260A24848495A60A2601201033F5C7F4B6C485A000002F713036D90 39E7E0078090267E01C349C7FC903A1F0781F81E903A0FFF007FF8D901FCEB0FE03B2D78 AB41>I<02F8133FD907FEEBFFE0903A0F0F83C0F0903A1C07C780F890393803CF030170 13EE01E0EBFC07120101C013F8000316F00180EC01C000074AC7FC13001407485C120EC7 FC140F5DA3141F5DA3143F92C8FCA34AEB03C01780147EA202FEEB0700121E003F5D267F 81FC130E6E5BD8FF83143CD903BE5B26FE079E5B3A7C0F1F01E03A3C1E0F83C0271FF803 FFC7FC3907E000FC2D2D7CAB2D>I<137C48B414072603C780EB1F80380703C0000F7F00 0E153F001C1600130712385E0078157EEA700F5C011F14FE00F0495B12E0EA003FEC0001 5E5B137E150301FE5C5BA2150700015D5BA2150F00035D5BA2151F5EA2153F12014BC7FC 6D5B00005BEB7C0390383E0F7EEB1FFEEB03F090C712FE5DA214015D121F397F8003F0A2 4A5A4848485A5D48131F00F049C8FC0070137E007813F8383801F0381E07C06CB4C9FCEA 01FC294078AB2F>I E %EndDVIPSBitmapFont %DVIPSBitmapFont: Ff cmtt12 12 83 /Ff 83 127 df<121C127FEAFF80B3A3EA7F00B3A2123EC7FCA9121C127FA2EAFF80A3EA 7F00A2121C093E6BBD33>33 D<00085B003EEB07C0007FEB0FE0A24814F0A26C14E0B3A2 007E1307003E14C0A20008EB01001C1E75BD33>I<903903E001F0A2496C487EA8010F13 07A202E05BA4007FB712E0A2B812F0A36C16E06C16C03B001FC00FE000013F131FA20280 5BA9017F133FA202005B003FB712C04816E0B812F0A36C16E0A2C648C66CC7FCA400015C A2495BA86C48137CA22C3D7DBC33>I<1438147C14FCA5903803FF80011F13F0017F13FC 48B6FC4815804815C0260FFEFD13E0391FF0FC3FD83FC0EB1FF00180EB07F8EA7F00007E 140316FC481401A21503A46CEC01F8ED0060007F15001380EA3FC013F0EA1FFCEA0FFF6C 7F6CEBFFC06C14F06C14FC013F7F01077F0100148016C09138FC7FE0ED1FF0150FED07F8 15031501003C15FC127EB41400A45AA26CEC01F87E15030180EB07F0D83FC0130F01E0EB 1FE0D81FF0EB3FC0390FFEFDFF6CB612806C15006C14FC6C5C011F13E0010390C7FCEB00 FCA5147C1438264D7AC433>I38 DI<140FEC3F80147F14FF491300495AEB07F8495A495A495A495A49C7FC5B12015B48 5A12075B120F5B121F5BA2123F5BA2127F90C8FCA45A5AAD7E7EA47F123FA27F121FA27F 120F7F12077F12036C7E7F12007F6D7E6D7E6D7E6D7E6D7EEB03FE6D7E6D1380147F143F EC0F00194D6FC433>I<127812FE7E7F6C7E6C7EEA0FF06C7E6C7E6C7E6C7E6D7E133F80 131F6D7E801307801303801301A2801300A28080A41580143FAD147F1500A45C5CA21301 5CA213035C13075C130F5C495A133F5C137F49C7FC485A485A485A485AEA3FE0485A485A 90C8FC5A1278194D78C433>I<14F0497EA8007015E000F8EC01F000FE140700FF140F01 C1133F01F113FF263FF9F913C0000FB61200000314FCC614F06D5B011F1380D907FEC7FC 90381FFF80017F13E090B57E000314FC000F14FF263FF9F913C026FFF1F813F001C1133F 0101130F00FE140700F814010070EC00E000001500A86D5A242B79B333>I<141FA24A7E B0007FB71280A2B812C0A36C1680A2C7D83F80C7FCB06EC8FCA22A2B7CB333>II<007FB612FEA2B8FCA36C15FEA22807 7BA133>I<121FEA3F80EA7FC0EAFFE0A5EA7FC0EA3F80EA1F000B0B6C8A33>I<167816F8 ED01FCA21503A2ED07F8A2ED0FF0A2ED1FE0A216C0153FA2ED7F80A2EDFF00A24A5AA25D 1403A24A5AA24A5AA24A5AA25D143FA24A5AA24AC7FCA2495AA25C1303A2495AA2495AA2 5C131FA2495AA2495AA249C8FCA25B1201A2485AA2485AA2485AA25B121FA2485AA2485A A248C9FCA25AA2127CA2264D7AC433>I<14FF010313C0010F13F0497F497F497F9038FF 81FF3A01FE007F804848EB3FC049131F4848EB0FE0A24848EB07F0A24848EB03F8A24848 EB01FCA348C812FEA4007E157E00FE157FAE6C15FF6C15FEA46D1301003F15FCA26D1303 001F15F8A26C6CEB07F0A26C6CEB0FE06D131F6C6CEB3FC0A26CB4EBFF806C018113006D B45A6D5B6D5B6D5B010313C0010090C7FC283F7BBD33>III< 903801FFC0010F13F8013F13FE90B67E48814881489038807FF03A0FFC000FF801F06D7E 484813036F7EA21500A26C5A6C5AC9FC15015EA215034B5A150F4B5A4B5A913803FFC001 03B55A4991C7FC5D8116C06D8090C76C7EED0FF8ED03FC6F7E6F7E821780163FA2EE1FC0 A3123C127EB4FCA2163F1780167F6C16006D5C6D495A6C6C1303D81FF8EB0FFC3A0FFF80 7FF86C90B55A6C5D6C15806C6C91C7FC010F13FC010113C02A3F7CBD33>I<0007B612F0 4815F85AA316F001C0C8FCB0ECFFC001C713F801DF7F90B6FC168016C0028013E09039FC 001FF001F0EB0FF849130749EB03FC6C4813016CC713FEC9FCA216FF167FA41218127EA2 B415FF16FEA24814016C15FC6C14036DEB07F86D130F6C6CEB1FF06C6CEB7FE09039FE03 FFC06CB612806C150000015C6C14F8013F13E0010390C7FC283E7BBC33>53 DI<49B47E010F13E0013F13F84913FE90B6FC000315 8048018113C09038FC007F4848EB1FE04848EB0FF0485A49EB07F84848130390C7FCED01 FC5A5A16FE1500A416FFA37E7E6D5BA26C6C5B6D5B6C6C5B6C6C5BD807FE137F90B7FC6C 157F6C14FC6C6CEBF8FF6DEBE0FE010F1380903800200091C7FC150116FCA2150316F815 0716F0000F140F486CEB1FE0486C133F16C0EDFF804A13004A5A381FF01F90B512F86C5C 6C5C6C1480C649C7FCEB3FF0283F7BBD33>57 D<121FEA3F80EA7FC0EAFFE0A5EA7FC0EA 3F80EA1F00C7FCB3A3121FEA3F80EA7FC0EAFFE0A5EA7FC0EA3F80EA1F000B2B6CAA33> II<161E167E16FF15035DED1FFE157FEDFFF8020313F04A 13C0021F138091383FFE00ECFFF8495B010713C0495BD93FFEC7FC495A3801FFF0485B00 0F13804890C8FCEA7FFC5BEAFFE05B7FEA7FF87FEA1FFF6C7F000313E06C7F38007FFC6D 7E90380FFF806D7F010113F06D7FEC3FFE91381FFF80020713C06E13F0020013F8ED7FFE 151FED07FF811500167E161E28337BB733>I<007FB71280A2B812C0A36C16806C1600CB FCA9003FB7FC481680B812C0A36C1680A22A177CA933>I<1278127EB4FC13C07FEA7FF8 13FEEA1FFF6C13C000037F6C13F86C6C7EEB1FFF6D7F010313E06D7F9038007FFC6E7E91 380FFF806E13C0020113F06E13F8ED3FFE151FED07FF815DED1FFE153FEDFFF84A13F002 0713C04A138091383FFE004A5A903801FFF0495B010F13804990C7FCEB7FFC48485A4813 E0000F5B4890C8FCEA7FFE13F8EAFFE05B90C9FC127E127828337BB733>I<90380FFF80 017F13F848B512FE0007ECFF804815C04815E0263FFC0113F03A7FE0001FF80180130748 C7EA03FC5A6C1401A3127E15030018EC07F8C8121FED3FF0EDFFE04A13C04A1380913807 FE004A5A4A5AEC3FE05D4A5A4AC7FCA2495A5CA213035CA96D5A90C9FCA914E0EB03F8A2 497EA36D5AA2EB00E0263E7ABD33>III<007F B512F8B7FC16C082826C813A03F8000FFCED03FE15016F7E82A2EE3F80A7EE7F00A25E4B 5AA2ED07FCED1FF890B65A5E1680828216F89039F8000FFCED01FE6F7EEE7F80163F17C0 161FA2EE0FE0A7161F17C0A2163FEE7F8016FF4B1300150F007FB65AB75A5E16E05E6C4A C7FC2B3D7DBC33>I<91391FE00780DAFFFC13C00103EBFF0F010F148F4914FF5B90387F F81F9038FFC00748497E4848487E497F485A167F485A49143F121F5B003F151F5BA2127F 90C8EA0F8093C7FCA25A5AAD7E7EA36DEC0F80003FED1FC0A27F121F7F000F153F6D1580 6C7E167F6C6CECFF007F3A01FF8003FE6C6D485A90397FF81FF86DB55A6D5C6D5C010391 C7FC010013FCEC1FE02A3F7CBD33>I<003FB512F04814FCB7FC826C816C813A03F8007F F0ED1FF8ED07FC15036F7E8281EE7F80A2163F17C0161FA217E0160FA4EE07F0AD160F17 E0A4161F17C0163FA21780167FEEFF00A24B5A15034B5AED1FF8ED7FF0003FB6FC4815C0 B75A93C7FC6C14FC6C14F02C3D7EBC33>I<003FB712E04816F0B8FCA27E7ED801FCC712 07A8EE03E093C7FCA6151F4B7EA490B6FCA69038FC003FA46FC7FC92C8FCA817F8EE01FC A9003FB7FC5AB8FCA27E6C16F82E3D7EBC33>I<3B7FFFC00FFFF8B56C4813FCA46C496C 13F8D803F8C7EA7F00B3A290B7FCA601F8C77EB3A53B7FFFC00FFFF8B56C4813FCA46C49 6C13F82E3D7EBC33>72 D<003FB612804815C0B712E0A26C15C06C1580260003F8C7FCB3 B3AD003FB612804815C0B712E0A26C15C06C1580233D78BC33>I<49B512F84914FC16FE A216FC6D14F890C7EA7F00B3B3A5123C127EB4FCA25D5D1401397F8007FC9038F01FF86C B5FC6C5C6C14C000035CC649C7FCEB1FF0273E79BC33>II<387FFFF8B57E80A25C6C5BD801FCC9FCB3B3A3EE03E0EE07F0A9007F B7FCB8FCA46C16E02C3D7DBC33>III<90381FFFF890B6FC000315C0000F15F0A2 4815F83A3FFC003FFC01E013074913034848EB01FEA290C8FCA500FE157FB3AC6C15FF6C 15FEA46D1301A36C6CEB03FC01F0130F01FC133F6CB612F86C15F0A2000315C0C6150001 1F13F8283F7BBD33>I<003FB512FC48ECFF80B712E016F86C816C813A01FC000FFF0303 13801500EE7FC0163FEE1FE0160FA217F01607A6160F17E0A2161FEE3FC0167FEEFF8015 03030F130090B65A5E5E16E0168003FCC7FC01FCC9FCB3383FFFE0487FB57EA26C5B6C5B 2C3D7EBC33>I<90381FFFF890B6FC000315C0000F15F0A24815F83A3FFC003FFC01F013 0F01C013034848EB01FEA290C8FCA54815FF48157FB3AA143F6C90387F80FF6C15FEEC3F C0A2EC1FE0A29038800FF1A23A3FC007FBFC01F013FFEBFC036CB612F86C15F0A2000315 C0C61500011F148090C7EA7FC0153F16E0151F16F0150F16F8150716FC150316FE1501ED 00FC284C7BBD33>I<007FB57EB612F815FE81826C812603F8007FED3FF0ED0FF815076F 7E1501A26F7EA74B5AA215034B5A150FED3FF0EDFFE090B65A5E93C7FC5D8182D9F8007F 153F6F7E150F821507AA173E177FA416F8030313FF267FFFC014FEB538E001FF17FC81EE 7FF86C49EB3FF0C9EA0FC0303E7EBC33>II<003FB712F84816FC B8FCA43AFE000FE001A8007CED00F8C71500B3B3A40107B512C049804980A26D5C6D5C2E 3D7EBC33>I<273FFFE001B5FC486D481480B56C4814C0A26C496C14806C496C1400D801 FCC7EA0FE0B3B3A36D141F00005EA26D143F6D5DA26D6C49C7FC6E5B6D6C485AECF00390 390FFC0FFC6DB55A6D5C6D5C6D6C1380DA1FFEC8FCEC07F8323E80BC33>II<3A3FFF807FFF486DB51280A46C496C13003A01FE000FE0151F6C7E4B5AEB7F805E90 383FC07F93C7FC6D6C5A5DEB0FF15DEB07FB5DEB03FF5D7F5D7F5D147F6E5AA34A7EA24A 7E815B81EB03FB81EB07F181EB0FE081011F7F02C07F013F133F02807F017F131F02007F 49130F49801507000181491303000381491301D87FFF90380FFFE0B56C4813F05DA2816C 496C13E02C3D7DBC33>88 DI<007FB512C0B612E0 A415C048C8FCB3B3B3ABB612C015E0A46C14C01B4D6CC433>91 D<127CA212FEA27EA26C 7EA26C7EA26C7EA2120F7FA26C7EA26C7EA26C7EA212007FA26D7EA26D7EA26D7EA2130F 80A26D7EA26D7EA2130180A26D7EA26E7EA26E7EA2141F81A26E7EA26E7EA26E7EA21401 81A26E7EA2ED7F80A2ED3FC0A2151F16E0A2ED0FF0A2ED07F8A2ED03FCA21501A2ED00F8 1678264D7AC433>I<007FB512C0B612E0A47EC7120FB3B3B3AB007FB5FCB6FCA46C14C0 1B4D7DC433>I<007FB612FEA2B8FCA36C15FEA228077B7D33>95 D97 DIIIIII< EA3FFC487E12FFA2127F123F1200AB4AB4FC020713C0021F13F0027F7F91B5FC90B67EED 07FEECF801ECF0004A7F4A7F5CA291C7FCA35BB3A43B3FFFF80FFFFC486D4813FEB56C48 13FFA26C496C13FE6C496C13FC303D7FBC33>I<14E0EB03F8A2497EA36D5AA2EB00E091 C8FCAA383FFFF8487FA47EEA0001B3AD007FB612C0B712E016F0A216E06C15C0243E78BD 33>I107 D<383FFFFC487FB5FCA27E7EC7 FCB3B3AD003FB612F84815FCB712FEA26C15FC6C15F8273D7ABC33>I<02FC137E3B7FC3 FF01FF80D8FFEF01877F90B500CF7F15DF92B57E6C010F13872607FE07130301FC01FE7F 9039F803FC01A201F013F8A401E013F0B3A53C7FFE0FFF07FF80B548018F13C0A46C486C 01071380322C80AB33>I<4AB4FC263FFC0713C0267FFE1F13F000FF017F7F91B5FC6CB6 7E6CEC07FEC6EBF801ECF0004A7F4A7F5CA291C7FCA35BB3A43B3FFFF80FFFFC486D4813 FEB56C4813FFA26C496C13FE6C496C13FC302C7FAB33>III<02FF137C0107EBE0FE011F13F0017F13FC90B512FE 4814FF4813C03907FE003F4848131F01F0130F484813071503485A491301127F90C7FC15 005A5AA97E7E15017F123F6D130315076C7E6C6C130F6D131FD807FE137F3903FF81FF6C EBFFFE6C14FC6D13F86D13F0010F13C0903801FE0090C8FCAF92387FFFFC92B512FEA46F 13FC2F427CAB33>II<90381FFE0F90B5EA8F80000314FF120F5A5AEBF007 387F800190C7FC00FE147F5A153FA37E007FEC1F0001C090C7FCEA3FF8EBFFC06C13FF6C 14E0000314F8C680011F13FF01001480020713C0EC007FED1FE0007C140F00FEEC07F015 03A27EA27F15076D14E06D130F6DEB3FC09038FE01FF90B61280160000FD5C00FC14F8D8 F83F13E0D8780790C7FC242E79AC33>III<3B3FFFC00FFFF0486D4813F8B5 6C4813FCA26C496C13F86C496C13F0D801F8C7EA7E006D14FE00005DA26D1301017E5CA2 017F13036D5CA2EC8007011F5CA2ECC00F010F5CA36D6C485AA3ECF03F010391C7FCA26E 5A0101137EA2ECFCFE01005BA214FF6E5AA36E5AA26E5A6E5A2E2B7EAA33>I<3B7FFF80 07FFF8B56C4813FC6E5AA24A7E6C496C13F8D80FC0C7EA0FC06D141F00071680A56D143F 00031600A3EC0FC0EC1FE0A23A01F83FF07EA3EC7FF8147CA20000157C9039FCFCFCFCA3 ECF87CA2017C5C017D137EECF03EA2017F133FA26D486C5AA3ECC00F90390F8007C02E2B 7EAA33>I<3B3FFFC07FFF80486DB512C0B500F114E0A26C01E014C06C496C13803B00FE 000FE000017F495AEB3F804B5A6D6C48C7FC90380FE07E903807F0FEECF1FC903803FBF8 EB01FF6D5B5D6E5A143F6E5A143F814A7E14FF903801FBF0ECF9F8903803F1FCEB07E015 7E90380FC07F011F6D7E90383F801F02007F496D7E01FE6D7E484813033B7FFFC03FFFE0 B56C4813F0A46C496C13E02C2B7DAA33>I<3B7FFF801FFFE0B56C4813F06E4813F8A24A 6C13F06C496C13E0D803F8C7EAFC00000114015E7F000014036D5C137EA2017F495A7FA2 6E485A131FA26D6C485AA214E0010749C7FCA214F01303157EEB01F8A2157C010013FC14 FC5D147C147DEC3FF0A36E5AA36E5AA2141F5DA2143F92C8FCA3147EA214FE003F5B1301 387F81F81383EB87F0139FEBFFE06C5B5C6C90C9FCEA0FFCEA03F02D427DAA33>I<000F B712804816C05AA317800180C713004B5A4B5A4B5A4B5A6CC7485AC8485A4B5A4BC7FC4A 5A4A5A4A5A4A5A4A5A4A5A4A5A4AC8FC495A495A495A495A495A495A495A49C7EA0F8048 48EC1FC0485A485A485A485A485A48B7FCB8FCA46C16802A2B7DAA33>II<127CA212FEB3B3B3B3127CA2074D6AC433>II<013E13079039FF800F8000039038C01FC048EBE03F48 EBF07F489038F9FF803A7FE7FFFE00D8FF835B01015B486C5B007CEB7FC00038011FC7FC 220C78BC33>I E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fg cmbx12 12 56 /Fg 56 122 df12 DI40 D<12F07E127E7E6C7E6C7E6C7E7F6C7E6C7E12007F137F8013 3F806D7EA26D7EA26D7EA2801303A2801301A280A27F1580A4EC7FC0A615E0A2143FAE14 7FA215C0A6ECFF80A415005BA25CA213035CA213075CA2495AA2495AA2495A5C137F91C7 FC13FE5B1201485A485A5B485A485A48C8FC127E12F85A1B647ACA2C>I<143E147F4A7E A56EC8FC00081508003E153E007F157FD8FFC0903801FF8001E05B9038F03E0701F85BD8 7FFE013F130001FF5B001F9038BEFFFC000390B512E0C66C91C7FC010F13F8010113C0A2 010F13F8017F13FF0003B612E0001F01BE13FC007F90383E7FFF01FE7FD8FFF8010F1380 01F07F9038E07F0301C07FD87F009038007F00003E153E00081508C791C7FC4A7EA56EC8 FC143E292C79CA38>I44 DII49 DII<163FA25E5E5D5DA25D5D5D5DA25D92B5FCEC01F7EC03E7140715C7EC 0F87EC1F07143E147E147C14F8EB01F0EB03E0130714C0EB0F80EB1F00133E5BA25B485A 485A485A120F5B48C7FC123E5A12FCB91280A5C8000F90C7FCAC027FB61280A531417DC0 38>I<0007150301E0143F01FFEB07FF91B6FC5E5E5E5E5E16804BC7FC5D15E092C8FC01 C0C9FCAAEC3FF001C1B5FC01C714C001DF14F09039FFE03FFC9138000FFE01FC6D7E01F0 6D13804915C0497F6C4815E0C8FC6F13F0A317F8A4EA0F80EA3FE0487E12FF7FA317F05B 5D6C4815E05B007EC74813C0123E003F4A1380D81FC0491300D80FF0495AD807FEEBFFFC 6CB612F0C65D013F1480010F01FCC7FC010113C02D427BC038>I<4AB47E021F13F0027F 13FC49B6FC01079038807F8090390FFC001FD93FF014C04948137F4948EBFFE048495A5A 1400485A120FA248486D13C0EE7F80EE1E00003F92C7FCA25B127FA2EC07FC91381FFF80 00FF017F13E091B512F89039F9F01FFC9039FBC007FE9039FF8003FF17804A6C13C05B6F 13E0A24915F0A317F85BA4127FA5123FA217F07F121FA2000F4A13E0A26C6C15C06D4913 806C018014006C6D485A6C9038E01FFC6DB55A011F5C010714C0010191C7FC9038003FF0 2D427BC038>I<121E121F13FC90B712FEA45A17FC17F817F017E017C0A2481680007EC8 EA3F00007C157E5E00785D15014B5A00F84A5A484A5A5E151FC848C7FC157E5DA24A5A14 035D14074A5AA2141F5D143FA2147F5D14FFA25BA35B92C8FCA35BA55BAA6D5A6D5A6D5A 2F447AC238>IIII<903807FFC0013F13FC48B612804815E0260FF80013F0D8 1FC0EB3FF848C7EA1FFC4815FE01C0130F486C14FF7FA66C485B6C4814FE000FC7FCC8EA 3FFCED7FF8EDFFF04A13E04A13801600EC07FC4A5A5D4A5A5D4A5A92C7FCA2147E147CA3 1478AA91C8FCA814F8EB03FE497E497FA2497FA56D5BA26D90C7FC6D5AEB00F828467AC5 35>63 D65 DIIIII73 D76 DI80 D83 D<003FBA12E0A59026FE000FEB8003D87FE09338003FF049171F90C71607A2007E180300 7C1801A300781800A400F819F8481978A5C81700B3B3A20107B8FCA545437CC24E>II<903801FFE0011F13FE01 7F6D7E48B612E03A03FE007FF84848EB1FFC6D6D7E486C6D7EA26F7FA36F7F6C5A6C5AEA 00F090C7FCA40203B5FC91B6FC1307013F13F19038FFFC01000313E0000F1380381FFE00 485A5B127F5B12FF5BA35DA26D5B6C6C5B4B13F0D83FFE013EEBFFC03A1FFF80FC7F0007 EBFFF86CECE01FC66CEB8007D90FFCC9FC322F7DAD36>97 DIIIIIII<137C48B4FC4813804813C0A24813E0 A56C13C0A26C13806C1300EA007C90C7FCAAEB7FC0EA7FFFA512037EB3AFB6FCA518467C C520>I107 DI<90277F8007FEEC0FFC B590263FFFC090387FFF8092B5D8F001B512E002816E4880913D87F01FFC0FE03FF8913D 8FC00FFE1F801FFC0003D99F009026FF3E007F6C019E6D013C130F02BC5D02F86D496D7E A24A5D4A5DA34A5DB3A7B60081B60003B512FEA5572D7CAC5E>I<90397F8007FEB59038 3FFF8092B512E0028114F8913987F03FFC91388F801F000390399F000FFE6C139E14BC02 F86D7E5CA25CA35CB3A7B60083B512FEA5372D7CAC3E>II<90397FC00FF8B590B57E02C314E002CF14F89139DFC03F FC9139FF001FFE000301FCEB07FF6C496D13804A15C04A6D13E05C7013F0A2EF7FF8A4EF 3FFCACEF7FF8A318F017FFA24C13E06E15C06E5B6E4913806E4913006E495A9139DFC07F FC02CFB512F002C314C002C091C7FCED1FF092C9FCADB67EA536407DAC3E>II<90387F807FB53881FFE002 8313F0028F13F8ED8FFC91389F1FFE000313BE6C13BC14F8A214F0ED0FFC9138E007F8ED 01E092C7FCA35CB3A5B612E0A5272D7DAC2E>I<90391FFC038090B51287000314FF120F 381FF003383FC00049133F48C7121F127E00FE140FA215077EA27F01E090C7FC13FE387F FFF014FF6C14C015F06C14FC6C800003806C15806C7E010F14C0EB003F020313E0140000 F0143FA26C141F150FA27EA26C15C06C141FA26DEB3F8001E0EB7F009038F803FE90B55A 00FC5CD8F03F13E026E007FEC7FC232F7CAD2C>II< D97FC049B4FCB50103B5FCA50003EC000F6C81B3A85EA25EA25E7E6E491380017FD901F7 13FE9138F807E76DB512C7010F1407010313FE9026007FF0EBFC00372E7CAC3E>I IIII E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fh cmbx12 17.28 35 /Fh 35 122 df<16F04B7E1507151F153FEC01FF1407147F010FB5FCB7FCA41487EBF007 C7FCB3B3B3B3007FB91280A6395E74DD51>49 D<913801FFF8021FEBFFC091B612F80103 15FF010F16C0013F8290267FFC0114F89027FFE0003F7F4890C7000F7F48486E7FD807F8 6E148048486E14C048486E14E048486F13F001FC17F8486C816D17FC6E80B56C16FE8380 A219FFA283A36C5BA26C5B6C90C8FCD807FC5DEA01F0CA14FEA34D13FCA219F85F19F04D 13E0A294B512C019804C14004C5B604C5B4C5B604C13804C90C7FC4C5A4C5A4B13F05F4B 13804B90C8FC4B5AED1FF84B5A4B5A4B48143F4A5B4A48C8FC4A5A4A48157E4A5A4A5AEC 7F8092C9FC02FE16FE495A495A4948ED01FCD90FC0150749B8FC5B5B90B9FC5A4818F85A 5A5A5A5ABAFCA219F0A4405E78DD51>I<92B5FC020F14F8023F14FF49B712C04916F001 0FD9C01F13FC90271FFC00077FD93FE001017F49486D8049C86C7F484883486C6F7F14C0 486D826E806E82487FA4805CA36C5E4A5E6C5B6C5B6C495E011FC85A90C95CA294B55A61 4C91C7FC604C5B4C5B4C5B4C5B047F138092260FFFFEC8FC020FB512F817E094C9FC17F8 17FF91C7003F13E0040713F8040113FE707F717F7113E085717FA2717F85A285831A80A3 1AC0EA03FCEA0FFF487F487F487FA2B57EA31A80A34D14005C7E4A5E5F6C495E49C8485B D81FF85F000F5ED807FE92B55A6C6C6C4914806C01F0010791C7FC6C9026FF803F5B6D90 B65A011F16F0010716C001014BC8FCD9001F14F0020149C9FC426079DD51>II<01C0EE01C0D801F816 0F01FF167F02F0EC07FFDAFF8090B5FC92B7128019006060606060606095C7FC17FC5F17 E0178004FCC8FC16E09026FC3FFCC9FC91CBFCADED3FFE0203B512F0020F14FE023F6E7E 91B712E001FDD9E00F7F9027FFFE00037F02F801007F02E06EB4FC02806E138091C8FC49 6F13C04917E07113F0EA00F090C914F8A219FC83A219FEA419FFA3EA03F0EA0FFC487E48 7E487FA2B57EA319FEA35C4D13FC6C90C8FC5B4917F8EA3FF001804B13F06D17E0001F5E 6C6C17C06D4B1380D807FC92B512006C6C4A5B6C6C6C01075B6C01E0011F5BD97FFE90B5 5A6DB712C0010F93C7FC6D15FC010115F0D9003F1480020301F0C8FC406078DD51>III58 D65 D<4DB5ED03C0057F02F014070407B600FE14 0F047FDBFFC0131F4BB800F0133F030F05FC137F033F9127F8007FFE13FF92B6C73807FF 814A02F0020113C3020702C09138007FE74A91C9001FB5FC023F01FC16074A01F08291B5 4882490280824991CB7E49498449498449498449865D49498490B5FC484A84A2484A84A2 4891CD127FA25A4A1A3F5AA348491A1FA44899C7FCA25CA3B5FCB07EA380A27EA2F50FC0 A26C7FA37E6E1A1F6C1D80A26C801D3F6C6E1A00A26C6E616D1BFE6D7F6F4E5A7F6D6D4E 5A6D6D4E5A6D6D4E5A6D6E171F6D02E04D5A6E6DEFFF806E01FC4C90C7FC020F01FFEE07 FE6E02C0ED1FF8020102F8ED7FF06E02FF913803FFE0033F02F8013F1380030F91B648C8 FC030117F86F6C16E004071680DC007F02F8C9FC050191CAFC626677E375>67 D70 D73 D76 DI80 D<001FBEFCA64849C79126E0000F148002E0180091C8171F498601F81A0349864986 A2491B7FA2491B3F007F1DC090C9181FA4007E1C0FA600FE1DE0481C07A5CA95C7FCB3B3 B3A3021FBAFCA663617AE070>84 DI<913803FFFE027FEBFFF00103B612FE010F6F7E4916E090273FFE001F 7FD97FE001077FD9FFF801017F486D6D7F717E486D6E7F85717FA2717FA36C496E7FA26C 5B6D5AEB1FC090C9FCA74BB6FC157F0207B7FC147F49B61207010F14C0013FEBFE004913 F048B512C04891C7FC485B4813F85A5C485B5A5CA2B55AA45FA25F806C5E806C047D7F6E EB01F96C6DD903F1EBFF806C01FED90FE114FF6C9027FFC07FC01580000191B5487E6C6C 4B7E011F02FC130F010302F001011400D9001F90CBFC49437CC14E>97 D<903807FF80B6FCA6C6FC7F7FB3A8EFFFF8040FEBFF80047F14F00381B612FC038715FF 038F010014C0DBBFF0011F7FDBFFC001077F93C76C7F4B02007F03F8824B6F7E4B6F1380 4B17C0851BE0A27313F0A21BF8A37313FCA41BFEAE1BFCA44F13F8A31BF0A24F13E0A24F 13C06F17804F1300816F4B5A6F4A5B4AB402075B4A6C6C495B9126F83FE0013F13C09127 F00FFC03B55A4A6CB648C7FCDAC00115F84A6C15E091C7001F91C8FC90C8000313E04F65 7BE35A>I<92380FFFF04AB67E020F15F0023F15FC91B77E01039039FE001FFF4901F801 0113804901E0010713C04901804913E0017F90C7FC49484A13F0A2485B485B5A5C5A7113 E0485B7113C048701380943800FE0095C7FC485BA4B5FCAE7EA280A27EA2806C18FCA26C 6D150119F87E6C6D15036EED07F06C18E06C6D150F6D6DEC1FC06D01E0EC7F806D6DECFF 00010701FCEB03FE6D9039FFC03FFC010091B512F0023F5D020F1580020102FCC7FCDA00 0F13C03E437BC148>II<92380FFFC04AB512FC020FECFF80023F15E091B712F80103D9FE03 7F499039F0007FFF011F01C0011F7F49496D7F4990C76C7F49486E7F48498048844A8048 84485B727E5A5C48717EA35A5C721380A2B5FCA391B9FCA41A0002C0CBFCA67EA380A27E A27E6E160FF11F806C183F6C7FF17F006C7F6C6D16FE6C17016D6C4B5A6D6D4A5A6D01E0 4A5A6D6DEC3FE0010301FC49B45A6D9026FFC01F90C7FC6D6C90B55A021F15F8020715E0 020092C8FC030713F041437CC14A>I103 D<903807FF80B6FCA6C6FC7F7FB3A8EF1FFF94B512F0040714FC041F14FF4C8193267FE0 7F7F922781FE001F7FDB83F86D7FDB87F07FDB8FC0814C7F039FC78015BE03BC8003FC82 5DA25DA25DA45DB3B2B7D8F007B71280A651647BE35A>II<903807FF80B6FCA6C6FC7F7FB3B3B3B3AD B712E0A623647BE32C>108 D<902607FF80EB1FFFB691B512F0040714FC041F14FF4C81 93267FE07F7F922781FE001F7FC6DA83F86D7F6DD987F07F6DD98FC0814C7F039FC78015 BE03BC8003FC825DA25DA25DA45DB3B2B7D8F007B71280A651417BC05A>110 D<923807FFE092B6FC020715E0021F15F8027F15FE494848C66C6C7E010701F0010F13E0 4901C001037F49496D7F4990C87F49486F7E49486F7E48496F13804819C04A814819E048 496F13F0A24819F8A348496F13FCA34819FEA4B518FFAD6C19FEA46C6D4B13FCA36C19F8 A26C6D4B13F0A26C19E06C6D4B13C0A26C6D4B13806C6D4B13006D6C4B5A6D6D495B6D6D 495B010701F0010F13E06D01FE017F5B010090B7C7FC023F15FC020715E0020092C8FC03 0713E048437CC151>I<902607FF80EBFFF8B6010FEBFF80047F14F00381B612FC038715 FF038F010114C09227BFF0003F7FC6DAFFC0010F7F6D91C76C7F6D496E7F03F86E7F4B6E 7F4B17804B6F13C0A27313E0A27313F0A21BF885A21BFCA3851BFEAE4F13FCA41BF861A2 1BF0611BE0611BC06F92B512801B006F5C6F4A5B6F4A5B03FF4A5B70495B04E0017F13C0 9226CFFC03B55A03C7B648C7FC03C115F803C015E0041F91C8FC040313E093CBFCB3A3B7 12F0A64F5D7BC05A>I114 D<913A3FFF8007800107B5EAF81F011FECFE7F017F91B5FC48B8FC48EBE0014890C7121F D80FFC1407D81FF0801600485A007F167F49153FA212FF171FA27F7F7F6D92C7FC13FF14 E014FF6C14F8EDFFC06C15FC16FF6C16C06C16F06C826C826C826C82013F1680010F16C0 1303D9007F15E0020315F0EC001F1500041F13F81607007C150100FC81177F6C163FA217 1F7EA26D16F0A27F173F6D16E06D157F6D16C001FEEDFF806D0203130002C0EB0FFE02FC EB7FFC01DFB65A010F5DD8FE0315C026F8007F49C7FC48010F13E035437BC140>II<902607FFC0ED3F FEB60207B5FCA6C6EE00076D826D82B3B3A260A360A2607F60183E6D6D147E4E7F6D6D49 48806D6DD907F0ECFF806D01FFEB3FE06D91B55A6E1500021F5C020314F8DA003F018002 F0C7FC51427BC05A>I<007FB600C0017FB512F8A6D8001F01F8C70007EBF0006D040190 C7FC6D6D5D6D6D4A5A6D6D4A5A70495A6D4C5A6E7F6E6D495A6E6D495A7049C8FC6E4A5A 6E6D485A6E6D485A6E13FFEF8FF06EEC9FE06FEBFFC06F5C6F91C9FC5F6F5B816F7F6F7F 8481707F8493B57E4B805D4B80DB0FF37FDB1FE17F04C080153F4B486C7F4B486C7F4A48 6D7F4A486D7F4A5A4B6D7F020F6E7F4A486D7F4A486D804A5A4AC86C7F49486F7F4A6F7F 0107707FEB3FFFB600F049B7FCA650407EBF55>120 DI E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fi cmr10 10 24 /Fi 24 122 df66 D<913A01FF800180020FEBE003027F13F8903A01 FF807E07903A03FC000F0FD90FF0EB039F4948EB01DFD93F80EB00FF49C8127F01FE153F 12014848151F4848150FA248481507A2485A1703123F5B007F1601A35B00FF93C7FCAD12 7F6DED0180A3123F7F001F160318006C7E5F6C7E17066C6C150E6C6C5D00001618017F15 386D6C5CD91FE05C6D6CEB03C0D903FCEB0F80902701FF803FC7FC9039007FFFFC020F13 F002011380313D7BBA3C>I69 D73 D77 D82 DI97 DII101 D104 DI 107 DI<2703F00FF0EB1F E000FFD93FFCEB7FF8913AF03F01E07E903BF1C01F83803F3D0FF3800FC7001F802603F7 0013CE01FE14DC49D907F8EB0FC0A2495CA3495CB3A3486C496CEB1FE0B500C1B50083B5 FCA340257EA445>I<3903F00FF000FFEB3FFCECF03F9039F1C01F803A0FF3800FC03803 F70013FE496D7EA25BA35BB3A3486C497EB500C1B51280A329257EA42E>II<3903F01FE000FFEB7FF89038F1E07E9039F3801F803A0FF7000FC0D803FEEB07E0 49EB03F04914F849130116FC150016FEA3167FAA16FEA3ED01FCA26DEB03F816F06D1307 6DEB0FE001F614C09039F7803F009038F1E07E9038F0FFF8EC1FC091C8FCAB487EB512C0 A328357EA42E>I<3807E01F00FFEB7FC09038E1E3E09038E387F0380FE707EA03E613EE 9038EC03E09038FC0080491300A45BB3A2487EB512F0A31C257EA421>114 DI<1318A5 1338A31378A313F8120112031207001FB5FCB6FCA2D801F8C7FCB215C0A93800FC011580 EB7C03017E13006D5AEB0FFEEB01F81A347FB220>II121 D E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fj cmr6 6 4 /Fj 4 117 df<130C1338137013E0EA01C0EA038013005A120EA25AA25AA312781270A3 12F0AB1270A312781238A37EA27EA27E7E1380EA01C0EA00E013701338130C0E317AA418 >40 D<12C012707E7E7E7E7E1380EA01C0A2EA00E0A21370A313781338A3133CAB1338A3 13781370A313E0A2EA01C0A2EA038013005A120E5A5A5A12C00E317CA418>I<3A0F07F0 07F03AFF1FFC1FFC9039703E703E3A1FC01EC01E6C486C487EA201001300AE3BFFF0FFF0 FFF0A22C167D9532>109 D<487EA41203A21207A2120F123FB51280A238078000AA14C0 A63803C180EBE300EA01FEEA007C12207E9E18>116 D E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fk cmti10 10.95 26 /Fk 26 122 df<171C173C177CA217FCA216011603A21607A24C7EA2161DA21639167916 7116E1A2ED01C1A2ED038115071601150EA2031C7FA24B7EA25D15F05D4A5AA24A5AA24A C7FC5C140E5C021FB6FC4A81A20270C7127FA25C13015C495AA249C8FCA2130E131E131C 133C5B01F882487ED807FEEC01FFB500E0017FEBFF80A25C39417BC044>65 D<49B812F8A390260003FEC7121F18074B14031801F000F014075DA3140F5D19E0A2141F 4B1338A2EF7801023F027013C04B91C7FCA217F0027F5CED80011603160F91B65AA3ED00 1F49EC07805CA3010392C8FC5CF003804C13070107020E14005C93C75A180E010F161E4A 151C183CA2011F5E5C60A2013F15014A4A5A1707017F150F4D5A4A147F01FF913807FF80 B9FCA295C7FC3D3E7BBD3E>69 D<9339FF8001C0030F13E0033F9038F803809239FF807E 07913A03FC001F0FDA0FF0EB071FDA1FC0ECBF00DA7F806DB4FC4AC77E495AD903F86E5A 495A130F4948157E4948157C495A13FF91C9FC4848167812035B1207491670120FA2485A 95C7FC485AA3127F5BA312FF5BA30303B512FC90C7FCA2DB000190C7FCA25FA216035FA3 16076C5E7FA2003F150F6D5D121F6D141F000F153F6C6C4A5A6C6C14F76C6CEB01E36CB4 EB07C1903A7FC03F81C090391FFFFE00010701F890C8FC010013803A4272BF46>71 D<49B648B6FC495DA2D9000390C7000313004B5D4B5DA2180714074B5DA2180F140F4B5D A2181F141F4B5DA2183F143F4B5DA2187F147F4B5DA218FF91B8FC96C7FCA292C712015B 4A5DA2170313034A5DA2170713074A5DA2170F130F4A5DA2171F131F4A5DA2173F133F4A 5DA2017F157FA24A5D496C4A7EB66CB67EA3483E7BBD44>I<49B612C0A25FD9000390C8 FC5D5DA314075DA3140F5DA3141F5DA3143F5DA3147F5DA314FF92C9FCA35B5CA313035C 18C0EF01E0010716C05C17031880130F4A140718005F131F4A141EA2173E013F5D4A14FC 1601017F4A5A16074A131F01FFECFFF0B8FCA25F333E7BBD39>76 D<49B5933807FFFC496062D90003F0FC00505ADBBF805E1A771AEF1407033F923801CFE0 A2F1039F020FEE071F020E606F6C140E1A3F021E161C021C04385BA2F1707F143C023804 E090C7FCF001C0629126780FE0495A02705FF00700F00E0114F002E0031C5BA2F0380301 0116704A6C6C5D18E019070103ED01C00280DA03805BA2943807000F13070200020E5C5F DB03F8141F495D010E4B5CA24D133F131E011CDAF9C05CEEFB80197F013C6DB4C7FC0138 95C8FC5E01784A5C13F8486C4A5CD807FE4C7EB500F04948B512FE16E01500563E7BBD52 >I<902601FFFE020FB5FC496D5CA2D900016D010013C04AEE3F00193E70141C193CEC07 BFDB3FE01438151F1978020F7FDA0E0F15708219F0EC1E07021C6D5CA203031401023C7F DA38015DA2701303EC7800027002805BA2047F130702F014C04A013F91C7FCA2715A0101 141F4AECF00EA2040F131E010315F84A151C1607EFFC3C0107140391C7143817FE040113 784915FF010E16708218F0131E011C6F5AA2173F133C01385E171F137813F8486C6F5AEA 07FEB500F01407A295C8FC483E7BBD44>I<49B77E18F018FC903B0003FE0003FEEF00FF 4BEC7F80F03FC00207151F19E05DA2020F16F0A25DA2141FF03FE05DA2023F16C0187F4B 1580A2027FEDFF00604B495A4D5A02FF4A5A4D5A92C7EA3FC04CB4C7FC4990B512FC17E0 4ACAFCA21303A25CA21307A25CA2130FA25CA2131FA25CA2133FA25CA2137FA25C497EB6 7EA33C3E7BBD3E>80 D<49B612FCEFFF8018F0903B0003FE000FF8EF03FE4BEB00FF8419 800207ED3FC05DA219E0140F5DA3021FED7FC05DA2F0FF80143F4B15004D5A60027F4A5A 4B495A4D5AEF3F8002FF02FEC7FC92380007F892B512E01780499038000FE04A6D7E707E 707E0103814A130083A213075CA25E130F5C5F1603131F5CA3013F020714404A16E05F01 7F160119C04A01031303496C1680B6D8800113079438FE0F009338007E1ECAEA3FFCEF07 F03B407BBD42>82 D<92391FE00380ED7FFC913A01FFFE0700913907F01F8F91390FC007 DF4AC66CB4FC023E6D5A4A130014FC495A4948147CA2495AA2010F15785CA3011F1570A4 6E91C7FCA2808014FE90380FFFE015FC6DEBFF8016E06D806D806D6C7F141F02037FEC00 3FED07FF1501A281A282A212075A167E120EA2001E15FE5EA25E003E14015E003F14034B 5A486C5C150F6D495A6D49C8FCD8F9F0137C39F8FE01F839F03FFFF0D8E00F13C026C001 FEC9FC314279BF33>I<001FB500F090B512F0485DA226003FF0C7380FFC004AEC03F04A 5D715A017F1503A24A5DA201FF150795C7FC91C8FCA2485E170E5BA20003161E171C5BA2 0007163C17385BA2000F167817705BA2001F16F05F5BA2003F1501A2495DA2007F1503A2 495DA2160794C8FC48C8FC5E160E161E6C151C163C5E5E5E6C6C13014B5A001F4A5A6C6C 011FC9FC6D133E6C6C13F83903FC07F0C6B512C0013F90CAFCEB07F83C406FBD44>85 D<91B690383FFFFC605E020101E0010F13006E49EB07F84C6D5A19C06F6C495A96C7FC03 3F140E705B183C031F5C705B4D5A030F5C70485A4DC8FC0307130EEEFC1E5F03035BEEFE 705F6F6C5A5FA26F90C9FC83A2707EA216FF4B7F5DED079FEE1FF0150EED1C0F03387F15 78EDF007DA01E07F15C09138038003DA07007F140E021E13014A805C02707F4A81495A49 48147F01078249C8FC013F6F7E496C147F2603FFC049487EB500F8011FEBFFE0A261463E 7CBD44>88 D<147E49B47E903907C1C38090391F80EFC090383F00FF017E137F49148048 48133F485AA248481400120F5B001F5C157E485AA215FE007F5C90C7FCA21401485C5AA2 1403EDF0385AA21407EDE078020F1370127C021F13F0007E013F13E0003E137FECF3E126 1F01E313C03A0F8781E3803A03FF00FF00D800FC133E252977A72E>97 DII101 D<1478EB01FCA21303A314F8EB00E01400AD 137C48B4FC38038F80EA0707000E13C0121E121CEA3C0F1238A2EA781F00701380A2EAF0 3F140012005B137E13FE5BA212015BA212035B1438120713E0000F1378EBC070A214F0EB 80E0A2EB81C01383148038078700EA03FEEA00F8163E79BC1C>105 D107 DII111 D<903903E001F890390FF807FE903A 1E7C1E0F80903A1C3E3C07C0013C137801389038E003E0EB783F017001C013F0ED800190 38F07F0001E015F8147E1603000113FEA2C75AA20101140717F05CA20103140F17E05CA2 0107EC1FC0A24A1480163F010F15005E167E5E131F4B5A6E485A4B5A90393FB80F80DA9C 1FC7FCEC0FFCEC03E049C9FCA2137EA213FEA25BA21201A25BA21203A2387FFFE0B5FCA2 2D3A80A72E>I114 DII<137C48B4143826038F 8013FCEA0707000E7F001E1401001C15F8EA3C0F12381503D8781F14F000701380A2D8F0 3F1307020013E012005B017E130F16C013FE5B151F1201491480A2153F000315005BA25D 157EA315FE5D00011301EBF8030000130790387C1FF8EB3FF9EB07E1EB00035DA2140700 0E5CEA3F80007F495AA24A5AD8FF0090C7FC143E007C137E00705B387801F0383803E038 1E0FC06CB4C8FCEA03F8263B79A72C>121 D E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fl cmr10 10.95 64 /Fl 64 122 df<4AB4EB0FE0021F9038E03FFC913A7F00F8FC1ED901FC90383FF03FD907 F090397FE07F80494801FF13FF4948485BD93F805C137F0200ED7F00EF003E01FE6D91C7 FC82ADB97EA3C648C76CC8FCB3AE486C4A7E007FD9FC3FEBFF80A339407FBF35>11 DI<001E130F397F803FC000FF137F01C013E0A201E0 13F0A3007F133F391E600F3000001300A401E01370491360A3000114E04913C000031301 01001380481303000EEB070048130E0018130C0038131C003013181C1C7DBE2D>34 D<121EEA7F8012FF13C0A213E0A3127FEA1E601200A413E013C0A312011380120313005A 120E5A1218123812300B1C79BE19>39 D<1430147014E0EB01C0EB03801307EB0F00131E 133E133C5B13F85B12015B1203A2485AA2120F5BA2121F90C7FCA25AA3123E127EA6127C 12FCB2127C127EA6123E123FA37EA27F120FA27F1207A26C7EA212017F12007F13787F13 3E131E7FEB07801303EB01C0EB00E014701430145A77C323>I<12C07E12707E7E121E7E 6C7E7F12036C7E7F12007F1378137CA27FA2133F7FA21480130FA214C0A3130714E0A613 0314F0B214E01307A614C0130FA31480A2131F1400A25B133EA25BA2137813F85B12015B 485A12075B48C7FC121E121C5A5A5A5A145A7BC323>I<1506150FB3A9007FB912E0BA12 F0A26C18E0C8000FC9FCB3A915063C3C7BB447>43 D<121EEA7F8012FF13C0A213E0A312 7FEA1E601200A413E013C0A312011380120313005A120E5A1218123812300B1C798919> II<121EEA7F80A2EAFFC0A4EA7F80A2EA1E000A0A798919>III<00061403D80780131F01F813FE90B5FC5D5D5D 15C092C7FC14FCEB3FE090C9FCACEB01FE90380FFF8090383E03E090387001F8496C7E49 137E497F90C713800006141FC813C0A216E0150FA316F0A3120C127F7F12FFA416E090C7 121F12FC007015C012780038EC3F80123C6CEC7F00001F14FE6C6C485A6C6C485A3903F8 0FE0C6B55A013F90C7FCEB07F8243F7CBC2D>53 D<121EEA7F80A2EAFFC0A4EA7F80A2EA 1E00C7FCB3121EEA7F80A2EAFFC0A4EA7F80A2EA1E000A2779A619>58 D<007FB912E0BA12F0A26C18E0CDFCAE007FB912E0BA12F0A26C18E03C167BA147>61 D<15074B7EA34B7EA34B7EA34B7EA34B7E15E7A2913801C7FC15C3A291380381FEA34AC6 7EA3020E6D7EA34A6D7EA34A6D7EA34A6D7EA34A6D7EA349486D7E91B6FCA24981913880 0001A249C87EA24982010E157FA2011E82011C153FA2013C820138151FA2017882170F13 FC00034C7ED80FFF4B7EB500F0010FB512F8A33D417DC044>65 DIIIIIIII75 DIIIIIIII<003FB91280A3903AF0007FE001018090393FC0003F48C7ED1FC0007E170712 7C00781703A300701701A548EF00E0A5C81600B3B14B7E4B7E0107B612FEA33B3D7DBC42 >IIII<007FB5D8C003B512E0A3C649C7EBFC00D93FF8EC3FE06D48 EC1F806D6C92C7FC171E6D6C141C6D6C143C5F6D6C14706D6D13F04C5ADA7FC05B023F13 036F485ADA1FF090C8FC020F5BEDF81E913807FC1C163C6E6C5A913801FF7016F06E5B6F 5AA26F7E6F7EA28282153FED3BFEED71FF15F103E07F913801C07F0203804B6C7EEC0700 4A6D7E020E6D7E5C023C6D7E02386D7E14784A6D7E4A6D7F130149486E7E4A6E7E130749 C86C7E496F7E497ED9FFC04A7E00076DEC7FFFB500FC0103B512FEA33F3E7EBD44>II<486C13C00003130101001380481303 000EEB070048130E0018130C0038131C003013180070133800601330A300E01370481360 A400CFEB678039FFC07FE001E013F0A3007F133FA2003F131F01C013E0390F0007801C1C 73BE2D>92 D97 DI<49B4FC010F13E090383F00F8017C131E4848131F4848137F0007ECFF8048 5A5B121FA24848EB7F00151C007F91C7FCA290C9FC5AAB6C7EA3003FEC01C07F001F1403 16806C6C13076C6C14000003140E6C6C131E6C6C137890383F01F090380FFFC0D901FEC7 FC222A7DA828>IIII<167C903903F801FF903A1FFF078F809039 7E0FDE1F9038F803F83803F001A23B07E000FC0600000F6EC7FC49137E001F147FA8000F 147E6D13FE00075C6C6C485AA23901F803E03903FE0FC026071FFFC8FCEB03F80006CAFC 120EA3120FA27F7F6CB512E015FE6C6E7E6C15E06C810003813A0FC0001FFC48C7EA01FE 003E140048157E825A82A46C5D007C153E007E157E6C5D6C6C495A6C6C495AD803F0EB0F C0D800FE017FC7FC90383FFFFC010313C0293D7EA82D>III107 DI<2701F801FE14FF 00FF902707FFC00313E0913B1E07E00F03F0913B7803F03C01F80007903BE001F87000FC 2603F9C06D487F000101805C01FBD900FF147F91C75B13FF4992C7FCA2495CB3A6486C49 6CECFF80B5D8F87FD9FC3F13FEA347287DA74C>I<3901F801FE00FF903807FFC091381E 07E091387803F000079038E001F82603F9C07F0001138001FB6D7E91C7FC13FF5BA25BB3 A6486C497EB5D8F87F13FCA32E287DA733>I<14FF010713E090381F81F890387E007E01 F8131F4848EB0F804848EB07C04848EB03E0000F15F04848EB01F8A2003F15FCA248C812 FEA44815FFA96C15FEA36C6CEB01FCA3001F15F86C6CEB03F0A26C6CEB07E06C6CEB0FC0 6C6CEB1F80D8007EEB7E0090383F81FC90380FFFF0010090C7FC282A7EA82D>I<3901FC 03FC00FF90381FFF8091387C0FE09039FDE003F03A07FFC001FC6C496C7E6C90C7127F49 EC3F805BEE1FC017E0A2EE0FF0A3EE07F8AAEE0FF0A4EE1FE0A2EE3FC06D1580EE7F007F 6E13FE9138C001F89039FDE007F09039FC780FC0DA3FFFC7FCEC07F891C9FCAD487EB512 F8A32D3A7EA733>I<02FF131C0107EBC03C90381F80F090397F00387C01FC131CD803F8 130E4848EB0FFC150748481303121F485A1501485AA448C7FCAA6C7EA36C7EA2001F1403 6C7E15076C6C130F6C7E6C6C133DD8007E137990383F81F190380FFFC1903801FE0190C7 FCAD4B7E92B512F8A32D3A7DA730>I<3901F807E000FFEB1FF8EC787CECE1FE3807F9C1 00031381EA01FB1401EC00FC01FF1330491300A35BB3A5487EB512FEA31F287EA724>I< 90383FC0603901FFF8E03807C03F381F000F003E1307003C1303127C0078130112F81400 A27E7E7E6D1300EA7FF8EBFFC06C13F86C13FE6C7F6C1480000114C0D8003F13E0010313 F0EB001FEC0FF800E01303A214017E1400A27E15F07E14016C14E06CEB03C09038800780 39F3E01F0038E0FFFC38C01FE01D2A7DA824>I<131CA6133CA4137CA213FCA212011203 1207001FB512C0B6FCA2D801FCC7FCB3A215E0A912009038FE01C0A2EB7F03013F138090 381F8700EB07FEEB01F81B397EB723>IIIIII E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fm cmbx10 10.95 30 /Fm 30 122 df<16FCA24B7EA24B7EA34B7FA24B7FA34B7FA24B7FA34B7F157C03FC7FED F87FA2020180EDF03F0203804B7E02078115C082020F814B7E021F811500824A81023E7F 027E81027C7FA202FC814A147F49B77EA34982A2D907E0C7001F7F4A80010F835C83011F 8391C87E4983133E83017E83017C81B500FC91B612FCA5463F7CBE4F>65 DI<9226 07FFC0130E92B500FC131E020702FF133E023FEDC07E91B7EAE1FE01039138803FFB4990 39F80003FF4901C01300013F90C8127F4948151FD9FFF8150F48491507485B4A15034817 01485B18004890CAFC197E5A5B193E127FA349170012FFAC127F7F193EA2123FA27F6C18 7E197C6C7F19FC6C6D16F86C6D150119F06C6D15036C6DED07E0D97FFEED0FC06D6CED3F 80010F01C0ECFF006D01F8EB03FE6D9039FF801FFC010091B55A023F15E0020715800200 02FCC7FC030713C03F407ABE4C>I69 DI73 D75 DIIIIIII<903A03FFC001C0011FEBF803017FEBFE0748B6 128F4815DF48010013FFD80FF8130F48481303497F4848EB007F127F49143F161F12FF16 0FA27F1607A27F7F01FC91C7FCEBFF806C13F8ECFFC06C14FCEDFF806C15E016F86C816C 816C816C16806C6C15C07F010715E0EB007F020714F0EC003F1503030013F8167F163F12 7800F8151FA2160FA27EA217F07E161F6C16E06D143F01E015C001F8EC7F8001FEEB01FF 9026FFE00713004890B55A486C14F8D8F81F5CD8F00314C027E0003FFEC7FC2D407ABE3A >I<003FB912FCA5903BFE003FFE003FD87FF0EE0FFE01C0160349160190C71500197E12 7EA2007C183EA400FC183F48181FA5C81600B3AF010FB712F8A5403D7CBC49>IIII< 903807FFC0013F13F848B6FC48812607FE037F260FF8007F6DEB3FF0486C806F7EA36F7E A26C5A6C5AEA01E0C8FC153F91B5FC130F137F3901FFFE0F4813E0000F1380381FFE0048 5A5B485A12FF5BA4151F7F007F143F6D90387BFF806C6C01FB13FE391FFF07F36CEBFFE1 00031480C6EC003FD91FF890C7FC2F2B7DA933>97 D<13FFB5FCA512077EAFEDFFE00207 13FC021FEBFF80027F80DAFF8113F09139FC003FF802F06D7E4A6D7E4A13074A80701380 A218C082A318E0AA18C0A25E1880A218005E6E5C6E495A6E495A02FCEB7FF0903AFCFF01 FFE0496CB55AD9F01F91C7FCD9E00713FCC7000113C033407DBE3A>IIII111 D<3901FE01FE00FF903807FF804A13E04A13F0EC3F1F91387C3FF8000713F8000313F0EB FFE0A29138C01FF0ED0FE091388007C092C7FCA391C8FCB3A2B6FCA525297DA82B>114 D<90383FFC1E48B512BE000714FE5A381FF00F383F800148C7FC007E147EA200FE143EA2 7E7F6D90C7FC13F8EBFFE06C13FF15C06C14F06C806C806C806C80C61580131F13000207 13C014000078147F00F8143F151F7EA27E16806C143F6D140001E013FF9038F803FE90B5 5A15F0D8F87F13C026E00FFEC7FC222B7DA929>II119 D121 D E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fn cmr12 12 94 /Fn 94 128 df<9239FFC001FC020F9038F80FFF913B3F803E3F03C0913BFC00077E07E0 D903F890390FFC0FF0494890383FF81F4948EB7FF0495A494814E049C7FCF00FE0499139 3FC0038049021F90C7FCAFB912F0A3C648C7D81FC0C7FCB3B2486CEC3FF0007FD9FC0FB5 12E0A33C467EC539>11 D<4AB4FC020F13E091387F80F8903901FC001C49487FD907E013 0F4948137F011FECFF80495A49C7FCA25B49EC7F00163E93C7FCACEE3F80B8FCA3C648C7 FC167F163FB3B0486CEC7FC0007FD9FC1FB5FCA330467EC536>I<913801FFC0020FEBFB 8091387F803F903801FC00494813FFEB07E0EB1FC0A2495A49C7FC167F49143F5BAFB8FC A3C648C7123FB3B2486CEC7FC0007FD9FC1FB5FCA330467EC536>III<121EEA7F80EAFFC0A9EA7F80ACEA3F00AB121EAC120CA5C7FCAA121EEA7F80A2 EAFFC0A4EA7F80A2EA1E000A4778C61B>33 D<001EEB03C0397F800FF000FF131F01C013 F8A201E013FCA3007F130F391E6003CC0000EB000CA401E0131C491318A3000114384913 300003147090C712604814E0000614C0000E130148EB038048EB070048130E0060130C1E 1D7DC431>I<1438A549B4FC010F13E0013F13F89038FE38FED801F0EB0F80D807E0EB03 C001C0EB01E0D80F801300D81F001470003E15301638481518A2007815FC00F814031507 A47EED03F8ED01F06C91C7FC127E127F1380EA3FC013F0EA1FF8EBFFB86C13F86CEBFF80 6C14E06C14F86C6C7F6D13FF010714801300023F13C0023813E0ED3FF0151F150FED07F8 1503150116FC001C1400127FEAFF80167CA413005A00E01578006015F8A2007015F00030 1401003815E0003C1403001CEC07C0000FEC0F80D80780EB1F00D803E0137E3901FC39FC 39007FFFF0011F13C0D903FEC7FCEB0038A526517BCA31>36 DII<121EEA7F8012FF13C0A213E0A3127FEA1E601200A413E013C0A312 011380120313005A1206120E5A5A5A12600B1D78C41B>I<140C141C1438147014E0EB01 C01303EB0780EB0F00A2131E5BA25B13F85B12015B1203A2485AA3485AA348C7FCA35AA2 123EA2127EA4127CA312FCB3A2127CA3127EA4123EA2123FA27EA36C7EA36C7EA36C7EA2 12017F12007F13787FA27F7FA2EB0780EB03C01301EB00E014701438141C140C166476CA 26>I<12C07E12707E7E7E120F6C7E6C7EA26C7E6C7EA21378137C133C133E131E131FA2 EB0F80A3EB07C0A3EB03E0A314F0A21301A214F8A41300A314FCB3A214F8A31301A414F0 A21303A214E0A3EB07C0A3EB0F80A3EB1F00A2131E133E133C137C13785BA2485A485AA2 485A48C7FC120E5A5A5A5A5A16647BCA26>I<14F0A2805CA70078EC01E000FCEC03F0B4 140FD87F80EB1FE0D83FC0EB3FC03A0FF060FF003903F861FC3900FC63F090383F6FC0D9 0FFFC7FCEB03FCEB00F0EB03FCEB0FFF90383F6FC09038FC63F03903F861FC390FF060FF 3A3FC0F03FC0D87F80EB1FE0D8FF00EB0FF000FC14030078EC01E0C790C7FCA7805CA224 2B7ACA31>I<16C04B7EB3AB007FBAFCBB1280A26C1900C8D801E0C9FCB3AB6F5A41407B B84C>I<121EEA7F8012FF13C0A213E0A3127FEA1E601200A413E013C0A3120113801203 13005A1206120E5A5A5A12600B1D78891B>II<121EEA7F80A2EA FFC0A4EA7F80A2EA1E000A0A78891B>I<1618163C167CA2167816F8A216F01501A216E0 1503A216C01507A21680150FA2ED1F00A2151E153EA2153C157CA2157815F8A25D1401A2 4A5AA25D1407A25D140FA292C7FC5CA2141E143EA2143C147CA25CA25C1301A25C1303A2 5C1307A25C130FA291C8FC5BA2133EA2133C137CA2137813F8A25B1201A25B1203A2485A A25B120FA290C9FC5AA2121E123EA2123C127CA2127812F8A25A126026647BCA31>I<14 FF010713E090381F81F890383E007C01FC133F4848EB1F8049130F4848EB07C04848EB03 E0A2000F15F0491301001F15F8A2003F15FCA390C8FC4815FEA54815FFB3A46C15FEA56D 1301003F15FCA3001F15F8A26C6CEB03F0A36C6CEB07E0000315C06D130F6C6CEB1F806C 6CEB3F00013E137C90381F81F8903807FFE0010090C7FC28447CC131>I<143014F01301 1303131F13FFB5FC13E713071200B3B3B0497E497E007FB6FCA3204278C131>II<49B4FC010F13E0013F13FC9038FE01FE3A01 F0007F80D803C0EB3FC048C7EA1FE0120EED0FF0EA0FE0486C14F8A215077F5BA26C4813 0FEA03C0C813F0A3ED1FE0A2ED3FC01680ED7F0015FE4A5AEC03F0EC1FC0D90FFFC7FC15 F090380001FCEC007FED3F80ED1FC0ED0FE016F0ED07F816FC150316FEA2150116FFA312 1EEA7F80487EA416FE491303A2007EC713FC00701407003015F80038140F6C15F06CEC1F E06C6CEB3FC0D803E0EB7F803A01FE01FE0039007FFFF8010F13E0010190C7FC28447CC1 31>II<000615C0D807C0130701FCEB7F8090B612005D5D5D15E0158026063F FCC7FC90C9FCAE14FF010713C090381F01F090383800FC01F0137ED807C07F49EB1F8016 C090C7120F000615E0C8EA07F0A316F81503A216FCA5123E127F487EA416F890C712075A 006015F0A20070140F003015E00038EC1FC07E001EEC3F806CEC7F006C6C13FE6C6C485A 3901F807F039007FFFE0011F90C7FCEB07F826447BC131>II<121CA2EA1F8090B712C0A3481680A217005E0038C8120C0030151C00705D0060 153016705E5E4814014B5A4BC7FCC81206150E5D151815385D156015E04A5AA24A5A1407 92C8FC5CA25C141E143EA2147E147CA214FCA21301A3495AA41307A6130FAA6D5AEB01C0 2A457BC231>I<14FF010713E0011F13F890387F00FE01FC133FD801F0EB1F804848EB0F C049EB07E00007EC03F048481301A290C713F8481400A47FA26D130116F07F6C6CEB03E0 13FC6C6CEB07C09039FF800F806C9038C01F006CEBF03EECF87839007FFEF090383FFFC0 7F01077F6D13F8497F90381E7FFFD97C1F1380496C13C02601E00313E048486C13F00007 9038007FF84848EB3FFC48C7120F003EEC07FE150148140016FF167F48153FA2161FA56C 151E007C153EA2007E153C003E157C6C15F86DEB01F06C6CEB03E06C6CEB07C0D803F8EB 1F80C6B4EBFF0090383FFFFC010F13F00101138028447CC131>I<14FF010713E0011F13 F890387F80FC9038FC007E48487F4848EB1F804848EB0FC0000FEC07E0485AED03F0485A 16F8007F140190C713FCA25AA216FE1500A516FFA46C5CA36C7E5D121F7F000F5C6C6C13 0E150C6C6C131C6C6C5BD8007C5B90383F01E090390FFF80FE903801FE0090C8FC150116 FCA4ED03F8A216F0D80F801307486C14E0486C130F16C0ED1F80A249EB3F0049137E001E C75A001C495A000F495A3907E01FE06CB51280C649C7FCEB1FF028447CC131>I<121EEA 7F80A2EAFFC0A4EA7F80A2EA1E00C7FCB3A5121EEA7F80A2EAFFC0A4EA7F80A2EA1E000A 2B78AA1B>I<121EEA7F80A2EAFFC0A4EA7F80A2EA1E00C7FCB3A5121E127FEAFF80A213 C0A4127F121E1200A512011380A3120313005A1206120E120C121C5A5A12600A3E78AA1B >I<121EEA7F80A2EAFFC0A4EA7F80A2EA1E00C7FCAA120CA5121EAC123FABEA7F80ACEA FFC0A9EA7F80EA1E000A4778B11B>I<007FBAFCBB1280A26C1900CEFCB0007FBAFCBB12 80A26C190041187BA44C>IIII<16C04B7EA34B7EA34B7EA34B7EA3ED19FEA3ED30FFA203 707FED607FA203E07FEDC03FA2020180ED801FA2DA03007F160FA20206801607A24A6D7E A34A6D7EA34A6D7EA20270810260147FA202E08191B7FCA249820280C7121FA249C87F17 0FA20106821707A2496F7EA3496F7EA3496F7EA201788313F8486C83D80FFF03037FB500 E0027FEBFFC0A342477DC649>IIIIIIIII<010FB512FEA3D9000313806E130080B3B3AB123F487E487E A44A5A13801300006C495A00705C6C13076C5C6C495A6CEB1F802603E07FC7FC3800FFFC EB1FE027467BC332>IIIIIII82 D<49B41303010FEBE007013F13F89039FE00FE0FD801F8131FD807E0 EB079F49EB03DF48486DB4FC48C8FC4881003E81127E82127C00FC81A282A37E82A27EA2 6C6C91C7FC7F7FEA3FF813FE381FFFE06C13FE6CEBFFE06C14FC6C14FF6C15C0013F14F0 010F80010180D9001F7F14019138001FFF03031380816F13C0167F163F161F17E000C015 0FA31607A37EA36C16C0160F7E17806C151F6C16006C5D6D147ED8FBC05CD8F9F0495AD8 F07C495A90393FC00FE0D8E00FB51280010149C7FC39C0003FF02B487BC536>I<003FB9 12F8A3903BF0001FF8001F01806D481303003EC7150048187C0078183CA20070181CA300 60180CA5481806A5C81600B3B3A54B7EED7FFE49B77EA33F447DC346>IIII89 D<001FB81280A39126800001130001FCC7FC01F04A5A01C04A5A5B90C8485A121E4C5A48 4B5AA200384B5A4C5AA24B90C7FC00304A5AA24B5AA24B5AC8485AA24B5A4B5AA24B5A5C 93C8FC4A5AA24A5A4A5AA24A5A4A5AA24A5A14FF5D4990C9FCEF0180495A495AA2495A49 4814031800495AA2495A495A5F4890C8FC485A5F485A48485D5F48485D17FE4848140348 48140F16FFB8FCA331447BC33C>II<01C01318000114384848137048C712E0000EEB01C0000C1480001C130300181400 00385B003013060070130E0060130CA300E0131C481318A400CFEB19E039FFC01FF801E0 13FCA3007F130FA2003F130701C013F8390F0001E01E1D71C431>II<130C131E133F497EEBF3C03801E1E03803C0F038 07807848487E001E7F487F0070EB038048EB01C00040EB00801A0E75C331>I<13C01201 EA0380EA0700120E120C121C12181238123012701260A312E05AA412CFEAFFC013E0A312 7FA2123F13C0EA0F000B1D79C41B>96 DIII<167FED3FFFA315018182B3EC 7F80903803FFF090380FC07C90383F000E017E1307496D5AD803F87F48487F5B000F8148 5AA2485AA2127FA290C8FC5AAB7E7FA2123FA26C7EA2000F5D7F6C6C5B00035C6C6C9038 077F806C6C010E13C0013F011C13FE90380FC0F8903803FFE09026007F0013002F467DC4 36>IIIIII<143C14FFA2491380A46D13 00A2143C91C7FCADEC7F80EB3FFFA31300147F143FB3B3AA123E127F39FF807F00A2147E A25C6C485A383C01F06C485A3807FF80D801FEC7FC195785C21E>IIII<3901FC01FE00FF903807FFC09138 1E07F091383801F8000701707F0003EBE0002601FDC07F5C01FF147F91C7FCA25BA35BB3 A8486CECFF80B5D8F83F13FEA32F2C7DAB36>II<3901FC03FC00FF90380FFF8091383C07E091387001F83A07FDE000FE0003018013 7FD801FFEC3F8091C7EA1FC04915E049140F17F0160717F8160317FCA3EE01FEABEE03FC A3EE07F8A217F0160F6D15E0EE1FC06D143F17806EEB7E00D9FDC05B9039FCF003F89138 3C0FE091381FFF80DA03FCC7FC91C9FCAE487EB512F8A32F3F7DAB36>I<91387F800390 3903FFE00790380FE07890393F801C0F90387E000E496D5AD803F8EB039F0007EC01BF49 14FF48487F121F5B003F81A2485AA348C8FCAB6C7EA3123F7F121F6D5C120F6D5B12076C 6C5B6C6C497E6C6C130E013F131C90380FC0F8903803FFE09038007F0091C7FCAEEEFF80 033F13FEA32F3F7DAB33>I<3903F803F000FFEB1FFCEC3C3EEC707F0007EBE0FF3803F9 C000015B13FBEC007E153C01FF13005BA45BB3A748B4FCB512FEA3202C7DAB26>I<9038 3FE0183901FFFC383907E01F78390F0003F8001E1301481300007C1478127800F81438A2 1518A27EA27E6C6C13006C7E13FC383FFFE06C13FC6C13FF6C14C06C14E0C614F0011F13 F81300EC0FFC140300C0EB01FE1400157E7E153EA27EA36C143C6C147C15786C14F86CEB 01F039F38003E039F1F00F8039E07FFE0038C00FF01F2E7DAC26>I<1306A5130EA4131E A3133E137EA213FE12011207001FB512F0B6FCA2C648C7FCB3A4150CAA017E131C017F13 18A26D133890381F8030ECC070903807E0E0903801FFC09038007F001E3E7EBC26>II< B539F001FFFCA3000790C7EA7FE06C48EC1F8000011600160E1200160C017F5CA280013F 5CA26E1370011F146080010F5CA2ECF00101075CA26D6C48C7FCA26E5A01011306A26D6C 5AA214FF6E5AA215B8EC3FB015F06E5AA36E5AA26E5AA36EC8FC2E2C7EAA33>IIII<003FB612E0A29038C0003F 90C713C0003CEC7F800038ECFF00A20030495A0070495AA24A5A0060495AA24A5A4A5AA2 C7485A4AC7FC5B5C495A13075C495A131F4A1360495A495AA249C712C0485AA2485A485A 1501485A48481303A24848EB07804848131F00FF14FF90B6FCA2232B7DAA2B>III<001EEB0780007FEB0FE039FF801FF0EBC03FA4 EB801F397F000FE0001EEB07801C0A76C231>127 D E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fo cmr12 14.4 28 /Fo 28 122 df<120FEA3FC0EA7FE012FF13F0A213F8A3127F123FEA0F381200A5137813 70A313F013E0A2120113C0120313801207EA0F00121EA25A5A12300D23768B21>44 D<120FEA3FC0EA7FE0EAFFF0A6EA7FE0EA3FC0EA0F000C0C768B21>46 D48 D50 DI<000316C001C0140301F8141F903A FFC003FF8091B612005E5E5E16E016804BC7FC019F13F8018113800180C9FCB0EC0FF0EC FFFE01836D7E903987F01FE090399F0007F801BE6D7E01F86D7E496D7E49EC7F805BEE3F C04915E0C9121F17F0A317F8160FA317FCA5120EEA3F80487E12FF7FA217F85B161F5B48 C813F012700078ED3FE0A26C16C0167F6CEDFF80001F16006C6C495A6C6C13036C6CEB07 F8D801F8EB1FF06CB4EB7FE06DB51280011F49C7FC010713F8010013C02E517ACE3B>53 D 65 D67 D69 D<49B612FEA490C7003F138092380FFE001507B3B3B3A21206EA3FC0487E487EA44B5AA2 5B007F5D0180131F0078C75B6C143F003E4A5A6C5D6C6C495A2707E003FEC7FC3901FC07 FC6CB512F0013F13C0D907FCC8FC2F547BD13C>74 D77 D82 D<003FBB12C0A449C79038F0000701F06E 48130001C0183F48C8EE0FE0007E1907007C1903A200781901A400701900A500F01AF048 1A70A6C91700B3B3AC4C7E030313FC027FB712E0A44C517CD055>84 D97 DII101 D 103 DI108 D<01FFD907FEEC03FFB590261FFFC0010F13E0 037F01F0013F13F8912701F80FFC9038FC07FE913D03C003FE01E001FF00039026070001 9038038000C6010E6D6C48C76C7E6D48DA7F8E6E7E4A159CA24ADA3FF86E7E02605D14E0 4A5DA34A5DB3AD2601FFE0DAFFF0EC7FF8B6D8C07F9026FFE03FB512F0A45C347CB363> I111 D<90397F8007FCB590387FFF800281B512E0913987 F00FF891398F8003FC000390399E0001FFC601BC6D7FD97FF86E7E4A6E7E4A6E7E4A140F 844A6E7EA2717EA3717EA4711380AB4D1300A44D5AA24D5AA2606E140F4D5A6E5D6E4A5A 6E4A5A02BC4AC7FC029E495A028FEB07FC913987E01FF00281B512C0DA807F90C8FCED0F F892CAFCB13801FFE0B612C0A4394B7DB341>I<01FFEB1F80B5EB7FF0913801FFF89138 03E1FC91380783FE0003EB0F07C6131EEB7F1C1438143091387003FC91386000F0160014 E05CA45CB3AA8048487EB612F0A427347DB32E>114 DIII121 D E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fp cmbxti10 12 8 /Fp 8 116 df54 D<007FB6023FB51280B76C4914C0A293C7 FC721480C649C9EBE00073C7FC19FE017F5F1801614E5A18076E5E4E5A181F6D5F183F4E C8FC187E6F14FE604D5A6D1503604D5A170F606F131F4D5A95C9FC6D5D177E5F160103E0 5B4C5A16076D5D160F4C5A5FEDF03F94CAFC167E6D14FE5EEDF1F815F35E15FF5E5E7F5E 93CBFCA25DA25D6D5BA25D5DA25D5DA26ECCFC147E4A466AC356>86 D<4AB47E021F13F091B512FC01038049EB81FF903A1FFE007F80D93FF8133F495A494814 C04849131F4849133F4890C71380A248157F484815005E4848EB03FEED0FFCED7FF848B6 5A16C093C7FC15F0D8FFF8C9FC5BA45BA51606007F150FEE1F80163F6C6C14FF4B13006C 6CEB07FE6C6CEB3FFC3A07FF01FFF06C90B55AC615806D01FCC7FC010713802A2E75AC35 >101 D105 D110 D<913801FFC0021F13FC027F13FF49B61280010701C113C0903A0FFE003FE0D91FF8EB1F F0D97FF014F84948EB0FFC485B5C4816FE4890C7FC5A5B121F5B123F161F127F5BA2163F 12FF4915FCA2167F17F85B17F016FF17E05D17C04B1380007F16005D4B5A6C6C495A001F EC3FF06C6CEBFFE02607FF075B6C90B5C7FC6C14FC6C6C13F0010790C8FC2F2E75AC3B> I<90393F8001FF9026FFE00F13E048D9F83F13F0486D4813F83B07E3FEFF03FC3B0FC3FF FC00FEEDF803D81F839038E007FF5ED83F0313C049495A127F007E020013FEA249EC0FFC 00FEED07F8007C49EB03E0000092C7FC131FA25CA2133FA25CA2137FA25CA213FFA25CA2 5AA25CA25AA25CA391C9FC6C5AEA00F8302E79AC32>114 DI E %EndDVIPSBitmapFont %DVIPSBitmapFont: Fq cmbx12 20.74 18 /Fq 18 122 df76 D<922603FFF8150E037FD9FFC0143F0203B600FC5C02 1F03FF5C027FEEC00149B8EAF00349EFFC07010FDA000F13FE4901F09039007FFF8F4901 C0020F13DF4990C8000390B5FC494815004801F8163F48844A8248498248844A8248844A 834885A291CB7E5A86A286B5FC8680A28680A280A26E8380806E187E6E95C7FC6C8015E0 15FCEDFFC06C15FCEEFFE06C16FF18F06CEFFF8019F06C18FE737E6C856C19F06C19FC6D 846D846D856D856D850101856D85023F846E841407020084031F18801500040F17C0EE00 7F050716E0EF003F1803DE007F14F0191F8585070114F8A28586007E85B4FC86A286A37F 86A36D1AF0A37F1CE06D60A26D1AC06D607F6D1A806E5F6E4D13006E606E17FF02FC4C5B 02FF4C5B03E04B5B03FC031F5B01FBD9FF80027F5B01F102FE0107B55AD9E07F90B8C7FC 6E17FCD9C00F5FD9800317E090C76C168048020F4BC8FC48020015F00070030349C9FC55 7A75F76C>83 D<001FC012F8A7481FFC03F0C76C91C7120F92C8EF007F02F81B1F02E01B 0702801B0191C984491D7F491D3F491D1FA2491D0FA2491D07007F1FFEA2491D03A4491D 01A700FF1FFF90CA85A6CB1A00B3B3B3AD4ABC12C0A8787479F387>I<92383FFFF80207 B612E0027F15FC49B87E010717E0011F83499026F0007F13FC4948C7000F7F90B502036D 7E486E6D806F6D80727F486E6E7F8486727FA28684A26C5C72806C5C6D90C8FC6D5AEB0F F8EB03E090CAFCA70507B6FC041FB7FC0303B8FC157F0203B9FC021FECFE0391B6128001 03ECF800010F14C04991C7FC017F13FC90B512F04814C0485C4891C8FC485B5A485B5C5A 5CA2B5FC5CA360A36E5DA26C5F6E5D187E6C6D846E4A48806C6D4A4814FC6C6ED90FF0EC FFFC6C02E090263FE07F14FE00019139FC03FFC06C91B6487E013F4B487E010F4B130701 0303F01301D9003F0280D9003F13FC020101F8CBFC57507ACE5E>97 D<903801FFFCB6FCA8C67E131F7FB3ADF0FFFC050FEBFFE0057F14FE0403B77E040F16E0 043F16F84CD9007F13FE9226FDFFF001077F92B500C001018094C86C13E004FC6F7F4C6F 7F04E06F7F4C6F7F5E747F93C915804B7014C0A27414E0A21DF087A21DF8A31DFC87A41D FEAF1DFCA4631DF8A31DF098B5FC1DE0A25014C0A26F1980501400705D705F704B5B505B 704B5B04FC4B5BDBE7FE92B55A9226C3FF8001035C038101E0011F49C7FC9226807FFC90 B55A4B6CB712F04A010F16C04A010393C8FC4A010015F84A023F14C090C9000301F0C9FC 5F797AF76C>I<93383FFFF00307B612C0033F15F84AB712FE0207707E021F17E0027F83 91B526FC001F7F010302C001037F4991C7487F49495C495B4901F04A7F5B90B55A485CA2 485C4891C8FCA248715B5C48715B725B4A6F5B489438007FC0071FC7FC96C8FC5AA25CA3 B5FCAF7E80A47E80A27E806CF11F80F23FC06C6E167FA26C6EEEFF80816C606C6E17006D 6D4B5A6D6D15076D6D4B5A6D6D6C4A5A6D02E0EC7FF06D02F849485A01009126FF801F5B 6E91B6C7FC021F5E020716F8020116E06E6C1580030702FCC8FCDB003F13804A507ACE56 >I<93387FFF80030FB512FC037FECFF804AB712E0020716F8021F16FE027FD9F8077F49 B5D8C000804991C7003F13E04901FC020F7F49496E7F49498049496E7F49496E7F90B55A 48727E92C914804884485B1BC048841BE0485BA27313F05AA25C5AA21BF885A2B5FCA391 BAFCA41BF002F8CCFCA67EA3807EA47E806CF103F0F207F86C7F1A0F6C6E17F06C191F6F 17E06C6E163F6D6DEE7FC06D6D16FF6D6D4B13806D6D4B13006D6D6CEC0FFE6D02E0EC3F FC6D02F8ECFFF86D9126FFC00F5B023F91B65A020F178002034CC7FC020016F8031F15E0 030392C8FCDB000F13E04D507BCE58>101 D<903801FFFCB6FCA8C67E131F7FB3AD9538 0FFFE095B512FE05036E7E050F15E0053F15F84D81932701FFF01F7F4CD900077FDC07FC 6D80DC0FF06D80DC1FC07F4C48824CC8FC047E6F7F5EEDFDF85E03FF707F5EA25EA25EA2 93C9FCA45DB3B3A6B8D8E003B81280A8617879F76C>104 DI<903801FFFC B6FCA8C67E131F7FB3AE0603B612FEA8DE001F01F8C7FC070713804F90C8FCF13FFE4F5A F1FFF04E5B4E5B4E5B061F90C9FC4E5AF07FF84E5A4D5B05075B4D5B4D48CAFC4D5A4D5A 4D5A04035B4C7F4C7F5E4C7F4C7F03FDB6FC92B7FC858585A204F98004E0804C804C7E4C 6C7F4B6D7F4B824B7F7180718086837180727F8684727F72808784728072808784737F73 7F87854F14C0B8D88007B712F0A85C787AF766>107 D<903801FFFCB6FCA8C67E131F7F B3B3B3B3B3ABB812C0A82A7879F735>I<902601FFF891260FFFE093383FFF80B692B500 FE0303B512F805036E6C020F14FE050F03E0023F6E7E053F03F891B712E04D6F49829327 01FFF01F6D0107D9C07F7F4CD900076D90270FFC001F7FDC07FC6D9126801FF06D7FC66C DA0FF06D9126C03FC06D7F011FDA1FC06D4BC77E6D4A48DCE0FE834CC8ECE1FC047E6FD9 F1F86E804CEFF3F0DBF9F8EFF7E04C6003FB7001FF6F804C6015FF4C95C9FCA24C5FA293 C95CA44B60B3B3A6B8D8E003B8D8800FB712FEA8974E79CDA2>I<93381FFFE00303B6FC 031F15E092B712FC020316FF020F17C0023FD9FC0014F091B500C0010F13FC4991C70003 7F4901FC02007F010F496F13C049496F7F49496F7F4B8149496F7F90B5C96C7F4886A248 49707F481B80A248497014C0A2481BE0A348497113F0A3481BF8A5B51AFCAE6C1BF8A46C 1BF06E94B5FCA36C1BE0A26C6D4C14C0A26C1B806E5E6C1B006C6E4B5BA26C6E4B5B6D6D 4B5B6D6D4B5B6D6D4B5B6D6D92B55A6D01FF02035C6D02C0010F91C7FC010002FC90B512 FC6E90B75A021F17E00207178002014CC8FCDA003F15F0030392C9FCDB001F13E056507B CE61>111 D<902601FFFCEC7FFEB6020FB512F0057F14FE4CB712C0040716F0041F8204 7F16FE93B5C66C7F92B500F0010F14C0C66C0380010380011F4AC76C806D4A6E8004F06F 7F4C6F7F4C6F7F4C8193C915804B7014C0861DE0A27414F0A27414F8A47513FCA57513FE AF5113FCA598B512F8A31DF0621DE0621DC0621D806F5E701800704B5B505B704B5B7092 B55A04FC4A5C704A5C706C010F5C05E0013F49C7FC9227FE7FFC01B55A70B712F0040F16 C0040393C8FC040015F8053F14C0050301F0C9FC94CCFCB3A6B812E0A85F6F7ACD6C>I< 902601FFF8EB07FEB691383FFFC094B512F00403804C14FE4C8093261FFC3F138093263F E07F13C0DC7F80B5FCC66C5D011FDAFE0114E06DEBF9FC16F815FB16F016E015FF16C071 14C05E72138095381FFE0093C76C5AF001E095C8FCA25DA65DB3B3A2B812F8A8434E7ACD 4F>114 D<912603FFFCEB0780027F9039FFE00FC00103B6EAF83F010FEDFEFF013F92B5 FC49EB000F2601FFF01300480180143F4890C8120F4848814848814981123F83485A187F A212FF6D163FA37F7F6DEE1F8002C092C7FC14F014FEECFFF06CECFF8016FEEEFFE06C16 FC6C16FF18C06C836C17F86C836C836C83013F17806D17C0010717E0010117F0EB003F02 0716F8EC001F030015FC1607EE007F051F13FE1707007E82B482836D167FA2183F7F181F A27F19FC7FA26D163F6D17F86D167F19F06D16FF6E4A13E002E04A13C06E4A138002FE02 3F1300913AFFC003FFFE01E790B65A01C316F0018016C026FE003F92C7FC48010714F800 70D9007F90C8FC3F507ACE4C>I<15FFA75CA55CA45CA25CA25CA25CA25C91B5FCA25B5B 5B131F5B90B9FC120FBAFCA6D8000791C9FCB3B3A3F01FE0AE183F7014C07F187F701480 6D16FF826D4B13006E6D485AEEFE0F6E90B55A020F5D6E5D020115C06E6C5C031F49C7FC 030113F03B6E7CEC4B>I121 D E %EndDVIPSBitmapFont end %%EndProlog %%BeginSetup %%Feature: *Resolution 600dpi TeXDict begin %%PaperSize: A4 end %%EndSetup %%Page: 1 1 TeXDict begin 1 0 bop 771 809 a Fq(The)65 b(Simple)g(So)5 b(c)-5 b(k)g(ets)65 b(Library)1699 1017 y Fp(V)-9 b(ersion)42 b(6)560 1313 y Fo(Charles)c(E.)g(Campb)s(ell,)d(Jr.,)j Fn(Ph.D.)304 b Fo(T)-10 b(erry)37 b(McRob)s(erts)1535 1545 y(August)h(23,)g(2005)1750 1912 y Fm(Abstract)380 2081 y Fl(The)31 b Fk(Simple)k(So)-5 b(ckets)35 b(Libr)-5 b(ary)33 b Fl(\(SSL\))e(allo)m(ws)g(C)g(programmers)g(to)i(use)e(in)m (terpro)s(cess)g(com-)244 2194 y(m)m(unications)26 b(via)h(Berk)m(eley) h(so)s(c)m(k)m(ets)h(simply)c(and)i(quic)m(kly)-8 b(.)39 b(The)26 b(programmer)h(is)g(able)g(to)h(mo)m(v)m(e)244 2307 y(information)h(easily)i(b)s(et)m(w)m(een)h(pro)s(cesses)f(on)g (the)g(same)h(or)f(di\013eren)m(t)g(mac)m(hines)f(connected)i(via)244 2420 y(Ethernet)i Fj(\(tm\))23 b Fl(and)34 b(using)f(the)i(TCP/IP)68 b(proto)s(col.)53 b(Most)35 b(of)g(the)f(SSL's)f(functions)g(resem)m (ble)244 2533 y(C's)d(\014le)f(i/o)i(functions,)e(so)i(C)f(programmers) f(will)f(\014nd)h(the)h(SSL)g(easy)h(to)g(learn.)380 2685 y(The)43 b(SSL)f(curren)m(tly)g(runs)g(under)f(v)-5 b(arious)42 b(UNIX)i Fj(\(tm\))72 b Fl(mac)m(hines:)66 b(IRIX)42 b Fj(\(tm\))72 b Fl(\(Silicon)244 2797 y(Graphics\),)47 b(SunOS)42 b Fj(\(tm\))29 b Fl(\(Sun\),)47 b(Domain)d(O/S)g Fj(\(tm\))29 b Fl(\(Ap)s(ollo\),)47 b(Ultrix)c Fj(\(tm\))29 b Fl(\(Dec\),)50 b(AIX)44 b Fj(\(tm\))244 2910 y Fl(\(IBM\),)29 b(SCO)e Fj(\(tm\))19 b Fl(,)29 b(OSF)e Fj(\(tm\))19 b Fl(,)29 b(and)f(VMS)g(5.x)g Fj(\(tm\))19 b Fl(,)29 b(and)e(MS-DOS)h Fj(\(tm\))47 b Fl(\(using)27 b(Borland)g(C++)244 3023 y(5.0\).)388 3532 y Fm(Keyw)m(ords)920 3382 y Fi(So)r(c)n(k)n(et)g(In)n (terpro)r(cess)f(Comm)n(unications)99 b(In)n(termac)n(hine)26 b(Comm)n(unications)920 3482 y(Berk)n(eley)g(So)r(c)n(k)n(ets)828 b(Ethernet)920 3581 y Fl(TCP/IP)1101 b Fi(Rob)r(otics)920 3681 y(Mac)n(hine)27 b(Con)n(trol)p eop end %%Page: 1 2 TeXDict begin 1 1 bop 0 407 a Fh(Con)l(ten)l(ts)0 626 y Fg(1)90 b(Cop)m(yrigh)m(t)3206 b(1)0 844 y(2)90 b(In)m(tro)s(duction) 3080 b(1)0 1062 y(3)90 b(The)38 b(Library)3103 b(3)146 1182 y Fn(3.1)100 b(User)33 b(Guide)96 b(.)50 b(.)g(.)g(.)f(.)h(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)184 b(4)146 1302 y(3.2)100 b(Reference)34 b(Man)m(ual)45 b(.)k(.)h(.)g(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)f(.) h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)184 b(7)146 1423 y(3.3)100 b(Hin)m(ts)41 b(.)50 b(.)g(.)g(.)g(.)g(.)g(.)g(.)f(.)h(.)g(.) g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)135 b(13)0 1641 y Fg(4)90 b(The)38 b(P)m(ortMaster)2848 b(17)146 1761 y Fn(4.1)100 b(Users)34 b(Guide)57 b(.)50 b(.)g(.)g(.)f(.)h(.)g(.) g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)135 b(17)146 1882 y(4.2)100 b(Sharing)31 b(P)m(ortMasters)83 b(.)50 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)135 b(17)146 2002 y(4.3)100 b(Theory)33 b(of)g(Op)s(eration)79 b(.)50 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.) g(.)g(.)g(.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)135 b(18)371 2122 y(4.3.1)111 b(The)33 b(P)m(ortMaster)h(Firew)m(all)49 b(.)h(.)g(.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)f(.)h(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)135 b(21)0 2340 y Fg(5)90 b(The)38 b(Utilities)3016 b(22)146 2461 y Fn(5.1)100 b(The)33 b Ff(sktdbg)h Fn(Program)50 b(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)f(.)h(.)g(.)g(.)g(.) g(.)g(.)g(.)g(.)g(.)135 b(23)0 2679 y Fg(6)90 b(Installation)36 b(Instructions)2460 b(25)146 2799 y Fn(6.1)100 b(Unix)63 b(.)50 b(.)g(.)g(.)g(.)g(.)g(.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) g(.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)f(.)h(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)135 b(25)146 2919 y(6.2)100 b(Vms)76 b(.)50 b(.)g(.)g(.)g(.)g(.)g(.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) g(.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)f(.)h(.)g(.)g(.)g (.)g(.)g(.)g(.)g(.)g(.)135 b(25)146 3040 y(6.3)100 b(Windo)m(ws)33 b(95)f(\()g(or)h(more)f(recen)m(t\))65 b(.)50 b(.)g(.)g(.)g(.)f(.)h(.)g (.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.) g(.)135 b(26)146 3160 y(6.4)100 b(Older)32 b(Ms-Dos)61 b(.)50 b(.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)f(.)h(.)g(.) g(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)f(.)h(.)g(.)g(.)g(.)g(.)g(.)g(.)g(.)g (.)135 b(27)0 3378 y Fg(7)90 b(App)s(endix:)51 b(Miscellaneous)36 b(F)-9 b(unctions)1897 b(29)p eop end %%Page: 1 3 TeXDict begin 1 2 bop 0 407 a Fh(1)161 b(Cop)l(yrigh)l(t)154 626 y Ff(Copyright:)54 b(Copyright)f(\(C\))f(1999-2005)i(Charles)f(E.)f (Campbell,)i(Jr.)718 746 y(Permission)g(is)d(hereby)i(granted)g(to)f (use)g(and)g(distribute)i(this)718 867 y(code)e(and)g(documentation,)j (with)d(or)g(without)h(modifications,)718 987 y(provided)g(that)f(this) h(copyright)g(notice)g(is)f(copied)h(with)718 1107 y(it.)f(Like)g (anything)i(else)e(that's)h(free,)f(the)g(Simple)h(Sockets)718 1228 y(Library)g(is)f(provided)h(*as)f(is*)g(and)g(comes)h(with)f(no)g (warranty)718 1348 y(of)g(any)g(kind,)g(either)h(expressed)h(or)e (implied.)104 b(By)52 b(using)718 1469 y(this)g(software,)i(you)e (agree)g(that)h(in)f(no)f(event)i(will)f(the)718 1589 y(copyright)h(holder)g(be)f(liable)h(for)f(any)g(damages)h(resulting) 718 1709 y(from)f(the)g(use)g(of)g(this)g(software.)0 2162 y Fh(2)161 b(In)l(tro)t(duction)0 2381 y Fn(The)28 b Fe(Simple)g(So)-5 b(ckets)29 b(Libr)-5 b(ary)27 b Fn(\(henceforth)h (to)e(b)s(e)h(abbreviated)g(as)g(the)g Fl(SSL)p Fn(\))e(allo)m(ws)h(C)h (programmers)0 2502 y(to)g(dev)m(elop)g(systems)i(of)d(co)s(op)s (erating)g(programs)g(using)h(Berk)m(eley)h(streaming)e(So)s(c)m(k)m (ets)j(running)d(under)0 2622 y(the)41 b Fl(TCP/IP)77 b Fn(proto)s(col)39 b(o)m(v)m(er)i(Ethernet.)68 b(The)41 b Fl(SSL)e Fn(pro)m(vides)j(simple)c(w)m(a)m(ys)k(to)e(mo)m(v)m(e)h (information)0 2743 y(b)s(et)m(w)m(een)25 b(programs)e(running)g(on)g (the)h(same)f(or)g(di\013eren)m(t)g(mac)m(hines)h(and)f(do)s(es)h(so)f (with)g(little)e(o)m(v)m(erhead.)0 2863 y(During)43 b(exp)s(erimen)m (ts)j(with)e(the)h Fe(Sr)-5 b(e)g(adbytes)44 b Fn(and)h Fe(Swrite)f Fn(functions,)k(for)c(example,)k(b)s(et)m(w)m(een)e(t)m(w)m (o)0 2983 y(mac)m(hines,)d(a)f(44)p Fd(;)17 b Fn(000)41 b(b)m(ytes/second)k(transfer)e(rate)g(w)m(as)g(ac)m(hiev)m(ed)h(with)e (4)h(b)m(ytes)h(p)s(er)f(pac)m(k)m(et)h(and)0 3104 y(o)m(v)m(er)f(1)p Fd(;)17 b Fn(000)p Fd(;)g Fn(000)39 b(b)m(ytes/second)44 b(w)m(as)f(ac)m(hiev)m(ed)f(with)g(128)e(b)m(ytes)k(p)s(er)d(pac)m(k)m (et.)72 b(Of)41 b(course,)k(hea)m(vily)0 3224 y(loaded)f(net)m(w)m (orks)i(will)d(a\013ect)h(the)h(rate)g(individual)c(users)46 b(ac)m(hiev)m(e.)80 b(The)46 b Fl(SSL)d Fn(pro)m(vides)i Fe(two-way)0 3345 y Fn(comm)m(unications.)146 3465 y(The)38 b Fl(SSL)e Fn(w)m(as)i(designed)g(to)f(resem)m(ble)g(the)h Fl(FILE)e Fn(i/o)g(system)i(pro)m(vided)g(b)m(y)g(the)f(standard)h(C)f (li-)0 3585 y(braries)53 b(\(ie.)f(fop)s(en,)59 b(fclose,)f(fputs,)h (etc.)105 b(map)52 b(to)h Fl(SSL)f Fn(analogs)g(Sop)s(en,)58 b(Sclose,)h(Sputs,)g(etc.\).)0 3706 y(Th)m(us,)34 b(C)f(programmers)e (t)m(ypically)h(\014nd)h(the)g Fl(SSL)e Fn(easy)j(to)e(learn.)146 3826 y(A)f(go)s(o)s(d)e(analogy)g(for)h(the)g Fl(SSL)f Fn(refers)j(to)d(the)i(phone)g(system.)44 b(There)31 b(are)g(three)g(t)m(yp)s(es)g(of)f(So)s(c)m(k)m(ets)0 3946 y(supp)s(orted)c(b)m(y)g(the)g Fl(SSL)e Fn(that)h(concern)h(the)g (user:)g(a)f Fe(server)p Fn(,)g(a)g Fe(client)p Fn(,)h(and)f(an)g Fe(ac)-5 b(c)g(ept)25 b Fn(so)s(c)m(k)m(et.)68 b(A)25 b(serv)m(er)0 4067 y(is)h(analogous)g(to)h(someone)g(w)m(aiting)e(b)m (y)j(sev)m(eral)g(phones)g(for)e(a)h(call,)e(a)i(clien)m(t)f(is)g (analogous)g(to)h(someone)0 4187 y(making)k(a)i(call,)e(and)h(an)h (accept)h(is)e(analogous)f(to)h(a)h(\(serv)m(er\))h(p)s(erson)f (accepting)g(the)g(call)e(b)m(y)j(pic)m(king)0 4308 y(up)f(one)g(of)f (the)h(phones.)146 4428 y(Th)m(us,)42 b(one)d(m)m(ust)f(ha)m(v)m(e)i(a) f(serv)m(er)h(for)e(a)g(clien)m(t)g(to)g(mak)m(e)h(a)f(successful)i (connection.)62 b(The)39 b(serv)m(er)0 4548 y(m)m(ust)45 b(in)g(turn)g(accept)h(the)g(connection.)82 b(Unlik)m(e)44 b(our)i(o)m(v)m(erw)m(ork)m(ed)i(serv)m(er)f(p)s(erson,)i(ho)m(w)m(ev)m (er,)i(the)0 4669 y(computer)30 b(using)h(the)f Fl(SSL)g Fn(is)g(p)s(erfectly)g(happ)m(y)i(handling)d(m)m(ultiple)f(\\accept")j (So)s(c)m(k)m(ets)h(concurren)m(tly)-8 b(.)146 4789 y(The)39 b Fl(SSL)e Fn(itself)g(is)g(pro)m(vided)i(in)e(three)i(main)d(parts)j (\(see)g(T)-8 b(able)38 b(1\).)59 b(The)39 b Fe(Libr)-5 b(ary)38 b Fn(is)g(comp)s(osed)0 4910 y(of)32 b(C)h(functions)g(and)f (the)h Fe(PortMaster)h Fn(and)e(the)h Fe(Utilities)g Fn(are)g(self-con)m(tained)f(programs.)146 5030 y(The)41 b Fl(SSL)e Fn(w)m(as)h(used)h(at)f(the)g(In)m(telligen)m(t)e(Rob)s (otics)h(Lab)s(oratory)g(\()p Fl(IRL)p Fn(\))g(since)h(Ma)m(y)-8 b(,)43 b(1991.)64 b(The)0 5150 y(soft)m(w)m(are)28 b(app)s(ears)f(to)f (b)s(e)h(stable)g(at)f(the)h(curren)m(t)h(writing)d(and)i(reasonably)g (robust.)42 b(F)-8 b(or)26 b(example,)i(the)0 5271 y(P)m(ortMaster,)36 b(a)f(bac)m(kground)h(pro)s(cess)g(pro)m(vided)g(in)e(the)i Fl(SSL)d Fn(distribution,)h(is)h(resistan)m(t)g(to)g(hanging)0 5391 y(\(and)46 b(thereb)m(y)i(b)s(eing)e(unresp)s(onsiv)m(e\).)86 b(It)47 b(uses)g Fe(Stime)-5 b(outwait)9 b Fn(s)48 b(\(see)f(the)g (Reference)g(Man)m(ual\))f(to)0 5511 y(return)f(to)f(its)f(normal)f (quiescen)m(t)k(mo)s(de)e(when)h(comm)m(unications)d(with)i(one)h(of)f (its)f(clien)m(ts)h(ceases)1926 5707 y(1)p eop end %%Page: 2 4 TeXDict begin 2 3 bop 1079 459 a Fn(T)-8 b(able)32 b(1:)44 b Fg(The)37 b(Three)h(P)m(arts)f(of)g(the)h Fm(SSL)0 688 y Fg(Library)49 b Fn(The)33 b(functions)g(that)f(the)h(users)h (will)c(link)i(to)g(are)h(in)e(the)i(library)-8 b(.)0 891 y Fg(P)m(ortMaster)48 b Fn(The)28 b(P)m(ortMaster)f(is)f(a)h(d\177) -49 b(aemon)26 b(program)f(whic)m(h)i(runs)g(in)f(the)h(bac)m(kground.) 42 b(It)27 b(allo)m(ws)244 1011 y Fe(clients)32 b Fn(to)g(connect)i(to) e Fe(servers)g Fn(using)g(an)m(y)h(a)m(v)-5 b(ailable)30 b(p)s(orts.)0 1215 y Fg(Utilities)45 b Fn(There)36 b(are)e(sev)m(eral)h (utilit)m(y)d(programs)i(pro)m(vided)h(with)f(the)g Fl(SSL)p Fn(:)g Ff(sktdbg)p Fn(,)i Ff(srmsrvr)p Fn(,)h(and)244 1335 y Ff(spmtable)p Fn(.)0 1731 y(unexp)s(ectedly)-8 b(.)146 1851 y(The)34 b Fl(IRL)e Fn(uses)j(the)e Fl(SSL)e Fn(to)i(con)m(trol)f(its)g(three)h(rob)s(ots;)g(its)f(use)i(of)e(the)i (Ethernet)g(is)e(consequen)m(tly)0 1972 y(somewhat)g(hea)m(vy)-8 b(.)44 b(Those)33 b(of)e(y)m(ou)h(who)g(wish)f(to)g(con)m(trol)g(mac)m (hinery)g(or)g(otherwise)h(presen)m(t)h(a)e(hea)m(vy)0 2092 y(load)25 b(ma)m(y)h(wish)g(to)f(purc)m(hase)j(a)e(\\bridge")f(to) h(isolate)e(y)m(our)j(mac)m(hines)f(from)e(y)m(our)j(lo)s(cal)d(net)m (w)m(ork.)43 b(This)0 2213 y(isolation)34 b(will)g(b)s(ene\014t)j(b)s (oth)g(the)g(y)m(ou)g(and)f(the)h(net)m(w)m(ork,)j(as)c(the)h(hea)m(vy) h(user)g(will)c(not)i(b)s(e)h(a\017icted)0 2333 y(with)26 b(slo)m(wdo)m(wns)h(due)g(to)f(the)h(net)m(w)m(ork)h(and)e(the)h(net)m (w)m(ork)h(will)c(not)i(b)s(e)g(b)s(othered)h(with)f(lots)f(of)h(pac)m (k)m(ets)0 2453 y(whic)m(h)33 b(slo)m(ws)g(all)e(its)h(users)i(do)m (wn.)1926 5707 y(2)p eop end %%Page: 3 5 TeXDict begin 3 4 bop 0 407 a Fh(3)161 b(The)53 b(Library)0 626 y Fn(The)29 b(user)g(of)f(the)g Fl(SSL)f Fn(accesses)k(it)c(b)m(y)i (linking)d(his)i(or)f(her)i(program)e(to)g(a)h Fe(libr)-5 b(ary)p Fn(.)70 b(A)28 b(soft)m(w)m(are)h(library)0 746 y(is)k(t)m(ypically)g(a)g(single)f(\014le)i(whic)m(h)g(consists)g(of)f (some)h(link)-5 b(age)32 b(information)e(along)i(with)i(pre-compiled)0 867 y Fe(obje)-5 b(ct)27 b(c)-5 b(o)g(de)p Fn(;)26 b(unfortunately)-8 b(,)26 b(metho)s(ds)e(for)f(pro)s(ducing)h(a)g(library)e(and)j(linking) d(to)i(it)f(v)-5 b(ary)24 b(from)f(system)0 987 y(to)30 b(system)i(and)f(compiler)d(to)j(compiler.)40 b(Directions)30 b(for)g(sev)m(eral)h(systems)h(app)s(ear)f(in)f(the)h(Section)f(on)0 1107 y(Implemen)m(tation.)146 1228 y(Practically)k(sp)s(eaking,)i(a)f (library)g(is)g(comp)s(osed)h(of)f(a)g(n)m(um)m(b)s(er)h(of)g (pre-compiled)e(C)i(functions)f(to)0 1348 y(b)s(e)30 b(utilized)e(b)m(y)j(the)f(programmer.)41 b(The)31 b(calls)d(made)i(a)m (v)-5 b(ailable)27 b(in)i(the)h Fl(SSL)f Fn(are)h(reminiscen)m(t)f(of)g (those)0 1469 y(used)34 b(b)m(y)f(the)g(v)-5 b(arious)32 b(\014le)g(functions)h(in)f(the)h(C)g(language)e(\(see)j(T)-8 b(able)32 b(2\).)754 1762 y(T)-8 b(able)32 b(2:)43 b(Simple)31 b(So)s(c)m(k)m(ets)j(and)f(Related)f(File)f Fl(I/O)h Fn(F)-8 b(unctions)p 1209 1796 1482 4 v 1209 1813 V 1207 1933 4 121 v 1224 1933 V 1276 1897 a Fe(File)34 b(F)-7 b(unction)p 1897 1933 V 98 w(So)i(cket)35 b(F)-7 b(unction)p 2673 1933 V 2690 1933 V 1209 1937 1482 4 v 1207 2057 4 121 v 1224 2057 V 1276 2021 a Fn(fop)s(en)p 1897 2057 V 439 w(Sop)s(en)p 2673 2057 V 2690 2057 V 1207 2177 V 1224 2177 V 1276 2141 a(fclose)p 1897 2177 V 441 w(Sclose)p 2673 2177 V 2690 2177 V 1207 2298 V 1224 2298 V 1276 2262 a(fread)p 1897 2298 V 458 w(Sread)p 2673 2298 V 2690 2298 V 1207 2418 V 1224 2418 V 1276 2382 a(fwrite)p 1897 2418 V 425 w(Swrite)p 2673 2418 V 2690 2418 V 1207 2538 V 1224 2538 V 1276 2502 a(fgets)p 1897 2538 V 474 w(Sgets)p 2673 2538 V 2690 2538 V 1207 2659 V 1224 2659 V 1276 2623 a(fputs)p 1897 2659 V 458 w(Sputs)p 2673 2659 V 2690 2659 V 1207 2779 V 1224 2779 V 1276 2743 a(fprin)m(tf)p 1897 2779 V 403 w(Sprin)m(tf)p 2673 2779 V 2690 2779 V 1207 2900 V 1224 2900 V 1276 2863 a(fscanf)p 1897 2900 V 428 w(Sscanf)p 2673 2900 V 2690 2900 V 1209 2903 1482 4 v 1209 2920 V 146 3239 a(The)35 b(So)s(c)m(k)m(ets)h (library)c(dep)s(ends)k(up)s(on)e(the)g Fe(PortMaster)g Fn(running)g(on)g(y)m(our)g(host)g(mac)m(hine.)47 b(Only)0 3360 y(one)37 b(cop)m(y)g(of)f(the)h(P)m(ortMaster)h(need)f(b)s(e)g (running)f(at)g(an)m(y)h(time)e(on)h(a)g(giv)m(en)h(mac)m(hine,)g(and)g (ma)m(y)f(b)s(e)0 3480 y(started)h(up)g(b)m(y)g(an)m(y)m(one)h(b)m(y)f (running)f(the)g Fe(Spm)g Fn(program)f(in)h(the)g(bac)m(kground.)56 b(On)37 b(Unix,)g(the)g Fe(Spm)0 3600 y Fn(program)31 b(will)f(put)j(itself)e(in)m(to)g(the)i(bac)m(kground.)45 b(One)33 b(ma)m(y)f(determine)g(if)f(y)m(our)i(system)g(has)g(a)f(P)m (ort-)0 3721 y(Master)40 b(running)f(b)m(y)h(t)m(yping)g Fe(spmtable)e Fn(\014rst)i({)f(it)f(will)f(inform)h(y)m(ou)i(of)f(an)m (y)h(existing)f(serv)m(ers)i(if)e(the)0 3841 y(P)m(ortMaster)34 b(is)e(up)h(or)f(tell)f(y)m(ou)i(that)g(the)g(P)m(ortMaster)g(is)f(not) h(up)g(otherwise.)146 3961 y(A)25 b(new)g(feature)g(of)f(the)h Fl(SSL)f Fn(allo)m(ws)f(serv)m(ers)k(to)d(share)h(another)g(mac)m (hine's)g(P)m(ortMaster.)42 b(Th)m(us,)28 b(the)0 4082 y Fl(SSL)g Fn(supp)s(orts)i(b)s(oth)f(distributed)g(and)h(cen)m (tralized)f(so)s(c)m(k)m(et)i(name)e(to)g(p)s(ort)g(mapping.)40 b(If)30 b(the)f(mac)m(hine)0 4202 y(on)h(whic)m(h)g(a)g(serv)m(er)i(is) d(to)h(run)g(do)s(esn't)g(ha)m(v)m(e)i(a)d(P)m(ortMaster,)j(suc)m(h)f (as)f(older)f Fl(MSDOS)h Fn(mac)m(hines,)g(then)0 4323 y(it)i(can)g(\\b)s(orro)m(w")h(another)f(mac)m(hine's)h(P)m(ortMaster.) 146 4443 y(A)d(program)d(ma)m(y)j(op)s(en)f(a)g(serv)m(er)i(So)s(c)m(k) m(et,)g(a)d(clien)m(t)h(So)s(c)m(k)m(et,)i(or)e(an)g(accept)i(So)s(c)m (k)m(et.)43 b(F)-8 b(ollo)m(wing)27 b(the)0 4563 y(phone)g(system)g (analogy)-8 b(,)26 b(assume)g(that)g(a)f(serv)m(er)j(So)s(c)m(k)m(et)f (is)f(op)s(ened)h(\014rst.)41 b(Then,)28 b(a)d(di\013eren)m(t)h (program)0 4684 y(ma)m(y)39 b(op)s(en)g(a)f(clien)m(t)h(So)s(c)m(k)m (et)h(whic)m(h)f(attempts)g(to)g(connect)h(to)e(the)i(serv)m(er)g({)f (it)f(succeeds)j(when)g(the)0 4804 y(serv)m(er)e(program)c(\\notices")h (that)h(there)g(is)f(a)h(connection)g(w)m(aiting)e(on)i(the)g(serv)m (er)h(So)s(c)m(k)m(et)g(and)f(then)0 4924 y(generates)e(an)e(accept)i (So)s(c)m(k)m(et.)48 b(The)35 b(clien)m(t)e(So)s(c)m(k)m(et)i(can)f(op) s(en,)h(ho)m(w)m(ev)m(er,)h(b)s(efore)e(the)g(serv)m(er)i(accepts)0 5045 y(the)e(clien)m(t;)f(there)h(just)g(w)m(on't)g(b)s(e)g(an)m(y)g(t) m(w)m(o-w)m(a)m(y)h(comm)m(unication)c(un)m(til)h(the)i(serv)m(er)h(do) s(es)f(accept)h(the)0 5165 y(clien)m(t.)1926 5707 y(3)p eop end %%Page: 4 6 TeXDict begin 4 5 bop 0 407 a Fc(3.1)135 b(User)46 b(Guide)0 592 y Fn(Soft)m(w)m(are)e(using)g(C)g(m)m(ust)g Ff(#include)53 b("sockets.h")47 b Fn(and)d(m)m(ust)f(link)g(to)g(the)i Fl(SSL)p Fn(.)d(Directions)g(for)0 712 y(doing)35 b(so)h(will)e(v)-5 b(ary)36 b(from)f(system)i(to)e(system)i(and)f(also)f(dep)s(end)j(up)s (on)e(where)h(the)f(installer)e(placed)0 832 y(the)27 b(libraries.)40 b(Please)27 b(refer)g(to)g(y)m(our)g(compiler)e(do)s (cumen)m(tation)h(and)h(the)g Fl(SSL)f Fn(installer)f(to)h(kno)m(w)i (ho)m(w)0 953 y(to)k(set)i(up)e(library)f(link)-5 b(age)31 b(paths)i(and)g(for)f(the)h(include)f(path)h(to)f(the)h Fe(so)-5 b(ckets.h)32 b Fn(\014le.)146 1073 y(The)43 b(soft)m(w)m(are)g(b)s(elo)m(w)e(illustrates)f(some)i(t)m(ypical)e(So)s (c)m(k)m(et)j(co)s(de)f(fragmen)m(ts)g(to)f(get)h(a)f(connected)0 1193 y(so)s(c)m(k)m(et,)f(assuming)d(that)g(the)h Ff(sockets.h)i Fn(\014le)d(is)f(on)i(y)m(our)g(compiler's)e(include)h(searc)m(h)h (path.)58 b(If)38 b(the)0 1314 y Ff(sockets.h)j Fn(\014le)d(has)h(b)s (een)h(placed)e(in)g(a)h(standard)g(system)g(directory)g(\(not)g(wise)g (-)f(up)s(dates)h(to)g(the)0 1434 y(compiler)i(ma)m(y)j(wip)s(e)f(it)f (o\013)7 b(!\))76 b(then)44 b(y)m(ou)g(ma)m(y)f(ha)m(v)m(e)i(to)e (substitute)h Ff(#include)53 b()46 b Fn(for)0 1555 y Ff(#include)35 b Fn("so)s(c)m(k)m(ets.h"`)f(in)e(the)h(follo)m (wing)d(examples.)0 1783 y Fg(Example)37 b(3.1)83 b Fe(A)36 b(server)e(with)h(one)f(ac)-5 b(c)g(ept)205 2107 y Ff(#include)53 b("sockets.h")205 2227 y(Socket)g(*server;)205 2347 y(Socket)g(*skt;) 205 2468 y(server=)g(Sopen\("servername","s"\);)205 2588 y(skt)155 b(=)51 b(Saccept\(server\);)205 2709 y(...)205 2829 y(Sclose\(skt\);)205 2949 y(Sclose\(server\);)146 3298 y Fn(Note)33 b(in)f(Example)h(3.1)f(that)h(the)g(serv)m(ername)h (is)e(completely)g(up)h(to)g(the)g(programmer)e(to)h(select.)0 3418 y(Please)h(note)g(that)f(all)f(serv)m(ers)j(share)g(the)f(same)f (namespace)h(on)g(an)m(y)g(giv)m(en)g(mac)m(hine,)f(ho)m(w)m(ev)m(er.)0 3647 y Fg(Example)37 b(3.2)83 b Fe(A)36 b(server)e(with)h(multiple)f (ac)-5 b(c)g(epts)205 3971 y Ff(#include)53 b("sockets.h")205 4091 y(Socket)g(*server=NULL;)205 4211 y(Socket)g(*skt=NULL;)205 4332 y(server=)g(Sopen\("servername","s"\);)205 4452 y(do)f({)308 4572 y(skt=)g(Saccept\(server\);)308 4693 y(...)308 4813 y(Sclose\(skt\);)308 4934 y(})f(while\(whatever\);)205 5054 y(Sclose\(server\);)146 5403 y Fn(Again,)32 b(the)g(programmer)f (ma)m(y)h(select)h(an)m(y)g(serv)m(ername.)45 b(Note)32 b(that)g(the)h Fe(ac)-5 b(c)g(ept)32 b Fn(So)s(c)m(k)m(et)i(\(\\skt"\)) 0 5523 y(is)f(re-used)i(in)e(Example)g(3.2.)47 b(Actually)-8 b(,)33 b(co)s(ding)g(of)g(m)m(ultiple)e(accept)k(so)s(c)m(k)m(ets)h(is) d(usually)g(a)h(bit)f(more)1926 5707 y(4)p eop end %%Page: 5 7 TeXDict begin 5 6 bop 0 407 a Fn(in)m(v)m(olv)m(ed;)50 b(see)45 b Ff(multiskt.c)h Fn(in)e(the)g Fl(EXAMPLES)f Fn(directory)-8 b(.)77 b(I)44 b(usually)g(set)g(up)g(a)g(doubly-link)m (ed)0 527 y(list)d(con)m(taining)f(a)i(So)s(c)m(k)m(et)i(p)s(oin)m(ter) d(for)h(eac)m(h)h(suc)m(h)g(accepted)h(clien)m(t)d(and)h(put)h(them)e (on)h(the)h(mask)0 648 y(\(using)35 b Ff(Smaskset\(\))p Fn(\).)56 b(I)35 b(can)h(then)h(use)f Ff(Smaskwait\(\))j Fn(or)c Ff(Smasktimeoutwait\(\))41 b Fn(to)35 b(w)m(ait)g(for)g(an)m(y) 0 768 y(So)s(c)m(k)m(et,)i(including)c(the)i(serv)m(er)i(itself,)d (that)h(needs)h(atten)m(tion.)50 b(Up)s(on)35 b(closing)e(suc)m(h)j(a)f (So)s(c)m(k)m(et,)i(I)e(also)0 888 y(use)f Ff(Smaskunset\(\))h Fn(to)d(remo)m(v)m(e)i(it)d(from)h(the)h(mask)f(and)h(do)f(a)h (double-link)d(deletion.)0 1113 y Fg(Example)37 b(3.3)83 b Fe(A)36 b(client)205 1433 y Ff(#include)53 b("sockets.h")205 1554 y(Socket)g(*client;)205 1674 y(while\(1\))g({)308 1795 y(client=)g(Sopen\("serverName","c"\);)308 1915 y(if\(client\))h(break;)308 2035 y(sleep\(1\);)308 2156 y(})205 2276 y(...)205 2397 y(Sclose\(client\);)146 2741 y Fn(In)28 b(Example)e(3.3,)i(the)f Ff(serverName)i Fn(ma)m(y)e(b)s(e)g (in)f(the)i(optional)c(form)i Ff(serverName@machineName)p Fn(.)0 2862 y(Without)35 b(the)g(mac)m(hine)g(name)g(sp)s (eci\014cation,)g(the)h(P)m(ortMaster)g(on)g(the)f(mac)m(hine)g(that)g (the)h(clien)m(t)e(is)0 2982 y(running)24 b(on)g(will)e(b)s(e)i(searc)m (hed)i(for)e(the)h(serv)m(er.)42 b(The)26 b Ff(smsrvr.c)g Fn(and)e Ff(smclient.c)j Fn(example)d(programs)0 3102 y(pro)m(vided)33 b(in)f(the)h Fl(SSL)e Fn(distribution)g(giv)m(e)h (complete)g(illustrations)e(of)i(Examples)h(3.1)f(and)g(3.3.)146 3223 y(Note)k(that)f(the)h(Sop)s(en\(\))f(of)g(a)g(clien)m(t)g(will)e (fail)g(if)h(the)i(serv)m(er)h(is)d(not)i(already)e(up;)k(in)c(whic)m (h)i(case,)0 3343 y(a)i(n)m(ull)g(p)s(oin)m(ter)g(is)g(returned.)63 b(Example)38 b(3.3)g(illustrates)f(a)i(probing)f(metho)s(d)g(\(in)f (this)i(case,)i(once)e(a)0 3464 y(second\).)59 b(Example)37 b(3.4)g(sho)m(ws)i(an)f(option)e(to)h(ha)m(v)m(e)i(Sop)s(en\(\))e(blo)s (c)m(k)h(un)m(til)e(the)i(requested)h(serv)m(er)g(is)0 3584 y(a)m(v)-5 b(ailable.)0 3808 y Fg(Example)37 b(3.4)83 b Fe(A)36 b(blo)-5 b(cking)33 b(until)i(op)-5 b(en)35 b(client)205 4129 y Ff(#include)53 b("sockets.h")205 4249 y(Socket)g(*client;)205 4370 y(client=)g (Sopen\("serverName","b"\);)205 4490 y(...)205 4611 y (Sclose\(client\);)146 4955 y Fn(In)43 b(Example)f(3.4,)i(the)f (requested)i(serv)m(er)f(ma)m(y)e(or)g(ma)m(y)g(not)h(b)s(e)f(up)h (already)-8 b(.)72 b(If)42 b(the)h(serv)m(er)h(is)0 5076 y(a)m(v)-5 b(ailable,)29 b(a)h(normal)f(clien)m(t)h(connection)h(is)g (op)s(ened.)43 b(If)31 b(the)g(serv)m(er)i(is)d Fe(not)h Fn(a)m(v)-5 b(ailable,)29 b(then)i(the)h(clien)m(t)0 5196 y(will)27 b(blo)s(c)m(k)i(\(w)m(ait\))f(un)m(til)g(the)h(serv)m (er)i(is)e(brough)m(t)g(up.)42 b(In)m(ternally)-8 b(,)30 b(the)f(P)m(ortMaster)h(places)f(an)m(y)h(clien)m(ts)0 5316 y(that)40 b(op)s(en)h(using)f(this)h(option)e(on)i(a)f(w)m(aiting) f(list)g(when)j(the)f(serv)m(er)h(is)f(not)f(a)m(v)-5 b(ailable.)65 b(When)42 b(the)0 5437 y(serv)m(er)28 b(connects)g(to)e (the)h(P)m(ortMaster,)i(the)e(P)m(ortMaster)g(then)g(c)m(hec)m(ks)j (its)c(w)m(aiting)f(list)g(for)g(clien)m(ts)i(who)0 5557 y(wish)33 b(to)f(connect.)1926 5707 y(5)p eop end %%Page: 6 8 TeXDict begin 6 7 bop 0 407 a Fg(Example)37 b(3.5)48 b Fe(Using)35 b(Sop)-5 b(env)205 731 y Ff(#include)53 b("sockets.h")205 851 y(Socket)g(*client;)205 971 y(while\(1\))g({)308 1092 y(client=)g(Sopenv\("serverName","c","S)q(KTPA)q(TH")q(\);)308 1212 y(if\(client\))h(break;)308 1333 y(sleep\(1\);)308 1453 y(})205 1573 y(...)205 1694 y(Sclose\(client\);)146 2042 y Fn(The)42 b Fl(SSL)d Fn(allo)m(ws)g(the)h(programmer)f(to)h(set) h(up)f(a)g(group)g(of)g(mac)m(hines)g(for)g(making)f(clien)m(t)g(con-)0 2163 y(nections.)52 b(In)36 b(Example)f(3.5,)g(the)h Fl(SSL)e Fn(tries)h(to)h(op)s(en)f(a)g(clien)m(t)g(to)g(a)g(serv)m(er)i (named)e Ff(serverName)j Fn(on)0 2283 y(an)m(y)30 b(mac)m(hine)g(on)f (the)i Fl(SKTP)-8 b(A)g(TH)p Fn(.)29 b(The)i(\\)p Fl(SKTP)-8 b(A)g(TH)p Fn(")29 b(is)g(an)h(en)m(vironmen)m(t)g(v)-5 b(ariable)28 b(t)m(ypically)g(of)i(the)0 2403 y(form)i Ff(machine1:machine2:machi)q(ne3)p Fn(,)40 b(ie.)33 b(a)h(list)e(of)h (mac)m(hine)g(names)h(separated)h(b)m(y)f(colons.)47 b(This)0 2524 y(example)32 b(also)g(sho)m(ws)i(a)e(t)m(ypical)g(clien)m (t)g(connection)h(attempt)e(and)i(sleep)g(p)s(olling)d(lo)s(op.)146 2644 y(A)36 b(somewhat)f(larger)f(example)h(is)g(included)g(in)g(the)g (distribution:)48 b Ff(multiskt.c)p Fn(.)54 b(This)35 b(example)0 2765 y(program)k(concurren)m(tly)j(accepts)g(m)m(ultiple)c (clien)m(ts)j(on)f(a)g(single)g(serv)m(er,)45 b(reads)c(an)m(y)g (messages)h(sen)m(t)0 2885 y(its)36 b(w)m(a)m(y)h(from)f(an)m(y)h(of)e (its)h(clien)m(ts,)h(and)g(sends)h(a)e(mo)s(di\014ed)f(v)m(ersion)i (bac)m(k)g(to)f(the)h(sending)g(clien)m(t.)54 b(It)0 3005 y(uses)44 b(the)f Fe(Smaskwait)f Fn(functions)g(to)h(blo)s(c)m(k)f (the)h(m)m(ultiskt)f(pro)s(cess)i(for)e(friendly)g(m)m(ulti-tasking.)71 b(It)0 3126 y(is)32 b(a)g(useful)h(program)e(to)h(study)i(in)e (conjunction)g(with)h(the)g(Man)m(ual)f(b)s(elo)m(w.)146 3246 y(Connected)42 b(so)s(c)m(k)m(ets)g(are)f(a)e(pre-requisite)h(for) g(an)m(y)h(of)f(the)g Fl(I/O)g Fn(So)s(c)m(k)m(et)i(functions)e (describ)s(ed)h(in)0 3367 y(the)e(next)h(section.)63 b(Note)39 b(that)f(the)i(serv)m(er)g(should)f(ha)m(v)m(e)h(a)f(unique)g (name)g(on)g(an)m(y)g(giv)m(en)g(mac)m(hine.)0 3487 y(Serv)m(ers)c(ma)m (y)d(ha)m(v)m(e)i(the)g(same)e(name)h(on)f(di\013eren)m(t)h(mac)m (hines,)g(although)f(this)g(ma)m(y)h(b)s(e)g(confusing.)44 b(It)0 3607 y(is)26 b(suggested)h(that)g(one)f(use)h(the)g(name)f(of)f (the)i(pro)s(cess)h(\(at)d(least)h(as)h(a)f(pre\014x\))h(for)f(that)g (purp)s(ose.)42 b(Note)0 3728 y(that)31 b(the)g(only)g(things)f(that)h (one)g(can)h(do)f(with)f(a)h(serv)m(er)i(So)s(c)m(k)m(et)f(are:)43 b(op)s(en)31 b(one,)h(close)f(one,)g(generate)0 3848 y(an)37 b(accept)h(So)s(c)m(k)m(et)g(with)f(one,)h(and)f(test/blo)s(c)m (k)g(on)g(one)g(\(for)g(clien)m(ts)g(requesting)g(connection\).)57 b(The)0 3968 y Fl(SSL)28 b Fn(supp)s(orts)j(up)f(to)f(10)g(clien)m(ts)h (concurren)m(tly)g(a)m(w)m(aiting)f(acceptance)i(on)f(a)f(serv)m(er)i (So)s(c)m(k)m(et,)h(although)0 4089 y(man)m(y)h(mac)m(hines)f(will)e (limit)f(that)k(to)f(5)g(\(silen)m(tly\).)146 4209 y(The)c Fl(SSL)d Fn(supp)s(orts)i(t)m(w)m(o)h(w)m(a)m(y)f(comm)m(unication)d (of)i(data)h(b)s(et)m(w)m(een)h(a)e(clien)m(t)g(and)h(an)f(accept)i(So) s(c)m(k)m(et.)0 4330 y(Since)33 b(the)g(pro)s(cesses)h(are)f(not)f(lik) m(ely)f(to)i(b)s(e)f(sync)m(hronized,)j(often)d(one)h(pro)s(cess)h(m)m (ust)e(someho)m(w)h(w)m(ait)0 4450 y(un)m(til)e(the)h(other)g(pro)s (cess)h(has)g(sen)m(t)g(it)e(something.)42 b(There)33 b(are)f(t)m(w)m(o)h(metho)s(ds)f(to)f(supp)s(ort)i(this)e(under)0 4570 y(the)46 b Fl(SSL)p Fn(:)e(p)s(olling)e(and)j(in)m(terrupt-driv)m (en.)81 b(The)46 b(p)s(olling)c(metho)s(d)j(uses)h(a)f(lot)f(of)h Fl(CPU)g Fn(time,)i(but)0 4691 y(lets)33 b(the)h(program)e(do)h(other)h (tasks)g(in)f(the)h(mean)m(time.)44 b(The)34 b(in)m(terrupt-driv)m(en)g (approac)m(h)g(hangs)g(the)0 4811 y(pro)s(cess)d(\(ak)-5 b(a)29 b(blo)s(c)m(ks)h(and)g(susp)s(ends\))i(un)m(til)c(something)h (sho)m(ws)i(up)f(on)g(the)g(So)s(c)m(k)m(et.)44 b(The)30 b(Smask)p Fl(XXX)0 4932 y Fn(group)i(of)g(functions)g(allo)m(ws)g(one)g (to)g(hang)h(the)f(pro)s(cess)i(un)m(til)d(something)h(sho)m(ws)i(up)e (on)g(an)m(y)i(n)m(um)m(b)s(er)0 5052 y(of)e(So)s(c)m(k)m(ets)i({)f (sort)f(of)h(a)f(big)f Fl(OR)i Fn(gate!)146 5172 y(The)40 b(Smask)p Fl(XXX)f Fn(alternativ)m(e)e(to)i(p)s(olling)c(also)i(allo)m (ws)h(the)h(programmer)d(to)i(insert)h(non-so)s(c)m(k)m(et)0 5293 y(\014le)34 b(descriptors)h(in)m(to)f(the)h(mask)g(via)f (Smaskfdset)h(\(and)g(to)f(remo)m(v)m(e)h(them)g(via)f(Smaskunfdset\))h (suc)m(h)0 5413 y(as)e(serial)e(p)s(orts)i(\(ex.)44 b(op)s(en)33 b(with)f(DEVICE\),)h(graphics)g(queues)h(\(ex.)44 b Fl(SGI)p Fn(s)33 b(with)f(qgetfd\),)h(etc.)1926 5707 y(6)p eop end %%Page: 7 9 TeXDict begin 7 8 bop 0 407 a Fc(3.2)135 b(Reference)46 b(Man)l(ual)0 592 y Fn(This)d(section)f(con)m(tains)h(a)f(description)g (of)g(the)h(functions)f(a)m(v)-5 b(ailable)40 b(in)i(the)h(So)s(c)m(k)m (et)h(Library)-8 b(.)72 b(The)0 712 y Fl(SSL)35 b Fn(returns)j(three)f (t)m(yp)s(es)h(of)e(So)s(c)m(k)m(ets:)i(a)f(serv)m(er,)i(clien)m(t,)e (and)g(an)f(accept)i(So)s(c)m(k)m(et.)93 b(A)36 b(So)s(c)m(k)m(et)i (itself)0 832 y(is)29 b(a)g(data)g(structure)h Fe(typ)-5 b(e)30 b Fn(set)g(up)g(b)m(y)g(the)g Ff(sockets.h)h Fn(header)f (\014le.)42 b(The)30 b(So)s(c)m(k)m(et)h(is)e(delib)s(erately)f(used)0 953 y(in)36 b(a)h(fashion)f(reminiscen)m(t)h(of)f(the)h(use)h(of)f Fl(FILE)g Fn(p)s(oin)m(ters)f(so)i(that)e(the)i(C)f(user)h(who)f(kno)m (ws)i(ho)m(w)e(to)0 1073 y(read)c(and)f(write)h(a)f(\014le)g(will)e (immediately)g(feel)i(comfortable)f(with)h(reading)g(and)h(writing)e (So)s(c)m(k)m(ets.)p 255 1212 3391 4 v 255 1229 V 253 1349 4 121 v 270 1349 V 321 1313 a Fe(R)-5 b(eturn)p 1104 1349 V 543 w(F)e(unction)p 1790 1349 V 310 w(A)n(r)i(gument)p 3627 1349 V 3644 1349 V 253 1469 V 270 1469 V 321 1433 a(T)e(yp)i(e)p 1104 1469 V 634 w(Name)p 1790 1469 V 439 w(List)p 3627 1469 V 3644 1469 V 255 1473 3391 4 v 253 1593 4 121 v 270 1593 V 321 1557 a Fn(So)s(c)m(k)m(et)411 b(*)p 1104 1593 V 99 w(Saccept)p 1790 1593 V 362 w(\(So)s(c)m(k)m(et)34 b(*skt\))p 3627 1593 V 3644 1593 V 253 1713 V 270 1713 V 321 1677 a(v)m(oid)p 1104 1713 V 655 w(Sclose)p 1790 1713 V 431 w(\(So)s(c)m(k)m(et)g(*skt\))p 3627 1713 V 3644 1713 V 253 1834 V 270 1834 V 321 1798 a(c)m(har)505 b(*)p 1104 1834 V 99 w(Sgets)p 1790 1834 V 464 w(\(c)m(har)33 b(*buf,)g(in)m(t)f(maxbuf,)g(So)s(c)m(k)m(et)i(*skt\))p 3627 1834 V 3644 1834 V 253 1954 V 270 1954 V 321 1918 a(in)m(t)p 1104 1954 V 717 w(Smaskfdisset)p 1790 1954 V 143 w(\(in)m(t)e(fd\))p 3627 1954 V 3644 1954 V 253 2075 V 270 2075 V 321 2038 a(v)m(oid)p 1104 2075 V 655 w(Smaskfdset)p 1790 2075 V 209 w(\(in)m(t)g(fd\))p 3627 2075 V 3644 2075 V 253 2195 V 270 2195 V 321 2159 a(fd)p 411 2159 30 4 v 35 w(set)p 1104 2195 4 121 v 596 w(Smaskget)p 1790 2195 V 282 w(\(\))p 3627 2195 V 3644 2195 V 253 2315 V 270 2315 V 321 2279 a(in)m(t)p 1104 2315 V 717 w(Smaskisset)p 1790 2315 V 227 w(\(So)s(c)m(k)m(et)i(*skt\))p 3627 2315 V 3644 2315 V 253 2436 V 270 2436 V 321 2400 a(v)m(oid)p 1104 2436 V 655 w(Smaskp)s(op)p 1790 2436 V 252 w(\(\))p 3627 2436 V 3644 2436 V 253 2556 V 270 2556 V 321 2520 a(v)m(oid)p 1104 2556 V 655 w(Smaskpush)p 1790 2556 V 212 w(\(\))p 3627 2556 V 3644 2556 V 253 2676 V 270 2676 V 321 2640 a(v)m(oid)p 1104 2676 V 655 w(Smaskset)p 1790 2676 V 293 w(\(So)s(c)m(k)m(et)g(*skt\))p 3627 2676 V 3644 2676 V 253 2797 V 270 2797 V 321 2761 a(in)m(t)p 1104 2797 V 717 w(Smasktest)p 1790 2797 V 255 w(\(\))p 3627 2797 V 3644 2797 V 253 2917 V 270 2917 V 321 2881 a(v)m(oid)p 1104 2917 V 655 w(Smasktime)p 1790 2917 V 221 w(\(long)d(seconds,long)j(useconds\))p 3627 2917 V 3644 2917 V 253 3038 V 270 3038 V 321 3002 a(v)m(oid)p 1104 3038 V 655 w(Smaskunset)p 1790 3038 V 185 w(\(So)s(c)m(k)m(et)g(*skt\))p 3627 3038 V 3644 3038 V 253 3158 V 270 3158 V 321 3122 a(v)m(oid)p 1104 3158 V 655 w(Smaskunfdset)p 1790 3158 V 101 w(\(in)m(t)e(fd\))p 3627 3158 V 3644 3158 V 253 3278 V 270 3278 V 321 3242 a(v)m(oid)p 1104 3278 V 655 w(Smaskuse)p 1790 3278 V 277 w(\(fd)p 1969 3242 30 4 v 35 w(set)i(usermask\))p 3627 3278 4 121 v 3644 3278 V 253 3399 V 270 3399 V 321 3363 a(in)m(t)p 1104 3399 V 717 w(Smaskw)m(ait)p 1790 3399 V 230 w(\(\))p 3627 3399 V 3644 3399 V 253 3519 V 270 3519 V 321 3483 a(So)s(c)m(k)m(et)411 b(*)p 1104 3519 V 99 w(Sop)s(en)p 1790 3519 V 429 w(\(c)m(har)33 b(*skthost,)h(c)m(har)f(*mo)s(de\))p 3627 3519 V 3644 3519 V 253 3640 V 270 3640 V 321 3603 a(So)s(c)m(k)m(et)411 b(*)p 1104 3640 V 99 w(Sop)s(en)m(v)p 1790 3640 V 381 w(\(c)m(har)33 b(*srvrname,c)m(har)h(*ctrl,c)m(har)e(*en)m(vv)-5 b(ar\))p 3627 3640 V 3644 3640 V 253 3760 V 270 3760 V 321 3724 a(in)m(t)p 1104 3760 V 717 w(Sp)s(eek)p 1790 3760 V 438 w(\(So)s(c)m(k)m(et)34 b(*skt,)f(c)m(har)g(*buf,)g(in)m(t)f (bu\015en\))p 3627 3760 V 3644 3760 V 253 3880 V 270 3880 V 321 3844 a(unsigned)h(long)p 1104 3880 V 247 w(Sp)s(eeraddr)p 1790 3880 V 256 w(\(So)s(c)m(k)m(et)h(*skt\))p 3627 3880 V 3644 3880 V 253 4001 V 270 4001 V 321 3965 a(c)m(har)505 b(*)p 1104 4001 V 99 w(Sp)s(eername)p 1790 4001 V 223 w(\(So)s(c)m(k)m(et)34 b(*skt\))p 3627 4001 V 3644 4001 V 253 4121 V 270 4121 V 321 4085 a(v)m(oid)p 1104 4121 V 655 w(Sprin)m(tf)p 1790 4121 V 393 w(\(So)s(c)m(k)m(et)g(*skt,)f(c)m (har)g(*fm)m(t,...\))p 3627 4121 V 3644 4121 V 253 4241 V 270 4241 V 321 4205 a(c)m(har)505 b(*)p 1104 4241 V 99 w(Sprtskt)p 1790 4241 V 375 w(\(So)s(c)m(k)m(et)34 b(*skt\))p 3627 4241 V 3644 4241 V 253 4362 V 270 4362 V 321 4326 a(v)m(oid)p 1104 4362 V 655 w(Sputs)p 1790 4362 V 448 w(\(c)m(har)f(*buf,)g(So)s(c)m(k)m(et)h(*skt\))p 3627 4362 V 3644 4362 V 253 4482 V 270 4482 V 321 4446 a(in)m(t)p 1104 4482 V 717 w(Sread)p 1790 4482 V 448 w(\(So)s(c)m(k)m(et)g(*skt,)f(c)m(har)g(*buf,)g(in)m(t)f(bu\015en\))p 3627 4482 V 3644 4482 V 253 4603 V 270 4603 V 321 4566 a(in)m(t)p 1104 4603 V 717 w(Sreadb)m(ytes)p 1790 4603 V 227 w(\(So)s(c)m(k)m(et)i(*skt,)f(c)m(har)g(*buf,)g(in)m(t)f (bu\015en\))p 3627 4603 V 3644 4603 V 253 4723 V 270 4723 V 321 4687 a(in)m(t)p 1104 4723 V 717 w(Srmsrvr)p 1790 4723 V 347 w(\(c)m(har)h(*skthost\))p 3627 4723 V 3644 4723 V 253 4843 V 270 4843 V 321 4807 a(in)m(t)p 1104 4843 V 717 w(Sscanf)p 1790 4843 V 418 w(\(So)s(c)m(k)m(et)h(*skt,) f(c)m(har)g(*fm)m(t,)f(...\))p 3627 4843 V 3644 4843 V 253 4964 V 270 4964 V 321 4928 a(in)m(t)p 1104 4964 V 717 w(Stest)p 1790 4964 V 475 w(\(So)s(c)m(k)m(et)i(*skt\))p 3627 4964 V 3644 4964 V 253 5084 V 270 5084 V 321 5048 a(in)m(t)p 1104 5084 V 717 w(Stimeout)m(w)m(ait)p 1790 5084 V 121 w(\(So)s(c)m(k)m(et)g(*skt,long)e(seconds,long)h(useconds\)) p 3627 5084 V 3644 5084 V 253 5205 V 270 5205 V 321 5168 a(in)m(t)p 1104 5205 V 717 w(Svprin)m(tf)p 1790 5205 V 342 w(\(So)s(c)m(k)m(et)h(*skt,)f(c)m(har)g(*fm)m(t,)f(v)m(oid)g (*args\))p 3627 5205 V 3644 5205 V 253 5325 V 270 5325 V 321 5289 a(in)m(t)p 1104 5325 V 717 w(Sw)m(ait)p 1790 5325 V 450 w(\(So)s(c)m(k)m(et)i(*skt\))p 3627 5325 V 3644 5325 V 253 5445 V 270 5445 V 321 5409 a(in)m(t)p 1104 5445 V 717 w(Swrite)p 1790 5445 V 415 w(\(So)s(c)m(k)m(et)g(*skt,) f(c)m(har)g(*buf,)g(in)m(t)f(bu\015en\))p 3627 5445 V 3644 5445 V 255 5449 3391 4 v 255 5465 V 1926 5707 a(7)p eop end %%Page: 8 10 TeXDict begin 8 9 bop 0 407 a Fg(So)s(c)m(k)m(et)37 b(*Saccept\(So)s(c) m(k)m(et)g(*skt\))72 b Fn(This)23 b(function)f(tak)m(es)i(a)e(serv)m (er)j(So)s(c)m(k)m(et)f(and)f(pro)s(duces)h(a)f(So)s(c)m(k)m(et)244 527 y(whic)m(h)39 b(has)g(accepted)h(a)f(connection.)62 b(This)39 b(function)f(ma)m(y)h(b)s(e)f(used)i(as)f(often)g(as)g(w)m (an)m(ted)h(on)244 648 y(the)31 b(same)g(serv)m(er)i(So)s(c)m(k)m(et!) 44 b(Note)31 b(that)g(one)g(m)m(ust)g(ha)m(v)m(e)h(successfully)g(op)s (ened)g(a)f(serv)m(er)h(prior)e(to)244 768 y(using)i(Saccept)i(to)e (accept)i(connections)f(\(see)g(Examples)g(3.1)f(and)h(3.2\).)244 930 y(If)f(this)h(op)s(eration)e(is)h(unsuccessful,)j(then)e(Saccept)h (will)c(return)j(a)f(n)m(ull)g(So)s(c)m(k)m(et)i(p)s(oin)m(ter.)0 1133 y Fg(v)m(oid)j(Sclose\(So)s(c)m(k)m(et)f(*skt\))89 b Fn(This)41 b(function)f(closes)h(a)f(So)s(c)m(k)m(et)i(of)e(an)m(y)h (t)m(yp)s(e)g(\(serv)m(er,)k(clien)m(t,)c(ac-)244 1254 y(cept\).)i(The)31 b(Sclose)f(function)f(comm)m(unicates)g(with)g(the)h (lo)s(cal)e(P)m(ortMaster)j(whenev)m(er)h(a)d(serv)m(er)244 1374 y(is)j(closed.)0 1577 y Fg(c)m(har)38 b(*Sgets\(c)m(har)f(*buf,)h (in)m(t)f(maxbuf,)h(So)s(c)m(k)m(et)f(*skt\))88 b Fn(This)39 b(is)g(an)g(I/O)h(function)e(whic)m(h)i(as-)244 1698 y(sumes)51 b(that)f(one)h(has)g(already)e(op)s(ened)j(a)e(connected)i (So)s(c)m(k)m(et)f(\()p Fe(skt)p Fn(\).)97 b(It)51 b(will)d(attempt)h (to)244 1818 y(get)c(a)g(n)m(ull-terminated)e(string)h(from)h(the)g(So) s(c)m(k)m(et)i(\(up)e(to)g(maxbuf)g(c)m(haracters\).)83 b(This)46 b(call)244 1939 y(will)c(blo)s(c)m(k)i(\(ak)-5 b(a)43 b(hang,)k(sleep\))e(un)m(til)d(a)i(string)g(sho)m(ws)h(up,)j (but)c(otherwise)h(acts)f(m)m(uc)m(h)h(as)f(a)244 2059 y(fgets\(\))33 b(function)f(do)s(es.)244 2221 y(If)k(Sgets)h(has)g(a)f (so)s(c)m(k)m(et)j(error,)e(then)g(a)f(n)m(ull)f(p)s(oin)m(ter)h(is)g (returned.)57 b(Otherwise,)38 b(it)d(returns)j(the)244 2341 y(\\)p Fe(buf)p Fn(")32 b(p)s(oin)m(ter.)0 2545 y Fg(in)m(t)k(Smaskfdisset\(in)m(t)g(fd\))101 b Fn(The)53 b(Smaskfdisset\(\))g(function)f(w)m(orks)h(in)f(conjunction)g(with)g (the)244 2665 y(Smaskw)m(ait\(\))27 b(function.)42 b(After)28 b(the)g(Smaskw)m(ait\(\))f(function)h(returns,)i(one)e(can)g(use)h (Smaskfdis-)244 2785 y(set\(skt\))34 b(to)e(test)h(if)f(a)g(particular) f(\014le)h(descriptor)h(is)f(read-ready)-8 b(.)0 2989 y Fg(v)m(oid)37 b(Smaskfdset\(in)m(t)g(fd\))83 b Fn(The)36 b(Smask)p Fl(XXX)f Fn(functions)g(use)h(a)e Fe(mask)g Fn(of)h(t)m(yp)s(e)g Fe(fd)p 3293 2989 30 4 v 36 w(set)g Fn(in)m(ternally)-8 b(.)244 3109 y(Other)38 b(op)s(erations,)h(suc)m(h) h(as)e(use)i(of)d(a)h(serial)f(p)s(ort)h(under)h(Unix)f(or)g(the)h Fk(GL)f Fn(queue)i(for)e Fl(SGI)p Fn('s)244 3230 y(Irises)c(\(see)g (their)e(qgetfd\(\))i(function\))f(use)h(\014le)f(descriptors.)46 b(This)33 b(function)g(allo)m(ws)f(one)h(to)g(set)244 3350 y(up)g(the)g(Smask)p Fl(XXX)g Fn(mask)g(with)f(one)h(or)f(more)g (of)g(those)h(\014le)f(descriptors.)0 3553 y Fg(Smask)38 b(Smaskget\(\))78 b Fn(The)31 b(Smask)p Fl(XXX)g Fn(functions)f(use)h (a)f Fe(mask)f Fn(of)g(t)m(yp)s(e)i Fe(fd)p 3006 3553 V 36 w(set)f Fn(in)m(ternally)-8 b(.)41 b(Other)244 3674 y(op)s(erations,)28 b(suc)m(h)h(as)f(use)g(of)g(a)f(serial)f(p)s(ort)h (under)i(Unix,)f(can)g(also)f(b)s(e)h(used)h(to)e(set)h(masks.)43 b(This)244 3794 y(function)30 b(pro)m(vides)h(access)g(to)f(the)h(mask) f(set)h(up)g(b)m(y)g(Smaskset.)43 b(The)32 b(mate)d(to)h(this)g (function)f(is)244 3914 y(Smaskuse\(\).)0 4118 y Fg(in)m(t)36 b(Smaskisset\(So)s(c)m(k)m(et)h(*skt\))86 b Fn(The)40 b(Smaskisset\(\))e(function)g(w)m(orks)i(in)d(conjunction)i(with)f(the) 244 4238 y(Smaskw)m(ait\(\))d(function.)53 b(After)36 b(the)h(Smaskw)m(ait\(\))e(function)h(returns,)h(one)g(can)f(use)h (Smaskis-)244 4359 y(set\(skt\))27 b(to)f(test)g(if)e(a)i(particular)e (So)s(c)m(k)m(et)j(is)e(read-ready)-8 b(.)42 b(It)26 b(is)f(simpler)f(then)i(and)g(thereb)m(y)i(faster)244 4479 y(than)k(Smasktest\(\).)0 4682 y Fg(v)m(oid)37 b(Smaskp)s(op\(\)) 74 b Fn(The)27 b(Smaskp)s(op\(\))e(function,)h(along)e(with)h(the)h (Smaskpush\(\))h(function,)f(allo)m(ws)244 4803 y(the)44 b(programmer)d(to)j(manipulate)d(an)i(in)m(ternal)g(stac)m(k)h(of)f (masks.)77 b(The)44 b(\\top")f(mask)h(is)f(the)244 4923 y(curren)m(t)34 b(mask.)0 5127 y Fg(v)m(oid)j(Smaskpush\(\))86 b Fn(The)38 b(Smaskpush\(\))g(function,)f(along)f(with)g(the)h(Smaskp)s (op\(\))g(function,)h(al-)244 5247 y(lo)m(ws)29 b(the)g(programmer)e (to)h(manipulate)f(an)h(in)m(ternal)g(stac)m(k)i(of)e(masks.)43 b(The)29 b(\\top")g(mask)f(is)h(the)244 5367 y(curren)m(t)34 b(mask.)1926 5707 y(8)p eop end %%Page: 9 11 TeXDict begin 9 10 bop 0 407 a Fg(v)m(oid)37 b(Smaskset\(So)s(c)m(k)m (et)g(*skt\))74 b Fn(This)27 b(function)e(is)h(part)f(of)h(the)g Fe(Smask)p Fk(XXX)e Fn(group.)41 b(So)s(c)m(k)m(ets)28 b(ma)m(y)244 527 y(b)s(e)k(set)g(up)g(for)f(Smaskw)m(ait'ing)f(one)i (at)g(a)f(time.)42 b(Note)32 b(that)f(all)e(So)s(c)m(k)m(ets)34 b(are)d(e\013ectiv)m(ely)i Fl(OR)p Fn('ed)244 648 y(together)43 b(for)g(blo)s(c)m(king;)48 b(to)42 b(clear)h(the)h(mask,)i(pass)e(a)f Fl(NULL)g Fn(So)s(c)m(k)m(et)h(p)s(oin)m(ter)f(to)g(Smaskset:)244 768 y(Smaskset\(\(So)s(c)m(k)m(et)35 b(*\))d Fl(NULL)p Fn(\);.)0 971 y Fg(in)m(t)k(Smasktest\(\))84 b Fn(This)35 b(function)g(is)g(part)h(of)f(the)g Fe(Smask)p Fk(XXX)f Fn(group.)52 b(The)36 b(Smasktest)g(function)244 1092 y(supp)s(orts)j(p)s(olling)34 b({)k(one)g(ma)m(y)f(determine)h(if)f(an) m(ything)g(is)h(on)f(an)m(y)i(of)e(the)h(Smaskset)h(So)s(c)m(k)m(ets) 244 1212 y(and)30 b(immediately)d(receiv)m(e)32 b(a)e(p)s(ositiv)m(e)f (in)m(teger)h(if)g(there)g(is,)61 b(a)30 b(0)g(if)f(there)i(isn't,)f (and)h(a)f(negativ)m(e)244 1333 y(n)m(um)m(b)s(er)j(if)e(there's)j(an)f (error.)0 1536 y Fg(v)m(oid)k(Smasktime\(long)e(seconds,long)j (useconds\))78 b Fn(This)29 b(function)f(is)g(part)g(of)g(the)h Fe(Smask)p Fk(XXX)244 1656 y Fn(group.)77 b(Normally)41 b(Smaskw)m(ait)j(will)e(blo)s(c)m(k)h(\\forev)m(er")i(\(w)m(ell,)g(at)f (least)f(as)h(long)f(as)h(the)g(ma-)244 1777 y(c)m(hine)35 b(sta)m(ys)h(up!\).)51 b(Ho)m(w)m(ev)m(er,)38 b(one)d(can)g(sp)s(ecify) g(a)g(time)e(limit)e({)k(then)g(Smaskw)m(ait)g(will)d(return)244 1897 y(with)43 b(a)g(v)-5 b(alue)43 b(of)g(0)g(if)f(the)i(time)e(limit) e(is)j(exceeded.)78 b(One)44 b(ma)m(y)f(sp)s(ecify)h(the)g(time)e (limit)e(in)244 2017 y(seconds)d(and)f(micro-seconds.)53 b(T)-8 b(o)35 b(clear)h(the)g(time)e(limit)e(\(ie.)j(restore)i(Smaskw)m (ait)e(to)g(w)m(aiting)244 2138 y(forev)m(er\),)48 b(pass)d(a)e (negativ)m(e)i(time)d(in)i(either)g(or)f(b)s(oth)h(argumen)m(ts)g(to)g (Smasktime.)77 b(W)-8 b(aiting)244 2258 y(forev)m(er)33 b(is)f(also)g(set)h(up)g(when)h(b)s(oth)e(argumen)m(ts)h(to)f (Smasktime)g(are)g(zero.)0 2462 y Fg(v)m(oid)37 b(Smaskunfdset\(in)m(t) g(fd\))82 b Fn(This)34 b(function)f(is)g(part)g(of)g(the)h Fe(Smask)p Fk(XXX)d Fn(group.)46 b(File)32 b(descrip-)244 2582 y(tors)40 b(ma)m(y)g(b)s(e)h(en)m(tered)g(in)m(to)f(the)g(mask)g (via)g(the)h(Smaskfdset\(\))g(function,)g(and)g(this)e(function)244 2702 y(can)33 b(remo)m(v)m(e)g(it)f(from)f(the)i(mask.)43 b(This)33 b(function)f(is)g(similar)e(to)i(the)h(Smaskunset\(\))h (function.)0 2906 y Fg(v)m(oid)j(Smaskunset\(So)s(c)m(k)m(et)h(*skt\)) 83 b Fn(This)35 b(function)f(is)h(part)f(of)h(the)g Fe(Smask)p Fk(XXX)e Fn(group.)50 b(So)s(c)m(k)m(ets)244 3026 y(ma)m(y)43 b(b)s(e)g(remo)m(v)m(ed)h(from)e(the)h(Smaskw)m(ait's)h(mask)f(one)g (at)g(a)g(time)e(via)i(this)f(function.)75 b(Lik)m(e)244 3147 y Fe(Smaskset)p Fn(,)32 b(a)g Fe(Smaskunset\(\(So)-5 b(cket)33 b(*\))i Fk(NULL)p Fe(\);)c Fn(will)f(clear)i(the)h(en)m(tire) g(mask.)0 3350 y Fg(v)m(oid)k(Smaskuse\(Smask)h(usermask\))85 b Fn(This)36 b(function)f(is)g(part)g(of)g(the)h Fe(Smask)p Fk(XXX)d Fn(group.)52 b(The)244 3470 y(in)m(ternal)c Fe(mask)h Fn(in)g(Smask)p Fl(XXX)h Fn(can)g(b)s(e)f(set)h(up)g(b)m(y)h (the)f(user)g(via)f(this)g(function.)94 b(Often,)244 3591 y(Smaskset)42 b(will)d(b)s(e)j(used)h(to)e(set)h(up)g(an)f(in)m (ternal)f(mask,)k(Smaskget)e(will)d(b)s(e)i(used)i(to)e(obtain)244 3711 y(the)33 b(resulting)e(mask,)i(and)g(Smaskuse)h(will)c(b)s(e)j (used)g(to)g(apply)f(that)g(mask.)0 3914 y Fg(in)m(t)k(Smaskw)m (ait\(\))80 b Fn(This)33 b(function)f(is)g(part)g(of)g(the)h Fe(Smask)p Fk(XXX)d Fn(group.)44 b(The)33 b Fe(Smaskwait)e Fn(function)244 4035 y(will)41 b(blo)s(c)m(k)j(\(ak)-5 b(a)43 b(hang\))h(the)g(pro)s(cess)h(un)m(til)e(an)m(y)h(So)s(c)m(k)m (et)h(set)g(via)e(Smaskset)i(has)f(something)244 4155 y(w)m(aiting)27 b(on)h(it)f(to)h(b)s(e)h(read.)42 b(Note)28 b(that)g(So)s(c)m(k)m(ets)j(set)e(b)m(y)g(Smaskset)g(are)f(retained;)i (ie.)e(they)h(m)m(ust)244 4276 y(b)s(e)k(explicitly)d(cleared)j(b)m(y)g (passing)g(a)f Fl(NULL)h Fn(So)s(c)m(k)m(et)h(p)s(oin)m(ter)e(to)g (Smaskset.)244 4438 y(Smaskw)m(ait)24 b(returns)i(a)f(p)s(ositiv)m(e)f (n)m(um)m(b)s(er)h(if)e(something)h(is)g(w)m(aiting)g(on)g(a)h(So)s(c)m (k)m(et,)j(zero)d(if)e(a)i(time-)244 4558 y(out)32 b(o)s(ccurs,)i(and)e (a)h(negativ)m(e)f(n)m(um)m(b)s(er)h(on)g(an)f(error.)0 4761 y Fg(So)s(c)m(k)m(et)37 b(*Sop)s(en\(c)m(har)i(*skthost,)e(c)m (har)h(*mo)s(de\))82 b Fn(This)35 b(function)f(is)g(the)g(w)m(orkhorse) i(for)e(op)s(en-)244 4882 y(ing)d(So)s(c)m(k)m(ets.)46 b(Basically)-8 b(,)31 b(it)g(can)i(mak)m(e)g(either)f(a)g(serv)m(er)j (or)d(a)g(clien)m(t)g(dep)s(ending)h(on)f(the)h(mo)s(de.)1926 5707 y(9)p eop end %%Page: 10 12 TeXDict begin 10 11 bop 692 311 2761 4 v 690 431 4 121 v 741 395 a Fe(Mo)-5 b(de)1146 b(E\013e)-5 b(ct)p 3451 431 V 692 434 2761 4 v 690 555 4 121 v 835 518 a(s)193 b Fn(op)s(en)33 b(a)f(serv)m(er)p 3451 555 V 690 675 V 827 639 a Fe(S)186 b Fn(op)s(en)33 b(a)f(serv)m(er)i(but,)f(on)g (failure,)e(retry)i(after)f(using)g(Srmsrvr)p 3451 675 V 690 795 V 832 759 a Fe(c)191 b Fn(op)s(en)33 b(a)f(clien)m(t)p 3451 795 V 690 916 V 832 880 a Fe(b)191 b Fn(op)s(en)33 b(a)f(blo)s(c)m(king)f(clien)m(t)p 3451 916 V 690 1036 V 758 1000 a Fe(s)p Ff(###)117 b Fn(op)s(en)33 b(a)f(serv)m(er)i(with)e (the)h(sp)s(eci\014ed)h(p)s(ort)e(n)m(um)m(b)s(er)p 3451 1036 V 690 1156 V 750 1120 a Fe(S)p Ff(###)110 b Fn(lik)m(e)32 b Fe(S)g Fn(ab)s(o)m(v)m(e,)h(but)g(with)g(the)g(sp)s(eci\014ed)g(p)s (ort)p 3451 1156 V 690 1277 V 755 1241 a Fe(c)p Ff(###)115 b Fn(op)s(en)33 b(a)f(clien)m(t)g(to)g(a)g(serv)m(er)j(with)d(the)h(sp) s(eci\014ed)g(p)s(ort)p 3451 1277 V 692 1280 2761 4 v 244 1507 a(The)i Fe(skthost)f Fn(is)f(the)i(name)e(of)h(the)h(serv)m (er.)49 b(If)34 b(one)h(is)e(making)g(a)h Fe(client)f Fn(So)s(c)m(k)m(et,)j(then)f(one)f(ma)m(y)244 1628 y(optionally)i(use)j (the)g(form)e(\\serv)m(ername@hostname")j(for)e(the)h(skthost.)62 b(The)40 b(\\@hostname")244 1748 y(form)33 b(is)h(not)g(necessary)j (for)d(clien)m(ts)h(to)f(serv)m(ers)i(that)f(are)f(on)h(the)g(same)f (host)h(as)f(the)h(clien)m(t,)g(as)244 1868 y(the)g(default)g(host)g (is)g(the)g(lo)s(cal)e(host.)51 b(The)36 b(\\serv)m(ername@hostname")g (form)e(mak)m(es)h(no)g(sense)244 1989 y(for)30 b(serv)m(ers,)j(and)d (so,)i(for)d(op)s(ening)h(serv)m(ers,)j(Sop)s(en)e(will)d(ignore)i(an)m (y)h(\\@hostname")e(p)s(ortion)g(of)244 2109 y(skthost.)244 2271 y(The)43 b Fe(\\S")e Fn(mo)s(de)h(for)f(op)s(ening)h(serv)m(ers,) 47 b(lik)m(e)41 b(the)i Fe(\\s")e Fn(mo)s(de,)j(will)c(cause)j(Sop)s (en)g(to)f(attempt)244 2391 y(to)35 b(op)s(en)g(a)f(serv)m(er,)k(but)d (if)f(unsuccessful,)k(Sop)s(en)d(will)e(then)i(use)h(Srmsrvr)f(using)g (the)g(pro)m(vided)244 2512 y(skthost)d(and)e(then)h(retry)h(op)s (ening)d(the)i(serv)m(er.)45 b(In)31 b(the)g(case)g(of)f Fe(s)p Ff(###)h Fn(or)g Fe(S)p Ff(###)p Fn(,)g(the)g(serv)m(ers)i(are) 244 2632 y(set)j(up)f(with)g(the)g Fl(TCP/IP)68 b Fn(option)34 b Fl(SO)p 1772 2632 28 4 v 32 w(REUSEADDR)p Fn(.)h(This)g(option)f (alleviates)g(some)h(of)g(the)244 2752 y(di\016culties)c(asso)s(ciated) i(with)f(re-starting)g(serv)m(ers)i(with)f(\014xed)g(p)s(orts.)244 2914 y(If)i(the)h(skthost)h(is)e(n)m(ull)f(or)h(an)g(empt)m(y)h(string) f(\(""\),)g(the)h(P)m(ortMaster)h(is)e(b)m(ypassed.)54 b(One)36 b(m)m(ust)244 3035 y(sp)s(ecify)46 b(a)f(p)s(ort)g(n)m(um)m(b) s(er)h(to)f(use)i(in)d(that)i(case.)83 b(A)45 b(w)m(arning)h(is)f (issued)h(\(as)f(w)m(ell)g(as)h(a)f(n)m(ull)244 3155 y Ff(Socket*)p Fn(\))34 b(b)s(ecause)g(that)e(is)h(t)m(ypically)e(a)h (programming)e(error,)i(not)h(a)f(user)h(error.)244 3317 y(The)g(P)m(ortMaster)h(is)d(also)h(alw)m(a)m(ys)h(b)m(ypassed)h(for)e (clien)m(ts)g(whic)m(h)h(sp)s(ecify)g(p)s(ort)f(n)m(um)m(b)s(er)g(\()p Fe(c)p Ff(###)p Fn(\).)244 3437 y(In)37 b(the)h(latter)e(case,)i(a)f (clien)m(t)g(connection)g(is)g(immediately)d(attempted)j(to)g(the)h (user-sp)s(eci\014ed)244 3558 y(p)s(ort)32 b(n)m(um)m(b)s(er.)44 b(If)32 b(the)h(function)f(is)h(not)f(successful,)i(a)f(n)m(ull)e(So)s (c)m(k)m(et)j(p)s(oin)m(ter)e(is)g(returned.)244 3720 y(If)23 b(the)h(user-sp)s(eci\014ed)g(serv)m(er)h(p)s(ort)e(mo)s(de)f (is)h(used)h(with)f(a)g(skthost,)j(the)d(serv)m(er)i(will)c(b)s(e)j (registered)244 3840 y(with)30 b(its)g(P)m(ortMaster;)i(clien)m(ts)f (need)g Fe(not)f Fn(use)i(sp)s(eci\014ed-p)s(ort)e(mo)s(de)g(to)g (connect)i(\(ie.)e(they)h(ma)m(y)244 3960 y(set)i Ff(mode)h Fn(to)e Ff("c")p Fn(\))h(so)g(long)e(as)i(they)h(sp)s(ecify)f(the)g (correct)g(name)f(of)g(the)h(serv)m(er.)244 4122 y(P)m(ortMaster)41 b(sharing)e(\(b)m(y)i(setting)e(the)i(en)m(vironmen)m(t)f(v)-5 b(ariable)38 b Ff(PMSHARE)p Fn(\))k(causes)f(serv)m(ers)h(to)244 4243 y(w)m(ork)26 b(with)e(the)i Fk(PMSHARE)11 b Fn(-sp)s(eci\014ed)23 b(mac)m(hine's)i(P)m(ortMaster.)42 b(Clien)m(ts)25 b(should)g(use)h (the)f(name)244 4363 y(of)34 b(the)h(mac)m(hine)f(that)g(the)h Fe(PortMaster)g Fn(is)f(on;)h(the)g(ev)m(en)m(tual)h(connection)e(will) f(b)s(e)h(made)g(with)244 4483 y(the)d(appropriate)e(serv)m(er)j (program,)e(ev)m(en)i(though)f(it)e(is)h(running)g(on)g(a)g(di\013eren) m(t)h(mac)m(hine)f(than)244 4604 y(the)g(P)m(ortMaster)i(it)d(uses.)44 b(See)31 b(Example)e(4.1)h(for)f(an)h(illustration)d(of)j(ho)m(w)g(P)m (ortMaster)i(sharing)244 4724 y(w)m(orks.)0 4928 y Fg(So)s(c)m(k)m(et) 37 b(*Sop)s(en)m(v\(c)m(har)i(*srvrname,c)m(har)f(*ctrl,c)m(har)e(*en)m (vv)-6 b(ar\))99 b Fn(The)52 b Fe(Sop)-5 b(env)49 b Fn(function)h(is) 244 5048 y(used)44 b(to)e(op)s(en)g(clien)m(t)g(So)s(c)m(k)m(ets,)47 b(but)c(is)f(form)m(ulated)f(to)h(resem)m(ble)h(the)g Fe(Sop)-5 b(en)41 b Fn(function)h(with)244 5168 y(one)g(additional)d (argumen)m(t.)71 b(Assuming)41 b(y)m(our)i(computer)f(system)g(supp)s (orts)h(the)f(concept)h(of)244 5289 y(en)m(vironmen)m(t)c(v)-5 b(ariables,)38 b(the)h(Sop)s(en)m(v)g(function)f(can)h(use)g(an)f(en)m (vironmen)m(t)h(v)-5 b(ariable)36 b(of)i(y)m(our)244 5409 y(c)m(hoice)g(to)f(help)g(it)g(op)s(en)g(a)g(clien)m(t.)58 b(T)m(ypically)-8 b(,)37 b(a)g Fl(SKTP)-8 b(A)g(TH)37 b Fn(en)m(vironmen)m(t)h(v)-5 b(ariable)35 b(gets)j(set)244 5530 y(up)i(b)m(y)i(the)e(user)h(with)f(a)g(colon-separated)g(list)f (of)h(mac)m(hine)g(names)g(\(ex.)67 b(seten)m(v)42 b Fl(SKTP)-8 b(A)g(TH)1901 5707 y Fn(10)p eop end %%Page: 11 13 TeXDict begin 11 12 bop 244 407 a Fn(\\gryphon:dragon:xorn"\).)62 b(The)39 b(Sop)s(en)m(v)h(function)e(attempts)g(to)h(op)s(en)f(a)h (clien)m(t)f(to)g(a)g(serv)m(er)244 527 y(of)f(the)i(giv)m(en)f(name)g (on)g(the)g(curren)m(t)h(mac)m(hine)f(\014rst,)i(and)e(then)g(attempts) g(to)g(do)g(so)g(on)g(eac)m(h)244 648 y(mac)m(hine)28 b(in)g(the)h(giv)m(en)g(sequence.)45 b(If)29 b Ff(env_var)h Fn(is)e(NULL)h(or)g(a)f(n)m(ull)f(string,)i(then)h Ff(SKTPATH)g Fn(will)244 768 y(b)s(e)j(used)g(instead.)244 929 y(If)25 b(successful,)j(a)d(So)s(c)m(k)m(et)i(p)s(oin)m(ter)e(is)g(returned,)j (otherwise)e(a)f Fl(NULL)h Fn(So)s(c)m(k)m(et)h(p)s(oin)m(ter)e(is)g (returned.)244 1050 y(Please)33 b(see)h(Saccept)f(on)g(ho)m(w)g(to)f (use)i(serv)m(ers.)0 1252 y Fg(in)m(t)i(Sp)s(eek\(So)s(c)m(k)m(et)i (*skt,)g(c)m(har)f(*buf,)i(in)m(t)d(bu\015en\))85 b Fn(The)36 b Fe(Sp)-5 b(e)g(ek)35 b Fn(function)f(b)s(eha)m(v)m(es)k(lik)m(e)d (Sread)244 1372 y(|)e(up)h(to)g Fe(bu\015en)f Fn(b)m(ytes,)j(the)e (bu\013er)h(will)c(b)s(e)j(\014lled)f(b)m(y)h(whatev)m(er)i(is)d (curren)m(tly)i(on)e(the)i(So)s(c)m(k)m(et.)244 1492 y(This)e(function)g(do)s(es)h(not)f(remo)m(v)m(e)i(those)f(b)m(ytes)h (from)d(the)i(So)s(c)m(k)m(et,)h(ho)m(w)m(ev)m(er,)h(and)d(those)h(b)m (ytes)244 1613 y(will)e(b)s(e)k(returned)f(again)f(on)h(subsequen)m(t)j (Sp)s(eek,)f(Sread,)f(etc.)f(calls.)49 b(This)35 b(function)g(do)s(es)g (not)p 3759 1626 141 4 v 244 1733 a(blo)s(c)m(k)d(\(ak)-5 b(a)32 b(hang,)h(sleep\).)244 1894 y(It)c(will)e(return)j(EOF)f(on)g (select)h(error,)g(some)f(negativ)m(e)g(n)m(um)m(b)s(er)h(on)f(recv)i (error,)e(zero)h(if)e(no)h(data)244 2015 y(is)k(presen)m(t)i(on)e(the)h (So)s(c)m(k)m(et,)h(and)f(a)f(p)s(ositiv)m(e)f(coun)m(t)j(of)d(the)i(a) m(v)-5 b(ailable)31 b(b)m(ytes)k(otherwise.)47 b(In)34 b(the)244 2135 y(latter)d(case,)j Fe(buf)f Fn(will)d(ha)m(v)m(e)k(a)e (cop)m(y)i(of)e(the)h(b)m(ytes)h(a)m(v)-5 b(ailable.)244 2296 y Fl(MS-DOS)p Fn(:)44 b(Sp)s(eek)h(will)d(only)i(return)g(a)g(1)g (when)h(data)f(is)g(a)m(v)-5 b(ailable)41 b(on)j(the)h(So)s(c)m(k)m (et,)k(not)44 b(the)244 2417 y(n)m(um)m(b)s(er)f(of)g(b)m(ytes)i(a)m(v) -5 b(ailable.)72 b(F)-8 b(urthermore,)46 b(the)d(bu\013er)h Fe(buf)f Fn(will)e(b)s(e)i(a)g(zero-length)g(string)244 2537 y(with)32 b(just)h(a)f(n)m(ull)g(b)m(yte.)0 2739 y Fg(unsigned)38 b(long)f(Sp)s(eeraddr\(So)s(c)m(k)m(et)h(*skt\))97 b Fn(The)50 b Fe(Sp)-5 b(e)g(er)g(addr)47 b Fn(function)h(returns)i (the)f(in)m(ternet)244 2860 y(address)34 b(of)e(the)h(p)s(eer)g(So)s(c) m(k)m(et.)0 3062 y Fg(c)m(har)38 b(*Sp)s(eername\(So)s(c)m(k)m(et)f (*skt\))86 b Fn(The)37 b Fe(Sp)-5 b(e)g(ername)35 b Fn(function)i (returns)g(the)h(name)e(of)g(the)h(p)s(eer)244 3182 y(So)s(c)m(k)m(et.) 63 b(In)m(ternally)-8 b(,)39 b(it)f(has)h(three)g(bu\013ers;)j(th)m(us) e(it)e(can)g(b)s(e)h(used)h(up)f(to)f(three)h(times)f(in)g(the)244 3302 y(same)32 b(prin)m(tf)g(statemen)m(t.)0 3504 y Fg(v)m(oid)37 b(Sprin)m(tf\(So)s(c)m(k)m(et)f(*skt,)i(c)m(har)f(*fm)m(t,...\))70 b Fn(The)23 b Fe(Sprintf)f Fn(function)f(acts)h(in)g(an)f(analogous)g (fash-)244 3625 y(ion)29 b(to)h(fprin)m(tf,)g(sprin)m(tf,)h(etc,)g(b)m (y)h(putting)d(formatted)h(strings,)g(appropriately)f(n)m(ull)g(b)m (yte)j(termi-)244 3745 y(nated,)38 b(through)f(the)g(So)s(c)m(k)m(et.) 58 b(Th)m(us,)40 b(one)d(ma)m(y)g(use)g(either)g Fe(Sgets)g Fn(or)f(an)h(appropriate)f Fe(Ssc)-5 b(anf)244 3865 y Fn(to)32 b(receiv)m(e)i(the)f(information.)0 4068 y Fg(c)m(har)38 b(*Sprtskt\(So)s(c)m(k)m(et)e(*skt\))78 b Fn(The)30 b Fe(Sprtskt)g Fn(function)f(returns)h(a)f(string)g(describing)g(the)h (So)s(c)m(k)m(et.)0 4270 y Fg(v)m(oid)37 b(Sputs\(c)m(har)h(*buf,)g(So) s(c)m(k)m(et)f(*skt\))94 b Fn(The)47 b Fe(Sputs)f Fn(function)g(puts)g (a)g(n)m(ull)f(b)m(yte)i(terminated)244 4390 y(string)32 b(on)g(the)h(So)s(c)m(k)m(et)h(in)e(a)g(fashion)g(analogous)f(to)i (fputs.)0 4592 y Fg(in)m(t)j(Sread\(So)s(c)m(k)m(et)i(*skt,)f(c)m(har)h (*buf,)g(in)m(t)f(bu\015en\))73 b Fn(The)24 b Fe(Sr)-5 b(e)g(ad)23 b Fn(function)g(is)h(similar)c(to)j(the)h Fe(r)-5 b(e)g(ad)244 4712 y Fn(function)27 b(in)g(Unix.)42 b(This)28 b(function)g(can)g(blo)s(c)m(k)g(\(ak)-5 b(a)27 b(hang,)i(sleep\))f(if)f(nothing)g(is)g(on)h(the)h(So)s(c)m(k)m(et.)244 4833 y(Otherwise,)47 b(it)42 b(will)f(return)i(up)h(to)f Fe(bu\015en)g Fn(b)m(ytes)i(in)e(the)g(bu\013er)h(\\)p Fe(buf)p Fn(".)75 b(This)44 b(function)e(will)244 4953 y(return)31 b(whatev)m(er)i(is)d(on)h(the)g(So)s(c)m(k)m(et,)i(and)e (do)s(esn't)g(try)g(to)g(insure)g(that)f(bu\015en)i(b)m(ytes)h(are)e (read.)244 5074 y(It)i(returns)g(the)g(n)m(um)m(b)s(er)g(of)f(b)m(ytes) i(read)f(from)e(the)j(So)s(c)m(k)m(et.)244 5235 y(On)e(error,)h(an)f (EOF)h(is)f(returned.)0 5437 y Fg(in)m(t)k(Sreadb)m(ytes\(So)s(c)m(k)m (et)i(*skt,)g(c)m(har)f(*buf,)i(in)m(t)d(bu\015en\))85 b Fn(The)37 b Fe(Sr)-5 b(e)g(adbytes)35 b Fn(function)g(b)s(eha)m(v)m (es)244 5557 y(m)m(uc)m(h)40 b(lik)m(e)f(Sread,)j(and)e(it)e(to)s(o)h (can)h(blo)s(c)m(k)f(\(ak)-5 b(a)39 b(hang,)j(sleep\))e(if)e(nothing)h (is)g(on)g(the)i(So)s(c)m(k)m(et.)1901 5707 y(11)p eop end %%Page: 12 14 TeXDict begin 12 13 bop 244 407 a Fn(Ho)m(w)m(ev)m(er,)38 b(it)d(will)e(not)i(return)h(un)m(til)e(bu\015en)j(b)m(ytes)g(are)e (read)h(from)e(the)i(So)s(c)m(k)m(et)h(and)e(placed)h(in)244 527 y(\\buf)7 b(".)244 689 y(On)32 b(error,)h(an)f(EOF)h(is)f (returned.)0 892 y Fg(in)m(t)k(Srmsrvr\(c)m(har)h(*skthost\))74 b Fn(The)26 b Fe(Srmsrvr)f Fn(function)g(is)g(made)f(a)m(v)-5 b(ailable)23 b(to)i(tak)m(e)i(care)e(of)g(those)244 1013 y(situations)37 b(when)j Fl(skt)c(=)g(Sop)s(en\(\\serv)m (ername",\\s"\))k Fn(fails)d(b)s(ecause)j(the)f(serv)m(ername)h(has)f (b)s(een)244 1133 y(inadv)m(erten)m(tly)j(left)e(in)g(the)i(P)m (ortMaster's)g(P)m(ortT)-8 b(able.)69 b(This)42 b(un)m(to)m(w)m(ard)g (ev)m(en)m(t)h(can)e(happ)s(en,)244 1254 y(for)35 b(example,)g(when)i (a)e(pro)s(cess)i(is)e(ab)s(orted/exited)g(without)g(calling)e(Sclose)j (on)f(its)g(serv)m(er\(s\).)244 1374 y(The)46 b(Srmsrvr)g(function)e (will)f(remo)m(v)m(e)j(a)f(serv)m(er)i(\(or)e(serv)m(er@host\))j(from)c (the)h(P)m(ortMaster's)244 1494 y(P)m(ortT)-8 b(able.)40 b(Note:)f(it)21 b(will)f(not)p 1265 1507 141 4 v 23 w(close)i(the)h (asso)s(ciated)g(So)s(c)m(k)m(et,)j(nor)c(free)h(up)g(an)m(y)g(So)s(c)m (k)m(et)h(memory)-8 b(,)244 1615 y(and)33 b(is)f(not)p 532 1628 V 32 w(a)g(substitute)i(for)e(Sclose.)244 1777 y(The)37 b Fe(Srmsrvr)f Fn(function)g(will)e(return)j(either)f Fl(PM)p 2133 1777 28 4 v 33 w(OK)f Fn(\(if)g(successful\))j(or)e Fl(PM)p 3227 1777 V 33 w(SORR)-8 b(Y)36 b Fn(\(other-)244 1897 y(wise\).)0 2100 y Fg(in)m(t)g(Sscanf\(So)s(c)m(k)m(et)i(*skt,)g (c)m(har)f(*fm)m(t,)g(...\))82 b Fn(The)34 b Fe(Ssc)-5 b(anf)32 b Fn(function)h(acts)h(m)m(uc)m(h)f(the)h(same)f(as)h(ss-)244 2221 y(canf)29 b(and)h(fscanf,)h(taking)e(format)f(strings)h(and)h (additional)c(argumen)m(ts)k(in)f(a)g(lik)m(e)g(manner.)42 b(The)244 2341 y(argumen)m(ts)29 b(Sscanf)h(tak)m(es,)h(of)e(course,)i (m)m(ust)e(all)e(b)s(e)i(appropriate)f(p)s(oin)m(ters.)42 b(This)30 b(function)e(will)244 2462 y(blo)s(c)m(k)k(if)g(insu\016cien) m(t)h(data)f(is)g(a)m(v)-5 b(ailable)30 b(on)j(the)g(so)s(c)m(k)m(et)h (according)e(to)g(the)h Fe(fmt)p Fn(.)244 2623 y(The)40 b Fe(Ssc)-5 b(anf)38 b Fn(function)h(returns)h(the)g(n)m(um)m(b)s(er)f (of)g(argumen)m(ts)h(for)e(whic)m(h)i(it)e(read)i(data,)g(whic)m(h)244 2744 y(ma)m(y)f(b)s(e)h(zero)g(or)g(incomplete)e(if)g(a)i(so)s(c)m(k)m (et)h(error)f(o)s(ccurred.)65 b(Normally)-8 b(,)39 b(the)i(returned)f (coun)m(t)244 2864 y(should)32 b(equal)h(the)g(n)m(um)m(b)s(er)g(of)f (argumen)m(ts)h(with)f(whic)m(h)h(Sscanf)g(w)m(as)h(pro)m(vided.)0 3068 y Fg(in)m(t)i(Stest\(So)s(c)m(k)m(et)h(*skt\))74 b Fn(The)28 b Fe(Stest)e Fn(function)g(allo)m(ws)f(one)i(to)e (determine)h(if)g(an)m(ything)g(is)f(a)m(v)-5 b(ailable)244 3188 y(on)32 b(the)h(sp)s(eci\014ed)h(So)s(c)m(k)m(et,)g Fe(without)h(blo)-5 b(cking)p Fn(.)244 3350 y(It)29 b(will)e(return)j (EOF)f(on)g(select)h(error,)g(some)f(negativ)m(e)g(n)m(um)m(b)s(er)h (on)f(recv)i(error,)e(zero)h(if)e(no)h(data)244 3470 y(is)j(presen)m(t)i(on)f(the)g(So)s(c)m(k)m(et,)h(and)e(a)h(p)s(ositiv) m(e)f(coun)m(t)h(of)f(the)h(a)m(v)-5 b(ailable)30 b(b)m(ytes)k (otherwise.)244 3632 y Fl(MS-DOS)p Fn(:)23 b(Stest)i(will)c(only)i (return)h(a)g(1)f(when)i(data)e(is)g(a)m(v)-5 b(ailable)21 b(on)j(the)g(So)s(c)m(k)m(et,)j(not)c(the)i(n)m(um)m(b)s(er)244 3753 y(of)32 b(b)m(ytes)i(a)m(v)-5 b(ailable.)0 3956 y Fg(in)m(t)36 b(Stimeout)m(w)m(ait\(So)s(c)m(k)m(et)e(*skt,long)j (seconds,long)h(useconds\))85 b Fn(The)37 b Fe(Stime)-5 b(outwait)35 b Fn(func-)244 4076 y(tion)28 b(blo)s(c)m(ks)i(on)g(the)g (giv)m(en)f(So)s(c)m(k)m(et,)j(but)e(for)f(no)g(longer)g(than)h(the)g (n)m(um)m(b)s(er)g(of)f(seconds)i(plus)f(the)244 4197 y(n)m(um)m(b)s(er)i(of)f(microseconds)h(sp)s(eci\014ed.)44 b(The)32 b(function)g(returns)g(the)g(n)m(um)m(b)s(er)g(of)f(b)m(ytes)i (a)m(v)-5 b(ailable)244 4317 y(on)32 b(the)h(So)s(c)m(k)m(et)h(\(whic)m (h)f(ma)m(y)g(b)s(e)f(zero\),)h(-1)f(if)g(there)h(w)m(as)g(an)g(error,) f(and)h(-2)f(on)g(timeout.)0 4521 y Fg(in)m(t)k(Svprin)m(tf\(So)s(c)m (k)m(et)h(*skt,)g(c)m(har)h(*fm)m(t,)e(v)m(oid)h(*args\))95 b Fn(The)46 b Fe(Svprintf)g Fn(function)f(reads)h(b)m(ytes)244 4641 y(using)30 b(a)h(prin)m(tf)f(family)e(format)h(string)i(from)e (the)i(So)s(c)m(k)m(et.)44 b(As)32 b(eac)m(h)f(format)f(co)s(de)h(is)f (pro)s(cessed,)244 4761 y(the)e(asso)s(ciated)g(argumen)m(t)f(is)h(c)m (hanged)g(in)f(the)i Fe(ar)-5 b(gs)27 b Fn(v)m(ector.)43 b(It)28 b(returns)h(the)f(n)m(um)m(b)s(er)g(of)f(format)244 4882 y(items)32 b(pro)s(cessed.)0 5085 y Fg(in)m(t)k(Sw)m(ait\(So)s(c)m (k)m(et)g(*skt\))75 b Fn(The)26 b Fe(Swait)g Fn(function)f(will)f(blo)s (c)m(k)h(\(ak)-5 b(a)26 b(hang,)h(sleep\))f(un)m(til)f(the)h(sp)s (eci\014ed)244 5205 y(So)s(c)m(k)m(et)34 b(has)f(data)f(a)m(v)-5 b(ailable.)244 5367 y(It)29 b(will)e(return)j(EOF)f(on)g(select)h (error,)g(some)f(negativ)m(e)g(n)m(um)m(b)s(er)h(on)f(recv)i(error,)e (zero)h(if)e(no)h(data)244 5488 y(is)j(presen)m(t)i(on)f(the)g(So)s(c)m (k)m(et,)h(and)e(a)h(p)s(ositiv)m(e)f(coun)m(t)h(of)f(the)h(a)m(v)-5 b(ailable)30 b(b)m(ytes)k(otherwise.)1901 5707 y(12)p eop end %%Page: 13 15 TeXDict begin 13 14 bop 0 407 a Fg(in)m(t)36 b(Swrite\(So)s(c)m(k)m(et) g(*skt,)h(c)m(har)h(*buf,)g(in)m(t)f(bu\015en\))89 b Fn(The)41 b Fe(Swrite)f Fn(function)g(will)e(write)i Fe(bu\015en)244 527 y Fn(b)m(ytes)34 b(from)d(the)i Fe(buf)g Fn(bu\013er)g(on)m(to)g(the)g(sp)s(eci\014ed)g(So)s(c)m(k)m(et.)244 689 y(The)24 b(function)f(will)e(return)j(a)f(coun)m(t)g(of)g(the)h(n)m (um)m(b)s(er)g(of)e(b)m(ytes)j(transmitted)e(through)g(the)h(So)s(c)m (k)m(et,)244 809 y(whic)m(h)g(should)g(b)s(e)g(equal)g(to)f Fe(bu\015en)p Fn(.)41 b(If)23 b(the)h(output)g(is)g(less)g(than)g Fe(bu\015en)p Fn(,)h(then)g(an)f(error)f(o)s(ccurred)244 930 y(while)32 b(writing)f(to)h(the)h(So)s(c)m(k)m(et.)0 1219 y Fc(3.3)135 b(Hin)l(ts)0 1403 y Fn(The)38 b Fe(Hints)g Fn(b)s(elo)m(w)g(ha)m(v)m(e)g(b)s(een)h(found)e(useful)h(at)f(the)h(In) m(telligen)m(t)e(Rob)s(otics)h(Lab)s(oratory)-8 b(.)57 b(They)39 b(are)0 1524 y(based)34 b(on)e(almost)f(a)h(y)m(ear's)i(exp)s (erience)g(with)e(the)h Fl(SSL)p Fn(.)119 1752 y(1.)49 b(The)27 b(\\Sscanf)7 b(")27 b(function)f(is)g(dangerous.)42 b(It)26 b(will)f(blo)s(c)m(k)h(un)m(til)f(all)f(of)i(the)h(format)e(co) s(des)i(in)f(its)g Fe(fmt)244 1872 y Fn(string)h(ha)m(v)m(e)i(b)s(een)f (used.)43 b(If)27 b(someho)m(w)56 b(a)27 b(programmer)e(sends)30 b(an)d(improp)s(er)f(string)h(and)g(Sscanf)244 1993 y(is)34 b(used)h(to)f(receiv)m(e)h(it,)f(then)g(the)h(receiving)f(program)e (will)g(probably)i(hang)g(for)g(quite)g(a)g(while.)244 2113 y(Dr.)g(Campb)s(ell)e(has)j(found)f(that)h(it)e(is)h(somewhat)g (safer)h(to)f(use)h Fe(Sgets)f Fn(to)g(get)h(an)f(en)m(tire)h(string) 244 2234 y(from)c(the)i(So)s(c)m(k)m(et)h(and)f(then)g(use)h Fe(ssc)-5 b(anf)31 b Fn(and)i Fe(stpnxt)f Fn(to)h(parse)g(it.)119 2437 y(2.)49 b(P)m(olling)d(is)j(unfriendly)f(to)h(other)g(pro)s (cesses)i({)d(it)g(w)m(astes)j(a)d(tremendous)i(amoun)m(t)e(of)g Fl(CPU)244 2557 y Fn(time)33 b(merely)h(querying)h(the)g(So)s(c)m(k)m (et\(s\))i(to)d(see)i(if)d(an)m(ything)i(is)f(a)m(w)m(aiting)f(action.) 49 b(The)36 b(v)-5 b(arious)244 2678 y(blo)s(c)m(king)31 b(functions)i(are)f(m)m(uc)m(h)i(b)s(etter:)44 b(Sw)m(ait,)32 b(Stimeout)m(w)m(ait,)f(Smask)p Fl(XXX)p Fn(,)i(etc.)119 2881 y(3.)49 b(Unless)39 b(y)m(our)g(pro)s(cesses)i(will)36 b(alw)m(a)m(ys)j(run)g(on)f(the)h(same)f(kind)h(of)f(mac)m(hine,)h(p)s (ortabilit)m(y)d(con-)244 3002 y(siderations)k(argue)h(against)f(using) h(Sread)g(and)g(Swrite)g(to)g(mo)m(v)m(e)g(non-c)m(haracter)h(string)e (data)244 3122 y(around)33 b({)g(ie.)44 b(\015oats,)34 b(doubles,)f(and)g(ev)m(en)i(in)m(ts.)45 b(Ev)m(en)35 b(if)d(the)h(programmer)f(tests)i(out)f(the)g(ma-)244 3242 y(c)m(hines)j(and)f(v)m(eri\014es)i(that)e(\(s\)he)h(can)f(safely) h(mo)m(v)m(e,)g(sa)m(y)-8 b(,)36 b(a)f(double)g(around,)h(or)f(ev)m(en) i(a)e(v)m(ector)244 3363 y(of)h(doubles,)i(data)f(structures)h(\()p Ff(struct)53 b(XXX)f({)g(...)g(})p Fn(\))37 b(ma)m(y)f(ha)m(v)m(e)i (\\holes")f(in)f(them)g(placed)244 3483 y(there)c(for)f(w)m(ord)i(or)e (b)m(yte)i(alignmen)m(t)d(reasons.)44 b(These)33 b(\\holes")f(ma)m(y)f (not)h(b)s(e)f(there)i(\(or)e(ma)m(y)h(b)s(e)244 3604 y(placed)g(di\013eren)m(tly\))h(b)m(y)g(other)g(mac)m(hines)f(and)h (compilers.)119 3807 y(4.)49 b(The)25 b(Srmsrvr)g(function)f(is)g(a)g (rather)h(rude)g(function)f({)g(there)h(is)f(no)h(o)m(wnership)g(c)m (hec)m(k)i(of)d(a)g(serv)m(er.)244 3927 y(Please)33 b(use)h(y)m(our)g (pro)s(cess)g(name)f(\(or)g(y)m(our)g(id\))g(as)g(part)g(of)f(y)m(our)i (serv)m(er)h(name)e(so)g(that)g(serv)m(ers)244 4048 y(do)k(not)f (clash.)56 b(Remem)m(b)s(er:)c(y)m(our)37 b(serv)m(er's)i(name)e(is)f (in)g(only)g(one)i(\\name)e(space")h(shared)h(b)m(y)244 4168 y(all)30 b(users)k(on)f(y)m(our)g(mac)m(hine.)119 4371 y(5.)49 b(F)-8 b(or)38 b(those)i(of)e(y)m(ou)i(who)g(wish)f(to)f (use)i(other)g(services)g(\(ex.)g(serial)e(p)s(orts\))h(whic)m(h)g(can) h(use)g(the)244 4492 y Fe(sele)-5 b(ct)23 b Fn(function)h(pro)m(vided)g (b)m(y)h Fl(TCP/IP)c Fn(,)j(c)m(hec)m(k)j(out)c(Smaskfdset)i(and)f(its) f(mate,)j(Smaskunfdset.)119 4695 y(6.)49 b(The)23 b Fl(IRL)e Fn(has)h(b)s(een)g(using)g(a)f(leading)f(t)m(w)m(o)j(c)m(haracter)f (command)f(con)m(v)m(en)m(tion:)39 b Ff(tp~L~x~y~z)54 b(rx)e(ry)g(rz)244 4816 y Fn(will)34 b(tell)g(the)j(\\left")d(T3)j(rob) s(ot)e(to)h(mo)m(v)m(e)g(to)g(\\x)g(y)h(z")f(\(inc)m(hes\))h(in)e (space)i(with)f(an)g(orien)m(tation)244 4936 y(of)k(\\rx)i(ry)f(rz")g (degrees)h(\(roll,)f(pitc)m(h,)j(y)m(a)m(w\).)70 b(Longer)41 b(w)m(ords)h(pro)m(vide)f(more)f(readabilit)m(y)g(but)244 5056 y(tak)m(e)d(up)f(more)g(bandwidth.)55 b(Exp)s(erimen)m(tally)-8 b(,)36 b(Dr.)f(Campb)s(ell)g(has)h(found)h(that)f Fl(TCP/IP)d Fn(can)244 5177 y(transfer)40 b(ab)s(out)f(10,000)g(pac)m(k)m(ets)j(p)s (er)e(second)h(with)f(up)g(to)f(128)h(b)m(ytes)h(in)e(a)h(pac)m(k)m (et.)67 b(Loaded)244 5297 y(systems)34 b(will,)c(of)i(course,)i(ac)m (hiev)m(e)g(less)f(throughput.)1901 5707 y(13)p eop end %%Page: 14 16 TeXDict begin 14 15 bop 119 407 a Fn(7.)49 b(It)43 b(is)g(a)g(go)s(o)s (d)f(idea)g(for)h(clien)m(ts)g(to)g(inform)e(serv)m(ers)k(that)e(they)i (are)e(quitting.)74 b(The)44 b Fl(IRL)f Fn(has)244 527 y(used)31 b(the)f(follo)m(wing)c(con)m(v)m(en)m(tion:)44 b Ff(tq)30 b Fe(t)9 b Fn(ells)29 b(the)h(serv)m(er)h(that)f(the)g (messaging)e(clien)m(t)h(is)g Fe(q)9 b Fn(uitting.)244 648 y(Also,)33 b(a)g Ff(tQ)h Fn(tells)e(the)i(serv)m(er)i(to)d(sh)m(ut) h(itself)e(do)m(wn.)47 b(The)35 b(serv)m(er)g(then)f(emits)f(a)g Ff(tq)h Fn(to)f(all)e(of)i(its)244 768 y(clien)m(ts)f(to)g(inform)f (them)h(that)g(the)h(serv)m(er)h(is)e(sh)m(utting)h(do)m(wn)g(\(except) h(for)e(the)h(one)g(clien)m(t)f(who)244 888 y(issued)h(the)g(sh)m(utdo) m(wn)i(command\),)c(and)i(then)g(closes)g(itself)e(do)m(wn)j(with)e (Sclose.)119 1092 y(8.)49 b(The)36 b(serv)m(er-clien)m(t)h (relationship)d(is)h(in)m(timately)e(in)m(v)m(olv)m(ed)j(with)f(ob)5 b(ject-orien)m(ted)36 b(messaging)f({)244 1212 y(refer)e(to)f(the)h (literature)e(on)i(ob)5 b(ject-orien)m(ted)33 b(concepts.)119 1416 y(9.)49 b(The)35 b Fl(SSL)e Fn(can)h(b)s(e)h(used)g(to)f(supp)s (ort)g(a)g Fe(no)i(startup)h(se)-5 b(quencing)33 b Fn(paradigm.)46 b(T)m(ypically)-8 b(,)34 b(clien)m(ts)244 1536 y(who)f(attempt)f(to)g (Sop)s(en)h(and)g(fail)d(should)i(go)g(in)m(to)g(a)h(p)s(oll)d(-)i (sleep)h(lo)s(op:)244 1806 y Fg(Example)j(3.6)49 b Fe(Client)35 b(So)-5 b(cket)34 b(Pol)5 b(ling)705 2171 y Ff(skt=)53 b(Sopen\("servername","c"\);)705 2291 y(while\(!skt\))h({)808 2412 y(sleep\(1\);)808 2532 y(skt=)e(Sopen\("servername","c"\);)808 2653 y(})244 3043 y Fn(The)27 b Fe(multiskt.c)f Fn(program)f (illustrates)g(ho)m(w)i(serv)m(ers)i(should)d(b)s(e)g(able)g(to)g (accept)h(m)m(ultiple)d(clien)m(ts)244 3163 y(using)32 b(blo)s(c)m(king)g(judiciously)-8 b(.)244 3325 y(This)44 b(non-sequencing)h(approac)m(h)g(allo)m(ws)e(one)i(to)e(bring)h(up)g (programs)f(whic)m(h)i(ha)m(v)m(e)h(serv)m(ers)244 3445 y(and/or)33 b(clien)m(ts)h(without)g(w)m(orrying)g(ab)s(out)f(what)i (comes)f(\014rst.)48 b(F)-8 b(or)33 b(t)m(w)m(o)i(programs,)f(this)f (isn't)244 3566 y(terribly)38 b(serious,)i(but)g(at)e(the)h Fl(IRL)g Fn(n)m(umerous)g(programs)f(pro)m(viding)g(n)m(umerous)i (services)g(are)244 3686 y(a)m(v)-5 b(ailable)30 b(and)j(sequencing)h (w)m(ould)e(b)s(e)h(a)f(nigh)m(tmare.)70 3890 y(10.)49 b(As)25 b(alluded)f(to)h(earlier,)g(clien)m(ts)g(should)g(tell)e(serv)m (ers)k(and)f(serv)m(ers)h(should)e(tell)e(clien)m(ts)i(when)h(they)244 4010 y(are)d(going)e(do)m(wn.)41 b(The)24 b(program)e(that)g(is)h Fe(not)g Fn(quitting)e(should)i(return)g(to)g(an)g(\\a)m(w)m(aiting)e (another)244 4130 y(clien)m(t)26 b(\(or)h(serv)m(er\)")i(mo)s(de)d (\(ie.)h(see)h(the)g(preceding)f(item\).)41 b(Th)m(us,)28 b(a)f(troublesome)g(program)f(can)244 4251 y(b)s(e)j(brough)m(t)h(do)m (wn,)h(the)f(programs)e(to)h(whic)m(h)h(it)e(is)h(comm)m(unicating)e (will)g(gracefully)h(terminate)244 4371 y(their)c(connections,)j(and)e (the)g(programmer)e(can)i(then)h(\(hop)s(efully\))d(\014x)j(the)f (problem.)40 b(When)26 b(the)244 4491 y(program)d(is)g(restarted,)k (the)d(non-sequencing)h(approac)m(h)g(will)d(allo)m(w)g(the)j(program)d (to)i(seamlessly)244 4612 y(re-en)m(ter)33 b(in)m(to)f(comm)m (unications)f(with)h(the)h(other)g(soft)m(w)m(are.)70 4815 y(11.)49 b(When)28 b(a)e(mac)m(hine)h(is)f(do)m(wn,)j(and)e(an)g (attempt)f(to)h(connect)h(a)e(clien)m(t)g(So)s(c)m(k)m(et)j(using)d (either)h Fe(Sop)-5 b(en)244 4936 y Fn(directly)32 b(or)g Fe(Sop)-5 b(env)42 b Fn(to)33 b(a)f(serv)m(er)i(either)f(normally)d(or) i(p)s(ossibly)g(on)h(that)f(mac)m(hine,)h(the)g(Sop)s(en)244 5056 y(will)d(fail)g(but)j(will)e(tak)m(e)i(an)f(inordinately)f(long)g (time)h(doing)f(so)i(\(connection)g(timeout\).)70 5259 y(12.)49 b(When)27 b(a)g(program)e(dies)i(abruptly)-8 b(,)27 b(connected)h(So)s(c)m(k)m(ets)h(app)s(ear)d(to)h Fe(sele)-5 b(ct)p Fn(\(\))26 b(to)g(ha)m(v)m(e)i(something)244 5380 y(on)k(them)h(\(select)g(is)f(used)h(b)m(y)h(Stest,)f(Smasktest,)h (Sw)m(ait,)e(Smaskw)m(ait,)g(Sp)s(eek,)i(Stimeout)m(w)m(ait\).)1901 5707 y(14)p eop end %%Page: 15 17 TeXDict begin 15 16 bop 244 407 a Fn(Hence,)36 b(functions)e(whic)m(h)h (normally)c(blo)s(c)m(k)j(\(Smaskw)m(ait,)h(Sw)m(ait\))e(no)i(longer)e (blo)s(c)m(k.)48 b(On)34 b(com-)244 527 y(puters)j(whic)m(h)f(can)g Fl(MSG)p 1220 527 28 4 v 33 w(PEEK)f Fn(\(Unix,)i(Vms\),)f(the)g (Stest,)i(Sp)s(eek,)g(Sgets,)f(and)f(Sscanf)h(func-)244 648 y(tions)27 b(will)f(detect)j(this)e(situation)g(and)h(will)d (return)k(an)e(error)h(indication)e(\()p Fl(EOF)p Fn(,)i Fl(NULL)f Fn(p)s(oin)m(ter,)244 768 y(incomplete)j(argumen)m(t)h(pro)s (cessed)j(coun)m(t\))e(to)f(indicate)g(that)g(the)h(So)s(c)m(k)m(et)h (has)f(a)f(problem)g(\(one)244 888 y(should)h(then)i(Sclose)e(the)h (a\013ected)h(So)s(c)m(k)m(et\).)244 1050 y(F)-8 b(urthermore,)30 b(attempts)h(to)f(write)g(to)g(suc)m(h)j(dead)e(So)s(c)m(k)m(ets)h(ma)m (y)e(generate)i Fl(SIGPIPE)p Fn(s)e(on)g(Unix)244 1171 y(b)s(o)m(xes.)45 b(Unix)32 b(programmers)f(should)i(write)f(and)h (install)d(signal)h(handlers)i(for)f Fl(SIGPIPE)p Fn(s.)70 1374 y(13.)49 b(F)-8 b(or)43 b(m)m(ultiple)f(concurren)m(t)j(So)s(c)m (k)m(ets,)k(one)c(should)f(generate)g(routines)h(for)e(b)s(oth)h (closing)f(and)244 1494 y(op)s(ening)32 b(them.)244 1764 y Fg(Example)k(3.7)49 b Fe(Client)35 b(Op)-5 b(ening)33 b(F)-7 b(unction)705 2130 y Ff(#include)54 b("sockets.h")705 2250 y(typedef)f(struct)g(clientlist_str)i(ClientList;)705 2370 y(struct)e(clientlist_str)i({)910 2491 y(Socket)e(*skt;)910 2611 y(ClientList)h(*nxt,*prv;)910 2731 y(})705 2852 y(ClientList)g(*clhd=NULL;)705 2972 y(ClientList)g(*cltl=NULL;)757 3093 y(...)705 3213 y(ClientList)g(*openClient\(char)i(*srvrname\))705 3333 y({)705 3454 y(Socket)d(*skt;)705 3574 y(ClientList)h(*clist;)705 3694 y(while\(1\))g({)910 3815 y(skt=)f(Sopen\(srvrname,"c"\);)910 3935 y(if\(!skt\))h(sleep\(1\);)910 4056 y(})705 4176 y(clist=)f(\(ClientList)h(*\))e(malloc\(sizeof\(ClientList)q(\)\);)705 4296 y(if\(cltl\))i(cltl->nxt=)g(clist;)705 4417 y(else)258 b(clhd)f(=)52 b(clist;)705 4537 y(clist->prv=)i(cltl;)705 4658 y(clist->nxt=)g(NULL;)705 4778 y(cltl)309 b(=)51 b(clist;)705 4898 y(Smaskset\(skt\);)705 5019 y(clist->skt=)j(skt;)705 5139 y(return)f(clist;)705 5259 y(})1901 5707 y Fn(15)p eop end %%Page: 16 18 TeXDict begin 16 17 bop 244 407 a Fn(The)32 b Ff(openClient)p Fn(\(\))i(function)d(p)s(olls)e(once)j(a)f(second)i(in)d(attempting)g (to)h(op)s(en)g(a)g(clien)m(t)g(So)s(c)m(k)m(et.)244 527 y(Once)g(it)e(succeeds,)k(a)d(Clien)m(tList)f(data)h(structure)h (is)f(allo)s(cated,)f(double-link)m(ed,)g(and)i(a)f(p)s(oin)m(ter)244 648 y(to)i(it)g(returned.)44 b(In)33 b(addition,)e(the)i(new)h(clien)m (t)d(So)s(c)m(k)m(et)j(is)e(added)i(to)e(the)h(Smask.)244 917 y Fg(Example)j(3.8)49 b Fe(Client)35 b(Closing)e(F)-7 b(unction)705 1283 y Ff(void)53 b(closeClient\(ClientList)k(*clist\)) 705 1403 y({)705 1523 y(if\(clist\))d({)910 1644 y (Smaskunset\(clist->skt\);)910 1764 y(Sclose\(clist->skt\);)910 1885 y(clist->skt=)h(NULL;)910 2005 y(})705 2125 y(})244 2516 y Fn(The)33 b Ff(closeClient)p Fn(\(\))i(function)c(remo)m(v)m(es) i(the)g(clien)m(t)e(So)s(c)m(k)m(et)j(from)d(the)h(Smask)g(system,)h (closes)244 2636 y(the)40 b(So)s(c)m(k)m(et,)k(and)c(then)h(sets)g(the) g(skt)g(p)s(oin)m(ter)f(to)f(NULL)i(to)e(guaran)m(tee)i(that)f(the)h (no)m(w)f(dead)244 2756 y(so)s(c)m(k)m(et)34 b(w)m(on't)f(b)s(e)g (inadv)m(erten)m(tly)g(re-used)h(someho)m(w.)70 2960 y(14.)49 b(It)39 b(is)g(usually)g(advisable)g(to)g(use)h(some)f(sort)h (of)f(handshaking)g(proto)s(col)f(b)s(et)m(w)m(een)k(serv)m(er)f(and) 244 3080 y(clien)m(t,)e(esp)s(ecially)e(when)i(large)e(data)h(blo)s(c)m (ks)h(are)f(b)s(eing)f(mo)m(v)m(ed.)61 b(The)39 b Fl(TCP/IP)73 b Fn(bu\013ers)40 b(can)244 3200 y(easily)32 b(get)g(\014lled)g(and)h (data)f(get)h(lost)e(otherwise.)45 b(T)-8 b(o)32 b(facilitate)e(this,)j (the)g Fl(SSL)e Fn(sets)j(so)s(c)m(k)m(ets)h(up)244 3321 y(with)h(the)i Fl(TCP)p 842 3321 28 4 v 32 w(NODELA)-8 b(Y)37 b Fn(option)f(so)h(that)g(small)d(pac)m(k)m(ets)39 b(are)e(mo)m(v)m(ed)h(out)e(across)i(and)f(not)244 3441 y(collected)26 b(\(collection)f(of)h(small)e(pac)m(k)m(ets)29 b(normally)24 b(impro)m(v)m(es)j(net)m(w)m(ork)h(e\016ciency)h(since)e (there's)244 3562 y(less)33 b(o)m(v)m(erhead)h(p)s(er)f(b)m(yte)g(of)g (data\).)1901 5707 y(16)p eop end %%Page: 17 19 TeXDict begin 17 18 bop 0 407 a Fh(4)161 b(The)53 b(P)l(ortMaster)0 626 y Fn(Serv)m(ers)43 b(ha)m(v)m(e)f(names)f(pro)m(vided)g(b)m(y)g (the)h(program)d(whic)m(h)i(op)s(ens)h(them.)67 b(When)42 b(a)f(serv)m(er)h(is)e(to)h(b)s(e)0 746 y(op)s(ened,)f(the)e(Sop)s(en)g (function)f(temp)s(orarily)e(op)s(ens)j(a)f(So)s(c)m(k)m(et)i(to)e(the) h(P)m(ortMaster)h(running)e(on)h(the)0 867 y(same)25 b(mac)m(hine.)41 b(The)26 b(Sop)s(en)g(function)e(then)i(tells)f(the)g (P)m(ortMaster)i(the)e(serv)m(er's)j Fe(name)d Fn(and)g(the)h(\(ran-)0 987 y(dom\))h Fe(p)-5 b(ort)28 b Fn(assigned)h(to)f(the)g(new)h(serv)m (er,)i(and)e(then)f(closes)h(do)m(wn)g(the)g(connection.)42 b(The)29 b(P)m(ortMaster)0 1107 y(retains)j(a)h(list)e(of)h(all)e (activ)m(e)j(serv)m(ers)i(and)e(p)s(orts)f(running)g(on)h(its)f(mac)m (hine.)146 1228 y(A)j(clien)m(t)f(is)h(op)s(ened)g(using)g(the)g(Sop)s (en)g(function,)h(to)s(o.)49 b(In)35 b(that)g(case,)h(a)e(connection)h (is)g(made)f(to)0 1348 y(the)29 b(P)m(ortMaster)h(on)f(the)h(mac)m (hine)e(where)i(the)f(requested)j(serv)m(er)e(is)f(running.)41 b(The)30 b(P)m(ortMaster)g(then)0 1469 y(tells)42 b(the)h(Sop)s(en)g (function)g(the)g(p)s(ort)f(n)m(um)m(b)s(er)h(asso)s(ciated)g(with)g (the)g(requested)i(serv)m(er,)i(and)c(then)0 1589 y(closes)30 b(do)m(wn)g(the)g(temp)s(orary)f(connection.)42 b(The)31 b(Sop)s(en)f(function)f(then)h(attempts)f(to)g(connect)h(to)g(the)0 1709 y(serv)m(er)k(using)f(the)g(giv)m(en)f(p)s(ort.)146 1830 y(The)46 b(serv)m(er)h(program)c(can)i(use)h(its)e(serv)m(er)j(So) s(c)m(k)m(et)f(to)e(test)i(if)d(an)m(y)j(clien)m(ts)e(are)h(w)m(aiting) e(to)i(b)s(e)0 1950 y(connected)e(to)e(it)g(\(via)f(the)i(Stest)g (function\).)70 b(If)41 b(a)h(clien)m(t)e(is)h(w)m(aiting,)i(then)f (the)g(serv)m(er's)h(program)0 2070 y(can)34 b Fe(ac)-5 b(c)g(ept)34 b Fn(the)g(connection,)h(generating)e(an)h(accept)h(So)s (c)m(k)m(et)g(\(via)f(Saccept\).)49 b(Once)34 b(the)h(connection)0 2191 y(is)h(accepted,)k(the)d(program)e(attempting)g(to)i(op)s(en)g (the)g(clien)m(t)f(So)s(c)m(k)m(et)i(will)d(\014nally)g(receiv)m(e)j(a) f(So)s(c)m(k)m(et)0 2311 y(p)s(oin)m(ter.)0 2600 y Fc(4.1)135 b(Users)46 b(Guide)0 2785 y Fn(The)f(P)m(ortMaster)g(is)f(probably)g (the)g(simplest)f(program)g(to)h(run:)67 b(under)45 b Fl(UNIX)p Fn(,)f(t)m(yp)s(e)h Ff(Spm)52 b(&)45 b Fn(and)0 2905 y(under)33 b Fl(VMS)f Fn(t)m(yp)s(e)h Ff(run/detach)54 b(Spm)p Fn(.)44 b(The)33 b(P)m(ortMaster)h(will)29 b(only)j(allo)m(w)f (one)h(cop)m(y)h(of)f(itself)f(to)h(run)0 3026 y(on)i(an)m(y)i(giv)m (en)e(computer.)50 b(It)35 b(uses)h(a)e(\014xed)i(p)s(ort)e(address)i (\(1750,)e(no)m(w)h(registered)g(with)f Fl(IANA)p Fn(\))h(and)0 3146 y(implemen)m(ts)23 b(a)h(table)g(of)g(serv)m(er)i(names)f(mapping) e(to)h(random)f(p)s(orts.)41 b(Although)24 b(kno)m(wledgeable)h(users)0 3266 y(could)39 b(c)m(hange)h(the)f(P)m(ortMaster's)i(\014xed)f(p)s (ort,)g(this)f(is)g(discouraged:)56 b(hop)s(efully)-8 b(,)40 b(P)m(ortMasters)g(will)0 3387 y(proliferate)27 b(across)j(the)g(w)m(orld)f(and,)h(if)e(they)i(all)d(use)j(the)g(same)f (p)s(ort)g(on)g(their)f(mac)m(hines,)i(will)d(b)s(e)j(able)0 3507 y(to)35 b(comm)m(unicate)e(with)i(one)g(another.)50 b(In)36 b(other)f(w)m(ords,)h(the)g Fl(SSL)d Fn(will)g(b)s(e)i(unable)g (to)f(comm)m(unicate)0 3627 y(with)e(other)h Fl(SSL)e Fn(systems)j(whic)m(h)f(use)h(a)e(di\013eren)m(t)h(p)s(ort)f(for)g(its) g(P)m(ortMaster.)146 3748 y(Since)25 b Fl(MS-DOS)f Fn(is)g(not)g(a)g(m) m(ulti-tasking)d(op)s(erating)i(system,)k(unlik)m(e)d Fl(UNIX)p Fn(,)h Fl(VMS)p Fn(,)f(or)g Fl(Amiga-DOS)p Fn(,)0 3868 y(one)29 b(cannot)g(ha)m(v)m(e)h(a)e(P)m(ortMaster)i (running)e(in)f(the)j(bac)m(kground)f(|)f(there)i(is)e(no)g(bac)m (kground.)44 b(Hence,)0 3989 y Fl(MS-DOS)28 b Fn(programs)f(are)h (curren)m(tly)h(restricted)f(to)g(using)g(clien)m(t)f(So)s(c)m(k)m(ets) j(only)-8 b(,)28 b Fe(unless)g Fn(they)h(can)f(share)0 4109 y(another)33 b(mac)m(hine's)f(P)m(ortMaster)i(\(see)g(b)s(elo)m (w\).)146 4229 y(The)45 b(P)m(ortMaster)g(no)m(w)g(supp)s(orts)f(a)g (\014rew)m(all:)65 b(one)44 b(can)g(instruct)g(the)g(P)m(ortMaster)h (to)f(restrict)0 4350 y(access)38 b(to)f(a)f(group)g(of)h(mac)m(hines)f (b)m(y)i(their)e(host)h(addresses.)58 b(See)37 b(the)g(section)g(on)f Fe(The)i(PortMaster)0 4470 y(Fir)-5 b(ewal)5 b(l)31 b Fn(b)s(elo)m(w.)0 4759 y Fc(4.2)135 b(Sharing)45 b(P)l(ortMasters)0 4944 y Fn(P)m(ortMasters)g(can)e(no)m(w)h(b)s(e)f Fe(shar)-5 b(e)g(d)p Fn(.)74 b(This)43 b(feature)h(w)m(as)g(installed)d(mainly)g (to)h(supp)s(ort)i Fl(MSDOS)e Fn({)0 5064 y(since)f(it)e(do)s(esn't)i (ha)m(v)m(e)h(a)e(bac)m(kground)h(pro)s(cess)h(capabilit)m(y)-8 b(,)40 b(it)f(cannot)i(run)f(P)m(ortMasters.)69 b(Hence,)0 5184 y(it)41 b(is)h(normally)e(restricted)j(to)f(running)g(clien)m(ts)g (only)-8 b(,)44 b(b)s(ecause)g(serv)m(ers)g(normally)c(announce)j (their)0 5305 y(presence)28 b(to)d(their)g(host's)h(P)m(ortMaster.)42 b(If)26 b(the)g(en)m(vironmen)m(t)f(v)-5 b(ariable)24 b Ff(PMSHARE)j Fn(is)e(set)h(to)g(some)f(other)0 5425 y(mac)m(hine,)37 b(that)f(other)h(mac)m(hine's)f(P)m(ortMaster)i(will)c (b)s(e)i(used)i(b)m(y)f(the)g(host's)g(pro)s(cesses)i(attempting)1901 5707 y(17)p eop end %%Page: 18 20 TeXDict begin 18 19 bop 0 407 a Fn(to)33 b(op)s(en)h(serv)m(ers.)50 b(F)-8 b(rom)32 b(the)i(clien)m(t's)g(viewp)s(oin)m(t,)g(the)g(serv)m (er)h(app)s(ears)g(to)e(b)s(e)h(on)g(the)g(mac)m(hine)f(with)0 527 y(the)g(P)m(ortMaster)h({)e(the)h(clien)m(t)f(do)s(esn't)h(need)h (to)e(kno)m(w)i(ab)s(out)e(where)i(the)f(serv)m(er)h(actually)d(is.)0 756 y Fg(Example)37 b(4.1)48 b Fe(PortMaster)36 b(Sharing)p 33 786 2778 4 v 31 907 4 121 v 362 871 a Fg(Mac)m(hine)p 1104 907 V 498 w(Mac)m(hine)p 1855 907 V 439 w(Mac)m(hine)p 2809 907 V 31 1027 V 527 991 a(A)p 1104 1027 V 830 w(B)p 1855 1027 V 771 w(C)p 2809 1027 V 33 1031 2778 4 v 31 1151 4 121 v 1104 1151 V 1855 1151 V 2809 1151 V 31 1271 V 82 1235 a Fn(PMSHARE=mac)m(hineb)p 1104 1271 V 1855 1271 V 2809 1271 V 31 1392 V 1104 1392 V 1855 1392 V 2809 1392 V 31 1512 V 82 1476 a(op)s(ens)e(serv)m(er)g Fe(ASrvr)p 1104 1512 V 1855 1512 V 2809 1512 V 31 1632 V 1104 1632 V 1855 1632 V 2809 1632 V 31 1753 V 1104 1753 V 1156 1717 a Fn(B's)f(P)m(ortMaster)p 1855 1753 V 2809 1753 V 31 1873 V 1104 1873 V 1156 1837 a(no)m(w)g(has)g Fe(ASrvr)p 1855 1873 V 2809 1873 V 31 1994 V 1104 1994 V 1156 1958 a Fn(on)f(its)g(list)p 1855 1994 V 2809 1994 V 31 2114 V 1104 2114 V 1855 2114 V 2809 2114 V 31 2234 V 1104 2234 V 1855 2234 V 1907 2198 a(pgm)g(op)s(ens)h(clien)m(t)p 2809 2234 V 31 2355 V 1104 2355 V 1855 2355 V 1907 2319 a(to)f(ASrvr@mac)m(hineb)p 2809 2355 V 31 2475 V 1104 2475 V 1855 2475 V 2809 2475 V 31 2596 V 1104 2596 V 1156 2559 a(B's)h(P)m(ortMaster)p 1855 2596 V 2809 2596 V 31 2716 V 1104 2716 V 1156 2680 a(satis\014es)p 1855 2716 V 2809 2716 V 31 2836 V 1104 2836 V 1156 2800 a(clien)m(t's)f (request)p 1855 2836 V 2809 2836 V 31 2957 V 1104 2957 V 1855 2957 V 2809 2957 V 31 3077 V 1104 3077 V 1855 3077 V 1907 3041 a(pgm)g(has)h(clien)m(t)f(to)p 2809 3077 V 31 3197 V 1104 3197 V 1855 3197 V 1907 3161 a Fe(ASrvr)h Fn(on)f(A)p 2809 3197 V 33 3201 2778 4 v 146 3386 a(In)f(Example)f(4.1,)h(three)g(mac)m(hines)g(are)f(in)g(use.)44 b(Ho)m(w)m(ev)m(er,)33 b(mac)m(hines)e(B)g(and)f(C)h(could)f(ha)m(v)m (e)i(b)s(een)0 3507 y(the)d(same)g(mac)m(hine.)42 b(In)29 b(essence,)j(when)e(A)f(shares)h(B's)g(P)m(ortMaster,)g(the)g(serv)m (ers)h(on)e(A)f(app)s(ear)h(to)g(b)s(e)0 3627 y(on)j(B)g(insofar)g(as)g (Sop)s(en'ing)g(a)g(clien)m(t)f(is)h(concerned.)45 b(In)m(ternally)-8 b(,)32 b(of)g(course,)h(B's)g(P)m(ortMaster)g(kno)m(ws)0 3747 y(where)h(the)f Fe(ASrvr)g Fn(is,)f(and)g(clien)m(ts)h(end)g(up)g (b)s(eing)f(connected)i(to)e(the)h(serv)m(er)i(on)d(mac)m(hine)g(A.)0 4036 y Fc(4.3)135 b(Theory)45 b(of)g(Op)t(eration)0 4221 y Fn(Normally)-8 b(,)37 b(users)j(of)d(the)i Fl(SSL)e Fn(will)f(not)i(need)h(to)f(read)g(this)g(section.)60 b(Ho)m(w)m(ev)m(er,)42 b(for)c(those)g(who)h(are)0 4341 y(curious...)146 4462 y(There)k(are)f(t)m(w)m(o)g(main)e(b)s(ene\014ts) j(to)e(using)h(the)g Fl(SSL)p Fn(:)e(the)i(functions)g(are)f(similar)e (to)i(those)h(that)0 4582 y(the)32 b(C)h(programmer)d(already)h(kno)m (ws)j(ho)m(w)f(to)e(use)i(and)f(hence)i(the)e Fl(SSL)f Fn(has)h(a)g(rapid)f(learning)f(curv)m(e,)0 4702 y(and)k(second,)h (serv)m(ers)g(are)f(assigned)g(to)f(curren)m(tly)h(a)m(v)-5 b(ailable)31 b(p)s(orts.)46 b(The)35 b(P)m(ortMaster)f(is)f(in)m (tegral)f(to)0 4823 y(pro)m(viding)g(the)h(second)g(b)s(ene\014t.)146 4943 y(Berk)m(eley)38 b(so)s(c)m(k)m(ets)h(are)e(assigned)g(p)s(orts,)g (whic)m(h)g(are)g(basically)e(just)i(in)m(tegers.)56 b(The)38 b(p)s(ort)e(is)g(used)0 5064 y(in)m(ternally)f(to)h(assign)h (the)g(\015o)m(w)g(of)f(data)g(to)h(the)g(correct)g(places.)56 b(One)37 b(m)m(ust)f(assign)h(a)f(sp)s(eci\014c)h(p)s(ort)0 5184 y(to)28 b(a)h(serv)m(er)h(or,)g(alternativ)m(ely)-8 b(,)28 b(allo)m(w)f(the)i(system)h(to)e(assign)h(an)m(y)g(a)m(v)-5 b(ailable)26 b(p)s(ort)j(to)f(it.)41 b(Clien)m(ts)29 b(m)m(ust)0 5304 y(use)j(that)f(same)g(p)s(ort)g(n)m(um)m(b)s(er)h(to)f (connect)h(to)f(the)h(desired)g(serv)m(er.)45 b(Hence,)33 b(the)e(problem)f(with)h(using)0 5425 y(the)d(\\an)m(y)h(a)m(v)-5 b(ailable)25 b(p)s(ort")i(is)h(ho)m(w)g(to)g(get)f(the)i(clien)m(t)e (pro)s(cess)i(to)f(kno)m(w)h(what)f(the)g(curren)m(tly)h(assigned)0 5545 y(p)s(ort)42 b(is!)71 b(Programmers)41 b(using)h(Berk)m(eley)h(so) s(c)m(k)m(ets)i(ha)m(v)m(e)e(t)m(ypically)e(just)h(assigned)h(a)e (\014xed)j(p)s(ort)d(to)1901 5707 y(18)p eop end %%Page: 19 21 TeXDict begin 19 20 bop 0 407 a Fn(their)35 b(serv)m(er)j(and)e (hard-co)s(ded)g(the)h(clien)m(ts)e(with)h(that)g(p)s(ort.)53 b(If)36 b(some)f(other)h(pro)s(cess)i(just)e(happ)s(ens)0 527 y(to)31 b(use)i(that)e(same)g(p)s(ort,)g(then)i(things)e(get)g (messy)i({)e(re-compile,)f(w)m(ait)g(un)m(til)h(the)h(other)f(pro)s (cess)i(go)s(es)0 648 y(a)m(w)m(a)m(y)-8 b(,)38 b(etc.)54 b(On)36 b(a)g(mac)m(hine)f(where)i(there)g(are)f(man)m(y)g(users,)i (co-op)s(eration)c(b)s(et)m(w)m(een)k(the)f(users)g(ma)m(y)0 768 y(b)s(e)c(impractical.)146 888 y(The)25 b(P)m(ortMaster)g(solv)m (es)g(the)f(problem)f(of)g(asso)s(ciating)f(a)i(serv)m(er)i(name)d (with)h(a)f(randomly)g(assigned)0 1009 y(\(and)30 b(a)m(v)-5 b(ailable\))27 b(p)s(ort,)j(and)g(making)e(that)i(asso)s(ciation)e(a)m (v)-5 b(ailable)28 b(to)h(clien)m(ts.)42 b(The)31 b(P)m(ortMaster)g (itself)0 1129 y(uses)36 b(a)f(\014xed)h(p)s(ort,)g(and)f(so)g(serv)m (ers)i(and)e(clien)m(ts)g(alw)m(a)m(ys)h(kno)m(w)g(\\where")g(it)e(is.) 50 b(Whenev)m(er)37 b(a)e(serv)m(er)0 1249 y(op)s(ens)27 b(\(using)g(the)g(Sop)s(en\(")p Fl(XXX)p Fn(","s"\))g(call\),)g(the)g (Sop)s(en)g(function)f(mak)m(es)i(a)e(So)s(c)m(k)m(et)i(data)f (structure,)0 1370 y(creates)34 b(a)e(Berk)m(eley)i(so)s(c)m(k)m(et,)h (initializes)29 b(and)k(binds)g(the)g(so)s(c)m(k)m(et)h(with)f(an)m(y)g (a)m(v)-5 b(ailable)30 b(p)s(ort,)i(and)h(then)0 1490 y(connects)38 b(to)f(the)g(P)m(ortMaster,)i Fe(using)g(its)g(\014xe)-5 b(d)38 b(p)-5 b(ort)p Fn(.)56 b(It)37 b(then)h(sends)g(a)f(\\message")g (\()p Fl(PM)p 3479 1490 28 4 v 33 w(SER)-10 b(VER)p Fn(,)0 1611 y(whic)m(h)24 b(is)g(simply)e(an)i(in)m(teger\))f(to)h(the)g(P)m (ortMaster,)j(telling)21 b(it)i(the)h(t)m(yp)s(e)g(of)g(So)s(c)m(k)m (et)h(it)d(is.)41 b(Subsequen)m(tly)-8 b(,)0 1731 y(the)33 b(P)m(ortMaster)h(gets)f(the)g(new)g(serv)m(er's)i(name)d(and)h(the)g (p)s(ort)f(it)g(is)g(assigned)h(to.)146 1851 y(When)39 b(a)f(clien)m(t)g(op)s(ens,)i(it)d(mak)m(es)i(a)e(So)s(c)m(k)m(et,)k (initializes)35 b(a)j(Berk)m(eley)h(so)s(c)m(k)m(et)h(as)e(a)g(clien)m (t)f(\(using)0 1972 y(the)28 b Fl(AF)p 295 1972 V 34 w(INET)f Fn(format\),)h(gets)g(a)g(\\host")g(en)m(tit)m(y)h(p)s(oin)m (ter)e(\(the)i(serv)m(er's)h(mac)m(hine)e(is)f(kno)m(wn)j(as)e(a)g (host\),)0 2092 y(and)36 b(then)h(connects)h(to)d(the)i(P)m(ortMaster)g (on)f(the)g(host)h(mac)m(hine.)53 b(It)36 b(then)h(sends)h(a)e(\\)p Fl(PM)p 3473 2092 V 32 w(CLIENT)p Fn(")0 2213 y(to)j(that)g(P)m (ortMaster)i(and)e(the)h(desired)g(serv)m(er's)i(name;)g(that)e(P)m (ortMaster)g(will)d(resp)s(ond)j(with)g(the)0 2333 y(asso)s(ciated)k(p) s(ort)f(n)m(um)m(b)s(er)h(\(if)f(there)h(is)g(one\).)77 b(The)45 b(clien)m(t)e(then)h(closes)g(do)m(wn)h(the)f(connection)g(to) 0 2453 y(the)34 b(target)f(host's)h(P)m(ortMaster,)h(and)e(initializes) d(a)j(Berk)m(eley)i(so)s(c)m(k)m(et)g(with)e(the)h(p)s(ort)f(n)m(um)m (b)s(er)g(it)g(just)0 2574 y(receiv)m(ed)h(and)f(returns)g(a)f(clien)m (t)g(So)s(c)m(k)m(et)i(p)s(oin)m(ter)e(to)g(the)h(user.)146 2694 y(Th)m(us,)h(the)e Fl(SSL)p Fn('s)f(P)m(ortMaster)i(system)g(is)e (a)h(distributed)f(database.)44 b(There)33 b(are)f(adv)-5 b(an)m(tages)32 b(and)0 2814 y(disadv)-5 b(an)m(tages)25 b(to)f(this)g(sc)m(heme.)42 b(No)24 b(P)m(ortMaster)i(kno)m(ws)g(an)m (ything)e(ab)s(out)g(serv)m(ers)j(residing)c(on)i(other)0 2935 y(mac)m(hines;)30 b(if)f(a)g(mac)m(hine)f(go)s(es)i(do)m(wn,)h (other)e(mac)m(hines)g(whic)m(h)h(ha)m(v)m(e)h(no)e(need)h(to)f(comm)m (unicate)f(with)0 3055 y(the)33 b(do)m(wned)h(mac)m(hine)e(are)h(not)f (a\013ected.)146 3176 y(On)39 b(the)g(other)f(hand,)h(a)f(single)f(mac) m(hine)h(with)g(a)h(single)e(P)m(ortMaster)i(w)m(ould)g(ob)m(viate)f (the)h(need)0 3296 y(for)48 b(clien)m(ts)f(to)h(kno)m(w)h(what)g(mac)m (hines)f(they)h(wish)f(to)g(connect)h(to,)j(and)c(could)f(force)i(serv) m(ers)h(on)0 3416 y(all)41 b(mac)m(hines)j(to)f(ha)m(v)m(e)i(unique)f (names)f(\(as)h(it)e(is,)k(serv)m(ers)g(can)e(ha)m(v)m(e)h(the)e(same)h (name)f(so)g(long)g(as)0 3537 y(they)36 b(run)g(on)f(di\013eren)m(t)g (mac)m(hines\).)52 b(As)35 b(a)g(palliativ)m(e,)f(the)h Fe(Sop)-5 b(env)34 b Fn(function)h(supp)s(orts)h(the)g(concept)0 3657 y(of)f(a)f Fe(machine)i(p)-5 b(ath)35 b Fn(via)f(the)i(use)g(of)e (en)m(vironmen)m(t)i(v)-5 b(ariables.)50 b(Using)34 b(the)i(Sop)s(en)m (v)g(function,)f(clien)m(ts)0 3778 y(can)26 b(\\h)m(un)m(t")g(do)m(wn)h (a)e(giv)m(en)h(serv)m(er)h(b)m(y)g(attempting)d(to)h(op)s(en)h(a)f (clien)m(t)g(one)h(at)g(a)f(time)f(on)i(eac)m(h)g(mac)m(hine)0 3898 y(un)m(til)j(a)i(serv)m(er)h(of)f(that)f(name)h(is)f(found.)43 b(Th)m(us,)33 b(the)e(user)g(can)g(designate)g(a)g(lo)s(cal)d(group)j (of)f(mac)m(hines)0 4018 y(via)c(an)h(en)m(vironmen)m(t)h(v)-5 b(ariable)25 b(\(t)m(ypically)-8 b(,)27 b(the)g(\\)p Fl(SKTP)-8 b(A)g(TH)p Fn(")26 b(en)m(vironmen)m(t)i(v)-5 b(ariable)25 b(is)i(used)h(for)e(this)0 4139 y(purp)s(ose\).)146 4259 y(The)k(P)m(ortMaster)f(talks)f(to)g(its)g(temp)s(orary)f(clien)m (ts)h(using)g(a)g(relativ)m(ely)f(simple)g(proto)s(col)g(based)i(on)0 4379 y(\\messages")j(\(in)m(tegers\))f(de\014ned)i(in)e(the)g Ff(sockets.h)j Fn(header)e(\014le.)43 b(T)-8 b(able)31 b(3)g(illustrates)f(the)h(proto)s(col.)0 4500 y(If)k(the)h(P)m (ortMaster)h(is)d(using)h(its)g(\014rew)m(all)g(capabilit)m(y)-8 b(,)34 b(it)g(immediately)f(c)m(hec)m(ks)38 b(all)33 b(of)i(its)g(temp)s(orary)0 4620 y(clien)m(ts)25 b(for)g(appro)m(v)m (ed)i(mac)m(hine)e(status;)h(a)g Fl(PM)p 1757 4620 V 32 w(SORR)-8 b(Y)25 b Fn(is)g(issued)i(immediately)22 b(prior)i(to)i(the)f(proto)s(col)0 4741 y(in)32 b(T)-8 b(able)32 b(3)g(up)s(on)h(failure)e(to)h(b)s(e)h(appro)m(v)m(ed.)45 b(The)33 b(connection)g(is)f(then)h(summarily)d(sev)m(ered.)146 4861 y(As)i(indicated)f(in)g(T)-8 b(able)31 b(3,)h(the)f(P)m(ortMaster) i(handles)f(more)f(ev)m(en)m(ts)j(than)d(just)h(the)g Fl(PM)p 3506 4861 V 33 w(SER)-10 b(VER)0 4981 y Fn(and)33 b Fl(PM)p 340 4981 V 33 w(CLIENT)e Fn(ev)m(en)m(ts)k(men)m(tioned)d (earlier.)42 b(When)34 b(a)e(clien)m(t)g(op)s(ens)h(to)f(the)h(P)m (ortMaster,)h(it)e(iden-)0 5102 y(ti\014es)37 b(the)h(t)m(yp)s(e)h(of)e (service)h(it)f(wishes)h(b)m(y)h(sending)e(that)h(P)m(ortMaster)g(a)f (\\message":)54 b Fl(PM)p 3479 5102 V 33 w(SER)-10 b(VER)p Fn(,)0 5222 y Fl(PM)p 150 5222 V 33 w(CLIENT)p Fn(,)40 b Fl(PM)p 747 5222 V 33 w(CLOSE)p Fn(,)f Fl(PM)p 1298 5222 V 33 w(T)-8 b(ABLE)p Fn(,)41 b(or)f Fl(PM)p 1980 5222 V 33 w(QUIT)p Fn(.)h(These)h(messages)g(are)f(discussed)h(b)s(elo) m(w.)0 5342 y(Whenev)m(er)31 b(the)d(P)m(ortMaster)i(do)s(es)f(not)f (understand)i(the)f(initial)24 b(message)29 b(\(due)g(to)f(garbling)e (or)i(what-)0 5463 y(ev)m(er\),)53 b(the)47 b(P)m(ortMaster)i(will)c (immediately)g(issue)j(a)f Fl(PM)p 2269 5463 V 33 w(RESEND)g Fn(message)h(and)f(then)i(w)m(ait)d(for)1901 5707 y(19)p eop end %%Page: 20 22 TeXDict begin 20 21 bop 0 407 a Fn(data.)83 b(It)45 b(will)f(con)m(tin) m(ue)i(doing)f(so)h(for)f(up)h(to)f Fl(PM)p 2029 407 28 4 v 33 w(MAXTR)-8 b(Y)47 b Fn(times)d(\(in)h(the)h Ff(sockets.h)i Fn(\014le)e(as)0 527 y(sen)m(t,)36 b Fl(PM)p 383 527 V 33 w(MAXTR)-8 b(Y)35 b Fn(is)f(de\014ned)h(as)g(20\).)47 b(If)35 b(the)f(limit)d(of)j(re-tries)f(is)h(reac)m(hed,)i(the)f(P)m (ortMaster)g(will)0 648 y(p)s(eremptorily)42 b(close)h(do)m(wn)i(the)e (connection)h(and)g(go)f(bac)m(k)h(to)f(its)g(usual)g(quiescen)m(t)i (state)f(w)m(aiting)0 768 y(for)32 b(a)g(new)i(connection.)146 888 y(The)j(P)m(ortMaster)g(will)d(w)m(ait)i(no)g(more)f(than)h Fl(TIMEOUT)f Fn(seconds)j(for)d(data,)i(whic)m(h)g(is)e(set)i(to)e(20)0 1009 y(seconds)27 b(in)e Ff(Spm.c)i Fn(as)f(deliv)m(ered.)41 b(If)25 b(that)h(amoun)m(t)f(of)g(time)f(elapses,)k(the)e(P)m (ortMaster)g(will)d(summarily)0 1129 y(close)33 b(do)m(wn)g(the)g(temp) s(orary)f(clien)m(t)g(and)g(con)m(tin)m(ue)i(for)e(more)g(business.)0 1357 y Fm(PM)p 176 1357 32 4 v 38 w(CLIENT)47 b Fn(tells)41 b(the)h(P)m(ortMaster)g(that)f(a)h(clien)m(t)e(is)h(attempting)f(to)h (op)s(en.)70 b(The)43 b(P)m(ortMaster)244 1478 y(normally)20 b(resp)s(onds)j(with)f(a)f Fl(PM)p 1469 1478 28 4 v 33 w(OK)h Fn(and)g(the)g(program)f(attempting)g(to)g(op)s(en)i(a)e(clien)m (t)h(resp)s(onds)244 1598 y(with)44 b(a)h(n)m(ull-b)m(yte)f(terminated) f(string)h(\(the)i(requested)g(serv)m(er)h(name\).)79 b(If)45 b(the)g(P)m(ortMaster)244 1719 y(\014nds)31 b(the)f(requested)i (serv)m(er)f(in)e(its)g(list,)g(then)h(it)f(resp)s(onds)i(with)e(a)g Fl(PM)p 2948 1719 V 33 w(OK)g Fn(and)h(then)g(the)g(p)s(ort)244 1839 y(n)m(um)m(b)s(er,)j(otherwise)g(it)f(sends)i(a)e Fl(PM)p 1650 1839 V 33 w(SORR)-8 b(Y)p Fn(.)244 2001 y(If)33 b(the)h(P)m(ortMaster)h(is)e(using)g(a)g(\014rew)m(all,)g(it)g (ma)m(y)g(resp)s(ond)h(immediately)d(with)66 b(a)33 b Fl(PM)p 3556 2001 V 33 w(SORR)-8 b(Y)244 2121 y Fn(if)31 b(the)i(clien)m(t)f(is)g(originating)d(from)j(an)g(unappro)m(v)m(ed)j (mac)m(hine.)0 2325 y Fm(PM)p 176 2325 32 4 v 38 w(CLIENTW)-12 b(AIT)47 b Fn(acts)41 b(m)m(uc)m(h)g(lik)m(e)e(a)h Fl(PM)p 1848 2325 28 4 v 33 w(CLIENT)p Fn(,)f(except)j(that)e(the)g(P)m (ortMaster)i(will)37 b(w)m(ait)244 2445 y(\(blo)s(c)m(k\))d(b)s(efore)h (sending)f(the)h(\014nal)f Fl(PM)p 1767 2445 V 33 w(OK)g Fn(and)g(p)s(ort)g(n)m(um)m(b)s(er.)50 b(Th)m(us)36 b(clien)m(ts)e(can) h(request)h(a)244 2565 y(blo)s(c)m(k)c(un)m(til)g(the)h(desired)g(serv) m(er)h(is)e(up.)0 2769 y Fm(PM)p 176 2769 32 4 v 38 w(CLOSE)48 b Fn(tells)34 b(the)j(P)m(ortMaster)f(that)g(a)f(serv)m(er)j(is)d (closing)g(do)m(wn.)54 b(The)36 b(P)m(ortMaster)h(will)d(nor-)244 2889 y(mally)i(resp)s(ond)j(with)f(a)g Fl(PM)p 1355 2889 28 4 v 33 w(OK)p Fn(;)f(the)i(program)e(closing)g(do)m(wn)i(the)g(serv) m(er)h(\(via)d Fe(Sclose)p Fn(\))g(will)244 3010 y(then)j(send)h(the)f (p)s(ort)f(n)m(um)m(b)s(er.)64 b(The)41 b(P)m(ortMaster)f(will)e(then)i (remo)m(v)m(e)g(the)g(asso)s(ciated)f(serv)m(er)244 3130 y(from)28 b(its)g(in)m(ternal)g(list)f(of)i(serv)m(ers)i(and)e(resp)s (ond)h(with)e(a)h Fl(PM)p 2539 3130 V 33 w(OK)f Fn(if)g(the)h (designated)g(serv)m(er)i(w)m(as)244 3250 y(in)h(its)g(list)f(and)i(a)f Fl(PM)p 1078 3250 V 33 w(SORR)-8 b(Y)32 b Fn(otherwise.)0 3454 y Fm(PM)p 176 3454 32 4 v 38 w(FWINIT)48 b Fn(tells)26 b(the)h(P)m(ortMaster)i(to)d(re-read)h(its)g(\014rew)m(all)f (data\014le.)41 b(The)28 b(P)m(ortMaster)h(will)24 b(then)244 3574 y(resp)s(ond)33 b(with)f(a)h Fl(PM)p 1064 3574 28 4 v 33 w(OK)f Fn(if)f(it)h(w)m(ork)m(ed)i(or)e Fl(PM)p 2055 3574 V 33 w(RESEND)g Fn(if)g(something)f(got)h(garbled.)0 3778 y Fm(PM)p 176 3778 32 4 v 38 w(QUIT)48 b Fn(tells)34 b(the)h(P)m(ortMaster)g(that)g(a)f(sh)m(utdo)m(wn)j(command)c(is)h(to)g (b)s(e)h(sen)m(t.)50 b(The)36 b(P)m(ortMaster)244 3898 y(resp)s(onds)30 b(with)e(a)h Fl(PM)p 1091 3898 28 4 v 33 w(OK)p Fn(,)f(and)h(the)g(program)e(sh)m(utting)i(do)m(wn)g(the)h (P)m(ortMaster)f(issues)h(a)f(n)m(ull-)244 4018 y(b)m(yte)48 b(terminated)e(string,)j(\\P)m(ortMaster")f(\(just)f(to)f(guaran)m(tee) h(that)g(a)f(sh)m(utdo)m(wn)j(is)d(really)244 4139 y(w)m(an)m(ted\).)c (The)26 b(P)m(ortMaster)g(will)d(then)j(sh)m(utdo)m(wn.)43 b(This)25 b(op)s(eration)e(requires)j(some)f(kno)m(wledge)244 4259 y(of)32 b(the)h(proto)s(col)e(as)i(no)g Fl(SSL)f Fn(function)g(is)g(pro)m(vided)h(to)g(mak)m(e)f(sh)m(utting)h(do)m(wn)h (the)f(P)m(ortMaster)244 4379 y(easy)-8 b(.)44 b(Ho)m(w)m(ev)m(er,)35 b(the)e Ff(sktdbg)h Fn(program)d(do)s(es)i(pro)m(vide)g(an)f(easy)i(w)m (a)m(y)f(to)f(sh)m(ut)i(do)m(wn)f(the)g(P)m(ort-)244 4500 y(Master.)58 b(Concerned)38 b(system)h(administrators)34 b(ma)m(y)j(wish)g(to)g(remo)m(v)m(e)h(the)f(\\sh)m(ut")h(command)244 4620 y(from)26 b Ff(sktdbg)p Fn(.)44 b(Sh)m(utting)27 b(do)m(wn)h(the)g(P)m(ortMaster)h(do)s(es)f(not)f(a\013ect)h(curren)m (tly)g(connected)i(So)s(c)m(k-)244 4741 y(ets;)45 b(ho)m(w)m(ev)m(er,)f (new)d(connections)g(b)s(et)m(w)m(een)h(serv)m(ers)h(and)d(clien)m(ts)g (cannot)g(b)s(e)h(made.)65 b(On)41 b(the)244 4861 y(other)f(hand,)j (starting)d(up)g(a)h(new)g(P)m(ortMaster)g(is)f(easy)i(and)e(an)m(y)m (one)i(ma)m(y)e(do)h(so)f({)g(the)h Ff(Spm)244 4981 y Fn(program)35 b(itself)f(will)g(refuse)j(to)f(allo)m(w)e(t)m(w)m(o)j(P) m(ortMasters)h(to)e(run)g(concurren)m(tly)h(\(and)f(will)e(sa)m(y)244 5102 y(so\).)0 5305 y Fm(PM)p 176 5305 32 4 v 38 w(SER)-12 b(VER)50 b Fn(tells)23 b(the)i(P)m(ortMaster)g(that)f(a)g(serv)m(er)j (has)d(b)s(een)h(op)s(ened.)42 b(The)25 b(P)m(ortMaster)h(will)c(nor-) 244 5425 y(mally)k(resp)s(ond)j(with)e(a)h Fl(PM)p 1314 5425 28 4 v 33 w(OK)g Fn(and)g(then)h(the)f(program)f(op)s(ening)h(a)g (serv)m(er)i(will)25 b(send)30 b(a)e(string)244 5546 y(giving)j(the)i(new)g(serv)m(er's)i(name)d(and)h(then)g(will)e(send)i (its)f(p)s(ort.)1901 5707 y(20)p eop end %%Page: 21 23 TeXDict begin 21 22 bop 244 407 a Fn(The)49 b(P)m(ortMaster)h(will)c (then)j(resp)s(ond)g(with)f(a)g Fl(PM)p 2298 407 28 4 v 33 w(OK)g Fn(up)s(on)g(success)j(or)96 b(a)48 b Fl(PM)p 3556 407 V 33 w(SORR)-8 b(Y)244 527 y Fn(if)31 b(a)i(serv)m(er)h(b)m(y) f(that)g(name)f(already)g(exists.)244 689 y(If)k(the)g(P)m(ortMaster)h (is)f(using)g(a)f(\014rew)m(all,)i(it)d(ma)m(y)i(resp)s(ond)h (immediately)c(with)j(a)f Fl(PM)p 3556 689 V 33 w(SORR)-8 b(Y)244 809 y Fn(if)39 b(the)i(serv)m(er)h(is)e(originating)c(from)k (an)g(unappro)m(v)m(ed)i(mac)m(hine.)66 b(When)41 b(P)m(ortMaster)h (sharing)244 930 y(is)g(not)h(op)s(erating,)i(this)e(ev)m(en)m(t)h (should)f(nev)m(er)i(o)s(ccur,)h(as)d(serv)m(ers)j(can)d(then)h(only)e (b)s(e)h(legally)244 1050 y(generated)e(on)f(the)h(same)f(mac)m(hine)g (that)g(the)h(P)m(ortMaster)g(resides)h(up)s(on.)67 b(The)41 b(P)m(ortMaster)244 1171 y(en)m(ters)30 b(its)e(o)m(wn)i(host)f(on)m (to)g(its)f(in)m(ternal)g(\014rew)m(all)f(table)i(whenev)m(er)i(use)f (of)e(a)g(\014rew)m(all)g(is)h(enabled.)0 1374 y Fm(PM)p 176 1374 32 4 v 38 w(T)-9 b(ABLE)49 b Fn(tells)30 b(the)i(P)m (ortMaster)h(to)e(giv)m(e)g(out)g(a)g(list)f(of)h(the)h(serv)m(ers)i (it)c(curren)m(tly)i(kno)m(ws)h(ab)s(out.)244 1494 y(Normally)d(the)k (P)m(ortMaster)g(will)d(resp)s(ond)i(with)66 b(a)33 b Fl(PM)p 2397 1494 28 4 v 33 w(OK)p Fn(,)f(a)h(coun)m(t)g(of)g(serv)m (ers)i(\(in)d(net)m(w)m(ork)244 1615 y(standard)f(2-b)m(yte)g(format,)e (see)j(the)e(Berk)m(eley)i(\\n)m(tohs")f(function)f(for)g(details\),)g (and)g(a)g(sequence)244 1735 y(of)f(strings)h(giving)e(the)i(serv)m(er) h(name)e(and)h(asso)s(ciated)g(p)s(ort)f(n)m(um)m(b)s(er.)43 b(The)31 b Ff(spmtable)g Fn(program)244 1856 y(and)i Ff(sktdbg)p Fn('s)h(\\table")e(function)g(use)h(this)g(facilit)m(y)-8 b(.)0 2115 y Fg(4.3.1)112 b(The)38 b(P)m(ortMaster)f(Firew)m(all)0 2300 y Fn(The)d(P)m(ortMaster)g(supp)s(orts)g(a)f Fe(\014r)-5 b(ewal)5 b(l)32 b Fn(to)g(k)m(eep)j(out)e(so)s(c)m(k)m(et)h(requests)h (from)d(unappro)m(v)m(ed)j(mac)m(hines.)0 2420 y(The)g(\014rew)m(all)e (consists)i(of)e(a)h(list)e(of)i(mac)m(hines')g(in)m(ternet)g (addresses)i(in)e(a)f(\014le.)47 b(One)35 b(sp)s(eci\014es)g(the)f (\014le)0 2541 y(b)m(y)f(one)g(of)f(t)m(w)m(o)i(metho)s(ds:)119 2769 y(1.)49 b(Startup)33 b(with)83 b Ff(Spm)52 b(-f)p Fe(ful)5 b(l-p)-5 b(ath-to-\014lename)119 2973 y Fn(2.)49 b(Initialization)24 b(of)k(an)g(en)m(vironmen)m(t)h(v)-5 b(ariable,)28 b Fl(SPMFIREW)-10 b(ALL)p Fn(,)28 b(to)h(the)g Fe(ful)5 b(l-p)-5 b(ath-to-\014lename)p Fn(.)146 3201 y(The)34 b Fe(ful)5 b(l-p)-5 b(ath-to-\014lename)31 b Fn(\014le)h(con)m(tains)g(records)i(of)e(the)h(form:)103 3404 y Ff(*)51 b(*)h(number)g(number)h(number)g(number)146 3608 y Fn(where)37 b(the)f(four)f Ff(number)p Fn(s)i(are)f(the)g(in)m (ternet)f(addresses)j(of)d(the)h(mac)m(hines)f(p)s(ermitted)g(to)g (talk)f(to)0 3728 y(the)44 b(P)m(ortMaster.)76 b(The)44 b Ff(*)f Fn(indicates)g(accept)h(an)m(y)g(n)m(um)m(b)s(er)g(in)e(that)h (\014eld.)75 b(The)44 b(\014rew)m(all)e(function)0 3848 y(examines)33 b(incoming)d(in)m(ternet)j(addresses)h(b)m(y)g(use)f(of)g (the)g Fe(getp)-5 b(e)g(ername)31 b Fn(function.)146 3969 y(The)i(\014rew)m(all)d(\014le,)h(often)h(called)e Fe(spm\014r)-5 b(ewal)5 b(l.dat)p Fn(,)30 b(ma)m(y)h(con)m(tain)g (blank)g(lines.)42 b(The)33 b Ff(#)e Fn(is)g(assumed)0 4089 y(to)h(b)s(egin)g(a)g(commen)m(t)g(and)h(is)f(stripp)s(ed)h (o\013.)1901 5707 y(21)p eop end %%Page: 22 24 TeXDict begin 22 23 bop 0 407 a Fh(5)161 b(The)53 b(Utilities)0 626 y Fn(There)36 b(are)f(sev)m(eral)h(utilities)c(pro)m(vided)k(with)e (the)i Fl(SSL)p Fn(,)e(and)h(they)h(are)f(explained)f(b)s(elo)m(w.)51 b(These)37 b(are)0 746 y(all)30 b(complete)i(programs)g(in)g(themselv)m (es,)i(and)e(can)h(serv)m(e)i(as)d(lessons)i(on)e(ho)m(w)i(to)e(use)h (the)g Fl(SSL)p Fn(.)0 975 y Fg(sktdbg)49 b Ff(server-name)54 b({s|c})48 b Fe(sktdb)-5 b(g)45 b Fn(is)h(the)h Fl(SSL)p Fn('s)e(testing)h(program.)83 b(One)46 b(ma)m(y)g(op)s(en)g(serv)m(er) 244 1095 y(So)s(c)m(k)m(ets,)36 b(accept)g(So)s(c)m(k)m(ets,)g(and)f (clien)m(t)e(So)s(c)m(k)m(ets,)k(test)e(out)f(ho)m(w)h(other)f (program's)g(So)s(c)m(k)m(ets)i(are)244 1215 y(comm)m(unicating,)28 b(etc.)43 b(See)31 b(the)f(subsection)h(on)f Fe(sktdb)-5 b(g)30 b Fn(b)s(elo)m(w.)42 b(The)31 b(\\serv)m(er-name")f(ma)m(y)g (tak)m(e)244 1336 y(t)m(w)m(o)35 b(forms:)46 b Ff(servername)36 b Fn(or)e Ff(servername@machine-name)p Fn(.)54 b(The)35 b(latter)f(form)f(ma)m(y)g(b)s(e)i(used)244 1456 y(when)40 b(attempting)e(to)g(op)s(en)i(clien)m(ts)e(to)h(serv)m(ers)j(residing)c (on)h(mac)m(hines)g(other)g(than)g(the)h(one)244 1576 y(the)33 b(user)g(is)f(curren)m(tly)i(running)e Ff(sktdbg)i Fn(on.)0 1780 y Fg(spmc)m(hk)49 b Ff([machine])29 b Fn(This)e(program)e (tests)j(the)f(curren)m(t)h(mac)m(hine)e(b)m(y)i(default,)f(the)g (named)f(mac)m(hine)244 1900 y(otherwise,)44 b(for)d(the)g(presence)j (of)d(a)g(P)m(ortMaster.)70 b(It)42 b(will)d(return)i(a)g(0)g(if)f(the) i(P)m(ortMaster)g(is)244 2021 y(presen)m(t,)34 b(or)e(a)h(1)f (otherwise,)h(and)g(is)f(useful)h(in)e(scripts:)1232 2290 y(spmc)m(hk)j Ff(||)f Fn(\(noh)m(up)g(Spm)f Ff(>)h Fn(/dev/n)m(ull)f(&\))244 2560 y(T)-8 b(ranslated)37 b(for)f(non-csh/ksh)i(users:)54 b(if)35 b(spmc)m(hk)j(\014nds)g(no)f(P) m(ortMaster)h(on)e(the)h(curren)m(t)h(ma-)244 2681 y(c)m(hine,)32 b(start)g(one)g(up)g(in)f(the)i(bac)m(kground)g(in)e(\\no)g(hangup)h (on)g(user)h(exit")e(mo)s(de,)g(with)h(output)244 2801 y(headed)h(to)g(the)g(bit)e(buc)m(k)m(et.)46 b Fl(\(thanks)30 b(go)i(to)f(Mart)m(y)g(Olevitc)m(h)f(for)g(this)f(program\))p Fn(.)244 2963 y(F)-8 b(or)32 b Fl(VMS)g Fn(users:)572 3190 y Ff(spmchk:=)53 b([fullpath]spmchk.exe)572 3310 y(set)f(noon)572 3431 y(spmchk)572 3551 y(if)g('$SEVERITY')i(.ne.)e(1)g (then)g(run/detach)i([fullpath]Spm.exe)572 3671 y(set)e(on)0 4019 y Fg(spm)m(table)c Ff([machine)54 b([machine)f([machine)g(...]]]) 36 b Fn(This)f(program)e(lists)g(the)i(serv)m(ers)i(and)d(p)s(ort)244 4139 y(n)m(um)m(b)s(ers)e(on)f(the)h(requested)i(mac)m(hines.)43 b(If)31 b(no)g(mac)m(hine)g(is)g(listed,)f(then)i(the)g(curren)m(t)g (mac)m(hine)244 4259 y(will)e(b)s(e)j(used.)0 4463 y Fg(srmsrvr)48 b Ff([server-name)55 b([server-name)f([server-name)g (...]]])24 b Fn(Sometimes)c(the)i(all-kno)m(wledgeable)244 4583 y(and)h(omnip)s(oten)m(t)e(programmer)g(\014nds)j(a)f(need)g(to)g (hit)f(the)h(con)m(trol-c)f(k)m(ey)i(or)f(otherwise)g(kill)e(a)h(run-) 244 4704 y(ning)h(program)f(with)i(a)f(serv)m(er)j(So)s(c)m(k)m(et.)42 b(In)24 b(suc)m(h)h(cases,)i(the)e(P)m(ortMaster)g(do)s(es)f(not)g(get) f(informed)244 4824 y(that)30 b(the)h(serv)m(er)h(has)f(gone)g(do)m (wn.)44 b(This)30 b(utilit)m(y)f(will)f(tell)h(the)i(P)m(ortMaster)h (to)e(forcibly)f(remo)m(v)m(e)244 4944 y(the)k(named)f(serv)m(er\(s\))j (from)c(its)h(list.)146 5173 y(Except)41 b(when)g(using)d Ff(sktdbg)j Fn(to)e(op)s(en)g(a)g(serv)m(er)i(with)e Ff(sktdbg)p Fn(,)k(the)c(serv)m(er)i(names)f(ab)s(o)m(v)m(e)g(can)0 5293 y(also)45 b(ha)m(v)m(e)i(the)f(form)e Ff(srvr@machine-name)p Fn(.)87 b(This)46 b(name)f(sp)s(eci\014es)i(a)f(serv)m(er)h(on)f(a)f (sp)s(eci\014c)h(ma-)0 5413 y(c)m(hine.)81 b(Note)44 b(that)h(the)g(mac)m(hine-name)f(is)g(its)g(normal)f(abbreviation)g (\(ie.)i(hostname\))f(or)h(its)f(full)0 5534 y(name)32 b(\(ie.)g(hostname.someplace.com\).)1901 5707 y(22)p eop end %%Page: 23 25 TeXDict begin 23 24 bop 0 407 a Fc(5.1)135 b(The)45 b Fb(sktdbg)d Fc(Program)0 592 y Fn(The)31 b Ff(sktdbg)g Fn(program)e(w)m(as)i(originally)26 b(a)k(testing)f(facilit)m(y)f(to)i (debug)h(the)f Fl(SSL)f Fn(itself,)g(but)h(has)g(pro)m(v)m(en)0 712 y(exceptionally)i(useful)g(in)g(debugging)g(programs)g(whic)m(h)h (use)h(the)f Fl(SSL)p Fn(.)e(Consequen)m(tly)-8 b(,)35 b(it)c(is)h(pro)m(vided)0 832 y(as)h(part)f(of)g(the)h(pac)m(k)-5 b(age.)146 953 y(T)d(o)46 b(start)f(up)h Ff(sktdbg)p Fn(,)k(one)c(m)m(ust)g(c)m(ho)s(ose)g(b)s(et)m(w)m(een)i(starting)c(up) i(a)f(serv)m(er)i(or)e(attempting)f(to)0 1073 y(op)s(en)33 b(a)f(clien)m(t)g(So)s(c)m(k)m(et.)0 1298 y Fg(Example)37 b(5.1)48 b Fe(Starting)35 b(up)g(a)g(sktdb)-5 b(g)34 b(Server)35 1418 y(sktdb)-5 b(g)34 b(servername)g(s)0 1643 y Fg(Example)j(5.2)48 b Fe(Starting)35 b(up)g(a)g(sktdb)-5 b(g)34 b(Client)35 1763 y(sktdb)-5 b(g)34 b(servername)g(c)146 1988 y Fn(One)f(ma)m(y)g(also)e(ask)j(sktdbg)f(to)f(explain)g(itself.)0 2213 y Fg(Example)37 b(5.3)48 b Fe(sktdb)-5 b(g)35 b(Explanation)35 2333 y(sktdb)-5 b(g)34 b("?")146 2558 y Fn(When)44 b(the)g Ff(sktdbg)g Fn(program)e(is)g(started,)47 b(the)c(\014rst)h(thing)e(it) g(do)s(es)h(is)g(attempt)f(to)h(create)h(the)0 2678 y(requested)35 b(t)m(yp)s(e)f(of)e(So)s(c)m(k)m(et.)45 b(T)m(ypically)-8 b(,)32 b(attempts)h(to)f(mak)m(e)h(a)g(serv)m(er)h(will)d(succeed;)k (if)d(it)f(do)s(esn't,)j(it)0 2799 y(will)28 b(rep)s(ort)i(a)g(w)m (arning,)h(apply)f(Srmsrvr\(\),)h(and)f(try)h(a)f(second)h(time)e(to)h (op)s(en)h(the)f(serv)m(er)i(again.)42 b(If)30 b(it)0 2919 y(fails)h(t)m(wice,)i(then)g(usually)f(the)h(P)m(ortMaster)h(is)e (not)g(running)g(on)h(y)m(our)g(mac)m(hine.)146 3040 y(A)m(ttempts)g(to)f(op)s(en)h(a)f(clien)m(t)f(to)h(a)g(non-existen)m (t)i(serv)m(er)g(also)d(yields)h(an)g(error)h(message:)43 b(\\unable)0 3160 y(to)32 b(Sop)s(en\(srvrname,c\)".)45 b(If)32 b(the)h(serv)m(er)i(is)d(up)h(and)f(running,)g(then)i(a)e (clien)m(t)g(So)s(c)m(k)m(et)i(will)c(b)s(e)j(set)g(up.)146 3280 y(The)e Ff(sktdbg)h Fn(program)d(then)i(prin)m(ts)f(out)g(a)g (little)e(men)m(u)i(of)g(actions)g(that)g(the)h(user)g(can)f(tak)m(e)h (with)0 3401 y(it.)146 3521 y(The)24 b(\\En)m(ter")f(prompt)g(no)m(w)g (also)f(sho)m(ws)i(the)g(n)m(um)m(b)s(er)f(of)f(b)m(ytes)j(w)m(aiting)c (on)i(the)g(queue)h(for)f(reading.)0 3641 y(This)36 b(n)m(um)m(b)s(er)g (is)f(up)s(dated)h(only)g(when)h(the)f(prompt)f(is)g(generated;)j(ie.) 52 b(it)35 b(is)g(not)h(a)f(dynamic)g(v)-5 b(alue,)0 3762 y(but)33 b(is)f(often)h(useful.)146 3882 y(In)g(T)-8 b(able)32 b(4,)h(there)g(are)g(20)f(commands)g(a)m(v)-5 b(ailable,)30 b(and)j(are)f(describ)s(ed)h(b)s(elo)m(w.)0 4107 y Fg(accept)95 b Fn(Used)48 b(b)m(y)g(a)e(serv)m(er)j(So)s(c)m(k)m (et)f(to)e(accept)h(clien)m(ts.)86 b(Note)47 b(that)f(one)h(ma)m(y)g (\014rst)g(do)f Fe(test)h Fn(to)244 4227 y(determine)32 b(if)g(a)g(clien)m(t)g(is)g(w)m(aiting.)0 4430 y Fg(close)81 b Fn(Used)33 b(b)m(y)h(a)e(serv)m(er)i(So)s(c)m(k)m(et)g(to)f(close)f (do)m(wn)i(an)e(accept)i(So)s(c)m(k)m(et.)0 4632 y Fg(fput)80 b Fn(This)31 b(function)g(tak)m(es)h(a)e(\014lename,)h Fe(fput)j(\014lename)p Fn(,)c(whic)m(h)h(sktdbg)h(then)g(op)s(ens.)43 b(Ev)m(ery)33 b(line)d(in)244 4753 y(it,)j(min)m(us)g(trailing)e(white) j(space,)h(is)e(sen)m(t)i(via)e(Sputs)i(across)g(the)f(So)s(c)m(k)m (et.)49 b(Sktdbg)34 b(then)g(closes)244 4873 y(the)f(\014le.)0 5076 y Fg(fwinit)81 b Fn(This)33 b(call)f(issues)i(a)g Fl(PM)p 1275 5076 28 4 v 33 w(FWINIT)f Fn(to)g(the)h(lo)s(cal)e(mac)m (hine's)h(P)m(ortMaster.)47 b(The)35 b(P)m(ortMaster)244 5196 y(will)43 b(then)j(re-read)f(the)h(\014rew)m(all)f(data)g(\014le)g (that)g(it)f(w)m(as)i(optionally)d(started)j(up)g(with)f(\(if)f(it)244 5316 y(had)36 b(none,)h(then)g(this)e(command)g(will)e(ha)m(v)m(e)k(no) f(e\013ect\).)54 b(The)37 b(fwinit)e(command)f(is)i(useful)f(for)244 5437 y(the)g(o)m(wner)h(of)f(the)g(\014rew)m(all)f(data)h(\014le)f(to)h (c)m(hange)h(it)e(and)h(ha)m(v)m(e)h(the)g(P)m(ortMaster)g(up)s(date)f (itself)244 5557 y(without)d(bringing)f(do)m(wn)i(the)g(P)m(ortMaster)h (and)f(restarting)e(it.)1901 5707 y(23)p eop end %%Page: 24 26 TeXDict begin 24 25 bop 0 407 a Fg(get)88 b Fn(Uses)41 b(Sgets)f(to)f(get)g(a)g(n)m(ull-terminated)e(string)i(from)f(the)i (clien)m(t.)63 b(This)39 b(call)f(will)f(blo)s(c)m(k)i(un)m(til)244 527 y(something)31 b(arriv)m(es)i(for)f(up)h(to)g(60)f(seconds.)0 717 y Fg(isset)70 b Fn(Uses)24 b(Smaskw)m(ait\(\))e(with)f(negligible)f (timeout)g(\(1)i(microsecond!\))40 b(and)22 b(then)h(uses)h (Smaskisset\(\))244 837 y(to)31 b(determine)f(if)g(the)i(so)s(c)m(k)m (et)g(is)f(read-ready)-8 b(.)43 b(This)31 b(function)g(w)m(as)h (included)f(mostly)f(for)g(testing)244 957 y(Smaskisset\(\).)0 1147 y Fg(men)m(u)81 b Fn(Rep)s(eats)33 b(the)g Fe(So)-5 b(cket)35 b(T)-7 b(est)34 b(Commands)d Fn(men)m(u)i(\(just)f(lik)m(e)g (\\?")43 b(b)s(elo)m(w\).)0 1336 y Fg(p)s(eek)93 b Fn(Uses)44 b(Sp)s(eek)h(to)e(p)s(eek)h(at)f(what)g(the)h(clien)m(t)e(has)i(sen)m (t.)77 b(This)43 b(call)e(will)g(not)i(blo)s(c)m(k,)j(ev)m(en)f(if)244 1457 y(nothing)32 b(is)g(there)h(y)m(et.)0 1646 y Fg(prin)m(tf)48 b Fn(prin)m(tf)25 b(y)m(our-w)m(ord)i(Uses)g(Sprin)m(tf)e(to)h(send)h ("y)m(our-w)m(ord)f(7)g(8.)41 b(it)m(w)m(ork)m(ed!")26 b(through)g(the)h(So)s(c)m(k)m(et.)0 1836 y Fg(put)49 b Fn(put)29 b(y)m(our)h(v)-5 b(arious)28 b(sundry)i(strings)f(across)g (Uses)i(Sputs)f(to)e(send)i(y)m(our)g(strings)e(on)h(the)h(same)e(line) 244 1956 y(through)k(the)h(So)s(c)m(k)m(et.)0 2146 y Fg(q)87 b Fn(This)38 b(function)f(\\quits")h({)f(uses)i(Sclose)f(to)g (close)g(do)m(wn)h(all)c(So)s(c)m(k)m(ets)40 b(that)e Ff(sktdbg)h Fn(is)e(using)h(and)244 2266 y(exits.)44 b(Just)33 b(lik)m(e)f(\\quit".)0 2456 y Fg(quit)77 b Fn(This)30 b(function)e(\\quits")h({)g(uses)i(Sclose)f(to)e(close)i(do) m(wn)g(all)d(So)s(c)m(k)m(ets)k(that)e Ff(sktdbg)i Fn(is)e(using)g(and) 244 2576 y(exits.)44 b(Just)33 b(lik)m(e)f(\\q".)0 2766 y Fg(read)76 b Fn(This)26 b(function)g(uses)h(Sread)g(to)f(read)g (whatev)m(er)i(is)e(on)g(the)h(So)s(c)m(k)m(et,)i(and)d(prin)m(ts)g(it) g(out)g(assuming)244 2886 y(that)32 b(it)g(receiv)m(ed)i(a)e(string.)0 3075 y Fg(rmsrvr)48 b Fn(rmsrvr)32 b(serv)m(er-name)i(This)f(function)f (uses)i(Srmsrvr)f(to)f(remo)m(v)m(e)h(a)f(serv)m(er.)0 3265 y Fg(scanf)92 b Fn(This)42 b(function)g(accepts)h(a)f(subset)i(of) e(format)e(co)s(de:)63 b(\045c,)46 b(\045d,)f(\045f,)f(and)f(\045s.)73 b(It)42 b(will)e(call)244 3385 y(Sscanf)33 b(once)g(for)f(eac)m(h)i (format)d(co)s(de)i(giv)m(en)g(to)f(it.)0 3575 y Fg(sh)m(utdo)m(wn)85 b Fn(This)36 b(function)f(is)g Fe(danger)-5 b(ous)p Fn(!)51 b(It)36 b(will)d(sh)m(ut)k(do)m(wn)f(the)g(P)m(ortMaster)h(on)f(y)m (our)g(curren)m(t)244 3695 y(mac)m(hine)g(and)h(p)s(erform)e(a)h(quit.) 56 b(Use)37 b(of)f(this)h(function)f(is)g(strongly)g(discouraged)h (unless)g(it)e(is)244 3816 y(necessary)g(to)d(pull)f(do)m(wn)j(a)e(P)m (ortMaster.)0 4005 y Fg(table)82 b Fn(The)34 b Fe(table)f Fn(function)g(comm)m(unicates)f(with)h(the)h(P)m(ortMaster)g(and)g (prin)m(ts)f(out)67 b(a)33 b(table)f(of)h(all)244 4126 y(curren)m(t)h(serv)m(ers)g(and)f(their)f(p)s(orts)h(\(rather)f(lik)m (e)g(spm)m(table\).)0 4315 y Fg(test)88 b Fn(The)41 b Fe(test)f Fn(function)g(prin)m(ts)g(out)f(the)i(n)m(um)m(b)s(er)f(of)f (b)m(ytes)j(a)m(w)m(aiting)c(p)s(erusal)i(b)m(y)h(a)e(get)h(or)g(read) 244 4435 y(op)s(eration.)h(It)28 b(do)s(es)h(not)f(blo)s(c)m(k,)h(ev)m (en)h(if)e(nothing)f(is)h(w)m(aiting)f({)h(it)f(will)f(return)j(0)f(in) g(suc)m(h)i(a)e(case.)0 4625 y Fg(w)m(ait)79 b Fn(This)32 b(function)f(will)e(blo)s(c)m(k)i(the)h(pro)s(cess)h(un)m(til)d (something)g(sho)m(ws)j(up)f(on)f(the)h(accept)h(or)e(clien)m(t)244 4745 y(So)s(c)m(k)m(et.)0 4935 y Fg(write)47 b Fn(write)36 b(y)m(our)g(sundry)h(though)m(ts)f(and)f(w)m(ords)i(This)f(function)f (will)e Fe(Swrite)i Fn(y)m(our)h(w)m(ords,)i(appro-)244 5055 y(priately)28 b(n)m(ull-b)m(yte)g(terminated,)h(through)g(the)g (So)s(c)m(k)m(et.)44 b(It)28 b(can)i(b)s(e)f(read)g(b)m(y)h(the)f Fe(r)-5 b(e)g(ad)28 b Fn(function.)0 5245 y Fg(?)81 b Fn(Rep)s(eats)33 b(the)g Fe(So)-5 b(cket)35 b(T)-7 b(est)34 b(Commands)d Fn(men)m(u)h(\(just)h(lik)m(e)f(\\men)m(u")h(ab)s(o)m(v)m (e\).)146 5417 y(This)k(program)d(is)i(really)f(quite)h(simple)e(to)i (learn)f(and)i(run,)g(and)f(is)g(useful)g(to)g(help)g(the)g(installer)0 5538 y(v)m(erify)d(that)f(the)h Fl(SSL)f Fn(is)g(installed)f(correctly) -8 b(.)1901 5707 y(24)p eop end %%Page: 25 27 TeXDict begin 25 26 bop 0 407 a Fh(6)161 b(Installation)56 b(Instructions)0 626 y Fn(Installation)30 b(v)-5 b(aries,)32 b(of)g(course,)i(from)e(op)s(erating)f(system)i(to)g(op)s(erating)e (system.)0 913 y Fc(6.1)135 b(Unix)119 1098 y Fn(1.)49 b(Mak)m(e)37 b(a)e Ff(SKTS)h Fn(sub)s(directory)g(somewhere,)i(and)d (extract)h(the)g(con)m(ten)m(ts)h(of)e(the)h(tap)s(e)f(in)m(to)g(that) 244 1218 y(sub)s(directory)g(\(t)m(ypically)-8 b(,)34 b Ff(tar)52 b(-xvop)p Fn(,)37 b(but)e(systems)h(will)c(v)-5 b(ary)35 b(and)g(y)m(ou)h(ma)m(y)e(need)i(to)e(sp)s(ec-)244 1339 y(ify)e(a)g(tap)s(e)h(driv)m(e\).)119 1540 y(2.)49 b(If)36 b(y)m(our)h(mac)m(hine)e(is)h(not)g Fl(ANSI)d(C)i Fn(complian)m(t,)g(but)i(supp)s(orts)g(protot)m(yping)e(an)m(yw)m(a)m (y)-8 b(,)39 b(edit)d(the)244 1660 y Ff(sockets.h)f Fn(\014le)d(to)g Ff(#)p Fn(de\014ne)p 1353 1660 28 4 v 1385 1660 V 100 w Fl(PR)m(OTOTYPE)p 2010 1660 V 2042 1660 V 97 w Fn(for)g(y)m(our)h (mac)m(hine.)119 1861 y(3.)49 b(T)m(yp)s(e)34 b Ff(make)52 b(all)p Fn(.)146 2079 y(These)34 b(instructions)e(should)g(result)g(in) f(the)i Fl(SSL)d Fn(b)s(eing)i(compiled,)e(the)j(utilities)c(b)s(eing)j (compiled,)0 2199 y(and)22 b(the)h(P)m(ortMaster)g(b)s(eing)e (compiled.)61 b(A)22 b Fe(simpleskts.a)f Fn(library)f(results.)41 b(Although)21 b(the)i(P)m(ortMaster)0 2320 y(gets)30 b(started)g(b)m(y)g(the)g(mak)m(e)g(instructions,)g(y)m(ou)g(ma)m(y)f (o)s(ccasionally)e(need)k(to)e(re-start)g(it)g(\(for)f(example,)0 2440 y(after)41 b(the)g(computer)f(go)s(es)h(do)m(wn\).)69 b(System)41 b(administrators)e(should)i(kno)m(w)h(ho)m(w)f(to)f(mo)s (dify)f(their)0 2560 y(op)s(erating)31 b(system)j(to)e(automatically)d (bring)j(up)h(the)g(P)m(ortMaster)g(during)f(a)h(re-b)s(o)s(ot.)146 2681 y(Users)h(ma)m(y)f(wish)f(to)h(place)615 2890 y(seten)m(v)i(SKTP) -8 b(A)g(TH)34 b(mac)m(hine:mac)m(hine:mac)m(hine...`)152 b(csh)34 b(users)615 3011 y(exp)s(ort)f(SKTP)-8 b(A)g(TH=mac)m (hine:mac)m(hine:mac)m(hine...`)100 b(ksh)34 b(users)615 3131 y(SKTP)-8 b(A)g(TH:==mac)m(hine:mac)m(hine:mac)m(hine...`)306 b(vms)33 b(users)615 3251 y(set)h(SKTP)-8 b(A)g(TH=mac)m(hine:mac)m (hine:mac)m(hine...`)256 b(msdos)33 b(users)0 3462 y(in)23 b(their)g(.login,)h(.pro\014le,)h(login.com,)e(and)h(auto)s(exec.bat)h (resp)s(ectiv)m(ely)-8 b(.)41 b(T)-8 b(o)24 b(link)f(to)g(the)h Fl(SSL)p Fn(,)f(one)h(m)m(ust)0 3583 y(include)j(\\so)s(c)m(k)m (ets.h".)44 b(F)-8 b(or)26 b(example,)j(under)f Fl(UNIX)p Fn(,)g(a)f(user)h(should)g(ha)m(v)m(e)h(a)e Fl(.HDR)h Fn(sub)s(directory)g(with)0 3703 y(all)i(his/her)j(fa)m(v)m(orite)f (header)i(\014les)e(and)h(use)g(\\)p Ff(cc)52 b(...)103 b(-I~/.HDR)54 b(...)e(simpleskts.a)p Fn(".)0 3991 y Fc(6.2)135 b(Vms)119 4175 y Fn(1.)49 b(Mak)m(e)37 b(a)e Ff(SKTS)h Fn(sub)s(directory)g(somewhere,)i(and)d(extract)h(the)g(con)m(ten)m(ts) h(of)e(the)h(tap)s(e)f(in)m(to)g(that)244 4296 y(sub)s(directory)-8 b(.)56 b(The)37 b(original)c(tap)s(e)k(w)m(as)g(a)g(quarter-inc)m(h)f (cartridge)g(in)g(Unix)g(tar)h(format,)f(but)244 4416 y(y)m(ou)d(ma)m(y)f(w)m(ell)g(receiv)m(e)i(a)e(di\013eren)m(t)h (format.)119 4617 y(2.)49 b(T)m(yp)s(e)34 b Ff(@makeskts)146 4835 y Fn(The)e(\\mak)m(eskts")f(command)f(script)g(will)e(create)k (sev)m(eral)f(sub)s(directories,)g(compile)d(the)j Fl(SSL)p Fn(,)f(and)0 4955 y(set)37 b(up)f(a)f(\\simpleskts.olb")g(library)-8 b(.)51 b(It)36 b(will)e Fg(not)i Fn(attempt)f(to)g(start)h(up)g(the)h (P)m(ortMaster.)54 b(Change)0 5076 y(to)29 b(the)g(\\)p Fl(EXE)p Fn(")g(sub)s(directory)g(under)h(the)g Fl(SKTS)d Fn(sub)s(directory)-8 b(.)43 b(The)30 b(P)m(ortMaster)g(should)f(b)s(e) g(started)0 5196 y(via)c Ff(run/detach)54 b(Spm)p Fn(;)29 b(y)m(ou)d(ma)m(y)g(or)f(ma)m(y)h(not)f(ha)m(v)m(e)i(su\016cien)m(t)g (privileges)e(to)g(do)h(so.)41 b(One)26 b(ma)m(y)g(spa)m(wn)0 5316 y(the)40 b(P)m(ortMaster,)j(but)d(as)f(so)s(on)h(as)g(y)m(ou)g (log)e(o\013)h(the)h(P)m(ortMaster)h(will)c(rudely)j(terminate.)64 b(Due)39 b(to)0 5437 y(the)32 b(p)s(oten)m(tial)f(problem)f(with)i (privileges,)f(the)h(command)f(script)h(will)d(not)j(start)g(up)g(the)h (P)m(ortMaster)0 5557 y(itself.)1901 5707 y(25)p eop end %%Page: 26 28 TeXDict begin 26 27 bop 146 407 a Fn(In)45 b(order)g(to)f(mak)m(e)h (use)h(of)e(command-line)d(argumen)m(ts)k(for)f(sktdbg,)49 b(etc,)f Fl(VMS)d Fn(requires)g(that)0 527 y(y)m(ou)i(\014rst)h(mak)m (e)e(\\logical)e(sym)m(b)s(ols.")85 b(In)47 b(y)m(our)h Ff()p Fn(,)53 b(place)46 b(the)h(follo)m(wing)e(lines)g (\(with)0 648 y(appropriately)31 b(mo)s(di\014ed)h Fl(YOURDIR)p Fn(\):)742 864 y($)g(spmc)m(hk)164 b(:==)99 b($[)p Fl(YOURDIR.SKTS.EXE) p Fn(]spmc)m(hk.exe)742 984 y($)32 b(spm)m(table)100 b(:==)f($[)p Fl(YOURDIR.SKTS.EXE)p Fn(]spm)m(table.exe)742 1105 y($)32 b(spm)309 b(:==)99 b($[)p Fl(YOURDIR.SKTS.EXE)p Fn(]spm.exe)742 1225 y($)32 b(srmsrvr)160 b(:==)99 b($[)p Fl(YOURDIR.SKTS.EXE)p Fn(]srmsrvr.exe)0 1497 y Fc(6.3)135 b(Windo)l(ws)46 b(95)f(\()g(or)g(more)h(recen)l(t\))0 1682 y Fn(As)36 b(of)f(V)-8 b(ersion)35 b(2.08,)h(the)g Fl(SSL)e Fn(runs)i(under)h(Windo)m(ws)f(95.)52 b(One)35 b(ma)m(y)h(ha)m(v)m(e)h(a)e(P)m(ortMaster)h(running)0 1803 y(in)29 b(the)h(bac)m(kground)g(on)g(those)g(mac)m(hines,)g(to)s (o!)42 b(Since)29 b(the)h(presen)m(t)h(author)e(only)g(has)h(Borland)f (C++,)0 1923 y(only)35 b(that)g(compiler)f(has)i(b)s(een)g(tested.)54 b(Other)36 b(compilers)e(ma)m(y)i(need)g(to)f(mo)s(dify)f(the)i Ff(<)p Fn(Sinit.c)p Ff(>)f Fn(\014le)0 2043 y(to)d(include)g(an)m(y)h Fl(TCP/IP)63 b Fn(initialization)27 b(they)33 b(ma)m(y)g(require.)119 2263 y(1.)49 b(Set)33 b(up)g(y)m(our)g(system)h(with)e(an)g (appropriate)g(C)h(compiler,)e(Ethernet)i(card,)g(and)g Fl(TCP/IP)d Fn(.)119 2464 y(2.)49 b(Cop)m(y)34 b(the)f(con)m(ten)m(ts)h (of)e()h(on)m(to)f(y)m(our)h(computer.)119 2665 y(3.)49 b(Use)33 b(gunzip)g(and)f(un)m(tar)h(to)f(get)h(the)g (uncompressed)h(\014les)119 2866 y(4.)49 b(Op)s(en)33 b(a)f Fl(MSDOS)g Fn(console,)h(c)m(hange)g(directory)g(to)f(...)p Ff(\\)p Fl(COSMIC)119 3067 y Fn(5.)49 b(mkwin95)146 3287 y(The)32 b Fa(smplskts.lib)g Fn(and)e(v)-5 b(arious)30 b Fa(*.exe)h Fn(\014les)f(should)g(b)s(e)h(generated)g(in)f(the)g Fl(COSMIC)f Fn(sub)s(directory)-8 b(.)0 3407 y(Y)g(ou)32 b(ma)m(y)h(w)m(ell)e(w)m(an)m(t)j(to)e(ha)m(v)m(e)i(the)f(Simple)d(So)s (c)m(k)m(ets)k(Library's)f(P)m(ortMaster)g(\(Spm\))f(alw)m(a)m(ys)h (running)0 3527 y(in)f(bac)m(kground.)44 b(T)-8 b(o)33 b(accomplish)e(this:)119 3747 y(1.)49 b(On)32 b(y)m(our)i(w)m(orkb)s (enc)m(h,)h(clic)m(k)d(the)h(righ)m(t)e(mouse)i(button)119 3948 y(2.)49 b(Select)33 b Fa(New)119 4149 y Fn(3.)49 b(Select)33 b Fa(Sho)m(rtcut)119 4350 y Fn(4.)49 b(Put)33 b(the)g(fully)e(sp)s(eci\014ed)j(path)e(to)g(Spm.exe)i(in)e(the)h Fa(Command)f(Line)h Fn(dialog)d(b)s(o)m(x.)119 4551 y(5.)49 b(Put)33 b Fa(Spm)g Fn(as)g(the)g(shortcut's)g(name)119 4753 y(6.)49 b(Righ)m(t-mouse)31 b(clic)m(k)h(on)h(the)g Fa(Spm)g Fn(shortcut)119 4954 y(7.)49 b(Select)33 b Fa(Prop)s(erties) 119 5155 y Fn(8.)49 b(Select)33 b(the)g Fa(Sho)m(rtcut)h Fn(tab)119 5356 y(9.)49 b(In)33 b(the)g Fa(Run)f Fn(dialog,)e(left)i (mouse)h(clic)m(k)f(on)h(the)g(do)m(wn)g(arro)m(w)g(and)f(select)h Fa(minimized)p Fn(.)70 5557 y(10.)49 b(Bring)31 b(up)i(Explorer)1901 5707 y(26)p eop end %%Page: 27 29 TeXDict begin 27 28 bop 70 407 a Fn(11.)49 b(Clic)m(k)32 b(on)h(the)g Ff(+)f Fn(in)g(the)h(left)f(hand)h(windo)m(w)g(near)g Fa(Windo)m(ws)70 610 y Fn(12.)49 b(Clic)m(k)32 b(on)h(the)g Ff(+)f Fn(in)g(the)h(left)f(hand)h(windo)m(w)g(near)g Fa(Sta)m(rt)g(Menu)70 814 y Fn(13.)49 b(Clic)m(k)32 b(on)h(the)g Ff(+)f Fn(in)g(the)h(left)f(hand)h(windo)m(w)g(near)g Fa(Programs)70 1017 y Fn(14.)49 b(Double)32 b(clic)m(k)g(on)g Fa(Sta)m(rtUp)70 1220 y Fn(15.)49 b(Put)35 b(the)g(mouse)g(cursor)g(on) f(the)h Fa(Spm)g Fn(shortcut;)i(press)f(the)f(righ)m(t)f(mouse)g (button)h(and)g(drag)f(it)244 1341 y(o)m(v)m(er)g(the)f(righ)m(t)e (hand)i(Explorer)g(windo)m(w.)70 1544 y(16.)49 b(Select)28 b Fa(Cop)m(y)f(Here)p Fn(.)43 b(Y)-8 b(ou)27 b(will)e(no)m(w)j(need)h (to)e(re-b)s(o)s(ot)f(y)m(our)i(mac)m(hine)f(for)g(this)g(op)s(eration) f(to)h(tak)m(e)244 1665 y(e\013ect.)0 1953 y Fc(6.4)135 b(Older)46 b(Ms-Dos)0 2138 y Fn(The)23 b Fl(SSL)d Fn(w)m(as)j(compiled) d(and)i(tested)h(using)e(the)h(W)-8 b(ollongong)19 b Fl(TCP/IP)42 b Fn(pac)m(k)-5 b(age)22 b(with)f(MicroSoft)g(C)h (\(v6.0\).)0 2259 y(Other)30 b(compilers)f(and)h Fl(TCP/IP)57 b Fn(pac)m(k)-5 b(ages)31 b(ma)m(y)f(require)g(adjustmen)m(t)h(to)e (the)i Fl(SSL)e Fn(co)s(de.)43 b(Y)-8 b(ou)30 b Fg(m)m(ust)0 2379 y Fn(ha)m(v)m(e)k(a)e Fl(TCP/IP)d Fn(pac)m(k)-5 b(age)33 b(for)f(y)m(our)h(mac)m(hine,)f(ho)m(w)m(ev)m(er)i({)e(that)h (is)e(what)i(pro)m(vides)g(Berk)m(eley)h(so)s(c)m(k)m(ets)0 2499 y(o)m(v)m(er)39 b(whic)m(h)f(the)g Fl(SSL)f Fn(pro)m(vides)i(a)e (con)m(v)m(enien)m(t)j(o)m(v)m(erla)m(y)-8 b(.)60 b(Also,)38 b(y)m(ou)h Fg(m)m(ust)e Fn(ha)m(v)m(e)i(an)f(Ethernet)h(card)0 2620 y(for)f(y)m(our)i(mac)m(hine)e({)h(that)f(pro)m(vides)i(the)f (hardw)m(are)h(o)m(v)m(er)g(whic)m(h)f(the)h(information)35 b(\015o)m(ws.)64 b(Neither)0 2740 y(the)33 b Fl(TCP/IP)62 b Fn(pac)m(k)-5 b(age,)33 b(the)g(C)g(compiler,)e(nor)h(the)h(Ethernet) h(hardw)m(are)g(come)e(with)g(the)h Fl(SSL)p Fn(.)119 2968 y(1.)49 b(The)35 b Fl(SSL)f Fn(mak)m(es)h(sev)m(eral)h (assumptions,)f(unfortunately)-8 b(,)35 b(ab)s(out)f(where)i(include)e (\014les)g(are)h(\(ex.)244 3089 y(see)45 b Fe(Sp)-5 b(e)g(ek.c)6 b Fn(\).)78 b(The)46 b(installer)c(will)g(undoubtedly)j(need)h(to)e (customize)g(these)i(include)e(lines.)244 3209 y(These)34 b(areas)f(will)d(alw)m(a)m(ys)j(b)s(e)g(in)f Ff(#ifdef)53 b(MSDOS)34 b Fn(...)43 b Ff(#endif)35 b Fn(zones.)119 3413 y(2.)49 b(Acquire)33 b(a)f Fl(TCP/IP)e Fn(pac)m(k)-5 b(age)33 b(for)f(y)m(our)h(computer)g(\(ie.)f(W)-8 b(ollongong\).)119 3616 y(3.)49 b(Acquire)33 b(a)f(C)h(compiler)e(for)h(y)m(our)h (computer)g(\(ie.)f(Microsoft)g(C,)h(v6.0\).)119 3819 y(4.)49 b(Acquire)33 b(an)f(Ethernet)i(card)f(and)g Fl(TCP/IP)62 b Fn(address)34 b(for)e(y)m(our)h(computer.)119 4023 y(5.)49 b(Cop)m(y)34 b(the)f(con)m(ten)m(ts)h(of)e(the)h(pro)m(vided)g (disk)m(ette)h(in)m(to)e(y)m(our)h(sub)s(directory)-8 b(.)119 4226 y(6.)49 b(F)-8 b(or)32 b(those)h(of)f(y)m(ou)h(with)f(the) h(soft)m(w)m(are)h(men)m(tioned)e(in)g(T)-8 b(able)32 b(5:)285 4430 y(\(a\))48 b(Mak)m(e)34 b(a)f(directory:)43 b Ff(c:\\c600\\socket)280 4591 y Fn(\(b\))48 b(Mak)m(e)34 b(a)f(directory:)43 b Ff(c:\\c600\\socket\\exe)290 4753 y Fn(\(c\))49 b(Cop)m(y)34 b Fe(wintcp.lib)e Fn(to)g Ff(c:\\c600\\socket)280 4915 y Fn(\(d\))48 b(Cop)m(y)34 b Fe(so)-5 b(cket.lib)32 b Fn(to)g Ff(c:\\c600\\socket)290 5077 y Fn(\(e\))49 b(Cop)m(y)34 b Fe(slib)-5 b(c)g(e.lib)31 b Fn(to)i Ff(c:\\c600\\socket)297 5239 y Fn(\(f)7 b(\))48 b(Disable)c(the)i Fl(MSDOS)f Fn(link)m(er)g({)g(p)s(ossibly)g(b)m(y)i (renaming)d(it)g(to)i Fe(doslink)p Fn(.)81 b(Use)46 b(the)g(Mi-)458 5359 y(croSoft)33 b(C)g(link)m(er)f(instead.)285 5521 y(\(g\))48 b(Return)33 b(to)g(the)g(directory)f(where)i(y)m(ou)f (placed)g(the)g Fl(SSL)e Fn(soft)m(w)m(are.)1901 5707 y(27)p eop end %%Page: 28 30 TeXDict begin 28 29 bop 280 407 a Fn(\(h\))48 b(T)m(yp)s(e)36 b Fe(makeskt)d Fn(\(whic)m(h)h(will)e(use)j(the)f Fe(Makeskt.b)-5 b(at)33 b Fn(command)g(script\).)47 b(This)34 b(script)g(will)458 527 y(use)49 b Fe(Makelib.)p Fn(,)h(compile,)g(create)e(the)g Fe(smplskts.lib)e Fn(library)-8 b(,)49 b(and)f(generate)g Fe(sktdb)-5 b(g.exe)p Fn(,)458 648 y Fe(spmtable.exe)p Fn(,)32 b(and)g Fe(srmsrvr.exe)p Fn(.)307 809 y(\(i\))47 b(Y)-8 b(ou)33 b(should)f(b)s(e)h(done)g(installing)c(the)k(soft)m(w)m (are)h(at)e(this)h(p)s(oin)m(t.)119 1013 y(7.)49 b(If)23 b(y)m(our)h(compiler)d(is)h(not)h Fl(ANSI)e(C)i Fn(complian)m(t,)g(but) g(supp)s(orts)h(protot)m(yping,)h(edit)d(the)i Ff(sockets.h)244 1133 y Fn(\014le)32 b(to)g(de\014ne)p 808 1133 28 4 v 840 1133 V 100 w Fl(PR)m(OTOTYPE)p 1465 1133 V 1497 1133 V 96 w Fn(for)g(y)m(our)i(mac)m(hine.)119 1337 y(8.)49 b(F)-8 b(ollo)m(w)26 b(y)m(our)j(compiler's)e(directions)g(to)h (compile)e(to)i(ob)5 b(ject)29 b(\014le)f(format)e(all)g(the)j(C)f (\014les)h(in)e Ff(SKTS)244 1457 y Fn(and)33 b Ff(SKTS\\EXE)p Fn(.)119 1660 y(9.)49 b(F)-8 b(ollo)m(w)32 b(y)m(our)k(compiler's)d (directions)h(to)g(set)h(up)g(a)f(\\library")f(\(a)h Ff(.LIB)h Fn(\014le\))f(with)h(all)d(the)j Ff(.OBJ)244 1781 y Fn(\014les)e(in)e(the)i Ff(SKTS)h Fn(sub)s(directory)-8 b(.)70 1984 y(10.)49 b(Change)37 b(to)f(the)h Ff(SKTS\\EXE)i Fn(sub)s(directory)e(and)g(follo)m(w)d(y)m(our)k(compiler's)d (instructions)h(to)g(link)244 2105 y(eac)m(h)26 b(of)f(the)g(ob)5 b(ject)26 b(\014les,)h(one)f(at)e(a)h(time,)h(to)f(the)g (\\smplskts.lib")f(library)-8 b(,)25 b(the)h Fl(TCP/IP)48 b Fn(library)-8 b(,)244 2225 y(and)33 b(whatev)m(er)h(libraries)c(y)m (our)k(compiler)c(normally)g(needs.)146 2453 y(The)j(installation)c (should)j(yield)f(a)h Fe(smplskts.lib)f Fn(\(or)h(something)f (similar\))e(library)h(and)i(three)h(exe-)0 2574 y(cutable)f(\014les)h (\(sktdbg.exe,)i(spm)m(table.exe,)e(and)g(spm)m(table.exe\).)146 2694 y(Note)h(that)f(the)h(\\)p Fl(SPM.EXE)p Fn(")e(\014le)h(should)g (not)h(b)s(e)f(generated;)i(y)m(ou)f(could)f(generate)h(and)f(execute)0 2814 y(it,)j(but)h(y)m(our)g(clone)f(could)f(not)h(use)i(it)d(as)h(it)f (do)s(es)i(not)f(allo)m(w)f(the)i(P)m(ortMaster)g(to)f(run)g(in)g(the)g (bac)m(k-)0 2935 y(ground.)66 b(No)40 b(attempt)f(has)h(b)s(een)h(made) f(to)f(insure)h(that)g(the)h(P)m(ortMaster)g(is)e(actually)g (compilable)0 3055 y(under)e(MicroSoft)e(C,)i(either.)53 b(Someda)m(y)37 b(a)f(kludge)g(to)f(allo)m(w)g(MS-DOS)h(programs)f(to)g (b)s(e)i(their)e(o)m(wn)0 3176 y(P)m(ortMaster)30 b(ma)m(y)g(b)s(e)f (dev)m(elop)s(ed,)i(but)f(that)f(da)m(y)h(is)e(not)i(y)m(et.)43 b(Using)29 b(W)-8 b(ollongong)27 b Fl(TCP/IP)f Fn(,)k(one)f(will)0 3296 y(b)s(e)k(restricted)g(to)f(three)h(\(or)g(\014v)m(e)g(if)f(its)g (\\k)m(ernel")h(is)f(rebuilt\))f(clien)m(ts.)146 3416 y(The)40 b(soft)m(w)m(are)f(in)f(T)-8 b(able)39 b(5)f(w)m(as)h(used)h (b)m(y)g(the)f Fl(IRL)f Fn(and)g(is)g(kno)m(wn)i(to)f(w)m(ork)g(prop)s (erly)f(with)h(the)0 3537 y Fl(SSL)p Fn(.)31 b(Other)i(soft)m(w)m(are)h (ma)m(y)e(w)m(ork)i(but)f(has)f(not)h(b)s(een)g(tested.)1901 5707 y(28)p eop end %%Page: 29 31 TeXDict begin 29 30 bop 0 407 a Fh(7)161 b(App)t(endix:)71 b(Miscellaneous)55 b(F)-13 b(unctions)0 626 y Fn(The)41 b Fl(SSL)e Fn(uses)j(nine)e(functions)g(from)f(Dr.)h(Campb)s(ell's)f Fe(xtdio)h Fn(library;)i(these)g(ha)m(v)m(e)f(b)s(een)g(gathered)0 746 y(together)f(and)g(made)g(part)g(of)f(the)i Fe(simpleskts.a)d Fn(library)-8 b(.)65 b(Sev)m(eral)40 b(of)g(the)g(functions)g(use)h(a)f (sp)s(ecial)0 867 y(data)32 b(\014le,)g Fe(r)-5 b(dc)g(olor.dat)p Fn(.)146 987 y(Note:)47 b(the)34 b Fe(err)-5 b(or)34 b Fn(and)g Fe(outofmem)g Fn(functions)g(claim)e(they)j(will)c (\\terminate")i(under)i(certain)e(con-)0 1107 y(ditions.)56 b(Actually)-8 b(,)37 b(they)h(will)c(call)i(the)h(function)g Fe(\(*err)-5 b(or)p 2256 1107 30 4 v 35 w(exit\)\(int)39 b(rtn\))p Fn(,)f(whic)m(h)g(b)m(y)g(default)e(is)h(the)0 1228 y Fe(exit)e Fn(function.)51 b(Programmers)34 b(ma)m(y)h(easily)g (prev)m(en)m(t)i(or)e(otherwise)h(con)m(trol)e(termination)f(b)m(y)j (simply)0 1348 y(setting)c Fe(err)-5 b(or)p 539 1348 V 36 w(exit)33 b Fn(to)f(p)s(oin)m(t)f(to)i(some)f(other)h(function.)0 1540 y Fg(v)m(oid)k(error\(in)m(t)e(sev)m(erit)m(y)-9 b(,c)m(har)37 b(*fm)m(t,...\))70 b Fn(The)23 b Fe(err)-5 b(or)22 b Fn(function)f(prin)m(ts)h(out)g(an)g(error,)i(w)m(arning,)g (or)244 1660 y(note)29 b(t)m(yp)s(e)g(of)f(message)i(to)e(stdout.)43 b(This)28 b(function)h(tak)m(es)g(four)g(kinds)g(of)f(\\sev)m(erit)m (y":)43 b Fl(SEVERE)p Fn(,)244 1780 y Fl(ERR)m(OR)p Fn(,)33 b Fl(W)-10 b(ARNING)p Fn(,)35 b(and)e Fl(NOTE)p Fn(.)g(Both)g(the)h Fl(SEVERE)f Fn(and)g Fl(ERR)m(OR)h Fn(lev)m(els)f(will)e Fe(terminate)244 1901 y Fn(the)k(program.)48 b(The)36 b(other)f(t)m(w)m(o,)h Fl(W)-10 b(ARNING)35 b Fn(and)g Fl(NOTE)p Fn(,)f(will)f(not)h(do)h(so.)50 b(The)35 b(termination)244 2021 y(action)45 b(tends)i(to)f(enforce)h(a)f(standard)g(for)g(what)g (errors)h(v)m(ersus)h(w)m(arnings)e(mean!)84 b(If)46 b(y)m(our)244 2142 y(terminal)39 b(t)m(yp)s(e)k(is)f(supp)s(orted)h(b)m (y)g(the)f Fe(r)-5 b(dc)g(olor.dat)41 b Fn(\014le)h(\(see)h(rdcolor)e (b)s(elo)m(w\),)j Fl(SEVERE)d Fn(and)244 2262 y Fl(ERR)m(OR)32 b Fn(messages)g(are)g(prin)m(ted)g(with)g(a)g(red)g(leader,)g Fl(W)-10 b(ARNING)p Fn(s)33 b(with)f(a)f(y)m(ello)m(w)h(leader,)g(and) 244 2382 y Fl(NOTE)p Fn(s)g(with)g(a)h(cy)m(an)g(leader.)0 2577 y Fg(FILE)k(*fop)s(en)m(v\(c)m(har)i(*\014lename,c)m(har)e (*ctrl,c)m(har)f(*en)m(v)p 2437 2577 34 4 v 41 w(v)-6 b(ar\))93 b Fn(The)45 b Fe(fop)-5 b(env)43 b Fn(pro)m(vides)i(a)e (\014le)244 2697 y(op)s(ening)30 b(service)i(akin)e(to)h(that)f(pro)m (vided)i(b)m(y)g(the)f Fe(Sop)-5 b(env)30 b Fn(function)g(for)g(the)i Fl(SSL)p Fn(.)d(The)j Fe(fop)-5 b(en\(\))244 2817 y Fn(function)38 b(will)f(b)s(e)i(used)i(with)d(the)i(giv)m(en)f(\014lename)f(and)h (ctrl)g(strings,)h(and)f(up)s(on)h(failure,)f(the)244 2938 y(en)m(vironmen)m(t)31 b(v)-5 b(ariable)29 b(in)g Fe(env)p 1429 2938 30 4 v 36 w(var)h Fn(will)e(b)s(e)j(used)g(lik)m(e)f (a)g Fl(P)-8 b(A)g(TH)32 b Fn(v)-5 b(ariable)28 b(in)i(attempts)h(to)f (op)s(en)244 3058 y(the)39 b(\014le)g(in)f(one)h(directory)f(after)h (another)g(\(un)m(til)e(success\).)65 b(If)39 b(none)g(of)g(the)g Fe(fop)-5 b(en)7 b Fn(s)39 b(succeed,)244 3178 y(then)33 b(the)g Fe(fop)-5 b(env)32 b Fn(function)g(will)e(return)j(a)f Fl(NULL)h Fn(p)s(oin)m(ter.)0 3373 y Fg(v)m(oid)k(outofmem\(v)m(oid)e (*ptr,c)m(har)j(*fm)m(t,...\))76 b Fn(The)29 b Fe(outofmem)f Fn(function)g(c)m(hec)m(ks)j(if)c Fe(ptr)i Fn(is)f Fl(NULL)p Fn(;)244 3493 y(if)j(it)h(is)g(not,)g(the)h(function)g(immediately)c (returns.)244 3650 y(Ho)m(w)m(ev)m(er,)g(if)24 b(the)i Fe(ptr)f Fn(p)s(oin)m(ter)g(is)g(in)g(fact)g Fl(NULL)p Fn(,)g(then)h(the)g Fe(fmt)f Fn(and)g(an)m(y)h(subsequen)m(t)j(argumen) m(ts)244 3771 y(will)g(b)s(e)j(used)g(lik)m(e)f(a)g(regular)g(prin)m (tf)g(to)g(giv)m(e)g(a)h(message)f(to)h(the)g(user.)44 b(The)32 b(program)e(will)f(then)244 3891 y(terminate.)0 4085 y Fg(v)m(oid)37 b(rdcolor\(v)m(oid\))90 b Fn(This)45 b(function)e(reads)i(the)g Fe(r)-5 b(dc)g(olor.dat)43 b Fn(\014le,)k(whic)m(h)e(essen)m(tially)f(is)g(an)g(ex-)244 4206 y(tended)h(\\termcap")e(\014le.)77 b(It)44 b(uses)h(the)f (\\RDCOLOR")e(en)m(vironmen)m(t)j(v)-5 b(ariable)42 b(with)h Fe(fop)-5 b(env)244 4326 y Fn(to)38 b(searc)m(h)h(for)f(the)g Fe(r)-5 b(dc)g(olor.dat)38 b Fn(\014le.)59 b(The)39 b(function)f(uses)i (that)d(\014le)h(to)g(set)h(up)f(v)-5 b(arious)38 b(string)244 4446 y(v)-5 b(ariables)31 b(\()p Fl(RED)p Fn(,)i Fl(CLEAR)p Fn(,)f({)g(see)i(b)s(elo)m(w\).)0 4641 y Fg(v)m(oid)j(rdcputs\(c)m(har) g(*s,FILE)h(*fp\))79 b Fn(This)30 b(function)f(puts)i(a)e(string)h(out) f(to)h(the)g Fl(FILE)g Fn(p)s(oin)m(ter)f Fe(fp)p Fn(,)244 4761 y(except)37 b(that)f(those)g(strings)g(\()p Fl(XRED)p Fn(,)g Fl(XUWHITE)p Fn(,)g(etc.\))54 b(are)36 b(in)m(terpreted)g(using) g(the)g Fe(r)-5 b(dc)g(olor)p Fn(-)244 4881 y(pro)m(vided)33 b(string)f(instead.)0 5076 y Fg(c)m(har)38 b(*sprt\(c)m(har)f(*s\))94 b Fn(This)46 b(function)g(returns)h(a)f(p)s(oin)m(ter)f(to)h(a)f (static)h(bu\013er)h(\(there)f(are)g(four)244 5196 y(of)d(them\).)77 b(The)45 b(string)e Fe(s)g Fn(has)i(all)c(of)j(its)f(c)m(haracters)i (made)e(in)m(to)g(\\visible")f(forms:)66 b(con)m(trol)244 5316 y(c)m(haracters)30 b(b)s(ecome)1063 5291 y(^)1050 5316 y(A)g(through)1523 5291 y(^)1518 5316 y(Z)f(and)g(c)m(haracters)h (with)f Fl(ANSI)g Fn(v)-5 b(alues)29 b(greater)g(than)g(or)g(equal)244 5437 y(to)37 b(128)g(are)g(made)g(in)m(to)g Ff(~###)h Fn(sequences.)61 b(Characters)39 b(whic)m(h)f(are)f(normally)e(visible) h(are)i(left)244 5557 y(unc)m(hanged.)1901 5707 y(29)p eop end %%Page: 30 32 TeXDict begin 30 31 bop 0 407 a Fg(v)m(oid)37 b(srm)m(trblk\(c)m(har)e (*s\))83 b Fn(This)34 b(function)g(remo)m(v)m(es)h(an)m(y)g(trailing)30 b(\\blanks")k(\(white)g(space\))h(from)244 527 y(the)e(end)g(of)f(a)h (string.)0 731 y Fg(c)m(har)38 b(*stpblk\(c)m(har)e(*p\))80 b Fn(This)32 b(function)e(returns)i(a)f(p)s(oin)m(ter)g(to)g(the)g (\014rst)h(non-white)f(space)h(c)m(har-)244 851 y(acter)h(in)f(the)h (string)e Fe(p)i Fn(\(ie.)f(steps)i(past)f(blanks\).)0 1054 y Fg(c)m(har)38 b(*stpnxt\(c)m(har)f(*s,c)m(har)h(*fm)m(t\))83 b Fn(This)35 b(function)g(returns)h(a)g(p)s(oin)m(ter)e(to)h(the)h (\014rst)g(c)m(haracter)244 1175 y(in)e Fe(s)h Fn(whic)m(h)g(w)m(ould)g (not)g(ha)m(v)m(e)h(b)s(een)g(read)f(b)m(y)h(a)f Fe(ssc)-5 b(anf\(s,fmt,...\))48 b Fn(function.)j(Useful)35 b(for)f(quic)m(k)244 1295 y(and)f(dirt)m(y)f(parsing.)0 1499 y Fg(c)m(har)38 b(*strnxtfm)m(t\(c)m(har)d(*fm)m(t\))84 b Fn(The)37 b Fe(strnxtfmt)g Fn(function)f(returns)h(a)f(p)s(oin)m(ter)g(to)g(the)g (b)s(eginning)244 1619 y(of)29 b(the)h(\(next\))h(format)d(co)s(de)j (substring.)42 b(If)30 b Fe(fmt)g Fn(is)f Fl(NULL)p Fn(,)h(then)g(the)h (previous)f(format)e(string)h(is)244 1739 y(used)h(\(ie.)e(a)h(p)s(oin) m(ter)f(to)h(the)g(last)f Fe(fmt)h Fn(co)s(de)g(is)f(retained)h(and)g (the)g(a)g(p)s(oin)m(ter)f(to)g(the)i(next)f(format)244 1860 y(co)s(de)40 b(p)s(oin)m(ter)g(will)d(b)s(e)k(returned\).)66 b(This)41 b(function)e(b)s(ears)i(some)f(similarit)m(y)c(to)k Fl(strtok)g Fn(except)244 1980 y(that)32 b(it)g(jumps)g(from)g(format)f (co)s(de)i(to)f(format)f(co)s(de)i(\(used)g(b)m(y)h(Sscanf)7 b(\).)146 2208 y(The)31 b Fe(r)-5 b(dc)g(olor.dat)38 b Fn(\014le)29 b(describ)s(es)i(terminal)c(escap)s(e)k(sequences)h(to)e (use)g(to)f(con)m(trol)g(color)f(and)i(a)f(few)0 2329 y(other)38 b(actions.)57 b(Eac)m(h)39 b(line)d(whic)m(h)i(do)s(es)g (not)f(b)s(egin)g(with)g(a)g(white)g(space)i(c)m(haracter)f(is)f (assumed)h(to)0 2449 y(b)s(e)c(a)g(terminal)e(line:)45 b(terminal)31 b(t)m(yp)s(es)36 b(are)e(separated)h(b)m(y)g(v)m(ertical) e(bars)h(and)g(the)h(line)d(is)i(terminated)0 2570 y(b)m(y)f(a)g (colon.)42 b(There)34 b(are)f(a)f(n)m(um)m(b)s(er)h(of)f(strings)h (de\014ned)h(\(see)f(T)-8 b(able)33 b(6\).)146 2690 y(Escap)s(e)23 b(sequences)i(ma)m(y)d(include)f(the)h(sequence)i Ff(\\e)f Fn(for)e(the)h Fl(ESCAPE)f Fn(c)m(haracter)h(and)g Ff(\\b)g Fn(for)f(a)h(blank.)0 2810 y(Please)33 b(see)h(the)f Fe(r)-5 b(dc)g(olor.dat)31 b Fn(\014le)i(for)f(examples.)1901 5707 y(30)p eop end %%Page: 31 33 TeXDict begin 31 32 bop 1132 1043 a Fn(T)-8 b(able)32 b(3:)43 b Fg(The)38 b(P)m(ortMaster)f(Proto)s(col)p 613 1175 2675 4 v 613 1191 V 611 1312 4 121 v 628 1312 V 947 1275 a Fe(Event)p 1506 1312 V 391 w(Client)d(Sends)p 2187 1312 V 231 w(PortMaster)i(Sends)p 3269 1312 V 3286 1312 V 613 1315 2675 4 v 613 1331 V 611 1452 4 121 v 628 1452 V 679 1416 a Fl(PM)p 829 1416 28 4 v 33 w(CLIENT)p 1506 1452 4 121 v 2187 1452 V 3269 1452 V 3286 1452 V 611 1572 V 628 1572 V 1506 1572 V 2187 1572 V 2239 1536 a(PM)p 2389 1536 28 4 v 33 w(OK)30 b(/)g(PM)p 2814 1536 V 33 w(RESEND)p 3269 1572 4 121 v 3286 1572 V 611 1693 V 628 1693 V 1506 1693 V 1558 1656 a Fn("sktname")p 2187 1693 V 3269 1693 V 3286 1693 V 611 1813 V 628 1813 V 1506 1813 V 2187 1813 V 2239 1777 a Fl(PM)p 2389 1777 28 4 v 33 w(OK)g(/)g(PM)p 2814 1777 V 33 w(SORR)-8 b(Y)p 3269 1813 4 121 v 3286 1813 V 611 1933 V 628 1933 V 1506 1933 V 2187 1933 V 2239 1897 a Fn(p)s(ort)p 3269 1933 V 3286 1933 V 613 1937 2675 4 v 611 2057 4 121 v 628 2057 V 679 2021 a Fl(PM)p 829 2021 28 4 v 33 w(CLIENTW)e(AIT)p 1506 2057 4 121 v 2187 2057 V 3269 2057 V 3286 2057 V 611 2177 V 628 2177 V 1506 2177 V 2187 2177 V 2239 2141 a(PM)p 2389 2141 28 4 v 33 w(OK)30 b(/)g(PM)p 2814 2141 V 33 w(RESEND)p 3269 2177 4 121 v 3286 2177 V 611 2298 V 628 2298 V 1506 2298 V 1558 2262 a Fn("sktname")p 2187 2298 V 3269 2298 V 3286 2298 V 611 2418 V 628 2418 V 1506 2418 V 2187 2418 V 2239 2382 a Fl(PM)p 2389 2382 28 4 v 33 w(OK)g(/)g(PM)p 2814 2382 V 33 w(SORR)-8 b(Y)p 3269 2418 4 121 v 3286 2418 V 611 2539 V 628 2539 V 1506 2539 V 2187 2539 V 2239 2502 a Fn(p)s(ort)p 3269 2539 V 3286 2539 V 613 2542 2675 4 v 611 2662 4 121 v 628 2662 V 679 2626 a Fl(PM)p 829 2626 28 4 v 33 w(CLOSE)p 1506 2662 4 121 v 2187 2662 V 3269 2662 V 3286 2662 V 611 2783 V 628 2783 V 1506 2783 V 2187 2783 V 2239 2747 a(PM)p 2389 2747 28 4 v 33 w(OK)30 b(/)g(PM)p 2814 2747 V 33 w(RESEND)p 3269 2783 4 121 v 3286 2783 V 611 2903 V 628 2903 V 1506 2903 V 1558 2867 a Fn(p)s(ort)p 2187 2903 V 3269 2903 V 3286 2903 V 611 3023 V 628 3023 V 1506 3023 V 2187 3023 V 2239 2987 a Fl(PM)p 2389 2987 28 4 v 33 w(OK)g(/)g(PM)p 2814 2987 V 33 w(SORR)-8 b(Y)p 3269 3023 4 121 v 3286 3023 V 613 3027 2675 4 v 611 3147 4 121 v 628 3147 V 679 3111 a(PM)p 829 3111 28 4 v 33 w(QUIT)p 1506 3147 4 121 v 2187 3147 V 3269 3147 V 3286 3147 V 611 3268 V 628 3268 V 1506 3268 V 2187 3268 V 2239 3231 a(PM)p 2389 3231 28 4 v 33 w(OK)30 b(/)g(PM)p 2814 3231 V 33 w(RESEND)p 3269 3268 4 121 v 3286 3268 V 611 3388 V 628 3388 V 1506 3388 V 1558 3352 a Fn("P)m(ortMaster")p 2187 3388 V 3269 3388 V 3286 3388 V 613 3391 2675 4 v 611 3512 4 121 v 628 3512 V 679 3476 a Fl(PM)p 829 3476 28 4 v 33 w(SER)-10 b(VER)p 1506 3512 4 121 v 2187 3512 V 1015 w(PM)p 2389 3476 28 4 v 33 w(OK)30 b(/)g(PM)p 2814 3476 V 33 w(RESEND)p 3269 3512 4 121 v 3286 3512 V 611 3632 V 628 3632 V 1506 3632 V 1558 3596 a Fn("sktname")p 2187 3632 V 3269 3632 V 3286 3632 V 611 3752 V 628 3752 V 1506 3752 V 1558 3716 a(p)s(ort)p 2187 3752 V 3269 3752 V 3286 3752 V 611 3873 V 628 3873 V 1506 3873 V 2187 3873 V 2239 3837 a Fl(PM)p 2389 3837 28 4 v 33 w(OK)g(/)g(PM)p 2814 3837 V 33 w(SORR)-8 b(Y)p 3269 3873 4 121 v 3286 3873 V 613 3876 2675 4 v 611 3996 4 121 v 628 3996 V 1506 3996 V 1558 3960 a(PM)p 1708 3960 28 4 v 32 w(OK)p 2187 3996 4 121 v 3269 3996 V 3286 3996 V 613 4000 2675 4 v 611 4120 4 121 v 628 4120 V 679 4084 a(PM)p 829 4084 28 4 v 33 w(T)g(ABLE)p 1506 4120 4 121 v 2187 4120 V 3269 4120 V 3286 4120 V 611 4241 V 628 4241 V 1506 4241 V 2187 4241 V 2239 4204 a(PM)p 2389 4204 28 4 v 33 w(OK)30 b(/)g(PM)p 2814 4204 V 33 w(RESEND)p 3269 4241 4 121 v 3286 4241 V 611 4361 V 628 4361 V 1506 4361 V 2187 4361 V 2239 4325 a Fn(coun)m(t)j(of)f(serv)m(ers)p 3269 4361 V 3286 4361 V 611 4481 V 628 4481 V 1506 4481 V 2187 4481 V 2239 4445 a("serv)m(er)i(:)43 b(p)s(ort")p 3269 4481 V 3286 4481 V 611 4602 V 628 4602 V 1506 4602 V 2187 4602 V 2239 4566 a(...)p 3269 4602 V 3286 4602 V 613 4605 2675 4 v 611 4725 4 121 v 628 4725 V 679 4689 a Fl(PM)p 829 4689 28 4 v 33 w(FWINIT)p 1506 4725 4 121 v 2187 4725 V 3269 4725 V 3286 4725 V 611 4846 V 628 4846 V 1506 4846 V 2187 4846 V 2239 4810 a(PM)p 2389 4810 28 4 v 33 w(OK)30 b(/)g(PM)p 2814 4810 V 33 w(RESEND)p 3269 4846 4 121 v 3286 4846 V 613 4849 2675 4 v 613 4866 V 1901 5707 a Fn(31)p eop end %%Page: 32 34 TeXDict begin 32 33 bop 1363 716 a Fn(T)-8 b(able)32 b(4:)44 b(sktdbg)33 b(Help)f(Men)m(u)0 837 y Ff(Socket)53 b(Test)f(Commands)103 957 y(accept)103 1077 y(close)103 1198 y(fwinit)103 1318 y(fput)103 1438 y(get)103 1559 y(menu)103 1679 y(peek)103 1800 y(printf)103 1920 y(put)103 2040 y(q)103 2161 y(quit)103 2281 y(read)103 2401 y(rmsrvr)103 2522 y(scanf)103 2642 y(shutdown)103 2763 y(table)103 2883 y(test)103 3003 y(wait)103 3124 y(write)103 3244 y(?)0 3365 y(\()154 b(0)52 b(bytes\))g(Enter:)622 4342 y Fn(T)-8 b(able)33 b(5:)43 b Fg(Ms-Dos)38 b(Soft)m(w)m(are)g(kno)m(wn) g(to)f(w)m(ork)g(with)f(the)i Fm(SSL)927 4434 y Fe(Softwar)-5 b(e)34 b(Pr)-5 b(o)g(duct)785 b(Comp)-5 b(any)656 4554 y Fn(MicroSoft)32 b(C,)h(v6.0)610 b(MicroSoft)656 4675 y Fl(Win/API)32 b Fn(for)g Fl(DOS)p Fn(,)g(v4.1)381 b(The)33 b(W)-8 b(ollongong)30 b(Group,)i(Inc.)2022 4795 y(PO)g(Bo)m(x)h(51860) 2022 4916 y(P)m(alo)e(Alto,)h(CA)h(94303-4374)2022 5036 y(\(415\)-962-7100)656 5156 y(W)-8 b(ollongong)30 b(Win/)p Fl(TCP)p Fn(,)h(v4.1.1)100 b(The)33 b(W)-8 b(ollongong)30 b(Group,)i(Inc.)1901 5707 y(32)p eop end %%Page: 33 35 TeXDict begin 33 34 bop 1366 1053 a Fn(T)-8 b(able)32 b(6:)43 b(rdcolor.dat)32 b(strings)p 509 1084 2883 4 v 509 1101 V 507 1221 4 121 v 524 1221 V 575 1185 a Fe(String)j(Name)p 1225 1221 V 162 w(F)-7 b(unction)p 3373 1221 V 3390 1221 V 509 1224 2883 4 v 507 1345 4 121 v 524 1345 V 575 1309 a Fl(BLA)m(CK)p 1225 1345 V 379 w Fn(subsequen)m(t)35 b(c)m(hars)f(are)e(blac)m(k)p 3373 1345 V 3390 1345 V 507 1465 V 524 1465 V 575 1429 a Fl(RED)p 1225 1465 V 504 w Fn(subsequen)m(t)j(c)m(hars)f(are)e(red)p 3373 1465 V 3390 1465 V 507 1585 V 524 1585 V 575 1549 a Fl(GREEN)p 1225 1585 V 372 w Fn(subsequen)m(t)j(c)m(hars)f(are)e(green)p 3373 1585 V 3390 1585 V 507 1706 V 524 1706 V 575 1670 a Fl(YELLO)m(W)p 1225 1706 V 297 w Fn(subsequen)m(t)j(c)m(hars)f(are)e (y)m(ello)m(w)p 3373 1706 V 3390 1706 V 507 1826 V 524 1826 V 575 1790 a Fl(BLUE)p 1225 1826 V 451 w Fn(subsequen)m(t)j(c)m (hars)f(are)e(blue)p 3373 1826 V 3390 1826 V 507 1947 V 524 1947 V 575 1910 a Fl(MA)m(GENT)-8 b(A)p 1225 1947 V 227 w Fn(subsequen)m(t)35 b(c)m(hars)f(are)e(magen)m(ta)p 3373 1947 V 3390 1947 V 507 2067 V 524 2067 V 575 2031 a Fl(CY)-8 b(AN)p 1225 2067 V 440 w Fn(subsequen)m(t)35 b(c)m(hars)f(are)e(cy)m(an)p 3373 2067 V 3390 2067 V 507 2187 V 524 2187 V 575 2151 a Fl(WHITE)p 1225 2187 V 380 w Fn(subsequen)m(t)j(c)m(hars)f(are)e(white)p 3373 2187 V 3390 2187 V 507 2308 V 524 2308 V 1225 2308 V 3373 2308 V 3390 2308 V 507 2428 V 524 2428 V 575 2392 a Fl(UBLA)m(CK)p 1225 2428 V 311 w Fn(subsequen)m(t)j(c)m(hars)f(are)e (underlined)h(and)f(blac)m(k)p 3373 2428 V 3390 2428 V 507 2548 V 524 2548 V 575 2512 a Fl(URED)p 1225 2548 V 436 w Fn(subsequen)m(t)j(c)m(hars)f(are)e(underlined)h(and)f(red)p 3373 2548 V 3390 2548 V 507 2669 V 524 2669 V 575 2633 a Fl(UGREEN)p 1225 2669 V 304 w Fn(subsequen)m(t)j(c)m(hars)f(are)e (underlined)h(and)f(green)p 3373 2669 V 3390 2669 V 507 2789 V 524 2789 V 575 2753 a Fl(UYELLO)m(W)p 1225 2789 V 229 w Fn(subsequen)m(t)j(c)m(hars)f(are)e(underlined)h(and)f(y)m (ello)m(w)p 3373 2789 V 3390 2789 V 507 2910 V 524 2910 V 575 2874 a Fl(UBLUE)p 1225 2910 V 383 w Fn(subsequen)m(t)j(c)m(hars)f (are)e(underlined)h(and)f(blue)p 3373 2910 V 3390 2910 V 507 3030 V 524 3030 V 575 2994 a Fl(UMA)m(GENT)-8 b(A)p 1225 3030 V 159 w Fn(subsequen)m(t)35 b(c)m(hars)f(are)e(underlined)h (and)f(magen)m(ta)p 3373 3030 V 3390 3030 V 507 3150 V 524 3150 V 575 3114 a Fl(UCY)-8 b(AN)p 1225 3150 V 372 w Fn(subsequen)m(t)35 b(c)m(hars)f(are)e(underlined)h(and)f(cy)m (an)p 3373 3150 V 3390 3150 V 507 3271 V 524 3271 V 575 3235 a Fl(UWHITE)p 1225 3271 V 312 w Fn(subsequen)m(t)j(c)m(hars)f(are) e(underlined)h(and)f(white)p 3373 3271 V 3390 3271 V 507 3391 V 524 3391 V 1225 3391 V 3373 3391 V 3390 3391 V 507 3512 V 524 3512 V 575 3475 a Fl(R)-10 b(VBLA)m(CK)p 1225 3512 V 254 w Fn(subsequen)m(t)35 b(c)m(hars)f(are)e(rev)m (erse-video)j(and)d(blac)m(k)p 3373 3512 V 3390 3512 V 507 3632 V 524 3632 V 575 3596 a Fl(R)-10 b(VRED)p 1225 3632 V 379 w Fn(subsequen)m(t)35 b(c)m(hars)f(are)e(rev)m (erse-video)j(and)d(red)p 3373 3632 V 3390 3632 V 507 3752 V 524 3752 V 575 3716 a Fl(R)-10 b(V)m(GREEN)p 1225 3752 V 250 w Fn(subsequen)m(t)35 b(c)m(hars)f(are)e(rev)m(erse-video)j (and)d(green)p 3373 3752 V 3390 3752 V 507 3873 V 524 3873 V 575 3837 a Fl(R)-10 b(VYELLO)m(W)p 1225 3873 V 172 w Fn(subsequen)m(t)35 b(c)m(hars)f(are)e(rev)m(erse-video)j(and)d (y)m(ello)m(w)p 3373 3873 V 3390 3873 V 507 3993 V 524 3993 V 575 3957 a Fl(R)-10 b(VBLUE)p 1225 3993 V 326 w Fn(subsequen)m(t)35 b(c)m(hars)f(are)e(rev)m(erse-video)j(and)d(blue) p 3373 3993 V 3390 3993 V 507 4113 V 524 4113 V 575 4077 a Fl(R)-10 b(VMA)m(GENT)i(A)p 1225 4113 V 102 w Fn(subsequen)m(t)35 b(c)m(hars)f(are)e(rev)m(erse-video)j(and)d(magen)m(ta)p 3373 4113 V 3390 4113 V 507 4234 V 524 4234 V 575 4198 a Fl(R)-10 b(V)m(CY)i(AN)p 1225 4234 V 318 w Fn(subsequen)m(t)35 b(c)m(hars)f(are)e(rev)m(erse-video)j(and)d(cy)m(an)p 3373 4234 V 3390 4234 V 507 4354 V 524 4354 V 575 4318 a Fl(R)-10 b(VWHITE)p 1225 4354 V 255 w Fn(subsequen)m(t)35 b(c)m(hars)f(are)e(rev)m(erse-video)j(and)d(white)p 3373 4354 V 3390 4354 V 507 4475 V 524 4475 V 1225 4475 V 3373 4475 V 3390 4475 V 507 4595 V 524 4595 V 575 4559 a Fl(NRML)p 1225 4595 V 427 w Fn(subsequen)m(t)j(c)m(hars)f(are)e (\\normal")p 3373 4595 V 3390 4595 V 507 4715 V 524 4715 V 575 4679 a Fl(BOLD)p 1225 4715 V 441 w Fn(subsequen)m(t)j(c)m(hars)f (are)e(\\b)s(old")p 3373 4715 V 3390 4715 V 507 4836 V 524 4836 V 575 4800 a Fl(CLEAR)p 1225 4836 V 382 w Fn(the)h(screen)h(is)e(cleared)p 3373 4836 V 3390 4836 V 509 4839 2883 4 v 509 4856 V 1901 5707 a(33)p eop end %%Trailer userdict /end-hook known{end-hook}if %%EOF