home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / programming / python / pytex / pytexdoc / lib1 / socket / tex
LaTeX Document  |  1996-11-08  |  13.1 KB

open in: MacOS 8.1     |     Win98     |     DOS

browse contents    |     view JSON data     |     view as text


This file was processed as: LaTeX Document (document/latex).

ConfidenceProgramDetectionMatch TypeSupport
100% dexvert LaTeX Document (document/latex) magic Supported
1% dexvert Text File (text/txt) fallback Supported
100% file LaTeX document text default
99% file LaTeX document, ASCII text default
100% checkBytes Printable ASCII default
100% perlTextCheck Likely Text (Perl) default
100% detectItEasy Format: plain text[LF] default (weak)



hex view
+--------+-------------------------+-------------------------+--------+--------+
|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 73 6f 63 6b 65 | 74 7d 7d 0a 0a 5c 62 69 |de{socke|t}}..\bi|
|00000030| 6d 6f 64 69 6e 64 65 78 | 7b 73 6f 63 6b 65 74 7d |modindex|{socket}|
|00000040| 0a 54 68 69 73 20 6d 6f | 64 75 6c 65 20 70 72 6f |.This mo|dule pro|
|00000050| 76 69 64 65 73 20 61 63 | 63 65 73 73 20 74 6f 20 |vides ac|cess to |
|00000060| 74 68 65 20 42 53 44 20 | 7b 5c 65 6d 20 73 6f 63 |the BSD |{\em soc|
|00000070| 6b 65 74 7d 20 69 6e 74 | 65 72 66 61 63 65 2e 0a |ket} int|erface..|
|00000080| 49 74 20 69 73 20 61 76 | 61 69 6c 61 62 6c 65 20 |It is av|ailable |
|00000090| 6f 6e 20 5c 55 4e 49 58 | 7b 7d 20 73 79 73 74 65 |on \UNIX|{} syste|
|000000a0| 6d 73 20 74 68 61 74 20 | 73 75 70 70 6f 72 74 20 |ms that |support |
|000000b0| 74 68 69 73 20 69 6e 74 | 65 72 66 61 63 65 2e 0a |this int|erface..|
|000000c0| 0a 46 6f 72 20 61 6e 20 | 69 6e 74 72 6f 64 75 63 |.For an |introduc|
|000000d0| 74 69 6f 6e 20 74 6f 20 | 73 6f 63 6b 65 74 20 70 |tion to |socket p|
|000000e0| 72 6f 67 72 61 6d 6d 69 | 6e 67 20 28 69 6e 20 43 |rogrammi|ng (in C|
|000000f0| 29 2c 20 73 65 65 20 74 | 68 65 20 66 6f 6c 6c 6f |), see t|he follo|
|00000100| 77 69 6e 67 0a 70 61 70 | 65 72 73 3a 20 5c 65 6d |wing.pap|ers: \em|
|00000110| 70 68 7b 41 6e 20 49 6e | 74 72 6f 64 75 63 74 6f |ph{An In|troducto|
|00000120| 72 79 20 34 2e 33 42 53 | 44 20 49 6e 74 65 72 70 |ry 4.3BS|D Interp|
|00000130| 72 6f 63 65 73 73 20 43 | 6f 6d 6d 75 6e 69 63 61 |rocess C|ommunica|
|00000140| 74 69 6f 6e 0a 54 75 74 | 6f 72 69 61 6c 7d 2c 20 |tion.Tut|orial}, |
|00000150| 62 79 20 53 74 75 61 72 | 74 20 53 65 63 68 72 65 |by Stuar|t Sechre|
|00000160| 73 74 20 61 6e 64 20 5c | 65 6d 70 68 7b 41 6e 20 |st and \|emph{An |
|00000170| 41 64 76 61 6e 63 65 64 | 20 34 2e 33 42 53 44 20 |Advanced| 4.3BSD |
|00000180| 49 6e 74 65 72 70 72 6f | 63 65 73 73 0a 43 6f 6d |Interpro|cess.Com|
|00000190| 6d 75 6e 69 63 61 74 69 | 6f 6e 20 54 75 74 6f 72 |municati|on Tutor|
|000001a0| 69 61 6c 7d 2c 20 62 79 | 20 53 61 6d 75 65 6c 20 |ial}, by| Samuel |
|000001b0| 4a 2e 20 20 4c 65 66 66 | 6c 65 72 20 65 74 20 61 |J. Leff|ler et a|
|000001c0| 6c 2c 20 62 6f 74 68 20 | 69 6e 20 74 68 65 0a 5c |l, both |in the.\|
|000001d0| 55 4e 49 58 7b 7d 20 50 | 72 6f 67 72 61 6d 6d 65 |UNIX{} P|rogramme|
|000001e0| 72 27 73 20 4d 61 6e 75 | 61 6c 2c 20 53 75 70 70 |r's Manu|al, Supp|
|000001f0| 6c 65 6d 65 6e 74 61 72 | 79 20 44 6f 63 75 6d 65 |lementar|y Docume|
|00000200| 6e 74 73 20 31 20 28 73 | 65 63 74 69 6f 6e 73 20 |nts 1 (s|ections |
|00000210| 50 53 31 3a 37 0a 61 6e | 64 20 50 53 31 3a 38 29 |PS1:7.an|d PS1:8)|
|00000220| 2e 20 20 54 68 65 20 5c | 55 4e 49 58 7b 7d 20 6d |. The \|UNIX{} m|
|00000230| 61 6e 75 61 6c 20 70 61 | 67 65 73 20 66 6f 72 20 |anual pa|ges for |
|00000240| 74 68 65 20 76 61 72 69 | 6f 75 73 20 73 6f 63 6b |the vari|ous sock|
|00000250| 65 74 2d 72 65 6c 61 74 | 65 64 0a 73 79 73 74 65 |et-relat|ed.syste|
|00000260| 6d 20 63 61 6c 6c 73 20 | 61 72 65 20 61 6c 73 6f |m calls |are also|
|00000270| 20 61 20 76 61 6c 75 61 | 62 6c 65 20 73 6f 75 72 | a valua|ble sour|
|00000280| 63 65 20 6f 66 20 69 6e | 66 6f 72 6d 61 74 69 6f |ce of in|formatio|
|00000290| 6e 20 6f 6e 20 74 68 65 | 20 64 65 74 61 69 6c 73 |n on the| details|
|000002a0| 20 6f 66 0a 73 6f 63 6b | 65 74 20 73 65 6d 61 6e | of.sock|et seman|
|000002b0| 74 69 63 73 2e 0a 0a 54 | 68 65 20 50 79 74 68 6f |tics...T|he Pytho|
|000002c0| 6e 20 69 6e 74 65 72 66 | 61 63 65 20 69 73 20 61 |n interf|ace is a|
|000002d0| 20 73 74 72 61 69 67 68 | 74 66 6f 72 77 61 72 64 | straigh|tforward|
|000002e0| 20 74 72 61 6e 73 6c 69 | 74 65 72 61 74 69 6f 6e | transli|teration|
|000002f0| 20 6f 66 20 74 68 65 0a | 5c 55 4e 49 58 7b 7d 20 | of the.|\UNIX{} |
|00000300| 73 79 73 74 65 6d 20 63 | 61 6c 6c 20 61 6e 64 20 |system c|all and |
|00000310| 6c 69 62 72 61 72 79 20 | 69 6e 74 65 72 66 61 63 |library |interfac|
|00000320| 65 20 66 6f 72 20 73 6f | 63 6b 65 74 73 20 74 6f |e for so|ckets to|
|00000330| 20 50 79 74 68 6f 6e 27 | 73 0a 6f 62 6a 65 63 74 | Python'|s.object|
|00000340| 2d 6f 72 69 65 6e 74 65 | 64 20 73 74 79 6c 65 3a |-oriente|d style:|
|00000350| 20 74 68 65 20 5c 63 6f | 64 65 7b 73 6f 63 6b 65 | the \co|de{socke|
|00000360| 74 28 29 7d 20 66 75 6e | 63 74 69 6f 6e 20 72 65 |t()} fun|ction re|
|00000370| 74 75 72 6e 73 20 61 0a | 5c 64 66 6e 7b 73 6f 63 |turns a.|\dfn{soc|
|00000380| 6b 65 74 20 6f 62 6a 65 | 63 74 7d 20 77 68 6f 73 |ket obje|ct} whos|
|00000390| 65 20 6d 65 74 68 6f 64 | 73 20 69 6d 70 6c 65 6d |e method|s implem|
|000003a0| 65 6e 74 20 74 68 65 20 | 76 61 72 69 6f 75 73 20 |ent the |various |
|000003b0| 73 6f 63 6b 65 74 20 73 | 79 73 74 65 6d 0a 63 61 |socket s|ystem.ca|
|000003c0| 6c 6c 73 2e 20 20 50 61 | 72 61 6d 65 74 65 72 20 |lls. Pa|rameter |
|000003d0| 74 79 70 65 73 20 61 72 | 65 20 73 6f 6d 65 77 68 |types ar|e somewh|
|000003e0| 61 74 20 68 69 67 65 72 | 2d 6c 65 76 65 6c 20 74 |at higer|-level t|
|000003f0| 68 61 6e 20 69 6e 20 74 | 68 65 20 43 0a 69 6e 74 |han in t|he C.int|
|00000400| 65 72 66 61 63 65 3a 20 | 61 73 20 77 69 74 68 20 |erface: |as with |
|00000410| 5c 63 6f 64 65 7b 72 65 | 61 64 28 29 7d 20 61 6e |\code{re|ad()} an|
|00000420| 64 20 5c 63 6f 64 65 7b | 77 72 69 74 65 28 29 7d |d \code{|write()}|
|00000430| 20 6f 70 65 72 61 74 69 | 6f 6e 73 20 6f 6e 20 50 | operati|ons on P|
|00000440| 79 74 68 6f 6e 0a 66 69 | 6c 65 73 2c 20 62 75 66 |ython.fi|les, buf|
|00000450| 66 65 72 20 61 6c 6c 6f | 63 61 74 69 6f 6e 20 6f |fer allo|cation o|
|00000460| 6e 20 72 65 63 65 69 76 | 65 20 6f 70 65 72 61 74 |n receiv|e operat|
|00000470| 69 6f 6e 73 20 69 73 20 | 61 75 74 6f 6d 61 74 69 |ions is |automati|
|00000480| 63 2c 20 61 6e 64 0a 62 | 75 66 66 65 72 20 6c 65 |c, and.b|uffer le|
|00000490| 6e 67 74 68 20 69 73 20 | 69 6d 70 6c 69 63 69 74 |ngth is |implicit|
|000004a0| 20 6f 6e 20 73 65 6e 64 | 20 6f 70 65 72 61 74 69 | on send| operati|
|000004b0| 6f 6e 73 2e 0a 0a 53 6f | 63 6b 65 74 20 61 64 64 |ons...So|cket add|
|000004c0| 72 65 73 73 65 73 20 61 | 72 65 20 72 65 70 72 65 |resses a|re repre|
|000004d0| 73 65 6e 74 65 64 20 61 | 73 20 61 20 73 69 6e 67 |sented a|s a sing|
|000004e0| 6c 65 20 73 74 72 69 6e | 67 20 66 6f 72 20 74 68 |le strin|g for th|
|000004f0| 65 0a 5c 63 6f 64 65 7b | 41 46 5f 55 4e 49 58 7d |e.\code{|AF_UNIX}|
|00000500| 20 61 64 64 72 65 73 73 | 20 66 61 6d 69 6c 79 20 | address| family |
|00000510| 61 6e 64 20 61 73 20 61 | 20 70 61 69 72 0a 5c 63 |and as a| pair.\c|
|00000520| 6f 64 65 7b 28 5c 76 61 | 72 7b 68 6f 73 74 7d 2c |ode{(\va|r{host},|
|00000530| 20 5c 76 61 72 7b 70 6f | 72 74 7d 29 7d 20 66 6f | \var{po|rt})} fo|
|00000540| 72 20 74 68 65 20 5c 63 | 6f 64 65 7b 41 46 5f 49 |r the \c|ode{AF_I|
|00000550| 4e 45 54 7d 20 61 64 64 | 72 65 73 73 20 66 61 6d |NET} add|ress fam|
|00000560| 69 6c 79 2c 0a 77 68 65 | 72 65 20 5c 76 61 72 7b |ily,.whe|re \var{|
|00000570| 68 6f 73 74 7d 20 69 73 | 20 61 20 73 74 72 69 6e |host} is| a strin|
|00000580| 67 20 72 65 70 72 65 73 | 65 6e 74 69 6e 67 0a 65 |g repres|enting.e|
|00000590| 69 74 68 65 72 20 61 20 | 68 6f 73 74 6e 61 6d 65 |ither a |hostname|
|000005a0| 20 69 6e 20 49 6e 74 65 | 72 6e 65 74 20 64 6f 6d | in Inte|rnet dom|
|000005b0| 61 69 6e 20 6e 6f 74 61 | 74 69 6f 6e 20 6c 69 6b |ain nota|tion lik|
|000005c0| 65 0a 5c 63 6f 64 65 7b | 27 64 61 72 69 6e 67 2e |e.\code{|'daring.|
|000005d0| 63 77 69 2e 6e 6c 27 7d | 20 6f 72 20 61 6e 20 49 |cwi.nl'}| or an I|
|000005e0| 50 20 61 64 64 72 65 73 | 73 20 6c 69 6b 65 20 5c |P addres|s like \|
|000005f0| 63 6f 64 65 7b 27 31 30 | 30 2e 35 30 2e 32 30 30 |code{'10|0.50.200|
|00000600| 2e 35 27 7d 2c 0a 61 6e | 64 20 5c 76 61 72 7b 70 |.5'},.an|d \var{p|
|00000610| 6f 72 74 7d 20 69 73 20 | 61 6e 20 69 6e 74 65 67 |ort} is |an integ|
|00000620| 72 61 6c 20 70 6f 72 74 | 20 6e 75 6d 62 65 72 2e |ral port| number.|
|00000630| 20 20 4f 74 68 65 72 20 | 61 64 64 72 65 73 73 20 | Other |address |
|00000640| 66 61 6d 69 6c 69 65 73 | 20 61 72 65 0a 63 75 72 |families| are.cur|
|00000650| 72 65 6e 74 6c 79 20 6e | 6f 74 20 73 75 70 70 6f |rently n|ot suppo|
|00000660| 72 74 65 64 2e 20 20 54 | 68 65 20 61 64 64 72 65 |rted. T|he addre|
|00000670| 73 73 20 66 6f 72 6d 61 | 74 20 72 65 71 75 69 72 |ss forma|t requir|
|00000680| 65 64 20 62 79 20 61 20 | 70 61 72 74 69 63 75 6c |ed by a |particul|
|00000690| 61 72 0a 73 6f 63 6b 65 | 74 20 6f 62 6a 65 63 74 |ar.socke|t object|
|000006a0| 20 69 73 20 61 75 74 6f | 6d 61 74 69 63 61 6c 6c | is auto|maticall|
|000006b0| 79 20 73 65 6c 65 63 74 | 65 64 20 62 61 73 65 64 |y select|ed based|
|000006c0| 20 6f 6e 20 74 68 65 20 | 61 64 64 72 65 73 73 20 | on the |address |
|000006d0| 66 61 6d 69 6c 79 0a 73 | 70 65 63 69 66 69 65 64 |family.s|pecified|
|000006e0| 20 77 68 65 6e 20 74 68 | 65 20 73 6f 63 6b 65 74 | when th|e socket|
|000006f0| 20 6f 62 6a 65 63 74 20 | 77 61 73 20 63 72 65 61 | object |was crea|
|00000700| 74 65 64 2e 0a 0a 41 6c | 6c 20 65 72 72 6f 72 73 |ted...Al|l errors|
|00000710| 20 72 61 69 73 65 20 65 | 78 63 65 70 74 69 6f 6e | raise e|xception|
|00000720| 73 2e 20 20 54 68 65 20 | 6e 6f 72 6d 61 6c 20 65 |s. The |normal e|
|00000730| 78 63 65 70 74 69 6f 6e | 73 20 66 6f 72 20 69 6e |xception|s for in|
|00000740| 76 61 6c 69 64 0a 61 72 | 67 75 6d 65 6e 74 20 74 |valid.ar|gument t|
|00000750| 79 70 65 73 20 61 6e 64 | 20 6f 75 74 2d 6f 66 2d |ypes and| out-of-|
|00000760| 6d 65 6d 6f 72 79 20 63 | 6f 6e 64 69 74 69 6f 6e |memory c|ondition|
|00000770| 73 20 63 61 6e 20 62 65 | 20 72 61 69 73 65 64 3b |s can be| raised;|
|00000780| 20 65 72 72 6f 72 73 0a | 72 65 6c 61 74 65 64 20 | errors.|related |
|00000790| 74 6f 20 73 6f 63 6b 65 | 74 20 6f 72 20 61 64 64 |to socke|t or add|
|000007a0| 72 65 73 73 20 73 65 6d | 61 6e 74 69 63 73 20 72 |ress sem|antics r|
|000007b0| 61 69 73 65 20 74 68 65 | 20 65 72 72 6f 72 20 5c |aise the| error \|
|000007c0| 63 6f 64 65 7b 73 6f 63 | 6b 65 74 2e 65 72 72 6f |code{soc|ket.erro|
|000007d0| 72 7d 2e 0a 0a 4e 6f 6e | 2d 62 6c 6f 63 6b 69 6e |r}...Non|-blockin|
|000007e0| 67 20 6d 6f 64 65 20 69 | 73 20 73 75 70 70 6f 72 |g mode i|s suppor|
|000007f0| 74 65 64 20 74 68 72 6f | 75 67 68 20 74 68 65 20 |ted thro|ugh the |
|00000800| 5c 63 6f 64 65 7b 73 65 | 74 62 6c 6f 63 6b 69 6e |\code{se|tblockin|
|00000810| 67 28 29 7d 0a 6d 65 74 | 68 6f 64 2e 0a 0a 54 68 |g()}.met|hod...Th|
|00000820| 65 20 6d 6f 64 75 6c 65 | 20 5c 63 6f 64 65 7b 73 |e module| \code{s|
|00000830| 6f 63 6b 65 74 7d 20 65 | 78 70 6f 72 74 73 20 74 |ocket} e|xports t|
|00000840| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 63 6f 6e |he follo|wing con|
|00000850| 73 74 61 6e 74 73 20 61 | 6e 64 20 66 75 6e 63 74 |stants a|nd funct|
|00000860| 69 6f 6e 73 3a 0a 0a 5c | 72 65 6e 65 77 63 6f 6d |ions:..\|renewcom|
|00000870| 6d 61 6e 64 7b 5c 69 6e | 64 65 78 73 75 62 69 74 |mand{\in|dexsubit|
|00000880| 65 6d 7d 7b 28 69 6e 20 | 6d 6f 64 75 6c 65 20 73 |em}{(in |module s|
|00000890| 6f 63 6b 65 74 29 7d 0a | 5c 62 65 67 69 6e 7b 65 |ocket)}.|\begin{e|
|000008a0| 78 63 64 65 73 63 7d 7b | 65 72 72 6f 72 7d 0a 54 |xcdesc}{|error}.T|
|000008b0| 68 69 73 20 65 78 63 65 | 70 74 69 6f 6e 20 69 73 |his exce|ption is|
|000008c0| 20 72 61 69 73 65 64 20 | 66 6f 72 20 73 6f 63 6b | raised |for sock|
|000008d0| 65 74 2d 20 6f 72 20 61 | 64 64 72 65 73 73 2d 72 |et- or a|ddress-r|
|000008e0| 65 6c 61 74 65 64 20 65 | 72 72 6f 72 73 2e 0a 54 |elated e|rrors..T|
|000008f0| 68 65 20 61 63 63 6f 6d | 70 61 6e 79 69 6e 67 20 |he accom|panying |
|00000900| 76 61 6c 75 65 20 69 73 | 20 65 69 74 68 65 72 20 |value is| either |
|00000910| 61 20 73 74 72 69 6e 67 | 20 74 65 6c 6c 69 6e 67 |a string| telling|
|00000920| 20 77 68 61 74 20 77 65 | 6e 74 20 77 72 6f 6e 67 | what we|nt wrong|
|00000930| 20 6f 72 20 61 0a 70 61 | 69 72 20 5c 63 6f 64 65 | or a.pa|ir \code|
|00000940| 7b 28 5c 76 61 72 7b 65 | 72 72 6e 6f 7d 2c 20 5c |{(\var{e|rrno}, \|
|00000950| 76 61 72 7b 73 74 72 69 | 6e 67 7d 29 7d 0a 72 65 |var{stri|ng})}.re|
|00000960| 70 72 65 73 65 6e 74 69 | 6e 67 20 61 6e 20 65 72 |presenti|ng an er|
|00000970| 72 6f 72 20 72 65 74 75 | 72 6e 65 64 20 62 79 20 |ror retu|rned by |
|00000980| 61 20 73 79 73 74 65 6d | 0a 63 61 6c 6c 2c 20 73 |a system|.call, s|
|00000990| 69 6d 69 6c 61 72 20 74 | 6f 20 74 68 65 20 76 61 |imilar t|o the va|
|000009a0| 6c 75 65 20 61 63 63 6f | 6d 70 61 6e 79 69 6e 67 |lue acco|mpanying|
|000009b0| 20 5c 63 6f 64 65 7b 70 | 6f 73 69 78 2e 65 72 72 | \code{p|osix.err|
|000009c0| 6f 72 7d 2e 0a 5c 65 6e | 64 7b 65 78 63 64 65 73 |or}..\en|d{excdes|
|000009d0| 63 7d 0a 0a 5c 62 65 67 | 69 6e 7b 64 61 74 61 64 |c}..\beg|in{datad|
|000009e0| 65 73 63 7d 7b 41 46 5f | 55 4e 49 58 7d 0a 5c 64 |esc}{AF_|UNIX}.\d|
|000009f0| 61 74 61 6c 69 6e 65 7b | 41 46 5f 49 4e 45 54 7d |ataline{|AF_INET}|
|00000a00| 0a 54 68 65 73 65 20 63 | 6f 6e 73 74 61 6e 74 73 |.These c|onstants|
|00000a10| 20 72 65 70 72 65 73 65 | 6e 74 20 74 68 65 20 61 | represe|nt the a|
|00000a20| 64 64 72 65 73 73 20 28 | 61 6e 64 20 70 72 6f 74 |ddress (|and prot|
|00000a30| 6f 63 6f 6c 29 20 66 61 | 6d 69 6c 69 65 73 2c 0a |ocol) fa|milies,.|
|00000a40| 75 73 65 64 20 66 6f 72 | 20 74 68 65 20 66 69 72 |used for| the fir|
|00000a50| 73 74 20 61 72 67 75 6d | 65 6e 74 20 74 6f 20 5c |st argum|ent to \|
|00000a60| 63 6f 64 65 7b 73 6f 63 | 6b 65 74 28 29 7d 2e 20 |code{soc|ket()}. |
|00000a70| 20 49 66 20 74 68 65 20 | 5c 63 6f 64 65 7b 41 46 | If the |\code{AF|
|00000a80| 5f 55 4e 49 58 7d 0a 63 | 6f 6e 73 74 61 6e 74 20 |_UNIX}.c|onstant |
|00000a90| 69 73 20 6e 6f 74 20 64 | 65 66 69 6e 65 64 20 74 |is not d|efined t|
|00000aa0| 68 65 6e 20 74 68 69 73 | 20 70 72 6f 74 6f 63 6f |hen this| protoco|
|00000ab0| 6c 20 69 73 20 75 6e 73 | 75 70 70 6f 72 74 65 64 |l is uns|upported|
|00000ac0| 2e 0a 5c 65 6e 64 7b 64 | 61 74 61 64 65 73 63 7d |..\end{d|atadesc}|
|00000ad0| 0a 0a 5c 62 65 67 69 6e | 7b 64 61 74 61 64 65 73 |..\begin|{datades|
|00000ae0| 63 7d 7b 53 4f 43 4b 5f | 53 54 52 45 41 4d 7d 0a |c}{SOCK_|STREAM}.|
|00000af0| 5c 64 61 74 61 6c 69 6e | 65 7b 53 4f 43 4b 5f 44 |\datalin|e{SOCK_D|
|00000b00| 47 52 41 4d 7d 0a 5c 64 | 61 74 61 6c 69 6e 65 7b |GRAM}.\d|ataline{|
|00000b10| 53 4f 43 4b 5f 52 41 57 | 7d 0a 5c 64 61 74 61 6c |SOCK_RAW|}.\datal|
|00000b20| 69 6e 65 7b 53 4f 43 4b | 5f 52 44 4d 7d 0a 5c 64 |ine{SOCK|_RDM}.\d|
|00000b30| 61 74 61 6c 69 6e 65 7b | 53 4f 43 4b 5f 53 45 51 |ataline{|SOCK_SEQ|
|00000b40| 50 41 43 4b 45 54 7d 0a | 54 68 65 73 65 20 63 6f |PACKET}.|These co|
|00000b50| 6e 73 74 61 6e 74 73 20 | 72 65 70 72 65 73 65 6e |nstants |represen|
|00000b60| 74 20 74 68 65 20 73 6f | 63 6b 65 74 20 74 79 70 |t the so|cket typ|
|00000b70| 65 73 2c 0a 75 73 65 64 | 20 66 6f 72 20 74 68 65 |es,.used| for the|
|00000b80| 20 73 65 63 6f 6e 64 20 | 61 72 67 75 6d 65 6e 74 | second |argument|
|00000b90| 20 74 6f 20 5c 63 6f 64 | 65 7b 73 6f 63 6b 65 74 | to \cod|e{socket|
|00000ba0| 28 29 7d 2e 0a 28 4f 6e | 6c 79 20 5c 63 6f 64 65 |()}..(On|ly \code|
|00000bb0| 7b 53 4f 43 4b 5f 53 54 | 52 45 41 4d 7d 20 61 6e |{SOCK_ST|REAM} an|
|00000bc0| 64 0a 5c 63 6f 64 65 7b | 53 4f 43 4b 5f 44 47 52 |d.\code{|SOCK_DGR|
|00000bd0| 41 4d 7d 20 61 70 70 65 | 61 72 20 74 6f 20 62 65 |AM} appe|ar to be|
|00000be0| 20 67 65 6e 65 72 61 6c | 6c 79 20 75 73 65 66 75 | general|ly usefu|
|00000bf0| 6c 2e 29 0a 5c 65 6e 64 | 7b 64 61 74 61 64 65 73 |l.).\end|{datades|
|00000c00| 63 7d 0a 0a 5c 62 65 67 | 69 6e 7b 64 61 74 61 64 |c}..\beg|in{datad|
|00000c10| 65 73 63 7d 7b 53 4f 5f | 2a 7d 0a 5c 64 61 74 61 |esc}{SO_|*}.\data|
|00000c20| 6c 69 6e 65 7b 53 4f 4d | 41 58 43 4f 4e 4e 7d 0a |line{SOM|AXCONN}.|
|00000c30| 5c 64 61 74 61 6c 69 6e | 65 7b 4d 53 47 5f 2a 7d |\datalin|e{MSG_*}|
|00000c40| 0a 5c 64 61 74 61 6c 69 | 6e 65 7b 53 4f 4c 5f 2a |.\datali|ne{SOL_*|
|00000c50| 7d 0a 5c 64 61 74 61 6c | 69 6e 65 7b 49 50 50 52 |}.\datal|ine{IPPR|
|00000c60| 4f 54 4f 5f 2a 7d 0a 5c | 64 61 74 61 6c 69 6e 65 |OTO_*}.\|dataline|
|00000c70| 7b 49 50 50 4f 52 54 5f | 2a 7d 0a 5c 64 61 74 61 |{IPPORT_|*}.\data|
|00000c80| 6c 69 6e 65 7b 49 4e 41 | 44 44 52 5f 2a 7d 0a 5c |line{INA|DDR_*}.\|
|00000c90| 64 61 74 61 6c 69 6e 65 | 7b 49 50 5f 2a 7d 0a 4d |dataline|{IP_*}.M|
|00000ca0| 61 6e 79 20 63 6f 6e 73 | 74 61 6e 74 73 20 6f 66 |any cons|tants of|
|00000cb0| 20 74 68 65 73 65 20 66 | 6f 72 6d 73 2c 20 64 6f | these f|orms, do|
|00000cc0| 63 75 6d 65 6e 74 65 64 | 20 69 6e 20 74 68 65 20 |cumented| in the |
|00000cd0| 5c 55 4e 49 58 7b 7d 20 | 64 6f 63 75 6d 65 6e 74 |\UNIX{} |document|
|00000ce0| 61 74 69 6f 6e 20 6f 6e | 0a 73 6f 63 6b 65 74 73 |ation on|.sockets|
|00000cf0| 20 61 6e 64 2f 6f 72 20 | 74 68 65 20 49 50 20 70 | and/or |the IP p|
|00000d00| 72 6f 74 6f 63 6f 6c 2c | 20 61 72 65 20 61 6c 73 |rotocol,| are als|
|00000d10| 6f 20 64 65 66 69 6e 65 | 64 20 69 6e 20 74 68 65 |o define|d in the|
|00000d20| 20 73 6f 63 6b 65 74 20 | 6d 6f 64 75 6c 65 2e 0a | socket |module..|
|00000d30| 54 68 65 79 20 61 72 65 | 20 67 65 6e 65 72 61 6c |They are| general|
|00000d40| 6c 79 20 75 73 65 64 20 | 69 6e 20 61 72 67 75 6d |ly used |in argum|
|00000d50| 65 6e 74 73 20 74 6f 20 | 74 68 65 20 5c 63 6f 64 |ents to |the \cod|
|00000d60| 65 7b 73 65 74 73 6f 63 | 6b 6f 70 74 7d 20 61 6e |e{setsoc|kopt} an|
|00000d70| 64 0a 5c 63 6f 64 65 7b | 67 65 74 73 6f 63 6b 6f |d.\code{|getsocko|
|00000d80| 70 74 7d 20 6d 65 74 68 | 6f 64 73 20 6f 66 20 73 |pt} meth|ods of s|
|00000d90| 6f 63 6b 65 74 20 6f 62 | 6a 65 63 74 73 2e 20 20 |ocket ob|jects. |
|00000da0| 49 6e 20 6d 6f 73 74 20 | 63 61 73 65 73 2c 20 6f |In most |cases, o|
|00000db0| 6e 6c 79 0a 74 68 6f 73 | 65 20 73 79 6d 62 6f 6c |nly.thos|e symbol|
|00000dc0| 73 20 74 68 61 74 20 61 | 72 65 20 64 65 66 69 6e |s that a|re defin|
|00000dd0| 65 64 20 69 6e 20 74 68 | 65 20 5c 55 4e 49 58 7b |ed in th|e \UNIX{|
|00000de0| 7d 20 68 65 61 64 65 72 | 20 66 69 6c 65 73 20 61 |} header| files a|
|00000df0| 72 65 20 64 65 66 69 6e | 65 64 3b 0a 66 6f 72 20 |re defin|ed;.for |
|00000e00| 61 20 66 65 77 20 73 79 | 6d 62 6f 6c 73 2c 20 64 |a few sy|mbols, d|
|00000e10| 65 66 61 75 6c 74 20 76 | 61 6c 75 65 73 20 61 72 |efault v|alues ar|
|00000e20| 65 20 70 72 6f 76 69 64 | 65 64 2e 0a 5c 65 6e 64 |e provid|ed..\end|
|00000e30| 7b 64 61 74 61 64 65 73 | 63 7d 0a 0a 5c 62 65 67 |{datades|c}..\beg|
|00000e40| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 67 65 74 |in{funcd|esc}{get|
|00000e50| 68 6f 73 74 62 79 6e 61 | 6d 65 7d 7b 68 6f 73 74 |hostbyna|me}{host|
|00000e60| 6e 61 6d 65 7d 0a 54 72 | 61 6e 73 6c 61 74 65 20 |name}.Tr|anslate |
|00000e70| 61 20 68 6f 73 74 20 6e | 61 6d 65 20 74 6f 20 49 |a host n|ame to I|
|00000e80| 50 20 61 64 64 72 65 73 | 73 20 66 6f 72 6d 61 74 |P addres|s format|
|00000e90| 2e 20 20 54 68 65 20 49 | 50 20 61 64 64 72 65 73 |. The I|P addres|
|00000ea0| 73 20 69 73 0a 72 65 74 | 75 72 6e 65 64 20 61 73 |s is.ret|urned as|
|00000eb0| 20 61 20 73 74 72 69 6e | 67 2c 20 65 2e 67 2e 2c | a strin|g, e.g.,|
|00000ec0| 20 20 5c 63 6f 64 65 7b | 27 31 30 30 2e 35 30 2e | \code{|'100.50.|
|00000ed0| 32 30 30 2e 35 27 7d 2e | 20 20 49 66 20 74 68 65 |200.5'}.| If the|
|00000ee0| 20 68 6f 73 74 20 6e 61 | 6d 65 0a 69 73 20 61 6e | host na|me.is an|
|00000ef0| 20 49 50 20 61 64 64 72 | 65 73 73 20 69 74 73 65 | IP addr|ess itse|
|00000f00| 6c 66 20 69 74 20 69 73 | 20 72 65 74 75 72 6e 65 |lf it is| returne|
|00000f10| 64 20 75 6e 63 68 61 6e | 67 65 64 2e 0a 5c 65 6e |d unchan|ged..\en|
|00000f20| 64 7b 66 75 6e 63 64 65 | 73 63 7d 0a 0a 5c 62 65 |d{funcde|sc}..\be|
|00000f30| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 67 65 |gin{func|desc}{ge|
|00000f40| 74 68 6f 73 74 6e 61 6d | 65 7d 7b 7d 0a 52 65 74 |thostnam|e}{}.Ret|
|00000f50| 75 72 6e 20 61 20 73 74 | 72 69 6e 67 20 63 6f 6e |urn a st|ring con|
|00000f60| 74 61 69 6e 69 6e 67 20 | 74 68 65 20 68 6f 73 74 |taining |the host|
|00000f70| 6e 61 6d 65 20 6f 66 20 | 74 68 65 20 6d 61 63 68 |name of |the mach|
|00000f80| 69 6e 65 20 77 68 65 72 | 65 20 0a 74 68 65 20 50 |ine wher|e .the P|
|00000f90| 79 74 68 6f 6e 20 69 6e | 74 65 72 70 72 65 74 65 |ython in|terprete|
|00000fa0| 72 20 69 73 20 63 75 72 | 72 65 6e 74 6c 79 20 65 |r is cur|rently e|
|00000fb0| 78 65 63 75 74 69 6e 67 | 2e 20 20 49 66 20 79 6f |xecuting|. If yo|
|00000fc0| 75 20 77 61 6e 74 20 74 | 6f 20 6b 6e 6f 77 20 74 |u want t|o know t|
|00000fd0| 68 65 0a 63 75 72 72 65 | 6e 74 20 6d 61 63 68 69 |he.curre|nt machi|
|00000fe0| 6e 65 27 73 20 49 50 20 | 61 64 64 72 65 73 73 2c |ne's IP |address,|
|00000ff0| 20 75 73 65 0a 5c 63 6f | 64 65 7b 73 6f 63 6b 65 | use.\co|de{socke|
|00001000| 74 2e 67 65 74 68 6f 73 | 74 62 79 6e 61 6d 65 28 |t.gethos|tbyname(|
|00001010| 73 6f 63 6b 65 74 2e 67 | 65 74 68 6f 73 74 6e 61 |socket.g|ethostna|
|00001020| 6d 65 28 29 29 7d 2e 0a | 5c 65 6e 64 7b 66 75 6e |me())}..|\end{fun|
|00001030| 63 64 65 73 63 7d 0a 0a | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|00001040| 75 6e 63 64 65 73 63 7d | 7b 67 65 74 68 6f 73 74 |uncdesc}|{gethost|
|00001050| 62 79 61 64 64 72 7d 7b | 69 70 5f 61 64 64 72 65 |byaddr}{|ip_addre|
|00001060| 73 73 7d 0a 52 65 74 75 | 72 6e 20 61 20 74 72 69 |ss}.Retu|rn a tri|
|00001070| 70 6c 65 20 5c 63 6f 64 | 65 7b 28 68 6f 73 74 6e |ple \cod|e{(hostn|
|00001080| 61 6d 65 2c 20 61 6c 69 | 61 73 6c 69 73 74 2c 20 |ame, ali|aslist, |
|00001090| 69 70 61 64 64 72 6c 69 | 73 74 29 7d 20 77 68 65 |ipaddrli|st)} whe|
|000010a0| 72 65 0a 5c 63 6f 64 65 | 7b 68 6f 73 74 6e 61 6d |re.\code|{hostnam|
|000010b0| 65 7d 20 69 73 20 74 68 | 65 20 70 72 69 6d 61 72 |e} is th|e primar|
|000010c0| 79 20 68 6f 73 74 20 6e | 61 6d 65 20 72 65 73 70 |y host n|ame resp|
|000010d0| 6f 6e 64 69 6e 67 20 74 | 6f 20 74 68 65 20 67 69 |onding t|o the gi|
|000010e0| 76 65 6e 0a 5c 76 61 72 | 7b 69 70 5f 61 64 64 72 |ven.\var|{ip_addr|
|000010f0| 65 73 73 7d 2c 20 5c 63 | 6f 64 65 7b 61 6c 69 61 |ess}, \c|ode{alia|
|00001100| 73 6c 69 73 74 7d 20 69 | 73 20 61 20 28 70 6f 73 |slist} i|s a (pos|
|00001110| 73 69 62 6c 79 20 65 6d | 70 74 79 29 20 6c 69 73 |sibly em|pty) lis|
|00001120| 74 20 6f 66 0a 61 6c 74 | 65 72 6e 61 74 69 76 65 |t of.alt|ernative|
|00001130| 20 68 6f 73 74 20 6e 61 | 6d 65 73 20 66 6f 72 20 | host na|mes for |
|00001140| 74 68 65 20 73 61 6d 65 | 20 61 64 64 72 65 73 73 |the same| address|
|00001150| 2c 20 61 6e 64 20 5c 63 | 6f 64 65 7b 69 70 61 64 |, and \c|ode{ipad|
|00001160| 64 72 6c 69 73 74 7d 20 | 69 73 0a 61 20 6c 69 73 |drlist} |is.a lis|
|00001170| 74 20 6f 66 20 49 50 20 | 61 64 64 72 65 73 73 65 |t of IP |addresse|
|00001180| 73 20 66 6f 72 20 74 68 | 65 20 73 61 6d 65 20 69 |s for th|e same i|
|00001190| 6e 74 65 72 66 61 63 65 | 20 6f 6e 20 74 68 65 20 |nterface| on the |
|000011a0| 73 61 6d 65 0a 68 6f 73 | 74 20 28 6d 6f 73 74 20 |same.hos|t (most |
|000011b0| 6c 69 6b 65 6c 79 20 63 | 6f 6e 74 61 69 6e 69 6e |likely c|ontainin|
|000011c0| 67 20 6f 6e 6c 79 20 61 | 20 73 69 6e 67 6c 65 20 |g only a| single |
|000011d0| 61 64 64 72 65 73 73 29 | 2e 0a 5c 65 6e 64 7b 66 |address)|..\end{f|
|000011e0| 75 6e 63 64 65 73 63 7d | 0a 0a 5c 62 65 67 69 6e |uncdesc}|..\begin|
|000011f0| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 67 65 74 73 65 |{funcdes|c}{getse|
|00001200| 72 76 62 79 6e 61 6d 65 | 7d 7b 73 65 72 76 69 63 |rvbyname|}{servic|
|00001210| 65 6e 61 6d 65 5c 2c 20 | 70 72 6f 74 6f 63 6f 6c |ename\, |protocol|
|00001220| 6e 61 6d 65 7d 0a 54 72 | 61 6e 73 6c 61 74 65 20 |name}.Tr|anslate |
|00001230| 61 6e 20 49 6e 74 65 72 | 6e 65 74 20 73 65 72 76 |an Inter|net serv|
|00001240| 69 63 65 20 6e 61 6d 65 | 20 61 6e 64 20 70 72 6f |ice name| and pro|
|00001250| 74 6f 63 6f 6c 20 6e 61 | 6d 65 20 74 6f 20 61 20 |tocol na|me to a |
|00001260| 70 6f 72 74 20 6e 75 6d | 62 65 72 0a 66 6f 72 20 |port num|ber.for |
|00001270| 74 68 61 74 20 73 65 72 | 76 69 63 65 2e 20 20 54 |that ser|vice. T|
|00001280| 68 65 20 70 72 6f 74 6f | 63 6f 6c 20 6e 61 6d 65 |he proto|col name|
|00001290| 20 73 68 6f 75 6c 64 20 | 62 65 20 5c 63 6f 64 65 | should |be \code|
|000012a0| 7b 27 74 63 70 27 7d 20 | 6f 72 0a 5c 63 6f 64 65 |{'tcp'} |or.\code|
|000012b0| 7b 27 75 64 70 27 7d 2e | 0a 5c 65 6e 64 7b 66 75 |{'udp'}.|.\end{fu|
|000012c0| 6e 63 64 65 73 63 7d 0a | 0a 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|000012d0| 66 75 6e 63 64 65 73 63 | 7d 7b 73 6f 63 6b 65 74 |funcdesc|}{socket|
|000012e0| 7d 7b 66 61 6d 69 6c 79 | 5c 2c 20 74 79 70 65 5c |}{family|\, type\|
|000012f0| 6f 70 74 69 6f 6e 61 6c | 7b 5c 2c 20 70 72 6f 74 |optional|{\, prot|
|00001300| 6f 7d 7d 0a 43 72 65 61 | 74 65 20 61 20 6e 65 77 |o}}.Crea|te a new|
|00001310| 20 73 6f 63 6b 65 74 20 | 75 73 69 6e 67 20 74 68 | socket |using th|
|00001320| 65 20 67 69 76 65 6e 20 | 61 64 64 72 65 73 73 20 |e given |address |
|00001330| 66 61 6d 69 6c 79 2c 20 | 73 6f 63 6b 65 74 20 74 |family, |socket t|
|00001340| 79 70 65 20 61 6e 64 0a | 70 72 6f 74 6f 63 6f 6c |ype and.|protocol|
|00001350| 20 6e 75 6d 62 65 72 2e | 20 20 54 68 65 20 61 64 | number.| The ad|
|00001360| 64 72 65 73 73 20 66 61 | 6d 69 6c 79 20 73 68 6f |dress fa|mily sho|
|00001370| 75 6c 64 20 62 65 20 5c | 63 6f 64 65 7b 41 46 5f |uld be \|code{AF_|
|00001380| 49 4e 45 54 7d 20 6f 72 | 0a 5c 63 6f 64 65 7b 41 |INET} or|.\code{A|
|00001390| 46 5f 55 4e 49 58 7d 2e | 20 20 54 68 65 20 73 6f |F_UNIX}.| The so|
|000013a0| 63 6b 65 74 20 74 79 70 | 65 20 73 68 6f 75 6c 64 |cket typ|e should|
|000013b0| 20 62 65 20 5c 63 6f 64 | 65 7b 53 4f 43 4b 5f 53 | be \cod|e{SOCK_S|
|000013c0| 54 52 45 41 4d 7d 2c 0a | 5c 63 6f 64 65 7b 53 4f |TREAM},.|\code{SO|
|000013d0| 43 4b 5f 44 47 52 41 4d | 7d 20 6f 72 20 70 65 72 |CK_DGRAM|} or per|
|000013e0| 68 61 70 73 20 6f 6e 65 | 20 6f 66 20 74 68 65 20 |haps one| of the |
|000013f0| 6f 74 68 65 72 20 5c 73 | 61 6d 70 7b 53 4f 43 4b |other \s|amp{SOCK|
|00001400| 5f 7d 20 63 6f 6e 73 74 | 61 6e 74 73 2e 0a 54 68 |_} const|ants..Th|
|00001410| 65 20 70 72 6f 74 6f 63 | 6f 6c 20 6e 75 6d 62 65 |e protoc|ol numbe|
|00001420| 72 20 69 73 20 75 73 75 | 61 6c 6c 79 20 7a 65 72 |r is usu|ally zer|
|00001430| 6f 20 61 6e 64 20 6d 61 | 79 20 62 65 20 6f 6d 69 |o and ma|y be omi|
|00001440| 74 74 65 64 20 69 6e 20 | 74 68 61 74 20 63 61 73 |tted in |that cas|
|00001450| 65 2e 0a 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |e..\end{|funcdesc|
|00001460| 7d 0a 0a 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|00001470| 73 63 7d 7b 66 72 6f 6d | 66 64 7d 7b 66 64 5c 2c |sc}{from|fd}{fd\,|
|00001480| 20 66 61 6d 69 6c 79 5c | 2c 20 74 79 70 65 5c 6f | family\|, type\o|
|00001490| 70 74 69 6f 6e 61 6c 7b | 5c 2c 20 70 72 6f 74 6f |ptional{|\, proto|
|000014a0| 7d 7d 0a 42 75 69 6c 64 | 20 61 20 73 6f 63 6b 65 |}}.Build| a socke|
|000014b0| 74 20 6f 62 6a 65 63 74 | 20 66 72 6f 6d 20 61 6e |t object| from an|
|000014c0| 20 65 78 69 73 74 69 6e | 67 20 66 69 6c 65 20 64 | existin|g file d|
|000014d0| 65 73 63 72 69 70 74 6f | 72 20 28 61 6e 20 69 6e |escripto|r (an in|
|000014e0| 74 65 67 65 72 20 61 73 | 0a 72 65 74 75 72 6e 65 |teger as|.returne|
|000014f0| 64 20 62 79 20 61 20 66 | 69 6c 65 20 6f 62 6a 65 |d by a f|ile obje|
|00001500| 63 74 27 73 20 5c 63 6f | 64 65 7b 66 69 6c 65 6e |ct's \co|de{filen|
|00001510| 6f 7d 20 6d 65 74 68 6f | 64 29 2e 20 20 41 64 64 |o} metho|d). Add|
|00001520| 72 65 73 73 20 66 61 6d | 69 6c 79 2c 0a 73 6f 63 |ress fam|ily,.soc|
|00001530| 6b 65 74 20 74 79 70 65 | 20 61 6e 64 20 70 72 6f |ket type| and pro|
|00001540| 74 6f 63 6f 6c 20 6e 75 | 6d 62 65 72 20 61 72 65 |tocol nu|mber are|
|00001550| 20 61 73 20 66 6f 72 20 | 74 68 65 20 5c 63 6f 64 | as for |the \cod|
|00001560| 65 7b 73 6f 63 6b 65 74 | 7d 20 66 75 6e 63 74 69 |e{socket|} functi|
|00001570| 6f 6e 0a 61 62 6f 76 65 | 2e 20 20 54 68 65 20 66 |on.above|. The f|
|00001580| 69 6c 65 20 64 65 73 63 | 72 69 70 74 6f 72 20 73 |ile desc|riptor s|
|00001590| 68 6f 75 6c 64 20 72 65 | 66 65 72 20 74 6f 20 61 |hould re|fer to a|
|000015a0| 20 73 6f 63 6b 65 74 2c | 20 62 75 74 20 74 68 69 | socket,| but thi|
|000015b0| 73 20 69 73 20 6e 6f 74 | 0a 63 68 65 63 6b 65 64 |s is not|.checked|
|000015c0| 20 2d 2d 2d 20 73 75 62 | 73 65 71 75 65 6e 74 20 | --- sub|sequent |
|000015d0| 6f 70 65 72 61 74 69 6f | 6e 73 20 6f 6e 20 74 68 |operatio|ns on th|
|000015e0| 65 20 6f 62 6a 65 63 74 | 20 6d 61 79 20 66 61 69 |e object| may fai|
|000015f0| 6c 20 69 66 20 74 68 65 | 20 66 69 6c 65 0a 64 65 |l if the| file.de|
|00001600| 73 63 72 69 70 74 6f 72 | 20 69 73 20 69 6e 76 61 |scriptor| is inva|
|00001610| 6c 69 64 2e 20 20 54 68 | 69 73 20 66 75 6e 63 74 |lid. Th|is funct|
|00001620| 69 6f 6e 20 69 73 20 72 | 61 72 65 6c 79 20 6e 65 |ion is r|arely ne|
|00001630| 65 64 65 64 2c 20 62 75 | 74 20 63 61 6e 20 62 65 |eded, bu|t can be|
|00001640| 0a 75 73 65 64 20 74 6f | 20 67 65 74 20 6f 72 20 |.used to| get or |
|00001650| 73 65 74 20 73 6f 63 6b | 65 74 20 6f 70 74 69 6f |set sock|et optio|
|00001660| 6e 73 20 6f 6e 20 61 20 | 73 6f 63 6b 65 74 20 70 |ns on a |socket p|
|00001670| 61 73 73 65 64 20 74 6f | 20 61 20 70 72 6f 67 72 |assed to| a progr|
|00001680| 61 6d 20 61 73 0a 73 74 | 61 6e 64 61 72 64 20 69 |am as.st|andard i|
|00001690| 6e 70 75 74 20 6f 72 20 | 6f 75 74 70 75 74 20 28 |nput or |output (|
|000016a0| 65 2e 67 2e 5c 20 61 20 | 73 65 72 76 65 72 20 73 |e.g.\ a |server s|
|000016b0| 74 61 72 74 65 64 20 62 | 79 20 74 68 65 20 5c 55 |tarted b|y the \U|
|000016c0| 4e 49 58 7b 7d 20 69 6e | 65 74 0a 64 61 65 6d 6f |NIX{} in|et.daemo|
|000016d0| 6e 29 2e 0a 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |n)..\end|{funcdes|
|000016e0| 63 7d 0a 0a 5c 73 75 62 | 73 65 63 74 69 6f 6e 7b |c}..\sub|section{|
|000016f0| 53 6f 63 6b 65 74 20 4f | 62 6a 65 63 74 73 7d 0a |Socket O|bjects}.|
|00001700| 0a 5c 6e 6f 69 6e 64 65 | 6e 74 0a 53 6f 63 6b 65 |.\noinde|nt.Socke|
|00001710| 74 20 6f 62 6a 65 63 74 | 73 20 68 61 76 65 20 74 |t object|s have t|
|00001720| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 6d 65 74 |he follo|wing met|
|00001730| 68 6f 64 73 2e 20 20 45 | 78 63 65 70 74 20 66 6f |hods. E|xcept fo|
|00001740| 72 0a 5c 63 6f 64 65 7b | 6d 61 6b 65 66 69 6c 65 |r.\code{|makefile|
|00001750| 28 29 7d 20 74 68 65 73 | 65 20 63 6f 72 72 65 73 |()} thes|e corres|
|00001760| 70 6f 6e 64 20 74 6f 20 | 5c 55 4e 49 58 7b 7d 20 |pond to |\UNIX{} |
|00001770| 73 79 73 74 65 6d 20 63 | 61 6c 6c 73 20 61 70 70 |system c|alls app|
|00001780| 6c 69 63 61 62 6c 65 20 | 74 6f 0a 73 6f 63 6b 65 |licable |to.socke|
|00001790| 74 73 2e 0a 0a 5c 72 65 | 6e 65 77 63 6f 6d 6d 61 |ts...\re|newcomma|
|000017a0| 6e 64 7b 5c 69 6e 64 65 | 78 73 75 62 69 74 65 6d |nd{\inde|xsubitem|
|000017b0| 7d 7b 28 73 6f 63 6b 65 | 74 20 6d 65 74 68 6f 64 |}{(socke|t method|
|000017c0| 29 7d 0a 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |)}.\begi|n{funcde|
|000017d0| 73 63 7d 7b 61 63 63 65 | 70 74 7d 7b 7d 0a 41 63 |sc}{acce|pt}{}.Ac|
|000017e0| 63 65 70 74 20 61 20 63 | 6f 6e 6e 65 63 74 69 6f |cept a c|onnectio|
|000017f0| 6e 2e 0a 54 68 65 20 73 | 6f 63 6b 65 74 20 6d 75 |n..The s|ocket mu|
|00001800| 73 74 20 62 65 20 62 6f | 75 6e 64 20 74 6f 20 61 |st be bo|und to a|
|00001810| 6e 20 61 64 64 72 65 73 | 73 20 61 6e 64 20 6c 69 |n addres|s and li|
|00001820| 73 74 65 6e 69 6e 67 20 | 66 6f 72 20 63 6f 6e 6e |stening |for conn|
|00001830| 65 63 74 69 6f 6e 73 2e | 0a 54 68 65 20 72 65 74 |ections.|.The ret|
|00001840| 75 72 6e 20 76 61 6c 75 | 65 20 69 73 20 61 20 70 |urn valu|e is a p|
|00001850| 61 69 72 20 5c 63 6f 64 | 65 7b 28 5c 76 61 72 7b |air \cod|e{(\var{|
|00001860| 63 6f 6e 6e 7d 2c 20 5c | 76 61 72 7b 61 64 64 72 |conn}, \|var{addr|
|00001870| 65 73 73 7d 29 7d 0a 77 | 68 65 72 65 20 5c 76 61 |ess})}.w|here \va|
|00001880| 72 7b 63 6f 6e 6e 7d 20 | 69 73 20 61 20 5c 65 6d |r{conn} |is a \em|
|00001890| 70 68 7b 6e 65 77 7d 20 | 73 6f 63 6b 65 74 20 6f |ph{new} |socket o|
|000018a0| 62 6a 65 63 74 20 75 73 | 61 62 6c 65 20 74 6f 20 |bject us|able to |
|000018b0| 73 65 6e 64 20 61 6e 64 | 0a 72 65 63 65 69 76 65 |send and|.receive|
|000018c0| 20 64 61 74 61 20 6f 6e | 20 74 68 65 20 63 6f 6e | data on| the con|
|000018d0| 6e 65 63 74 69 6f 6e 2c | 20 61 6e 64 20 5c 76 61 |nection,| and \va|
|000018e0| 72 7b 61 64 64 72 65 73 | 73 7d 20 69 73 20 74 68 |r{addres|s} is th|
|000018f0| 65 20 61 64 64 72 65 73 | 73 20 62 6f 75 6e 64 0a |e addres|s bound.|
|00001900| 74 6f 20 74 68 65 20 73 | 6f 63 6b 65 74 20 6f 6e |to the s|ocket on|
|00001910| 20 74 68 65 20 6f 74 68 | 65 72 20 65 6e 64 20 6f | the oth|er end o|
|00001920| 66 20 74 68 65 20 63 6f | 6e 6e 65 63 74 69 6f 6e |f the co|nnection|
|00001930| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00001940| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00001950| 63 7d 7b 62 69 6e 64 7d | 7b 61 64 64 72 65 73 73 |c}{bind}|{address|
|00001960| 7d 0a 42 69 6e 64 20 74 | 68 65 20 73 6f 63 6b 65 |}.Bind t|he socke|
|00001970| 74 20 74 6f 20 5c 76 61 | 72 7b 61 64 64 72 65 73 |t to \va|r{addres|
|00001980| 73 7d 2e 20 20 54 68 65 | 20 73 6f 63 6b 65 74 20 |s}. The| socket |
|00001990| 6d 75 73 74 20 6e 6f 74 | 20 61 6c 72 65 61 64 79 |must not| already|
|000019a0| 20 62 65 20 62 6f 75 6e | 64 2e 0a 28 54 68 65 20 | be boun|d..(The |
|000019b0| 66 6f 72 6d 61 74 20 6f | 66 20 5c 76 61 72 7b 61 |format o|f \var{a|
|000019c0| 64 64 72 65 73 73 7d 20 | 64 65 70 65 6e 64 73 20 |ddress} |depends |
|000019d0| 6f 6e 20 74 68 65 20 61 | 64 64 72 65 73 73 20 66 |on the a|ddress f|
|000019e0| 61 6d 69 6c 79 20 2d 2d | 2d 20 73 65 65 20 61 62 |amily --|- see ab|
|000019f0| 6f 76 65 2e 29 0a 5c 65 | 6e 64 7b 66 75 6e 63 64 |ove.).\e|nd{funcd|
|00001a00| 65 73 63 7d 0a 0a 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|00001a10| 63 64 65 73 63 7d 7b 63 | 6c 6f 73 65 7d 7b 7d 0a |cdesc}{c|lose}{}.|
|00001a20| 43 6c 6f 73 65 20 74 68 | 65 20 73 6f 63 6b 65 74 |Close th|e socket|
|00001a30| 2e 20 20 41 6c 6c 20 66 | 75 74 75 72 65 20 6f 70 |. All f|uture op|
|00001a40| 65 72 61 74 69 6f 6e 73 | 20 6f 6e 20 74 68 65 20 |erations| on the |
|00001a50| 73 6f 63 6b 65 74 20 6f | 62 6a 65 63 74 20 77 69 |socket o|bject wi|
|00001a60| 6c 6c 20 66 61 69 6c 2e | 0a 54 68 65 20 72 65 6d |ll fail.|.The rem|
|00001a70| 6f 74 65 20 65 6e 64 20 | 77 69 6c 6c 20 72 65 63 |ote end |will rec|
|00001a80| 65 69 76 65 20 6e 6f 20 | 6d 6f 72 65 20 64 61 74 |eive no |more dat|
|00001a90| 61 20 28 61 66 74 65 72 | 20 71 75 65 75 65 64 20 |a (after| queued |
|00001aa0| 64 61 74 61 20 69 73 20 | 66 6c 75 73 68 65 64 29 |data is |flushed)|
|00001ab0| 2e 0a 53 6f 63 6b 65 74 | 73 20 61 72 65 20 61 75 |..Socket|s are au|
|00001ac0| 74 6f 6d 61 74 69 63 61 | 6c 6c 79 20 63 6c 6f 73 |tomatica|lly clos|
|00001ad0| 65 64 20 77 68 65 6e 20 | 74 68 65 79 20 61 72 65 |ed when |they are|
|00001ae0| 20 67 61 72 62 61 67 65 | 2d 63 6f 6c 6c 65 63 74 | garbage|-collect|
|00001af0| 65 64 2e 0a 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |ed..\end|{funcdes|
|00001b00| 63 7d 0a 0a 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00001b10| 65 73 63 7d 7b 63 6f 6e | 6e 65 63 74 7d 7b 61 64 |esc}{con|nect}{ad|
|00001b20| 64 72 65 73 73 7d 0a 43 | 6f 6e 6e 65 63 74 20 74 |dress}.C|onnect t|
|00001b30| 6f 20 61 20 72 65 6d 6f | 74 65 20 73 6f 63 6b 65 |o a remo|te socke|
|00001b40| 74 20 61 74 20 5c 76 61 | 72 7b 61 64 64 72 65 73 |t at \va|r{addres|
|00001b50| 73 7d 2e 0a 28 54 68 65 | 20 66 6f 72 6d 61 74 20 |s}..(The| format |
|00001b60| 6f 66 20 5c 76 61 72 7b | 61 64 64 72 65 73 73 7d |of \var{|address}|
|00001b70| 20 64 65 70 65 6e 64 73 | 20 6f 6e 20 74 68 65 20 | depends| on the |
|00001b80| 61 64 64 72 65 73 73 20 | 66 61 6d 69 6c 79 20 2d |address |family -|
|00001b90| 2d 2d 20 73 65 65 20 61 | 62 6f 76 65 2e 29 0a 5c |-- see a|bove.).\|
|00001ba0| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0a 0a 5c |end{func|desc}..\|
|00001bb0| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00001bc0| 66 69 6c 65 6e 6f 7d 7b | 7d 0a 52 65 74 75 72 6e |fileno}{|}.Return|
|00001bd0| 20 74 68 65 20 73 6f 63 | 6b 65 74 27 73 20 66 69 | the soc|ket's fi|
|00001be0| 6c 65 20 64 65 73 63 72 | 69 70 74 6f 72 20 28 61 |le descr|iptor (a|
|00001bf0| 20 73 6d 61 6c 6c 20 69 | 6e 74 65 67 65 72 29 2e | small i|nteger).|
|00001c00| 20 20 54 68 69 73 20 69 | 73 20 75 73 65 66 75 6c | This i|s useful|
|00001c10| 0a 77 69 74 68 20 5c 63 | 6f 64 65 7b 73 65 6c 65 |.with \c|ode{sele|
|00001c20| 63 74 7d 2e 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |ct}..\en|d{funcde|
|00001c30| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00001c40| 64 65 73 63 7d 7b 67 65 | 74 70 65 65 72 6e 61 6d |desc}{ge|tpeernam|
|00001c50| 65 7d 7b 7d 0a 52 65 74 | 75 72 6e 20 74 68 65 20 |e}{}.Ret|urn the |
|00001c60| 72 65 6d 6f 74 65 20 61 | 64 64 72 65 73 73 20 74 |remote a|ddress t|
|00001c70| 6f 20 77 68 69 63 68 20 | 74 68 65 20 73 6f 63 6b |o which |the sock|
|00001c80| 65 74 20 69 73 20 63 6f | 6e 6e 65 63 74 65 64 2e |et is co|nnected.|
|00001c90| 20 20 54 68 69 73 20 69 | 73 0a 75 73 65 66 75 6c | This i|s.useful|
|00001ca0| 20 74 6f 20 66 69 6e 64 | 20 6f 75 74 20 74 68 65 | to find| out the|
|00001cb0| 20 70 6f 72 74 20 6e 75 | 6d 62 65 72 20 6f 66 20 | port nu|mber of |
|00001cc0| 61 20 72 65 6d 6f 74 65 | 20 49 50 20 73 6f 63 6b |a remote| IP sock|
|00001cd0| 65 74 2c 20 66 6f 72 20 | 69 6e 73 74 61 6e 63 65 |et, for |instance|
|00001ce0| 2e 0a 28 54 68 65 20 66 | 6f 72 6d 61 74 20 6f 66 |..(The f|ormat of|
|00001cf0| 20 74 68 65 20 61 64 64 | 72 65 73 73 20 72 65 74 | the add|ress ret|
|00001d00| 75 72 6e 65 64 20 64 65 | 70 65 6e 64 73 20 6f 6e |urned de|pends on|
|00001d10| 20 74 68 65 20 61 64 64 | 72 65 73 73 20 66 61 6d | the add|ress fam|
|00001d20| 69 6c 79 20 2d 2d 2d 0a | 73 65 65 20 61 62 6f 76 |ily ---.|see abov|
|00001d30| 65 2e 29 20 20 4f 6e 20 | 73 6f 6d 65 20 73 79 73 |e.) On |some sys|
|00001d40| 74 65 6d 73 20 74 68 69 | 73 20 66 75 6e 63 74 69 |tems thi|s functi|
|00001d50| 6f 6e 20 69 73 20 6e 6f | 74 20 73 75 70 70 6f 72 |on is no|t suppor|
|00001d60| 74 65 64 2e 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |ted..\en|d{funcde|
|00001d70| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00001d80| 64 65 73 63 7d 7b 67 65 | 74 73 6f 63 6b 6e 61 6d |desc}{ge|tsocknam|
|00001d90| 65 7d 7b 7d 0a 52 65 74 | 75 72 6e 20 74 68 65 20 |e}{}.Ret|urn the |
|00001da0| 73 6f 63 6b 65 74 27 73 | 20 6f 77 6e 20 61 64 64 |socket's| own add|
|00001db0| 72 65 73 73 2e 20 20 54 | 68 69 73 20 69 73 20 75 |ress. T|his is u|
|00001dc0| 73 65 66 75 6c 20 74 6f | 20 66 69 6e 64 20 6f 75 |seful to| find ou|
|00001dd0| 74 20 74 68 65 20 70 6f | 72 74 0a 6e 75 6d 62 65 |t the po|rt.numbe|
|00001de0| 72 20 6f 66 20 61 6e 20 | 49 50 20 73 6f 63 6b 65 |r of an |IP socke|
|00001df0| 74 2c 20 66 6f 72 20 69 | 6e 73 74 61 6e 63 65 2e |t, for i|nstance.|
|00001e00| 0a 28 54 68 65 20 66 6f | 72 6d 61 74 20 6f 66 20 |.(The fo|rmat of |
|00001e10| 74 68 65 20 61 64 64 72 | 65 73 73 20 72 65 74 75 |the addr|ess retu|
|00001e20| 72 6e 65 64 20 64 65 70 | 65 6e 64 73 20 6f 6e 20 |rned dep|ends on |
|00001e30| 74 68 65 20 61 64 64 72 | 65 73 73 20 66 61 6d 69 |the addr|ess fami|
|00001e40| 6c 79 20 2d 2d 2d 0a 73 | 65 65 20 61 62 6f 76 65 |ly ---.s|ee above|
|00001e50| 2e 29 0a 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |.).\end{|funcdesc|
|00001e60| 7d 0a 0a 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|00001e70| 73 63 7d 7b 67 65 74 73 | 6f 63 6b 6f 70 74 7d 7b |sc}{gets|ockopt}{|
|00001e80| 6c 65 76 65 6c 5c 2c 20 | 6f 70 74 6e 61 6d 65 5c |level\, |optname\|
|00001e90| 6f 70 74 69 6f 6e 61 6c | 7b 5c 2c 20 62 75 66 6c |optional|{\, bufl|
|00001ea0| 65 6e 7d 7d 0a 52 65 74 | 75 72 6e 20 74 68 65 20 |en}}.Ret|urn the |
|00001eb0| 76 61 6c 75 65 20 6f 66 | 20 74 68 65 20 67 69 76 |value of| the giv|
|00001ec0| 65 6e 20 73 6f 63 6b 65 | 74 20 6f 70 74 69 6f 6e |en socke|t option|
|00001ed0| 20 28 73 65 65 20 74 68 | 65 20 5c 55 4e 49 58 7b | (see th|e \UNIX{|
|00001ee0| 7d 20 6d 61 6e 20 70 61 | 67 65 0a 7b 5c 69 74 20 |} man pa|ge.{\it |
|00001ef0| 67 65 74 73 6f 63 6b 6f | 70 74 7d 28 32 29 29 2e |getsocko|pt}(2)).|
|00001f00| 20 20 54 68 65 20 6e 65 | 65 64 65 64 20 73 79 6d | The ne|eded sym|
|00001f10| 62 6f 6c 69 63 20 63 6f | 6e 73 74 61 6e 74 73 20 |bolic co|nstants |
|00001f20| 28 5c 63 6f 64 65 7b 53 | 4f 5f 2a 7d 20 65 74 63 |(\code{S|O_*} etc|
|00001f30| 2e 29 0a 61 72 65 20 64 | 65 66 69 6e 65 64 20 69 |.).are d|efined i|
|00001f40| 6e 20 74 68 69 73 20 6d | 6f 64 75 6c 65 2e 20 20 |n this m|odule. |
|00001f50| 49 66 20 5c 76 61 72 7b | 62 75 66 6c 65 6e 7d 0a |If \var{|buflen}.|
|00001f60| 69 73 20 61 62 73 65 6e | 74 2c 20 61 6e 20 69 6e |is absen|t, an in|
|00001f70| 74 65 67 65 72 20 6f 70 | 74 69 6f 6e 20 69 73 20 |teger op|tion is |
|00001f80| 61 73 73 75 6d 65 64 20 | 61 6e 64 20 69 74 73 20 |assumed |and its |
|00001f90| 69 6e 74 65 67 65 72 20 | 76 61 6c 75 65 0a 69 73 |integer |value.is|
|00001fa0| 20 72 65 74 75 72 6e 65 | 64 20 62 79 20 74 68 65 | returne|d by the|
|00001fb0| 20 66 75 6e 63 74 69 6f | 6e 2e 20 20 49 66 20 5c | functio|n. If \|
|00001fc0| 76 61 72 7b 62 75 66 6c | 65 6e 7d 20 69 73 20 70 |var{bufl|en} is p|
|00001fd0| 72 65 73 65 6e 74 2c 20 | 69 74 20 73 70 65 63 69 |resent, |it speci|
|00001fe0| 66 69 65 73 0a 74 68 65 | 20 6d 61 78 69 6d 75 6d |fies.the| maximum|
|00001ff0| 20 6c 65 6e 67 74 68 20 | 6f 66 20 74 68 65 20 62 | length |of the b|
|00002000| 75 66 66 65 72 20 75 73 | 65 64 20 74 6f 20 72 65 |uffer us|ed to re|
|00002010| 63 65 69 76 65 20 74 68 | 65 20 6f 70 74 69 6f 6e |ceive th|e option|
|00002020| 20 69 6e 2c 20 61 6e 64 | 0a 74 68 69 73 20 62 75 | in, and|.this bu|
|00002030| 66 66 65 72 20 69 73 20 | 72 65 74 75 72 6e 65 64 |ffer is |returned|
|00002040| 20 61 73 20 61 20 73 74 | 72 69 6e 67 2e 20 20 49 | as a st|ring. I|
|00002050| 74 20 69 73 20 75 70 20 | 74 6f 20 74 68 65 20 63 |t is up |to the c|
|00002060| 61 6c 6c 65 72 20 74 6f | 20 64 65 63 6f 64 65 0a |aller to| decode.|
|00002070| 74 68 65 20 63 6f 6e 74 | 65 6e 74 73 20 6f 66 20 |the cont|ents of |
|00002080| 74 68 65 20 62 75 66 66 | 65 72 20 28 73 65 65 20 |the buff|er (see |
|00002090| 74 68 65 20 6f 70 74 69 | 6f 6e 61 6c 20 62 75 69 |the opti|onal bui|
|000020a0| 6c 74 2d 69 6e 20 6d 6f | 64 75 6c 65 0a 5c 63 6f |lt-in mo|dule.\co|
|000020b0| 64 65 7b 73 74 72 75 63 | 74 7d 20 66 6f 72 20 61 |de{struc|t} for a|
|000020c0| 20 77 61 79 20 74 6f 20 | 64 65 63 6f 64 65 20 43 | way to |decode C|
|000020d0| 20 73 74 72 75 63 74 75 | 72 65 73 20 65 6e 63 6f | structu|res enco|
|000020e0| 64 65 64 20 61 73 20 73 | 74 72 69 6e 67 73 29 2e |ded as s|trings).|
|000020f0| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|00002100| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00002110| 7d 7b 6c 69 73 74 65 6e | 7d 7b 62 61 63 6b 6c 6f |}{listen|}{backlo|
|00002120| 67 7d 0a 4c 69 73 74 65 | 6e 20 66 6f 72 20 63 6f |g}.Liste|n for co|
|00002130| 6e 6e 65 63 74 69 6f 6e | 73 20 6d 61 64 65 20 74 |nnection|s made t|
|00002140| 6f 20 74 68 65 20 73 6f | 63 6b 65 74 2e 20 20 54 |o the so|cket. T|
|00002150| 68 65 20 5c 76 61 72 7b | 62 61 63 6b 6c 6f 67 7d |he \var{|backlog}|
|00002160| 20 61 72 67 75 6d 65 6e | 74 0a 73 70 65 63 69 66 | argumen|t.specif|
|00002170| 69 65 73 20 74 68 65 20 | 6d 61 78 69 6d 75 6d 20 |ies the |maximum |
|00002180| 6e 75 6d 62 65 72 20 6f | 66 20 71 75 65 75 65 64 |number o|f queued|
|00002190| 20 63 6f 6e 6e 65 63 74 | 69 6f 6e 73 20 61 6e 64 | connect|ions and|
|000021a0| 20 73 68 6f 75 6c 64 20 | 62 65 20 61 74 0a 6c 65 | should |be at.le|
|000021b0| 61 73 74 20 31 3b 20 74 | 68 65 20 6d 61 78 69 6d |ast 1; t|he maxim|
|000021c0| 75 6d 20 76 61 6c 75 65 | 20 69 73 20 73 79 73 74 |um value| is syst|
|000021d0| 65 6d 2d 64 65 70 65 6e | 64 65 6e 74 20 28 75 73 |em-depen|dent (us|
|000021e0| 75 61 6c 6c 79 20 35 29 | 2e 0a 5c 65 6e 64 7b 66 |ually 5)|..\end{f|
|000021f0| 75 6e 63 64 65 73 63 7d | 0a 0a 5c 62 65 67 69 6e |uncdesc}|..\begin|
|00002200| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 6d 61 6b 65 66 |{funcdes|c}{makef|
|00002210| 69 6c 65 7d 7b 5c 6f 70 | 74 69 6f 6e 61 6c 7b 6d |ile}{\op|tional{m|
|00002220| 6f 64 65 5c 6f 70 74 69 | 6f 6e 61 6c 7b 5c 2c 20 |ode\opti|onal{\, |
|00002230| 62 75 66 73 69 7a 65 7d | 7d 7d 0a 52 65 74 75 72 |bufsize}|}}.Retur|
|00002240| 6e 20 61 20 5c 64 66 6e | 7b 66 69 6c 65 20 6f 62 |n a \dfn|{file ob|
|00002250| 6a 65 63 74 7d 20 61 73 | 73 6f 63 69 61 74 65 64 |ject} as|sociated|
|00002260| 20 77 69 74 68 20 74 68 | 65 20 73 6f 63 6b 65 74 | with th|e socket|
|00002270| 2e 20 20 28 46 69 6c 65 | 20 6f 62 6a 65 63 74 73 |. (File| objects|
|00002280| 0a 77 65 72 65 20 64 65 | 73 63 72 69 62 65 64 20 |.were de|scribed |
|00002290| 65 61 72 6c 69 65 72 20 | 75 6e 64 65 72 20 42 75 |earlier |under Bu|
|000022a0| 69 6c 74 2d 69 6e 20 54 | 79 70 65 73 2e 29 20 20 |ilt-in T|ypes.) |
|000022b0| 54 68 65 20 66 69 6c 65 | 20 6f 62 6a 65 63 74 0a |The file| object.|
|000022c0| 72 65 66 65 72 65 6e 63 | 65 73 20 61 20 5c 63 6f |referenc|es a \co|
|000022d0| 64 65 7b 64 75 70 28 29 | 7d 70 65 64 20 76 65 72 |de{dup()|}ped ver|
|000022e0| 73 69 6f 6e 20 6f 66 20 | 74 68 65 20 73 6f 63 6b |sion of |the sock|
|000022f0| 65 74 20 66 69 6c 65 20 | 64 65 73 63 72 69 70 74 |et file |descript|
|00002300| 6f 72 2c 20 73 6f 0a 74 | 68 65 20 66 69 6c 65 20 |or, so.t|he file |
|00002310| 6f 62 6a 65 63 74 20 61 | 6e 64 20 73 6f 63 6b 65 |object a|nd socke|
|00002320| 74 20 6f 62 6a 65 63 74 | 20 6d 61 79 20 62 65 20 |t object| may be |
|00002330| 63 6c 6f 73 65 64 20 6f | 72 20 67 61 72 62 61 67 |closed o|r garbag|
|00002340| 65 2d 63 6f 6c 6c 65 63 | 74 65 64 0a 69 6e 64 65 |e-collec|ted.inde|
|00002350| 70 65 6e 64 65 6e 74 6c | 79 2e 20 20 54 68 65 20 |pendentl|y. The |
|00002360| 6f 70 74 69 6f 6e 61 6c | 20 5c 76 61 72 7b 6d 6f |optional| \var{mo|
|00002370| 64 65 7d 20 61 6e 64 20 | 5c 76 61 72 7b 62 75 66 |de} and |\var{buf|
|00002380| 73 69 7a 65 7d 20 61 72 | 67 75 6d 65 6e 74 73 0a |size} ar|guments.|
|00002390| 61 72 65 20 69 6e 74 65 | 72 70 72 65 74 65 64 20 |are inte|rpreted |
|000023a0| 74 68 65 20 73 61 6d 65 | 20 77 61 79 20 61 73 20 |the same| way as |
|000023b0| 62 79 20 74 68 65 20 62 | 75 69 6c 74 2d 69 6e 0a |by the b|uilt-in.|
|000023c0| 5c 63 6f 64 65 7b 6f 70 | 65 6e 28 29 7d 20 66 75 |\code{op|en()} fu|
|000023d0| 6e 63 74 69 6f 6e 2e 0a | 5c 65 6e 64 7b 66 75 6e |nction..|\end{fun|
|000023e0| 63 64 65 73 63 7d 0a 0a | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|000023f0| 75 6e 63 64 65 73 63 7d | 7b 72 65 63 76 7d 7b 62 |uncdesc}|{recv}{b|
|00002400| 75 66 73 69 7a 65 5c 6f | 70 74 69 6f 6e 61 6c 7b |ufsize\o|ptional{|
|00002410| 5c 2c 20 66 6c 61 67 73 | 7d 7d 0a 52 65 63 65 69 |\, flags|}}.Recei|
|00002420| 76 65 20 64 61 74 61 20 | 66 72 6f 6d 20 74 68 65 |ve data |from the|
|00002430| 20 73 6f 63 6b 65 74 2e | 20 20 54 68 65 20 72 65 | socket.| The re|
|00002440| 74 75 72 6e 20 76 61 6c | 75 65 20 69 73 20 61 20 |turn val|ue is a |
|00002450| 73 74 72 69 6e 67 20 72 | 65 70 72 65 73 65 6e 74 |string r|epresent|
|00002460| 69 6e 67 0a 74 68 65 20 | 64 61 74 61 20 72 65 63 |ing.the |data rec|
|00002470| 65 69 76 65 64 2e 20 20 | 54 68 65 20 6d 61 78 69 |eived. |The maxi|
|00002480| 6d 75 6d 20 61 6d 6f 75 | 6e 74 20 6f 66 20 64 61 |mum amou|nt of da|
|00002490| 74 61 20 74 6f 20 62 65 | 20 72 65 63 65 69 76 65 |ta to be| receive|
|000024a0| 64 0a 61 74 20 6f 6e 63 | 65 20 69 73 20 73 70 65 |d.at onc|e is spe|
|000024b0| 63 69 66 69 65 64 20 62 | 79 20 5c 76 61 72 7b 62 |cified b|y \var{b|
|000024c0| 75 66 73 69 7a 65 7d 2e | 20 20 53 65 65 20 74 68 |ufsize}.| See th|
|000024d0| 65 20 5c 55 4e 49 58 7b | 7d 20 6d 61 6e 75 61 6c |e \UNIX{|} manual|
|000024e0| 20 70 61 67 65 0a 66 6f | 72 20 74 68 65 20 6d 65 | page.fo|r the me|
|000024f0| 61 6e 69 6e 67 20 6f 66 | 20 74 68 65 20 6f 70 74 |aning of| the opt|
|00002500| 69 6f 6e 61 6c 20 61 72 | 67 75 6d 65 6e 74 20 5c |ional ar|gument \|
|00002510| 76 61 72 7b 66 6c 61 67 | 73 7d 3b 20 69 74 20 64 |var{flag|s}; it d|
|00002520| 65 66 61 75 6c 74 73 20 | 74 6f 0a 7a 65 72 6f 2e |efaults |to.zero.|
|00002530| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|00002540| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00002550| 7d 7b 72 65 63 76 66 72 | 6f 6d 7d 7b 62 75 66 73 |}{recvfr|om}{bufs|
|00002560| 69 7a 65 5c 6f 70 74 69 | 6f 6e 61 6c 7b 5c 2c 20 |ize\opti|onal{\, |
|00002570| 66 6c 61 67 73 7d 7d 0a | 52 65 63 65 69 76 65 20 |flags}}.|Receive |
|00002580| 64 61 74 61 20 66 72 6f | 6d 20 74 68 65 20 73 6f |data fro|m the so|
|00002590| 63 6b 65 74 2e 20 20 54 | 68 65 20 72 65 74 75 72 |cket. T|he retur|
|000025a0| 6e 20 76 61 6c 75 65 20 | 69 73 20 61 20 70 61 69 |n value |is a pai|
|000025b0| 72 0a 5c 63 6f 64 65 7b | 28 5c 76 61 72 7b 73 74 |r.\code{|(\var{st|
|000025c0| 72 69 6e 67 7d 2c 20 5c | 76 61 72 7b 61 64 64 72 |ring}, \|var{addr|
|000025d0| 65 73 73 7d 29 7d 20 77 | 68 65 72 65 20 5c 76 61 |ess})} w|here \va|
|000025e0| 72 7b 73 74 72 69 6e 67 | 7d 20 69 73 20 61 20 73 |r{string|} is a s|
|000025f0| 74 72 69 6e 67 0a 72 65 | 70 72 65 73 65 6e 74 69 |tring.re|presenti|
|00002600| 6e 67 20 74 68 65 20 64 | 61 74 61 20 72 65 63 65 |ng the d|ata rece|
|00002610| 69 76 65 64 20 61 6e 64 | 20 5c 76 61 72 7b 61 64 |ived and| \var{ad|
|00002620| 64 72 65 73 73 7d 20 69 | 73 20 74 68 65 20 61 64 |dress} i|s the ad|
|00002630| 64 72 65 73 73 20 6f 66 | 20 74 68 65 0a 73 6f 63 |dress of| the.soc|
|00002640| 6b 65 74 20 73 65 6e 64 | 69 6e 67 20 74 68 65 20 |ket send|ing the |
|00002650| 64 61 74 61 2e 20 20 54 | 68 65 20 6f 70 74 69 6f |data. T|he optio|
|00002660| 6e 61 6c 20 5c 76 61 72 | 7b 66 6c 61 67 73 7d 20 |nal \var|{flags} |
|00002670| 61 72 67 75 6d 65 6e 74 | 20 68 61 73 20 74 68 65 |argument| has the|
|00002680| 0a 73 61 6d 65 20 6d 65 | 61 6e 69 6e 67 20 61 73 |.same me|aning as|
|00002690| 20 66 6f 72 20 5c 63 6f | 64 65 7b 72 65 63 76 28 | for \co|de{recv(|
|000026a0| 29 7d 20 61 62 6f 76 65 | 2e 0a 28 54 68 65 20 66 |)} above|..(The f|
|000026b0| 6f 72 6d 61 74 20 6f 66 | 20 5c 76 61 72 7b 61 64 |ormat of| \var{ad|
|000026c0| 64 72 65 73 73 7d 20 64 | 65 70 65 6e 64 73 20 6f |dress} d|epends o|
|000026d0| 6e 20 74 68 65 20 61 64 | 64 72 65 73 73 20 66 61 |n the ad|dress fa|
|000026e0| 6d 69 6c 79 20 2d 2d 2d | 20 73 65 65 20 61 62 6f |mily ---| see abo|
|000026f0| 76 65 2e 29 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |ve.).\en|d{funcde|
|00002700| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00002710| 64 65 73 63 7d 7b 73 65 | 6e 64 7d 7b 73 74 72 69 |desc}{se|nd}{stri|
|00002720| 6e 67 5c 6f 70 74 69 6f | 6e 61 6c 7b 5c 2c 20 66 |ng\optio|nal{\, f|
|00002730| 6c 61 67 73 7d 7d 0a 53 | 65 6e 64 20 64 61 74 61 |lags}}.S|end data|
|00002740| 20 74 6f 20 74 68 65 20 | 73 6f 63 6b 65 74 2e 20 | to the |socket. |
|00002750| 20 54 68 65 20 73 6f 63 | 6b 65 74 20 6d 75 73 74 | The soc|ket must|
|00002760| 20 62 65 20 63 6f 6e 6e | 65 63 74 65 64 20 74 6f | be conn|ected to|
|00002770| 20 61 20 72 65 6d 6f 74 | 65 0a 73 6f 63 6b 65 74 | a remot|e.socket|
|00002780| 2e 20 20 54 68 65 20 6f | 70 74 69 6f 6e 61 6c 20 |. The o|ptional |
|00002790| 5c 76 61 72 7b 66 6c 61 | 67 73 7d 20 61 72 67 75 |\var{fla|gs} argu|
|000027a0| 6d 65 6e 74 20 68 61 73 | 20 74 68 65 20 73 61 6d |ment has| the sam|
|000027b0| 65 20 6d 65 61 6e 69 6e | 67 20 61 73 20 66 6f 72 |e meanin|g as for|
|000027c0| 0a 5c 63 6f 64 65 7b 72 | 65 63 76 28 29 7d 20 61 |.\code{r|ecv()} a|
|000027d0| 62 6f 76 65 2e 20 20 52 | 65 74 75 72 6e 20 74 68 |bove. R|eturn th|
|000027e0| 65 20 6e 75 6d 62 65 72 | 20 6f 66 20 62 79 74 65 |e number| of byte|
|000027f0| 73 20 73 65 6e 74 2e 0a | 5c 65 6e 64 7b 66 75 6e |s sent..|\end{fun|
|00002800| 63 64 65 73 63 7d 0a 0a | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|00002810| 75 6e 63 64 65 73 63 7d | 7b 73 65 6e 64 74 6f 7d |uncdesc}|{sendto}|
|00002820| 7b 73 74 72 69 6e 67 5c | 6f 70 74 69 6f 6e 61 6c |{string\|optional|
|00002830| 7b 5c 2c 20 66 6c 61 67 | 73 7d 5c 2c 20 61 64 64 |{\, flag|s}\, add|
|00002840| 72 65 73 73 7d 0a 53 65 | 6e 64 20 64 61 74 61 20 |ress}.Se|nd data |
|00002850| 74 6f 20 74 68 65 20 73 | 6f 63 6b 65 74 2e 20 20 |to the s|ocket. |
|00002860| 54 68 65 20 73 6f 63 6b | 65 74 20 73 68 6f 75 6c |The sock|et shoul|
|00002870| 64 20 6e 6f 74 20 62 65 | 20 63 6f 6e 6e 65 63 74 |d not be| connect|
|00002880| 65 64 20 74 6f 20 61 0a | 72 65 6d 6f 74 65 20 73 |ed to a.|remote s|
|00002890| 6f 63 6b 65 74 2c 20 73 | 69 6e 63 65 20 74 68 65 |ocket, s|ince the|
|000028a0| 20 64 65 73 74 69 6e 61 | 74 69 6f 6e 20 73 6f 63 | destina|tion soc|
|000028b0| 6b 65 74 20 69 73 20 73 | 70 65 63 69 66 69 65 64 |ket is s|pecified|
|000028c0| 20 62 79 0a 5c 63 6f 64 | 65 7b 61 64 64 72 65 73 | by.\cod|e{addres|
|000028d0| 73 7d 2e 20 20 54 68 65 | 20 6f 70 74 69 6f 6e 61 |s}. The| optiona|
|000028e0| 6c 20 5c 76 61 72 7b 66 | 6c 61 67 73 7d 20 61 72 |l \var{f|lags} ar|
|000028f0| 67 75 6d 65 6e 74 20 68 | 61 73 20 74 68 65 20 73 |gument h|as the s|
|00002900| 61 6d 65 0a 6d 65 61 6e | 69 6e 67 20 61 73 20 66 |ame.mean|ing as f|
|00002910| 6f 72 20 5c 63 6f 64 65 | 7b 72 65 63 76 28 29 7d |or \code|{recv()}|
|00002920| 20 61 62 6f 76 65 2e 20 | 20 52 65 74 75 72 6e 20 | above. | Return |
|00002930| 74 68 65 20 6e 75 6d 62 | 65 72 20 6f 66 20 62 79 |the numb|er of by|
|00002940| 74 65 73 20 73 65 6e 74 | 2e 0a 28 54 68 65 20 66 |tes sent|..(The f|
|00002950| 6f 72 6d 61 74 20 6f 66 | 20 5c 76 61 72 7b 61 64 |ormat of| \var{ad|
|00002960| 64 72 65 73 73 7d 20 64 | 65 70 65 6e 64 73 20 6f |dress} d|epends o|
|00002970| 6e 20 74 68 65 20 61 64 | 64 72 65 73 73 20 66 61 |n the ad|dress fa|
|00002980| 6d 69 6c 79 20 2d 2d 2d | 20 73 65 65 20 61 62 6f |mily ---| see abo|
|00002990| 76 65 2e 29 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |ve.).\en|d{funcde|
|000029a0| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|000029b0| 64 65 73 63 7d 7b 73 65 | 74 62 6c 6f 63 6b 69 6e |desc}{se|tblockin|
|000029c0| 67 7d 7b 66 6c 61 67 7d | 0a 53 65 74 20 62 6c 6f |g}{flag}|.Set blo|
|000029d0| 63 6b 69 6e 67 20 6f 72 | 20 6e 6f 6e 2d 62 6c 6f |cking or| non-blo|
|000029e0| 63 6b 69 6e 67 20 6d 6f | 64 65 20 6f 66 20 74 68 |cking mo|de of th|
|000029f0| 65 20 73 6f 63 6b 65 74 | 3a 20 69 66 20 5c 76 61 |e socket|: if \va|
|00002a00| 72 7b 66 6c 61 67 7d 20 | 69 73 20 30 2c 0a 74 68 |r{flag} |is 0,.th|
|00002a10| 65 20 73 6f 63 6b 65 74 | 20 69 73 20 73 65 74 20 |e socket| is set |
|00002a20| 74 6f 20 6e 6f 6e 2d 62 | 6c 6f 63 6b 69 6e 67 2c |to non-b|locking,|
|00002a30| 20 65 6c 73 65 20 74 6f | 20 62 6c 6f 63 6b 69 6e | else to| blockin|
|00002a40| 67 20 6d 6f 64 65 2e 20 | 20 49 6e 69 74 69 61 6c |g mode. | Initial|
|00002a50| 6c 79 0a 61 6c 6c 20 73 | 6f 63 6b 65 74 73 20 61 |ly.all s|ockets a|
|00002a60| 72 65 20 69 6e 20 62 6c | 6f 63 6b 69 6e 67 20 6d |re in bl|ocking m|
|00002a70| 6f 64 65 2e 20 20 49 6e | 20 6e 6f 6e 2d 62 6c 6f |ode. In| non-blo|
|00002a80| 63 6b 69 6e 67 20 6d 6f | 64 65 2c 20 69 66 20 61 |cking mo|de, if a|
|00002a90| 0a 5c 63 6f 64 65 7b 72 | 65 63 76 7d 20 63 61 6c |.\code{r|ecv} cal|
|00002aa0| 6c 20 64 6f 65 73 6e 27 | 74 20 66 69 6e 64 20 61 |l doesn'|t find a|
|00002ab0| 6e 79 20 64 61 74 61 2c | 20 6f 72 20 69 66 20 61 |ny data,| or if a|
|00002ac0| 20 5c 63 6f 64 65 7b 73 | 65 6e 64 7d 20 63 61 6c | \code{s|end} cal|
|00002ad0| 6c 20 63 61 6e 27 74 0a | 69 6d 6d 65 64 69 61 74 |l can't.|immediat|
|00002ae0| 65 6c 79 20 64 69 73 70 | 6f 73 65 20 6f 66 20 74 |ely disp|ose of t|
|00002af0| 68 65 20 64 61 74 61 2c | 20 61 20 5c 63 6f 64 65 |he data,| a \code|
|00002b00| 7b 73 6f 63 6b 65 74 2e | 65 72 72 6f 72 7d 20 65 |{socket.|error} e|
|00002b10| 78 63 65 70 74 69 6f 6e | 20 69 73 0a 72 61 69 73 |xception| is.rais|
|00002b20| 65 64 3b 20 69 6e 20 62 | 6c 6f 63 6b 69 6e 67 20 |ed; in b|locking |
|00002b30| 6d 6f 64 65 2c 20 74 68 | 65 20 63 61 6c 6c 73 20 |mode, th|e calls |
|00002b40| 62 6c 6f 63 6b 20 75 6e | 74 69 6c 20 74 68 65 79 |block un|til they|
|00002b50| 20 63 61 6e 20 70 72 6f | 63 65 65 64 2e 0a 5c 65 | can pro|ceed..\e|
|00002b60| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 62 |nd{funcd|esc}..\b|
|00002b70| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 73 |egin{fun|cdesc}{s|
|00002b80| 65 74 73 6f 63 6b 6f 70 | 74 7d 7b 6c 65 76 65 6c |etsockop|t}{level|
|00002b90| 5c 2c 20 6f 70 74 6e 61 | 6d 65 5c 2c 20 76 61 6c |\, optna|me\, val|
|00002ba0| 75 65 7d 0a 53 65 74 20 | 74 68 65 20 76 61 6c 75 |ue}.Set |the valu|
|00002bb0| 65 20 6f 66 20 74 68 65 | 20 67 69 76 65 6e 20 73 |e of the| given s|
|00002bc0| 6f 63 6b 65 74 20 6f 70 | 74 69 6f 6e 20 28 73 65 |ocket op|tion (se|
|00002bd0| 65 20 74 68 65 20 5c 55 | 4e 49 58 7b 7d 20 6d 61 |e the \U|NIX{} ma|
|00002be0| 6e 20 70 61 67 65 0a 7b | 5c 69 74 20 73 65 74 73 |n page.{|\it sets|
|00002bf0| 6f 63 6b 6f 70 74 7d 28 | 32 29 29 2e 20 20 54 68 |ockopt}(|2)). Th|
|00002c00| 65 20 6e 65 65 64 65 64 | 20 73 79 6d 62 6f 6c 69 |e needed| symboli|
|00002c10| 63 20 63 6f 6e 73 74 61 | 6e 74 73 20 61 72 65 20 |c consta|nts are |
|00002c20| 64 65 66 69 6e 65 64 20 | 69 6e 0a 74 68 65 20 5c |defined |in.the \|
|00002c30| 63 6f 64 65 7b 73 6f 63 | 6b 65 74 7d 20 6d 6f 64 |code{soc|ket} mod|
|00002c40| 75 6c 65 20 28 5c 63 6f | 64 65 7b 53 4f 5f 2a 7d |ule (\co|de{SO_*}|
|00002c50| 20 65 74 63 2e 29 2e 20 | 20 54 68 65 20 76 61 6c | etc.). | The val|
|00002c60| 75 65 20 63 61 6e 20 62 | 65 20 61 6e 0a 69 6e 74 |ue can b|e an.int|
|00002c70| 65 67 65 72 20 6f 72 20 | 61 20 73 74 72 69 6e 67 |eger or |a string|
|00002c80| 20 72 65 70 72 65 73 65 | 6e 74 69 6e 67 20 61 20 | represe|nting a |
|00002c90| 62 75 66 66 65 72 2e 20 | 20 49 6e 20 74 68 65 20 |buffer. | In the |
|00002ca0| 6c 61 74 74 65 72 20 63 | 61 73 65 20 69 74 20 69 |latter c|ase it i|
|00002cb0| 73 0a 75 70 20 74 6f 20 | 74 68 65 20 63 61 6c 6c |s.up to |the call|
|00002cc0| 65 72 20 74 6f 20 65 6e | 73 75 72 65 20 74 68 61 |er to en|sure tha|
|00002cd0| 74 20 74 68 65 20 73 74 | 72 69 6e 67 20 63 6f 6e |t the st|ring con|
|00002ce0| 74 61 69 6e 73 20 74 68 | 65 20 70 72 6f 70 65 72 |tains th|e proper|
|00002cf0| 20 62 69 74 73 0a 28 73 | 65 65 20 74 68 65 20 6f | bits.(s|ee the o|
|00002d00| 70 74 69 6f 6e 61 6c 20 | 62 75 69 6c 74 2d 69 6e |ptional |built-in|
|00002d10| 20 6d 6f 64 75 6c 65 0a | 5c 63 6f 64 65 7b 73 74 | module.|\code{st|
|00002d20| 72 75 63 74 7d 20 66 6f | 72 20 61 20 77 61 79 20 |ruct} fo|r a way |
|00002d30| 74 6f 20 65 6e 63 6f 64 | 65 20 43 20 73 74 72 75 |to encod|e C stru|
|00002d40| 63 74 75 72 65 73 20 61 | 73 20 73 74 72 69 6e 67 |ctures a|s string|
|00002d50| 73 29 2e 0a 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |s)..\end|{funcdes|
|00002d60| 63 7d 0a 0a 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00002d70| 65 73 63 7d 7b 73 68 75 | 74 64 6f 77 6e 7d 7b 68 |esc}{shu|tdown}{h|
|00002d80| 6f 77 7d 0a 53 68 75 74 | 20 64 6f 77 6e 20 6f 6e |ow}.Shut| down on|
|00002d90| 65 20 6f 72 20 62 6f 74 | 68 20 68 61 6c 76 65 73 |e or bot|h halves|
|00002da0| 20 6f 66 20 74 68 65 20 | 63 6f 6e 6e 65 63 74 69 | of the |connecti|
|00002db0| 6f 6e 2e 20 20 49 66 20 | 5c 76 61 72 7b 68 6f 77 |on. If |\var{how|
|00002dc0| 7d 20 69 73 20 5c 63 6f | 64 65 7b 30 7d 2c 0a 66 |} is \co|de{0},.f|
|00002dd0| 75 72 74 68 65 72 20 72 | 65 63 65 69 76 65 73 20 |urther r|eceives |
|00002de0| 61 72 65 20 64 69 73 61 | 6c 6c 6f 77 65 64 2e 20 |are disa|llowed. |
|00002df0| 20 49 66 20 5c 76 61 72 | 7b 68 6f 77 7d 20 69 73 | If \var|{how} is|
|00002e00| 20 5c 63 6f 64 65 7b 31 | 7d 2c 20 66 75 72 74 68 | \code{1|}, furth|
|00002e10| 65 72 20 73 65 6e 64 73 | 20 61 72 65 0a 64 69 73 |er sends| are.dis|
|00002e20| 61 6c 6c 6f 77 65 64 2e | 20 20 49 66 20 5c 76 61 |allowed.| If \va|
|00002e30| 72 7b 68 6f 77 7d 20 69 | 73 20 5c 63 6f 64 65 7b |r{how} i|s \code{|
|00002e40| 32 7d 2c 20 66 75 72 74 | 68 65 72 20 73 65 6e 64 |2}, furt|her send|
|00002e50| 73 20 61 6e 64 20 72 65 | 63 65 69 76 65 73 20 61 |s and re|ceives a|
|00002e60| 72 65 0a 64 69 73 61 6c | 6c 6f 77 65 64 2e 0a 5c |re.disal|lowed..\|
|00002e70| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0a 0a 4e |end{func|desc}..N|
|00002e80| 6f 74 65 20 74 68 61 74 | 20 74 68 65 72 65 20 61 |ote that| there a|
|00002e90| 72 65 20 6e 6f 20 6d 65 | 74 68 6f 64 73 20 5c 63 |re no me|thods \c|
|00002ea0| 6f 64 65 7b 72 65 61 64 | 28 29 7d 20 6f 72 20 5c |ode{read|()} or \|
|00002eb0| 63 6f 64 65 7b 77 72 69 | 74 65 28 29 7d 3b 20 75 |code{wri|te()}; u|
|00002ec0| 73 65 0a 5c 63 6f 64 65 | 7b 72 65 63 76 28 29 7d |se.\code|{recv()}|
|00002ed0| 20 61 6e 64 20 5c 63 6f | 64 65 7b 73 65 6e 64 28 | and \co|de{send(|
|00002ee0| 29 7d 20 77 69 74 68 6f | 75 74 20 5c 76 61 72 7b |)} witho|ut \var{|
|00002ef0| 66 6c 61 67 73 7d 20 61 | 72 67 75 6d 65 6e 74 20 |flags} a|rgument |
|00002f00| 69 6e 73 74 65 61 64 2e | 0a 0a 5c 73 75 62 73 65 |instead.|..\subse|
|00002f10| 63 74 69 6f 6e 7b 45 78 | 61 6d 70 6c 65 7d 0a 5c |ction{Ex|ample}.\|
|00002f20| 6e 6f 64 65 6e 61 6d 65 | 7b 53 6f 63 6b 65 74 20 |nodename|{Socket |
|00002f30| 45 78 61 6d 70 6c 65 7d | 0a 0a 48 65 72 65 20 61 |Example}|..Here a|
|00002f40| 72 65 20 74 77 6f 20 6d | 69 6e 69 6d 61 6c 20 65 |re two m|inimal e|
|00002f50| 78 61 6d 70 6c 65 20 70 | 72 6f 67 72 61 6d 73 20 |xample p|rograms |
|00002f60| 75 73 69 6e 67 20 74 68 | 65 20 54 43 50 2f 49 50 |using th|e TCP/IP|
|00002f70| 20 70 72 6f 74 6f 63 6f | 6c 3a 5c 20 61 0a 73 65 | protoco|l:\ a.se|
|00002f80| 72 76 65 72 20 74 68 61 | 74 20 65 63 68 6f 65 73 |rver tha|t echoes|
|00002f90| 20 61 6c 6c 20 64 61 74 | 61 20 74 68 61 74 20 69 | all dat|a that i|
|00002fa0| 74 20 72 65 63 65 69 76 | 65 73 20 62 61 63 6b 20 |t receiv|es back |
|00002fb0| 28 73 65 72 76 69 63 69 | 6e 67 20 6f 6e 6c 79 20 |(servici|ng only |
|00002fc0| 6f 6e 65 0a 63 6c 69 65 | 6e 74 29 2c 20 61 6e 64 |one.clie|nt), and|
|00002fd0| 20 61 20 63 6c 69 65 6e | 74 20 75 73 69 6e 67 20 | a clien|t using |
|00002fe0| 69 74 2e 20 20 4e 6f 74 | 65 20 74 68 61 74 20 61 |it. Not|e that a|
|00002ff0| 20 73 65 72 76 65 72 20 | 6d 75 73 74 20 70 65 72 | server |must per|
|00003000| 66 6f 72 6d 20 74 68 65 | 0a 73 65 71 75 65 6e 63 |form the|.sequenc|
|00003010| 65 20 5c 63 6f 64 65 7b | 73 6f 63 6b 65 74 7d 2c |e \code{|socket},|
|00003020| 20 5c 63 6f 64 65 7b 62 | 69 6e 64 7d 2c 20 5c 63 | \code{b|ind}, \c|
|00003030| 6f 64 65 7b 6c 69 73 74 | 65 6e 7d 2c 20 5c 63 6f |ode{list|en}, \co|
|00003040| 64 65 7b 61 63 63 65 70 | 74 7d 0a 28 70 6f 73 73 |de{accep|t}.(poss|
|00003050| 69 62 6c 79 20 72 65 70 | 65 61 74 69 6e 67 20 74 |ibly rep|eating t|
|00003060| 68 65 20 5c 63 6f 64 65 | 7b 61 63 63 65 70 74 7d |he \code|{accept}|
|00003070| 20 74 6f 20 73 65 72 76 | 69 63 65 20 6d 6f 72 65 | to serv|ice more|
|00003080| 20 74 68 61 6e 20 6f 6e | 65 20 63 6c 69 65 6e 74 | than on|e client|
|00003090| 29 2c 0a 77 68 69 6c 65 | 20 61 20 63 6c 69 65 6e |),.while| a clien|
|000030a0| 74 20 6f 6e 6c 79 20 6e | 65 65 64 73 20 74 68 65 |t only n|eeds the|
|000030b0| 20 73 65 71 75 65 6e 63 | 65 20 5c 63 6f 64 65 7b | sequenc|e \code{|
|000030c0| 73 6f 63 6b 65 74 7d 2c | 20 5c 63 6f 64 65 7b 63 |socket},| \code{c|
|000030d0| 6f 6e 6e 65 63 74 7d 2e | 0a 41 6c 73 6f 20 6e 6f |onnect}.|.Also no|
|000030e0| 74 65 20 74 68 61 74 20 | 74 68 65 20 73 65 72 76 |te that |the serv|
|000030f0| 65 72 20 64 6f 65 73 20 | 6e 6f 74 20 5c 63 6f 64 |er does |not \cod|
|00003100| 65 7b 73 65 6e 64 7d 2f | 5c 63 6f 64 65 7b 72 65 |e{send}/|\code{re|
|00003110| 63 65 69 76 65 7d 20 6f | 6e 20 74 68 65 0a 73 6f |ceive} o|n the.so|
|00003120| 63 6b 65 74 20 69 74 20 | 69 73 20 6c 69 73 74 65 |cket it |is liste|
|00003130| 6e 69 6e 67 20 6f 6e 20 | 62 75 74 20 6f 6e 20 74 |ning on |but on t|
|00003140| 68 65 20 6e 65 77 20 73 | 6f 63 6b 65 74 20 72 65 |he new s|ocket re|
|00003150| 74 75 72 6e 65 64 20 62 | 79 0a 5c 63 6f 64 65 7b |turned b|y.\code{|
|00003160| 61 63 63 65 70 74 7d 2e | 0a 0a 5c 62 63 6f 64 65 |accept}.|..\bcode|
|00003170| 5c 62 65 67 69 6e 7b 76 | 65 72 62 61 74 69 6d 7d |\begin{v|erbatim}|
|00003180| 0a 23 20 45 63 68 6f 20 | 73 65 72 76 65 72 20 70 |.# Echo |server p|
|00003190| 72 6f 67 72 61 6d 0a 66 | 72 6f 6d 20 73 6f 63 6b |rogram.f|rom sock|
|000031a0| 65 74 20 69 6d 70 6f 72 | 74 20 2a 0a 48 4f 53 54 |et impor|t *.HOST|
|000031b0| 20 3d 20 27 27 20 20 20 | 20 20 20 20 20 20 20 20 | = '' | |
|000031c0| 20 20 20 20 20 20 23 20 | 53 79 6d 62 6f 6c 69 63 | # |Symbolic|
|000031d0| 20 6e 61 6d 65 20 6d 65 | 61 6e 69 6e 67 20 74 68 | name me|aning th|
|000031e0| 65 20 6c 6f 63 61 6c 20 | 68 6f 73 74 0a 50 4f 52 |e local |host.POR|
|000031f0| 54 20 3d 20 35 30 30 30 | 37 20 20 20 20 20 20 20 |T = 5000|7 |
|00003200| 20 20 20 20 20 20 20 23 | 20 41 72 62 69 74 72 61 | #| Arbitra|
|00003210| 72 79 20 6e 6f 6e 2d 70 | 72 69 76 69 6c 65 67 65 |ry non-p|rivilege|
|00003220| 64 20 73 65 72 76 65 72 | 0a 73 20 3d 20 73 6f 63 |d server|.s = soc|
|00003230| 6b 65 74 28 41 46 5f 49 | 4e 45 54 2c 20 53 4f 43 |ket(AF_I|NET, SOC|
|00003240| 4b 5f 53 54 52 45 41 4d | 29 0a 73 2e 62 69 6e 64 |K_STREAM|).s.bind|
|00003250| 28 48 4f 53 54 2c 20 50 | 4f 52 54 29 0a 73 2e 6c |(HOST, P|ORT).s.l|
|00003260| 69 73 74 65 6e 28 31 29 | 0a 63 6f 6e 6e 2c 20 61 |isten(1)|.conn, a|
|00003270| 64 64 72 20 3d 20 73 2e | 61 63 63 65 70 74 28 29 |ddr = s.|accept()|
|00003280| 0a 70 72 69 6e 74 20 27 | 43 6f 6e 6e 65 63 74 65 |.print '|Connecte|
|00003290| 64 20 62 79 27 2c 20 61 | 64 64 72 0a 77 68 69 6c |d by', a|ddr.whil|
|000032a0| 65 20 31 3a 0a 20 20 20 | 20 64 61 74 61 20 3d 20 |e 1:. | data = |
|000032b0| 63 6f 6e 6e 2e 72 65 63 | 76 28 31 30 32 34 29 0a |conn.rec|v(1024).|
|000032c0| 20 20 20 20 69 66 20 6e | 6f 74 20 64 61 74 61 3a | if n|ot data:|
|000032d0| 20 62 72 65 61 6b 0a 20 | 20 20 20 63 6f 6e 6e 2e | break. | conn.|
|000032e0| 73 65 6e 64 28 64 61 74 | 61 29 0a 63 6f 6e 6e 2e |send(dat|a).conn.|
|000032f0| 63 6c 6f 73 65 28 29 0a | 5c 65 6e 64 7b 76 65 72 |close().|\end{ver|
|00003300| 62 61 74 69 6d 7d 5c 65 | 63 6f 64 65 0a 0a 5c 62 |batim}\e|code..\b|
|00003310| 63 6f 64 65 5c 62 65 67 | 69 6e 7b 76 65 72 62 61 |code\beg|in{verba|
|00003320| 74 69 6d 7d 0a 23 20 45 | 63 68 6f 20 63 6c 69 65 |tim}.# E|cho clie|
|00003330| 6e 74 20 70 72 6f 67 72 | 61 6d 0a 66 72 6f 6d 20 |nt progr|am.from |
|00003340| 73 6f 63 6b 65 74 20 69 | 6d 70 6f 72 74 20 2a 0a |socket i|mport *.|
|00003350| 48 4f 53 54 20 3d 20 27 | 64 61 72 69 6e 67 2e 63 |HOST = '|daring.c|
|00003360| 77 69 2e 6e 6c 27 20 20 | 20 20 23 20 54 68 65 20 |wi.nl' | # The |
|00003370| 72 65 6d 6f 74 65 20 68 | 6f 73 74 0a 50 4f 52 54 |remote h|ost.PORT|
|00003380| 20 3d 20 35 30 30 30 37 | 20 20 20 20 20 20 20 20 | = 50007| |
|00003390| 20 20 20 20 20 20 23 20 | 54 68 65 20 73 61 6d 65 | # |The same|
|000033a0| 20 70 6f 72 74 20 61 73 | 20 75 73 65 64 20 62 79 | port as| used by|
|000033b0| 20 74 68 65 20 73 65 72 | 76 65 72 0a 73 20 3d 20 | the ser|ver.s = |
|000033c0| 73 6f 63 6b 65 74 28 41 | 46 5f 49 4e 45 54 2c 20 |socket(A|F_INET, |
|000033d0| 53 4f 43 4b 5f 53 54 52 | 45 41 4d 29 0a 73 2e 63 |SOCK_STR|EAM).s.c|
|000033e0| 6f 6e 6e 65 63 74 28 48 | 4f 53 54 2c 20 50 4f 52 |onnect(H|OST, POR|
|000033f0| 54 29 0a 73 2e 73 65 6e | 64 28 27 48 65 6c 6c 6f |T).s.sen|d('Hello|
|00003400| 2c 20 77 6f 72 6c 64 27 | 29 0a 64 61 74 61 20 3d |, world'|).data =|
|00003410| 20 73 2e 72 65 63 76 28 | 31 30 32 34 29 0a 73 2e | s.recv(|1024).s.|
|00003420| 63 6c 6f 73 65 28 29 0a | 70 72 69 6e 74 20 27 52 |close().|print 'R|
|00003430| 65 63 65 69 76 65 64 27 | 2c 20 60 64 61 74 61 60 |eceived'|, `data`|
|00003440| 0a 5c 65 6e 64 7b 76 65 | 72 62 61 74 69 6d 7d 5c |.\end{ve|rbatim}\|
|00003450| 65 63 6f 64 65 0a | |ecode. | |
+--------+-------------------------+-------------------------+--------+--------+