/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / python / pytexdoc / ext / lib / lib2 / mactcp / tex

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 42 75 69 6c 74 2d 69 |\section|{Built-i|
|00000010| 6e 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |n Module| \sectco|
|00000020| 64 65 7b 6d 61 63 74 63 | 70 7d 7d 0a 5c 62 69 6d |de{mactc|p}}.\bim|
|00000030| 6f 64 69 6e 64 65 78 7b | 6d 61 63 74 63 70 7d 0a |odindex{|mactcp}.|
|00000040| 0a 5c 72 65 6e 65 77 63 | 6f 6d 6d 61 6e 64 7b 5c |.\renewc|ommand{\|
|00000050| 69 6e 64 65 78 73 75 62 | 69 74 65 6d 7d 7b 28 69 |indexsub|item}{(i|
|00000060| 6e 20 6d 6f 64 75 6c 65 | 20 6d 61 63 74 63 70 29 |n module| mactcp)|
|00000070| 7d 0a 0a 54 68 69 73 20 | 6d 6f 64 75 6c 65 20 70 |}..This |module p|
|00000080| 72 6f 76 69 64 65 73 20 | 61 6e 20 69 6e 74 65 72 |rovides |an inter|
|00000090| 66 61 63 65 20 74 6f 20 | 74 68 65 20 4d 61 63 69 |face to |the Maci|
|000000a0| 6e 74 6f 73 68 20 54 43 | 50 2f 49 50 20 64 72 69 |ntosh TC|P/IP dri|
|000000b0| 76 65 72 0a 4d 61 63 54 | 43 50 5c 40 2e 20 54 68 |ver.MacT|CP\@. Th|
|000000c0| 65 72 65 20 69 73 20 61 | 6e 20 61 63 63 6f 6d 70 |ere is a|n accomp|
|000000d0| 61 6e 79 69 6e 67 20 6d | 6f 64 75 6c 65 20 5c 63 |anying m|odule \c|
|000000e0| 6f 64 65 7b 6d 61 63 64 | 6e 72 7d 20 77 68 69 63 |ode{macd|nr} whic|
|000000f0| 68 20 70 72 6f 76 69 64 | 65 73 20 61 6e 0a 69 6e |h provid|es an.in|
|00000100| 74 65 72 66 61 63 65 20 | 74 6f 20 74 68 65 20 6e |terface |to the n|
|00000110| 61 6d 65 2d 73 65 72 76 | 65 72 20 28 61 6c 6c 6f |ame-serv|er (allo|
|00000120| 77 69 6e 67 20 79 6f 75 | 20 74 6f 20 74 72 61 6e |wing you| to tran|
|00000130| 73 6c 61 74 65 20 68 6f | 73 74 6e 61 6d 65 73 20 |slate ho|stnames |
|00000140| 74 6f 0a 69 70 2d 61 64 | 64 72 65 73 73 65 73 29 |to.ip-ad|dresses)|
|00000150| 2c 20 61 20 6d 6f 64 75 | 6c 65 20 5c 63 6f 64 65 |, a modu|le \code|
|00000160| 7b 4d 41 43 54 43 50 63 | 6f 6e 73 74 7d 20 77 68 |{MACTCPc|onst} wh|
|00000170| 69 63 68 20 68 61 73 20 | 73 79 6d 62 6f 6c 69 63 |ich has |symbolic|
|00000180| 20 6e 61 6d 65 73 20 66 | 6f 72 0a 63 6f 6e 73 74 | names f|or.const|
|00000190| 61 6e 74 73 20 63 6f 6e | 73 74 61 6e 74 73 20 75 |ants con|stants u|
|000001a0| 73 65 64 20 62 79 20 4d | 61 63 54 43 50 2e 20 53 |sed by M|acTCP. S|
|000001b0| 69 6e 63 65 20 74 68 65 | 20 62 75 69 6c 74 69 6e |ince the| builtin|
|000001c0| 20 6d 6f 64 75 6c 65 0a | 5c 63 6f 64 65 7b 73 6f | module.|\code{so|
|000001d0| 63 6b 65 74 7d 20 69 73 | 20 61 6c 73 6f 20 61 76 |cket} is| also av|
|000001e0| 61 69 6c 61 62 6c 65 20 | 6f 6e 20 74 68 65 20 6d |ailable |on the m|
|000001f0| 61 63 20 69 74 20 69 73 | 20 75 73 75 61 6c 6c 79 |ac it is| usually|
|00000200| 20 65 61 73 69 65 72 20 | 74 6f 20 75 73 65 0a 73 | easier |to use.s|
|00000210| 6f 63 6b 65 74 73 20 69 | 6e 20 73 74 65 61 64 20 |ockets i|n stead |
|00000220| 6f 66 20 74 68 65 20 6d | 61 63 2d 73 70 65 63 69 |of the m|ac-speci|
|00000230| 66 69 63 20 4d 61 63 54 | 43 50 20 41 50 49 2e 0a |fic MacT|CP API..|
|00000240| 0a 41 20 63 6f 6d 70 6c | 65 74 65 20 64 65 73 63 |.A compl|ete desc|
|00000250| 72 69 70 74 69 6f 6e 20 | 6f 66 20 74 68 65 20 4d |ription |of the M|
|00000260| 61 63 54 43 50 20 69 6e | 74 65 72 66 61 63 65 20 |acTCP in|terface |
|00000270| 63 61 6e 20 62 65 20 66 | 6f 75 6e 64 20 69 6e 20 |can be f|ound in |
|00000280| 74 68 65 0a 41 70 70 6c | 65 20 4d 61 63 54 43 50 |the.Appl|e MacTCP|
|00000290| 20 41 50 49 20 64 6f 63 | 75 6d 65 6e 74 61 74 69 | API doc|umentati|
|000002a0| 6f 6e 2e 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |on...\be|gin{func|
|000002b0| 64 65 73 63 7d 7b 4d 54 | 55 7d 7b 7d 0a 52 65 74 |desc}{MT|U}{}.Ret|
|000002c0| 75 72 6e 20 74 68 65 20 | 4d 61 78 69 6d 75 6d 20 |urn the |Maximum |
|000002d0| 54 72 61 6e 73 6d 69 74 | 20 55 6e 69 74 20 28 74 |Transmit| Unit (t|
|000002e0| 68 65 20 70 61 63 6b 65 | 74 20 73 69 7a 65 29 20 |he packe|t size) |
|000002f0| 6f 66 20 74 68 65 20 6e | 65 74 77 6f 72 6b 0a 69 |of the n|etwork.i|
|00000300| 6e 74 65 72 66 61 63 65 | 2e 0a 5c 65 6e 64 7b 66 |nterface|..\end{f|
|00000310| 75 6e 63 64 65 73 63 7d | 0a 0a 5c 62 65 67 69 6e |uncdesc}|..\begin|
|00000320| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 49 50 41 64 64 |{funcdes|c}{IPAdd|
|00000330| 72 7d 7b 7d 0a 52 65 74 | 75 72 6e 20 74 68 65 20 |r}{}.Ret|urn the |
|00000340| 33 32 2d 62 69 74 20 69 | 6e 74 65 67 65 72 20 49 |32-bit i|nteger I|
|00000350| 50 20 61 64 64 72 65 73 | 73 20 6f 66 20 74 68 65 |P addres|s of the|
|00000360| 20 6e 65 74 77 6f 72 6b | 20 69 6e 74 65 72 66 61 | network| interfa|
|00000370| 63 65 2e 0a 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |ce..\end|{funcdes|
|00000380| 63 7d 0a 0a 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00000390| 65 73 63 7d 7b 4e 65 74 | 4d 61 73 6b 7d 7b 7d 0a |esc}{Net|Mask}{}.|
|000003a0| 52 65 74 75 72 6e 20 74 | 68 65 20 33 32 2d 62 69 |Return t|he 32-bi|
|000003b0| 74 20 69 6e 74 65 67 65 | 72 20 6e 65 74 77 6f 72 |t intege|r networ|
|000003c0| 6b 20 6d 61 73 6b 20 6f | 66 20 74 68 65 20 69 6e |k mask o|f the in|
|000003d0| 74 65 72 66 61 63 65 2e | 0a 5c 65 6e 64 7b 66 75 |terface.|.\end{fu|
|000003e0| 6e 63 64 65 73 63 7d 0a | 0a 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|000003f0| 66 75 6e 63 64 65 73 63 | 7d 7b 54 43 50 43 72 65 |funcdesc|}{TCPCre|
|00000400| 61 74 65 7d 7b 73 69 7a | 65 7d 0a 43 72 65 61 74 |ate}{siz|e}.Creat|
|00000410| 65 20 61 20 54 43 50 20 | 53 74 72 65 61 6d 20 6f |e a TCP |Stream o|
|00000420| 62 6a 65 63 74 2e 20 5c | 76 61 72 7b 73 69 7a 65 |bject. \|var{size|
|00000430| 7d 20 69 73 20 74 68 65 | 20 73 69 7a 65 20 6f 66 |} is the| size of|
|00000440| 20 74 68 65 20 72 65 63 | 65 69 76 65 0a 62 75 66 | the rec|eive.buf|
|00000450| 66 65 72 2c 20 5c 63 6f | 64 65 7b 34 30 39 36 7d |fer, \co|de{4096}|
|00000460| 20 69 73 20 73 75 67 67 | 65 73 74 65 64 20 62 79 | is sugg|ested by|
|00000470| 20 76 61 72 69 6f 75 73 | 20 73 6f 75 72 63 65 73 | various| sources|
|00000480| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00000490| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|000004a0| 63 7d 7b 55 44 50 43 72 | 65 61 74 65 7d 7b 73 69 |c}{UDPCr|eate}{si|
|000004b0| 7a 65 2c 20 70 6f 72 74 | 7d 0a 43 72 65 61 74 65 |ze, port|}.Create|
|000004c0| 20 61 20 55 44 50 20 73 | 74 72 65 61 6d 20 6f 62 | a UDP s|tream ob|
|000004d0| 6a 65 63 74 2e 20 5c 76 | 61 72 7b 73 69 7a 65 7d |ject. \v|ar{size}|
|000004e0| 20 69 73 20 74 68 65 20 | 73 69 7a 65 20 6f 66 20 | is the |size of |
|000004f0| 74 68 65 20 72 65 63 65 | 69 76 65 0a 62 75 66 66 |the rece|ive.buff|
|00000500| 65 72 20 28 61 6e 64 2c | 20 68 65 6e 63 65 2c 20 |er (and,| hence, |
|00000510| 74 68 65 20 73 69 7a 65 | 20 6f 66 20 74 68 65 20 |the size| of the |
|00000520| 62 69 67 67 65 73 74 20 | 64 61 74 61 67 72 61 6d |biggest |datagram|
|00000530| 20 79 6f 75 20 63 61 6e | 20 72 65 63 65 69 76 65 | you can| receive|
|00000540| 0a 6f 6e 20 74 68 69 73 | 20 70 6f 72 74 29 2e 20 |.on this| port). |
|00000550| 5c 76 61 72 7b 70 6f 72 | 74 7d 20 69 73 20 74 68 |\var{por|t} is th|
|00000560| 65 20 55 44 50 20 70 6f | 72 74 20 6e 75 6d 62 65 |e UDP po|rt numbe|
|00000570| 72 20 79 6f 75 20 77 61 | 6e 74 20 74 6f 20 72 65 |r you wa|nt to re|
|00000580| 63 65 69 76 65 0a 64 61 | 74 61 67 72 61 6d 73 20 |ceive.da|tagrams |
|00000590| 6f 6e 2c 20 61 20 76 61 | 6c 75 65 20 6f 66 20 7a |on, a va|lue of z|
|000005a0| 65 72 6f 20 77 69 6c 6c | 20 6d 61 6b 65 20 4d 61 |ero will| make Ma|
|000005b0| 63 54 43 50 20 73 65 6c | 65 63 74 20 61 20 66 72 |cTCP sel|ect a fr|
|000005c0| 65 65 20 70 6f 72 74 2e | 0a 5c 65 6e 64 7b 66 75 |ee port.|.\end{fu|
|000005d0| 6e 63 64 65 73 63 7d 0a | 0a 5c 73 75 62 73 65 63 |ncdesc}.|.\subsec|
|000005e0| 74 69 6f 6e 7b 54 43 50 | 20 53 74 72 65 61 6d 20 |tion{TCP| Stream |
|000005f0| 4f 62 6a 65 63 74 73 7d | 0a 0a 5c 72 65 6e 65 77 |Objects}|..\renew|
|00000600| 63 6f 6d 6d 61 6e 64 7b | 5c 69 6e 64 65 78 73 75 |command{|\indexsu|
|00000610| 62 69 74 65 6d 7d 7b 28 | 54 43 50 20 73 74 72 65 |bitem}{(|TCP stre|
|00000620| 61 6d 20 61 74 74 72 69 | 62 75 74 65 29 7d 0a 0a |am attri|bute)}..|
|00000630| 5c 62 65 67 69 6e 7b 64 | 61 74 61 64 65 73 63 7d |\begin{d|atadesc}|
|00000640| 7b 61 73 72 7d 0a 57 68 | 65 6e 20 73 65 74 20 74 |{asr}.Wh|en set t|
|00000650| 6f 20 61 20 76 61 6c 75 | 65 20 64 69 66 66 65 72 |o a valu|e differ|
|00000660| 65 6e 74 20 74 68 61 6e | 20 5c 63 6f 64 65 7b 4e |ent than| \code{N|
|00000670| 6f 6e 65 7d 20 74 68 69 | 73 20 73 68 6f 75 6c 64 |one} thi|s should|
|00000680| 20 70 6f 69 6e 74 20 74 | 6f 20 61 0a 66 75 6e 63 | point t|o a.func|
|00000690| 74 69 6f 6e 20 77 69 74 | 68 20 74 77 6f 20 69 6e |tion wit|h two in|
|000006a0| 74 65 67 65 72 20 70 61 | 72 61 6d 65 74 65 72 73 |teger pa|rameters|
|000006b0| 3a 5c 20 61 6e 20 65 76 | 65 6e 74 20 63 6f 64 65 |:\ an ev|ent code|
|000006c0| 20 61 6e 64 20 61 20 64 | 65 74 61 69 6c 2e 20 54 | and a d|etail. T|
|000006d0| 68 69 73 0a 66 75 6e 63 | 74 69 6f 6e 20 77 69 6c |his.func|tion wil|
|000006e0| 6c 20 62 65 20 63 61 6c | 6c 65 64 20 75 70 6f 6e |l be cal|led upon|
|000006f0| 20 6e 65 74 77 6f 72 6b | 2d 67 65 6e 65 72 61 74 | network|-generat|
|00000700| 65 64 20 65 76 65 6e 74 | 73 20 73 75 63 68 20 61 |ed event|s such a|
|00000710| 73 20 75 72 67 65 6e 74 | 0a 64 61 74 61 20 61 72 |s urgent|.data ar|
|00000720| 72 69 76 61 6c 2e 20 49 | 6e 20 61 64 64 69 74 69 |rival. I|n additi|
|00000730| 6f 6e 2c 20 69 74 20 69 | 73 20 63 61 6c 6c 65 64 |on, it i|s called|
|00000740| 20 77 69 74 68 20 65 76 | 65 6e 74 63 6f 64 65 0a | with ev|entcode.|
|00000750| 5c 63 6f 64 65 7b 4d 41 | 43 54 43 50 2e 50 61 73 |\code{MA|CTCP.Pas|
|00000760| 73 69 76 65 4f 70 65 6e | 44 6f 6e 65 7d 20 77 68 |siveOpen|Done} wh|
|00000770| 65 6e 20 61 20 5c 63 6f | 64 65 7b 50 61 73 73 69 |en a \co|de{Passi|
|00000780| 76 65 4f 70 65 6e 7d 20 | 63 6f 6d 70 6c 65 74 65 |veOpen} |complete|
|00000790| 73 2e 20 54 68 69 73 0a | 69 73 20 61 20 50 79 74 |s. This.|is a Pyt|
|000007a0| 68 6f 6e 20 61 64 64 69 | 74 69 6f 6e 20 74 6f 20 |hon addi|tion to |
|000007b0| 74 68 65 20 4d 61 63 54 | 43 50 20 73 65 6d 61 6e |the MacT|CP seman|
|000007c0| 74 69 63 73 2e 0a 49 74 | 20 69 73 20 73 61 66 65 |tics..It| is safe|
|000007d0| 20 74 6f 20 64 6f 20 66 | 75 72 74 68 65 72 20 63 | to do f|urther c|
|000007e0| 61 6c 6c 73 20 66 72 6f | 6d 20 74 68 65 20 5c 63 |alls fro|m the \c|
|000007f0| 6f 64 65 7b 61 73 72 7d | 2e 0a 5c 65 6e 64 7b 64 |ode{asr}|..\end{d|
|00000800| 61 74 61 64 65 73 63 7d | 0a 0a 5c 72 65 6e 65 77 |atadesc}|..\renew|
|00000810| 63 6f 6d 6d 61 6e 64 7b | 5c 69 6e 64 65 78 73 75 |command{|\indexsu|
|00000820| 62 69 74 65 6d 7d 7b 28 | 54 43 50 20 73 74 72 65 |bitem}{(|TCP stre|
|00000830| 61 6d 20 6d 65 74 68 6f | 64 29 7d 0a 0a 5c 62 65 |am metho|d)}..\be|
|00000840| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 50 61 |gin{func|desc}{Pa|
|00000850| 73 73 69 76 65 4f 70 65 | 6e 7d 7b 70 6f 72 74 7d |ssiveOpe|n}{port}|
|00000860| 0a 57 61 69 74 20 66 6f | 72 20 61 6e 20 69 6e 63 |.Wait fo|r an inc|
|00000870| 6f 6d 69 6e 67 20 63 6f | 6e 6e 65 63 74 69 6f 6e |oming co|nnection|
|00000880| 20 6f 6e 20 54 43 50 20 | 70 6f 72 74 20 5c 76 61 | on TCP |port \va|
|00000890| 72 7b 70 6f 72 74 7d 20 | 28 7a 65 72 6f 20 6d 61 |r{port} |(zero ma|
|000008a0| 6b 65 73 20 74 68 65 0a | 73 79 73 74 65 6d 20 70 |kes the.|system p|
|000008b0| 69 63 6b 20 61 20 66 72 | 65 65 20 70 6f 72 74 29 |ick a fr|ee port)|
|000008c0| 2e 20 54 68 65 20 63 61 | 6c 6c 20 72 65 74 75 72 |. The ca|ll retur|
|000008d0| 6e 73 20 69 6d 6d 65 64 | 69 61 74 65 6c 79 2c 20 |ns immed|iately, |
|000008e0| 61 6e 64 20 79 6f 75 20 | 73 68 6f 75 6c 64 0a 75 |and you |should.u|
|000008f0| 73 65 20 5c 76 61 72 7b | 77 61 69 74 7d 20 74 6f |se \var{|wait} to|
|00000900| 20 77 61 69 74 20 66 6f | 72 20 63 6f 6d 70 6c 65 | wait fo|r comple|
|00000910| 74 69 6f 6e 2e 20 59 6f | 75 20 73 68 6f 75 6c 64 |tion. Yo|u should|
|00000920| 20 6e 6f 74 20 69 73 73 | 75 65 20 61 6e 79 20 6d | not iss|ue any m|
|00000930| 65 74 68 6f 64 0a 63 61 | 6c 6c 73 20 6f 74 68 65 |ethod.ca|lls othe|
|00000940| 72 20 74 68 61 6e 0a 5c | 63 6f 64 65 7b 77 61 69 |r than.\|code{wai|
|00000950| 74 7d 2c 20 5c 63 6f 64 | 65 7b 69 73 64 6f 6e 65 |t}, \cod|e{isdone|
|00000960| 7d 20 6f 72 20 5c 63 6f | 64 65 7b 47 65 74 53 6f |} or \co|de{GetSo|
|00000970| 63 6b 4e 61 6d 65 7d 20 | 62 65 66 6f 72 65 20 74 |ckName} |before t|
|00000980| 68 65 20 63 61 6c 6c 0a | 63 6f 6d 70 6c 65 74 65 |he call.|complete|
|00000990| 73 2e 0a 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |s..\end{|funcdesc|
|000009a0| 7d 0a 0a 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|000009b0| 73 63 7d 7b 77 61 69 74 | 7d 7b 7d 0a 57 61 69 74 |sc}{wait|}{}.Wait|
|000009c0| 20 66 6f 72 20 5c 63 6f | 64 65 7b 50 61 73 73 69 | for \co|de{Passi|
|000009d0| 76 65 4f 70 65 6e 7d 20 | 74 6f 20 63 6f 6d 70 6c |veOpen} |to compl|
|000009e0| 65 74 65 2e 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |ete..\en|d{funcde|
|000009f0| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00000a00| 64 65 73 63 7d 7b 69 73 | 64 6f 6e 65 7d 7b 7d 0a |desc}{is|done}{}.|
|00000a10| 52 65 74 75 72 6e 20 31 | 20 69 66 20 61 20 5c 63 |Return 1| if a \c|
|00000a20| 6f 64 65 7b 50 61 73 73 | 69 76 65 4f 70 65 6e 7d |ode{Pass|iveOpen}|
|00000a30| 20 68 61 73 20 63 6f 6d | 70 6c 65 74 65 64 2e 0a | has com|pleted..|
|00000a40| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0a 0a |\end{fun|cdesc}..|
|00000a50| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00000a60| 7b 47 65 74 53 6f 63 6b | 4e 61 6d 65 7d 7b 7d 0a |{GetSock|Name}{}.|
|00000a70| 52 65 74 75 72 6e 20 74 | 68 65 20 54 43 50 20 61 |Return t|he TCP a|
|00000a80| 64 64 72 65 73 73 20 6f | 66 20 74 68 69 73 20 73 |ddress o|f this s|
|00000a90| 69 64 65 20 6f 66 20 61 | 20 63 6f 6e 6e 65 63 74 |ide of a| connect|
|00000aa0| 69 6f 6e 20 61 73 20 61 | 20 32 2d 74 75 70 6c 65 |ion as a| 2-tuple|
|00000ab0| 0a 5c 63 6f 64 65 7b 28 | 68 6f 73 74 2c 20 70 6f |.\code{(|host, po|
|00000ac0| 72 74 29 7d 2c 20 62 6f | 74 68 20 69 6e 74 65 67 |rt)}, bo|th integ|
|00000ad0| 65 72 73 2e 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |ers..\en|d{funcde|
|00000ae0| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00000af0| 64 65 73 63 7d 7b 41 63 | 74 69 76 65 4f 70 65 6e |desc}{Ac|tiveOpen|
|00000b00| 7d 7b 6c 70 6f 72 74 5c | 2c 20 68 6f 73 74 5c 2c |}{lport\|, host\,|
|00000b10| 20 72 70 6f 72 74 7d 0a | 4f 70 65 6e 20 61 6e 20 | rport}.|Open an |
|00000b20| 6f 75 74 67 6f 69 6e 67 | 20 63 6f 6e 6e 65 63 74 |outgoing| connect|
|00000b30| 69 6f 6e 20 74 6f 20 54 | 43 50 20 61 64 64 72 65 |ion to T|CP addre|
|00000b40| 73 73 20 5c 63 6f 64 65 | 7b 28 5c 76 61 72 7b 68 |ss \code|{(\var{h|
|00000b50| 6f 73 74 7d 2c 20 5c 76 | 61 72 7b 72 70 6f 72 74 |ost}, \v|ar{rport|
|00000b60| 7d 29 7d 2e 20 55 73 65 | 0a 6c 6f 63 61 6c 20 70 |})}. Use|.local p|
|00000b70| 6f 72 74 20 5c 76 61 72 | 7b 6c 70 6f 72 74 7d 20 |ort \var|{lport} |
|00000b80| 28 7a 65 72 6f 20 6d 61 | 6b 65 73 20 74 68 65 20 |(zero ma|kes the |
|00000b90| 73 79 73 74 65 6d 20 70 | 69 63 6b 20 61 20 66 72 |system p|ick a fr|
|00000ba0| 65 65 20 70 6f 72 74 29 | 2e 20 54 68 69 73 0a 63 |ee port)|. This.c|
|00000bb0| 61 6c 6c 20 62 6c 6f 63 | 6b 73 20 75 6e 74 69 6c |all bloc|ks until|
|00000bc0| 20 74 68 65 20 63 6f 6e | 6e 65 63 74 69 6f 6e 20 | the con|nection |
|00000bd0| 68 61 73 20 62 65 65 6e | 20 65 73 74 61 62 6c 69 |has been| establi|
|00000be0| 73 68 65 64 2e 0a 5c 65 | 6e 64 7b 66 75 6e 63 64 |shed..\e|nd{funcd|
|00000bf0| 65 73 63 7d 0a 0a 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|00000c00| 63 64 65 73 63 7d 7b 53 | 65 6e 64 7d 7b 62 75 66 |cdesc}{S|end}{buf|
|00000c10| 5c 2c 20 70 75 73 68 5c | 2c 20 75 72 67 65 6e 74 |\, push\|, urgent|
|00000c20| 7d 0a 53 65 6e 64 20 64 | 61 74 61 20 5c 76 61 72 |}.Send d|ata \var|
|00000c30| 7b 62 75 66 7d 20 6f 76 | 65 72 20 74 68 65 20 63 |{buf} ov|er the c|
|00000c40| 6f 6e 6e 65 63 74 69 6f | 6e 2e 20 5c 76 61 72 7b |onnectio|n. \var{|
|00000c50| 50 75 73 68 7d 20 61 6e | 64 20 5c 76 61 72 7b 75 |Push} an|d \var{u|
|00000c60| 72 67 65 6e 74 7d 0a 61 | 72 65 20 66 6c 61 67 73 |rgent}.a|re flags|
|00000c70| 20 61 73 20 73 70 65 63 | 69 66 69 65 64 20 62 79 | as spec|ified by|
|00000c80| 20 74 68 65 20 54 43 50 | 20 73 74 61 6e 64 61 72 | the TCP| standar|
|00000c90| 64 2e 0a 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |d..\end{|funcdesc|
|00000ca0| 7d 0a 0a 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|00000cb0| 73 63 7d 7b 52 63 76 7d | 7b 74 69 6d 65 6f 75 74 |sc}{Rcv}|{timeout|
|00000cc0| 7d 0a 52 65 63 65 69 76 | 65 20 64 61 74 61 2e 20 |}.Receiv|e data. |
|00000cd0| 54 68 65 20 63 61 6c 6c | 20 72 65 74 75 72 6e 73 |The call| returns|
|00000ce0| 20 77 68 65 6e 20 5c 76 | 61 72 7b 74 69 6d 65 6f | when \v|ar{timeo|
|00000cf0| 75 74 7d 20 73 65 63 6f | 6e 64 73 20 68 61 76 65 |ut} seco|nds have|
|00000d00| 20 70 61 73 73 65 64 0a | 6f 72 20 77 68 65 6e 20 | passed.|or when |
|00000d10| 28 61 63 63 6f 72 64 69 | 6e 67 20 74 6f 20 74 68 |(accordi|ng to th|
|00000d20| 65 20 4d 61 63 54 43 50 | 20 64 6f 63 75 6d 65 6e |e MacTCP| documen|
|00000d30| 74 61 74 69 6f 6e 29 20 | 60 60 61 20 72 65 61 73 |tation) |``a reas|
|00000d40| 6f 6e 61 62 6c 65 20 61 | 6d 6f 75 6e 74 0a 6f 66 |onable a|mount.of|
|00000d50| 20 64 61 74 61 20 68 61 | 73 20 62 65 65 6e 20 72 | data ha|s been r|
|00000d60| 65 63 65 69 76 65 64 27 | 27 2e 20 54 68 65 20 72 |eceived'|'. The r|
|00000d70| 65 74 75 72 6e 20 76 61 | 6c 75 65 20 69 73 20 61 |eturn va|lue is a|
|00000d80| 20 33 2d 74 75 70 6c 65 | 0a 5c 63 6f 64 65 7b 28 | 3-tuple|.\code{(|
|00000d90| 5c 76 61 72 7b 64 61 74 | 61 7d 2c 20 5c 76 61 72 |\var{dat|a}, \var|
|00000da0| 7b 75 72 67 65 6e 74 7d | 2c 20 5c 76 61 72 7b 6d |{urgent}|, \var{m|
|00000db0| 61 72 6b 7d 29 7d 2e 20 | 49 66 20 75 72 67 65 6e |ark})}. |If urgen|
|00000dc0| 74 20 64 61 74 61 20 69 | 73 20 6f 75 74 73 74 61 |t data i|s outsta|
|00000dd0| 6e 64 69 6e 67 20 5c 63 | 6f 64 65 7b 52 63 76 7d |nding \c|ode{Rcv}|
|00000de0| 0a 77 69 6c 6c 20 61 6c | 77 61 79 73 20 72 65 74 |.will al|ways ret|
|00000df0| 75 72 6e 20 74 68 61 74 | 20 62 65 66 6f 72 65 20 |urn that| before |
|00000e00| 6c 6f 6f 6b 69 6e 67 20 | 61 74 20 61 6e 79 20 6e |looking |at any n|
|00000e10| 6f 72 6d 61 6c 20 64 61 | 74 61 2e 20 54 68 65 20 |ormal da|ta. The |
|00000e20| 66 69 72 73 74 0a 63 61 | 6c 6c 20 72 65 74 75 72 |first.ca|ll retur|
|00000e30| 6e 69 6e 67 20 75 72 67 | 65 6e 74 20 64 61 74 61 |ning urg|ent data|
|00000e40| 20 77 69 6c 6c 20 68 61 | 76 65 20 74 68 65 20 5c | will ha|ve the \|
|00000e50| 76 61 72 7b 75 72 67 65 | 6e 74 7d 20 66 6c 61 67 |var{urge|nt} flag|
|00000e60| 20 73 65 74 2c 20 74 68 | 65 0a 6c 61 73 74 20 77 | set, th|e.last w|
|00000e70| 69 6c 6c 20 68 61 76 65 | 20 74 68 65 20 5c 76 61 |ill have| the \va|
|00000e80| 72 7b 6d 61 72 6b 7d 20 | 66 6c 61 67 20 73 65 74 |r{mark} |flag set|
|00000e90| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00000ea0| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00000eb0| 63 7d 7b 43 6c 6f 73 65 | 7d 7b 7d 0a 54 65 6c 6c |c}{Close|}{}.Tell|
|00000ec0| 20 4d 61 63 54 43 50 20 | 74 68 61 74 20 6e 6f 20 | MacTCP |that no |
|00000ed0| 6d 6f 72 65 20 64 61 74 | 61 20 77 69 6c 6c 20 62 |more dat|a will b|
|00000ee0| 65 20 74 72 61 6e 73 6d | 69 74 74 65 64 20 6f 6e |e transm|itted on|
|00000ef0| 20 74 68 69 73 0a 63 6f | 6e 6e 65 63 74 69 6f 6e | this.co|nnection|
|00000f00| 2e 20 54 68 65 20 63 61 | 6c 6c 20 72 65 74 75 72 |. The ca|ll retur|
|00000f10| 6e 73 20 77 68 65 6e 20 | 61 6c 6c 20 64 61 74 61 |ns when |all data|
|00000f20| 20 68 61 73 20 62 65 65 | 6e 20 61 63 6b 6e 6f 77 | has bee|n acknow|
|00000f30| 6c 65 64 67 65 64 20 62 | 79 0a 74 68 65 20 72 65 |ledged b|y.the re|
|00000f40| 63 65 69 76 69 6e 67 20 | 73 69 64 65 2e 0a 5c 65 |ceiving |side..\e|
|00000f50| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 62 |nd{funcd|esc}..\b|
|00000f60| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 41 |egin{fun|cdesc}{A|
|00000f70| 62 6f 72 74 7d 7b 7d 0a | 46 6f 72 63 69 62 6c 79 |bort}{}.|Forcibly|
|00000f80| 20 63 6c 6f 73 65 20 62 | 6f 74 68 20 73 69 64 65 | close b|oth side|
|00000f90| 73 20 6f 66 20 61 20 63 | 6f 6e 6e 65 63 74 69 6f |s of a c|onnectio|
|00000fa0| 6e 2c 20 69 67 6e 6f 72 | 69 6e 67 20 6f 75 74 73 |n, ignor|ing outs|
|00000fb0| 74 61 6e 64 69 6e 67 20 | 64 61 74 61 2e 0a 5c 65 |tanding |data..\e|
|00000fc0| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 62 |nd{funcd|esc}..\b|
|00000fd0| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 53 |egin{fun|cdesc}{S|
|00000fe0| 74 61 74 75 73 7d 7b 7d | 0a 52 65 74 75 72 6e 20 |tatus}{}|.Return |
|00000ff0| 61 20 54 43 50 20 73 74 | 61 74 75 73 20 6f 62 6a |a TCP st|atus obj|
|00001000| 65 63 74 20 66 6f 72 20 | 74 68 69 73 20 73 74 72 |ect for |this str|
|00001010| 65 61 6d 20 67 69 76 69 | 6e 67 20 74 68 65 20 63 |eam givi|ng the c|
|00001020| 75 72 72 65 6e 74 20 73 | 74 61 74 75 73 0a 28 73 |urrent s|tatus.(s|
|00001030| 65 65 20 62 65 6c 6f 77 | 29 2e 0a 5c 65 6e 64 7b |ee below|)..\end{|
|00001040| 66 75 6e 63 64 65 73 63 | 7d 0a 0a 5c 73 75 62 73 |funcdesc|}..\subs|
|00001050| 65 63 74 69 6f 6e 7b 54 | 43 50 20 53 74 61 74 75 |ection{T|CP Statu|
|00001060| 73 20 4f 62 6a 65 63 74 | 73 7d 0a 54 68 69 73 20 |s Object|s}.This |
|00001070| 6f 62 6a 65 63 74 20 68 | 61 73 20 6e 6f 20 6d 65 |object h|as no me|
|00001080| 74 68 6f 64 73 2c 20 6f | 6e 6c 79 20 73 6f 6d 65 |thods, o|nly some|
|00001090| 20 6d 65 6d 62 65 72 73 | 20 68 6f 6c 64 69 6e 67 | members| holding|
|000010a0| 20 69 6e 66 6f 72 6d 61 | 74 69 6f 6e 20 6f 6e 0a | informa|tion on.|
|000010b0| 74 68 65 20 63 6f 6e 6e | 65 63 74 69 6f 6e 2e 20 |the conn|ection. |
|000010c0| 41 20 63 6f 6d 70 6c 65 | 74 65 20 64 65 73 63 72 |A comple|te descr|
|000010d0| 69 70 74 69 6f 6e 20 6f | 66 20 61 6c 6c 20 66 69 |iption o|f all fi|
|000010e0| 65 6c 64 73 20 69 6e 20 | 74 68 69 73 20 6f 62 6a |elds in |this obj|
|000010f0| 65 63 74 73 0a 63 61 6e | 20 62 65 20 66 6f 75 6e |ects.can| be foun|
|00001100| 64 20 69 6e 20 74 68 65 | 20 41 70 70 6c 65 20 64 |d in the| Apple d|
|00001110| 6f 63 75 6d 65 6e 74 61 | 74 69 6f 6e 2e 20 54 68 |ocumenta|tion. Th|
|00001120| 65 20 6d 6f 73 74 20 69 | 6e 74 65 72 65 73 74 69 |e most i|nteresti|
|00001130| 6e 67 20 6f 6e 65 73 20 | 61 72 65 3a 0a 0a 5c 72 |ng ones |are:..\r|
|00001140| 65 6e 65 77 63 6f 6d 6d | 61 6e 64 7b 5c 69 6e 64 |enewcomm|and{\ind|
|00001150| 65 78 73 75 62 69 74 65 | 6d 7d 7b 28 54 43 50 20 |exsubite|m}{(TCP |
|00001160| 73 74 61 74 75 73 20 61 | 74 74 72 69 62 75 74 65 |status a|ttribute|
|00001170| 29 7d 0a 0a 5c 62 65 67 | 69 6e 7b 64 61 74 61 64 |)}..\beg|in{datad|
|00001180| 65 73 63 7d 7b 6c 6f 63 | 61 6c 48 6f 73 74 7d 0a |esc}{loc|alHost}.|
|00001190| 5c 64 61 74 61 6c 69 6e | 65 7b 6c 6f 63 61 6c 50 |\datalin|e{localP|
|000011a0| 6f 72 74 7d 0a 5c 64 61 | 74 61 6c 69 6e 65 7b 72 |ort}.\da|taline{r|
|000011b0| 65 6d 6f 74 65 48 6f 73 | 74 7d 0a 5c 64 61 74 61 |emoteHos|t}.\data|
|000011c0| 6c 69 6e 65 7b 72 65 6d | 6f 74 65 50 6f 72 74 7d |line{rem|otePort}|
|000011d0| 0a 54 68 65 20 69 6e 74 | 65 67 65 72 20 49 50 2d |.The int|eger IP-|
|000011e0| 61 64 64 72 65 73 73 65 | 73 20 61 6e 64 20 70 6f |addresse|s and po|
|000011f0| 72 74 20 6e 75 6d 62 65 | 72 73 20 6f 66 20 62 6f |rt numbe|rs of bo|
|00001200| 74 68 20 65 6e 64 70 6f | 69 6e 74 73 20 6f 66 20 |th endpo|ints of |
|00001210| 74 68 65 0a 63 6f 6e 6e | 65 63 74 69 6f 6e 2e 20 |the.conn|ection. |
|00001220| 0a 5c 65 6e 64 7b 64 61 | 74 61 64 65 73 63 7d 0a |.\end{da|tadesc}.|
|00001230| 0a 5c 62 65 67 69 6e 7b | 64 61 74 61 64 65 73 63 |.\begin{|datadesc|
|00001240| 7d 7b 73 65 6e 64 57 69 | 6e 64 6f 77 7d 0a 54 68 |}{sendWi|ndow}.Th|
|00001250| 65 20 63 75 72 72 65 6e | 74 20 77 69 6e 64 6f 77 |e curren|t window|
|00001260| 20 73 69 7a 65 2e 0a 5c | 65 6e 64 7b 64 61 74 61 | size..\|end{data|
|00001270| 64 65 73 63 7d 0a 0a 5c | 62 65 67 69 6e 7b 64 61 |desc}..\|begin{da|
|00001280| 74 61 64 65 73 63 7d 7b | 61 6d 74 55 6e 61 63 6b |tadesc}{|amtUnack|
|00001290| 65 64 44 61 74 61 7d 0a | 54 68 65 20 6e 75 6d 62 |edData}.|The numb|
|000012a0| 65 72 20 6f 66 20 62 79 | 74 65 73 20 73 65 6e 74 |er of by|tes sent|
|000012b0| 20 62 75 74 20 6e 6f 74 | 20 79 65 74 20 61 63 6b | but not| yet ack|
|000012c0| 6e 6f 77 6c 65 64 67 65 | 64 2e 20 5c 63 6f 64 65 |nowledge|d. \code|
|000012d0| 7b 73 65 6e 64 57 69 6e | 64 6f 77 20 2d 0a 61 6d |{sendWin|dow -.am|
|000012e0| 74 55 6e 61 63 6b 65 64 | 44 61 74 61 7d 20 69 73 |tUnacked|Data} is|
|000012f0| 20 77 68 61 74 20 79 6f | 75 20 63 61 6e 20 70 61 | what yo|u can pa|
|00001300| 73 73 20 74 6f 20 5c 63 | 6f 64 65 7b 53 65 6e 64 |ss to \c|ode{Send|
|00001310| 7d 20 77 69 74 68 6f 75 | 74 20 62 6c 6f 63 6b 69 |} withou|t blocki|
|00001320| 6e 67 2e 0a 5c 65 6e 64 | 7b 64 61 74 61 64 65 73 |ng..\end|{datades|
|00001330| 63 7d 0a 0a 5c 62 65 67 | 69 6e 7b 64 61 74 61 64 |c}..\beg|in{datad|
|00001340| 65 73 63 7d 7b 61 6d 74 | 55 6e 72 65 61 64 44 61 |esc}{amt|UnreadDa|
|00001350| 74 61 7d 0a 54 68 65 20 | 6e 75 6d 62 65 72 20 6f |ta}.The |number o|
|00001360| 66 20 62 79 74 65 73 20 | 72 65 63 65 69 76 65 64 |f bytes |received|
|00001370| 20 62 75 74 20 6e 6f 74 | 20 79 65 74 20 72 65 61 | but not| yet rea|
|00001380| 64 20 28 77 68 61 74 20 | 79 6f 75 20 63 61 6e 20 |d (what |you can |
|00001390| 5c 63 6f 64 65 7b 52 65 | 63 76 7d 0a 77 69 74 68 |\code{Re|cv}.with|
|000013a0| 6f 75 74 20 62 6c 6f 63 | 6b 69 6e 67 29 2e 0a 5c |out bloc|king)..\|
|000013b0| 65 6e 64 7b 64 61 74 61 | 64 65 73 63 7d 0a 0a 0a |end{data|desc}...|
|000013c0| 0a 5c 73 75 62 73 65 63 | 74 69 6f 6e 7b 55 44 50 |.\subsec|tion{UDP|
|000013d0| 20 53 74 72 65 61 6d 20 | 4f 62 6a 65 63 74 73 7d | Stream |Objects}|
|000013e0| 0a 4e 6f 74 65 20 74 68 | 61 74 2c 20 75 6e 6c 69 |.Note th|at, unli|
|000013f0| 6b 65 20 74 68 65 20 6e | 61 6d 65 20 73 75 67 67 |ke the n|ame sugg|
|00001400| 65 73 74 73 2c 20 74 68 | 65 72 65 20 69 73 20 6e |ests, th|ere is n|
|00001410| 6f 74 68 69 6e 67 20 73 | 74 72 65 61 6d 2d 6c 69 |othing s|tream-li|
|00001420| 6b 65 0a 61 62 6f 75 74 | 20 55 44 50 2e 0a 0a 5c |ke.about| UDP...\|
|00001430| 72 65 6e 65 77 63 6f 6d | 6d 61 6e 64 7b 5c 69 6e |renewcom|mand{\in|
|00001440| 64 65 78 73 75 62 69 74 | 65 6d 7d 7b 28 55 44 50 |dexsubit|em}{(UDP|
|00001450| 20 73 74 72 65 61 6d 20 | 61 74 74 72 69 62 75 74 | stream |attribut|
|00001460| 65 29 7d 0a 0a 5c 62 65 | 67 69 6e 7b 64 61 74 61 |e)}..\be|gin{data|
|00001470| 64 65 73 63 7d 7b 61 73 | 72 7d 0a 54 68 65 20 61 |desc}{as|r}.The a|
|00001480| 73 79 6e 63 68 72 6f 6e | 6f 75 73 20 73 65 72 76 |synchron|ous serv|
|00001490| 69 63 65 20 72 6f 75 74 | 69 6e 65 20 74 6f 20 62 |ice rout|ine to b|
|000014a0| 65 20 63 61 6c 6c 65 64 | 20 6f 6e 20 65 76 65 6e |e called| on even|
|000014b0| 74 73 20 73 75 63 68 20 | 61 73 0a 64 61 74 61 67 |ts such |as.datag|
|000014c0| 72 61 6d 20 61 72 72 69 | 76 61 6c 20 77 69 74 68 |ram arri|val with|
|000014d0| 6f 75 74 20 6f 75 74 73 | 74 61 6e 64 69 6e 67 20 |out outs|tanding |
|000014e0| 5c 63 6f 64 65 7b 52 65 | 61 64 7d 20 63 61 6c 6c |\code{Re|ad} call|
|000014f0| 2e 20 54 68 65 20 5c 63 | 6f 64 65 7b 61 73 72 7d |. The \c|ode{asr}|
|00001500| 20 68 61 73 20 61 0a 73 | 69 6e 67 6c 65 20 61 72 | has a.s|ingle ar|
|00001510| 67 75 6d 65 6e 74 2c 20 | 74 68 65 20 65 76 65 6e |gument, |the even|
|00001520| 74 20 63 6f 64 65 2e 0a | 5c 65 6e 64 7b 64 61 74 |t code..|\end{dat|
|00001530| 61 64 65 73 63 7d 0a 0a | 5c 62 65 67 69 6e 7b 64 |adesc}..|\begin{d|
|00001540| 61 74 61 64 65 73 63 7d | 7b 70 6f 72 74 7d 0a 41 |atadesc}|{port}.A|
|00001550| 20 72 65 61 64 2d 6f 6e | 6c 79 20 6d 65 6d 62 65 | read-on|ly membe|
|00001560| 72 20 67 69 76 69 6e 67 | 20 74 68 65 20 70 6f 72 |r giving| the por|
|00001570| 74 20 6e 75 6d 62 65 72 | 20 6f 66 20 74 68 69 73 |t number| of this|
|00001580| 20 55 44 50 20 73 74 72 | 65 61 6d 2e 0a 5c 65 6e | UDP str|eam..\en|
|00001590| 64 7b 64 61 74 61 64 65 | 73 63 7d 0a 0a 5c 72 65 |d{datade|sc}..\re|
|000015a0| 6e 65 77 63 6f 6d 6d 61 | 6e 64 7b 5c 69 6e 64 65 |newcomma|nd{\inde|
|000015b0| 78 73 75 62 69 74 65 6d | 7d 7b 28 55 44 50 20 73 |xsubitem|}{(UDP s|
|000015c0| 74 72 65 61 6d 20 6d 65 | 74 68 6f 64 29 7d 0a 0a |tream me|thod)}..|
|000015d0| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|000015e0| 7b 52 65 61 64 7d 7b 74 | 69 6d 65 6f 75 74 7d 0a |{Read}{t|imeout}.|
|000015f0| 52 65 61 64 20 61 20 64 | 61 74 61 67 72 61 6d 2c |Read a d|atagram,|
|00001600| 20 77 61 69 74 69 6e 67 | 20 61 74 20 6d 6f 73 74 | waiting| at most|
|00001610| 20 5c 76 61 72 7b 74 69 | 6d 65 6f 75 74 7d 20 73 | \var{ti|meout} s|
|00001620| 65 63 6f 6e 64 73 20 28 | 24 2d 31 24 20 69 73 0a |econds (|$-1$ is.|
|00001630| 69 6e 66 69 6e 69 74 65 | 29 2e 20 20 52 65 74 75 |infinite|).  Retu|
|00001640| 72 6e 20 74 68 65 20 64 | 61 74 61 2e 0a 5c 65 6e |rn the d|ata..\en|
|00001650| 64 7b 66 75 6e 63 64 65 | 73 63 7d 0a 0a 5c 62 65 |d{funcde|sc}..\be|
|00001660| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 57 72 |gin{func|desc}{Wr|
|00001670| 69 74 65 7d 7b 68 6f 73 | 74 5c 2c 20 70 6f 72 74 |ite}{hos|t\, port|
|00001680| 5c 2c 20 62 75 66 7d 0a | 53 65 6e 64 20 5c 76 61 |\, buf}.|Send \va|
|00001690| 72 7b 62 75 66 7d 20 61 | 73 20 61 20 64 61 74 61 |r{buf} a|s a data|
|000016a0| 67 72 61 6d 20 74 6f 20 | 49 50 2d 61 64 64 72 65 |gram to |IP-addre|
|000016b0| 73 73 20 5c 76 61 72 7b | 68 6f 73 74 7d 2c 20 70 |ss \var{|host}, p|
|000016c0| 6f 72 74 0a 5c 76 61 72 | 7b 70 6f 72 74 7d 2e 0a |ort.\var|{port}..|
|000016d0| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0a    |\end{fun|cdesc}. |
+--------+-------------------------+-------------------------+--------+--------+