/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / python / pytexdoc / ext / lib / lib1 / posix / 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 70 6f 73 69 78 | 7d 7d 0a 5c 62 69 6d 6f |de{posix|}}.\bimo|
|00000030| 64 69 6e 64 65 78 7b 70 | 6f 73 69 78 7d 0a 0a 54 |dindex{p|osix}..T|
|00000040| 68 69 73 20 6d 6f 64 75 | 6c 65 20 70 72 6f 76 69 |his modu|le provi|
|00000050| 64 65 73 20 61 63 63 65 | 73 73 20 74 6f 20 6f 70 |des acce|ss to op|
|00000060| 65 72 61 74 69 6e 67 20 | 73 79 73 74 65 6d 20 66 |erating |system f|
|00000070| 75 6e 63 74 69 6f 6e 61 | 6c 69 74 79 20 74 68 61 |unctiona|lity tha|
|00000080| 74 20 69 73 0a 73 74 61 | 6e 64 61 72 64 69 7a 65 |t is.sta|ndardize|
|00000090| 64 20 62 79 20 74 68 65 | 20 43 20 53 74 61 6e 64 |d by the| C Stand|
|000000a0| 61 72 64 20 61 6e 64 20 | 74 68 65 20 50 4f 53 49 |ard and |the POSI|
|000000b0| 58 20 73 74 61 6e 64 61 | 72 64 20 28 61 20 74 68 |X standa|rd (a th|
|000000c0| 69 6e 6c 79 20 64 69 73 | 67 75 69 73 65 64 0a 5c |inly dis|guised.\|
|000000d0| 55 4e 49 58 7b 7d 20 69 | 6e 74 65 72 66 61 63 65 |UNIX{} i|nterface|
|000000e0| 29 2e 0a 0a 5c 73 74 72 | 6f 6e 67 7b 44 6f 20 6e |)...\str|ong{Do n|
|000000f0| 6f 74 20 69 6d 70 6f 72 | 74 20 74 68 69 73 20 6d |ot impor|t this m|
|00000100| 6f 64 75 6c 65 20 64 69 | 72 65 63 74 6c 79 2e 7d |odule di|rectly.}|
|00000110| 20 20 49 6e 73 74 65 61 | 64 2c 20 69 6d 70 6f 72 |  Instea|d, impor|
|00000120| 74 20 74 68 65 0a 6d 6f | 64 75 6c 65 20 5c 63 6f |t the.mo|dule \co|
|00000130| 64 65 7b 6f 73 7d 2c 20 | 77 68 69 63 68 20 70 72 |de{os}, |which pr|
|00000140| 6f 76 69 64 65 73 20 61 | 20 5c 65 6d 70 68 7b 70 |ovides a| \emph{p|
|00000150| 6f 72 74 61 62 6c 65 7d | 20 76 65 72 73 69 6f 6e |ortable}| version|
|00000160| 20 6f 66 20 74 68 69 73 | 0a 69 6e 74 65 72 66 61 | of this|.interfa|
|00000170| 63 65 2e 20 20 4f 6e 20 | 5c 55 4e 49 58 7b 7d 2c |ce.  On |\UNIX{},|
|00000180| 20 74 68 65 20 5c 63 6f | 64 65 7b 6f 73 7d 20 6d | the \co|de{os} m|
|00000190| 6f 64 75 6c 65 20 70 72 | 6f 76 69 64 65 73 20 61 |odule pr|ovides a|
|000001a0| 20 73 75 70 65 72 73 65 | 74 20 6f 66 0a 74 68 65 | superse|t of.the|
|000001b0| 20 5c 63 6f 64 65 7b 70 | 6f 73 69 78 7d 20 69 6e | \code{p|osix} in|
|000001c0| 74 65 72 66 61 63 65 2e | 20 20 4f 6e 20 6e 6f 6e |terface.|  On non|
|000001d0| 2d 5c 55 4e 49 58 7b 7d | 20 6f 70 65 72 61 74 69 |-\UNIX{}| operati|
|000001e0| 6e 67 20 73 79 73 74 65 | 6d 73 20 74 68 65 0a 5c |ng syste|ms the.\|
|000001f0| 63 6f 64 65 7b 70 6f 73 | 69 78 7d 20 6d 6f 64 75 |code{pos|ix} modu|
|00000200| 6c 65 20 69 73 20 6e 6f | 74 20 61 76 61 69 6c 61 |le is no|t availa|
|00000210| 62 6c 65 2c 20 62 75 74 | 20 61 20 73 75 62 73 65 |ble, but| a subse|
|00000220| 74 20 69 73 20 61 6c 77 | 61 79 73 20 61 76 61 69 |t is alw|ays avai|
|00000230| 6c 61 62 6c 65 0a 74 68 | 72 6f 75 67 68 20 74 68 |lable.th|rough th|
|00000240| 65 20 5c 63 6f 64 65 7b | 6f 73 7d 20 69 6e 74 65 |e \code{|os} inte|
|00000250| 72 66 61 63 65 2e 20 20 | 4f 6e 63 65 20 5c 63 6f |rface.  |Once \co|
|00000260| 64 65 7b 6f 73 7d 20 69 | 73 20 69 6d 70 6f 72 74 |de{os} i|s import|
|00000270| 65 64 2c 20 74 68 65 72 | 65 20 69 73 0a 5c 65 6d |ed, ther|e is.\em|
|00000280| 70 68 7b 6e 6f 7d 20 70 | 65 72 66 6f 72 6d 61 6e |ph{no} p|erforman|
|00000290| 63 65 20 70 65 6e 61 6c | 74 79 20 69 6e 20 75 73 |ce penal|ty in us|
|000002a0| 69 6e 67 20 69 74 20 69 | 6e 73 74 65 61 64 20 6f |ing it i|nstead o|
|000002b0| 66 0a 5c 63 6f 64 65 7b | 70 6f 73 69 78 7d 2e 0a |f.\code{|posix}..|
|000002c0| 5c 73 74 6d 6f 64 69 6e | 64 65 78 7b 6f 73 7d 0a |\stmodin|dex{os}.|
|000002d0| 0a 54 68 65 20 64 65 73 | 63 72 69 70 74 69 6f 6e |.The des|cription|
|000002e0| 73 20 62 65 6c 6f 77 20 | 61 72 65 20 76 65 72 79 |s below |are very|
|000002f0| 20 74 65 72 73 65 3b 20 | 72 65 66 65 72 20 74 6f | terse; |refer to|
|00000300| 20 74 68 65 0a 63 6f 72 | 72 65 73 70 6f 6e 64 69 | the.cor|respondi|
|00000310| 6e 67 20 5c 55 4e 49 58 | 7b 7d 20 6d 61 6e 75 61 |ng \UNIX|{} manua|
|00000320| 6c 20 65 6e 74 72 79 20 | 66 6f 72 20 6d 6f 72 65 |l entry |for more|
|00000330| 20 69 6e 66 6f 72 6d 61 | 74 69 6f 6e 2e 20 20 41 | informa|tion.  A|
|00000340| 72 67 75 6d 65 6e 74 73 | 0a 63 61 6c 6c 65 64 20 |rguments|.called |
|00000350| 5c 76 61 72 7b 70 61 74 | 68 7d 20 72 65 66 65 72 |\var{pat|h} refer|
|00000360| 20 74 6f 20 61 20 70 61 | 74 68 6e 61 6d 65 20 67 | to a pa|thname g|
|00000370| 69 76 65 6e 20 61 73 20 | 61 20 73 74 72 69 6e 67 |iven as |a string|
|00000380| 2e 0a 0a 45 72 72 6f 72 | 73 20 61 72 65 20 72 65 |...Error|s are re|
|00000390| 70 6f 72 74 65 64 20 61 | 73 20 65 78 63 65 70 74 |ported a|s except|
|000003a0| 69 6f 6e 73 3b 20 74 68 | 65 20 75 73 75 61 6c 20 |ions; th|e usual |
|000003b0| 65 78 63 65 70 74 69 6f | 6e 73 20 61 72 65 20 67 |exceptio|ns are g|
|000003c0| 69 76 65 6e 0a 66 6f 72 | 20 74 79 70 65 20 65 72 |iven.for| type er|
|000003d0| 72 6f 72 73 2c 20 77 68 | 69 6c 65 20 65 72 72 6f |rors, wh|ile erro|
|000003e0| 72 73 20 72 65 70 6f 72 | 74 65 64 20 62 79 20 74 |rs repor|ted by t|
|000003f0| 68 65 20 73 79 73 74 65 | 6d 20 63 61 6c 6c 73 20 |he syste|m calls |
|00000400| 72 61 69 73 65 0a 5c 63 | 6f 64 65 7b 70 6f 73 69 |raise.\c|ode{posi|
|00000410| 78 2e 65 72 72 6f 72 7d | 2c 20 64 65 73 63 72 69 |x.error}|, descri|
|00000420| 62 65 64 20 62 65 6c 6f | 77 2e 0a 0a 4d 6f 64 75 |bed belo|w...Modu|
|00000430| 6c 65 20 5c 63 6f 64 65 | 7b 70 6f 73 69 78 7d 20 |le \code|{posix} |
|00000440| 64 65 66 69 6e 65 73 20 | 74 68 65 20 66 6f 6c 6c |defines |the foll|
|00000450| 6f 77 69 6e 67 20 64 61 | 74 61 20 69 74 65 6d 73 |owing da|ta items|
|00000460| 3a 0a 0a 5c 72 65 6e 65 | 77 63 6f 6d 6d 61 6e 64 |:..\rene|wcommand|
|00000470| 7b 5c 69 6e 64 65 78 73 | 75 62 69 74 65 6d 7d 7b |{\indexs|ubitem}{|
|00000480| 28 64 61 74 61 20 69 6e | 20 6d 6f 64 75 6c 65 20 |(data in| module |
|00000490| 70 6f 73 69 78 29 7d 0a | 5c 62 65 67 69 6e 7b 64 |posix)}.|\begin{d|
|000004a0| 61 74 61 64 65 73 63 7d | 7b 65 6e 76 69 72 6f 6e |atadesc}|{environ|
|000004b0| 7d 0a 41 20 64 69 63 74 | 69 6f 6e 61 72 79 20 72 |}.A dict|ionary r|
|000004c0| 65 70 72 65 73 65 6e 74 | 69 6e 67 20 74 68 65 20 |epresent|ing the |
|000004d0| 73 74 72 69 6e 67 20 65 | 6e 76 69 72 6f 6e 6d 65 |string e|nvironme|
|000004e0| 6e 74 20 61 74 20 74 68 | 65 20 74 69 6d 65 0a 74 |nt at th|e time.t|
|000004f0| 68 65 20 69 6e 74 65 72 | 70 72 65 74 65 72 20 77 |he inter|preter w|
|00000500| 61 73 20 73 74 61 72 74 | 65 64 2e 0a 46 6f 72 20 |as start|ed..For |
|00000510| 65 78 61 6d 70 6c 65 2c | 0a 5c 63 6f 64 65 7b 70 |example,|.\code{p|
|00000520| 6f 73 69 78 2e 65 6e 76 | 69 72 6f 6e 5b 27 48 4f |osix.env|iron['HO|
|00000530| 4d 45 27 5d 7d 0a 69 73 | 20 74 68 65 20 70 61 74 |ME']}.is| the pat|
|00000540| 68 6e 61 6d 65 20 6f 66 | 20 79 6f 75 72 20 68 6f |hname of| your ho|
|00000550| 6d 65 20 64 69 72 65 63 | 74 6f 72 79 2c 20 65 71 |me direc|tory, eq|
|00000560| 75 69 76 61 6c 65 6e 74 | 20 74 6f 0a 5c 63 6f 64 |uivalent| to.\cod|
|00000570| 65 7b 67 65 74 65 6e 76 | 28 22 48 4f 4d 45 22 29 |e{getenv|("HOME")|
|00000580| 7d 0a 69 6e 20 43 2e 0a | 4d 6f 64 69 66 79 69 6e |}.in C..|Modifyin|
|00000590| 67 20 74 68 69 73 20 64 | 69 63 74 69 6f 6e 61 72 |g this d|ictionar|
|000005a0| 79 20 64 6f 65 73 20 6e | 6f 74 20 61 66 66 65 63 |y does n|ot affec|
|000005b0| 74 20 74 68 65 20 73 74 | 72 69 6e 67 20 65 6e 76 |t the st|ring env|
|000005c0| 69 72 6f 6e 6d 65 6e 74 | 0a 70 61 73 73 65 64 20 |ironment|.passed |
|000005d0| 6f 6e 20 62 79 20 5c 63 | 6f 64 65 7b 65 78 65 63 |on by \c|ode{exec|
|000005e0| 76 28 29 7d 2c 20 5c 63 | 6f 64 65 7b 70 6f 70 65 |v()}, \c|ode{pope|
|000005f0| 6e 28 29 7d 20 6f 72 20 | 5c 63 6f 64 65 7b 73 79 |n()} or |\code{sy|
|00000600| 73 74 65 6d 28 29 7d 3b | 20 69 66 20 79 6f 75 0a |stem()};| if you.|
|00000610| 6e 65 65 64 20 74 6f 20 | 63 68 61 6e 67 65 20 74 |need to |change t|
|00000620| 68 65 20 65 6e 76 69 72 | 6f 6e 6d 65 6e 74 2c 20 |he envir|onment, |
|00000630| 70 61 73 73 20 5c 63 6f | 64 65 7b 65 6e 76 69 72 |pass \co|de{envir|
|00000640| 6f 6e 7d 20 74 6f 20 5c | 63 6f 64 65 7b 65 78 65 |on} to \|code{exe|
|00000650| 63 76 65 28 29 7d 0a 6f | 72 20 61 64 64 20 76 61 |cve()}.o|r add va|
|00000660| 72 69 61 62 6c 65 20 61 | 73 73 69 67 6e 6d 65 6e |riable a|ssignmen|
|00000670| 74 73 20 61 6e 64 20 65 | 78 70 6f 72 74 20 73 74 |ts and e|xport st|
|00000680| 61 74 65 6d 65 6e 74 73 | 20 74 6f 20 74 68 65 20 |atements| to the |
|00000690| 63 6f 6d 6d 61 6e 64 0a | 73 74 72 69 6e 67 20 66 |command.|string f|
|000006a0| 6f 72 20 5c 63 6f 64 65 | 7b 73 79 73 74 65 6d 28 |or \code|{system(|
|000006b0| 29 7d 20 6f 72 20 5c 63 | 6f 64 65 7b 70 6f 70 65 |)} or \c|ode{pope|
|000006c0| 6e 28 29 7d 2e 25 0a 5c | 66 6f 6f 74 6e 6f 74 65 |n()}.%.\|footnote|
|000006d0| 7b 54 68 65 20 70 72 6f | 62 6c 65 6d 20 77 69 74 |{The pro|blem wit|
|000006e0| 68 20 61 75 74 6f 6d 61 | 74 69 63 61 6c 6c 79 20 |h automa|tically |
|000006f0| 70 61 73 73 69 6e 67 20 | 6f 6e 20 5c 63 6f 64 65 |passing |on \code|
|00000700| 7b 65 6e 76 69 72 6f 6e | 7d 20 69 73 0a 74 68 61 |{environ|} is.tha|
|00000710| 74 20 74 68 65 72 65 20 | 69 73 20 6e 6f 20 70 6f |t there |is no po|
|00000720| 72 74 61 62 6c 65 20 77 | 61 79 20 6f 66 20 63 68 |rtable w|ay of ch|
|00000730| 61 6e 67 69 6e 67 20 74 | 68 65 20 65 6e 76 69 72 |anging t|he envir|
|00000740| 6f 6e 6d 65 6e 74 2e 7d | 0a 5c 65 6e 64 7b 64 61 |onment.}|.\end{da|
|00000750| 74 61 64 65 73 63 7d 0a | 0a 5c 72 65 6e 65 77 63 |tadesc}.|.\renewc|
|00000760| 6f 6d 6d 61 6e 64 7b 5c | 69 6e 64 65 78 73 75 62 |ommand{\|indexsub|
|00000770| 69 74 65 6d 7d 7b 28 65 | 78 63 65 70 74 69 6f 6e |item}{(e|xception|
|00000780| 20 69 6e 20 6d 6f 64 75 | 6c 65 20 70 6f 73 69 78 | in modu|le posix|
|00000790| 29 7d 0a 5c 62 65 67 69 | 6e 7b 65 78 63 64 65 73 |)}.\begi|n{excdes|
|000007a0| 63 7d 7b 65 72 72 6f 72 | 7d 0a 54 68 69 73 20 65 |c}{error|}.This e|
|000007b0| 78 63 65 70 74 69 6f 6e | 20 69 73 20 72 61 69 73 |xception| is rais|
|000007c0| 65 64 20 77 68 65 6e 20 | 61 20 50 4f 53 49 58 20 |ed when |a POSIX |
|000007d0| 66 75 6e 63 74 69 6f 6e | 20 72 65 74 75 72 6e 73 |function| returns|
|000007e0| 20 61 0a 50 4f 53 49 58 | 2d 72 65 6c 61 74 65 64 | a.POSIX|-related|
|000007f0| 20 65 72 72 6f 72 20 28 | 65 2e 67 2e 2c 20 6e 6f | error (|e.g., no|
|00000800| 74 20 66 6f 72 20 69 6c | 6c 65 67 61 6c 20 61 72 |t for il|legal ar|
|00000810| 67 75 6d 65 6e 74 20 74 | 79 70 65 73 29 2e 20 20 |gument t|ypes).  |
|00000820| 49 74 73 0a 73 74 72 69 | 6e 67 20 76 61 6c 75 65 |Its.stri|ng value|
|00000830| 20 69 73 20 5c 63 6f 64 | 65 7b 27 70 6f 73 69 78 | is \cod|e{'posix|
|00000840| 2e 65 72 72 6f 72 27 7d | 2e 20 20 54 68 65 20 61 |.error'}|.  The a|
|00000850| 63 63 6f 6d 70 61 6e 79 | 69 6e 67 20 76 61 6c 75 |ccompany|ing valu|
|00000860| 65 20 69 73 20 61 0a 70 | 61 69 72 20 63 6f 6e 74 |e is a.p|air cont|
|00000870| 61 69 6e 69 6e 67 20 74 | 68 65 20 6e 75 6d 65 72 |aining t|he numer|
|00000880| 69 63 20 65 72 72 6f 72 | 20 63 6f 64 65 20 66 72 |ic error| code fr|
|00000890| 6f 6d 20 5c 63 6f 64 65 | 7b 65 72 72 6e 6f 7d 20 |om \code|{errno} |
|000008a0| 61 6e 64 20 74 68 65 0a | 63 6f 72 72 65 73 70 6f |and the.|correspo|
|000008b0| 6e 64 69 6e 67 20 73 74 | 72 69 6e 67 2c 20 61 73 |nding st|ring, as|
|000008c0| 20 77 6f 75 6c 64 20 62 | 65 20 70 72 69 6e 74 65 | would b|e printe|
|000008d0| 64 20 62 79 20 74 68 65 | 20 43 20 66 75 6e 63 74 |d by the| C funct|
|000008e0| 69 6f 6e 0a 5c 63 6f 64 | 65 7b 70 65 72 72 6f 72 |ion.\cod|e{perror|
|000008f0| 28 29 7d 2e 0a 5c 65 6e | 64 7b 65 78 63 64 65 73 |()}..\en|d{excdes|
|00000900| 63 7d 0a 0a 49 74 20 64 | 65 66 69 6e 65 73 20 74 |c}..It d|efines t|
|00000910| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 66 75 6e |he follo|wing fun|
|00000920| 63 74 69 6f 6e 73 20 61 | 6e 64 20 63 6f 6e 73 74 |ctions a|nd const|
|00000930| 61 6e 74 73 3a 0a 0a 5c | 72 65 6e 65 77 63 6f 6d |ants:..\|renewcom|
|00000940| 6d 61 6e 64 7b 5c 69 6e | 64 65 78 73 75 62 69 74 |mand{\in|dexsubit|
|00000950| 65 6d 7d 7b 28 69 6e 20 | 6d 6f 64 75 6c 65 20 70 |em}{(in |module p|
|00000960| 6f 73 69 78 29 7d 0a 5c | 62 65 67 69 6e 7b 66 75 |osix)}.\|begin{fu|
|00000970| 6e 63 64 65 73 63 7d 7b | 63 68 64 69 72 7d 7b 70 |ncdesc}{|chdir}{p|
|00000980| 61 74 68 7d 0a 43 68 61 | 6e 67 65 20 74 68 65 20 |ath}.Cha|nge the |
|00000990| 63 75 72 72 65 6e 74 20 | 77 6f 72 6b 69 6e 67 20 |current |working |
|000009a0| 64 69 72 65 63 74 6f 72 | 79 20 74 6f 20 5c 76 61 |director|y to \va|
|000009b0| 72 7b 70 61 74 68 7d 2e | 0a 5c 65 6e 64 7b 66 75 |r{path}.|.\end{fu|
|000009c0| 6e 63 64 65 73 63 7d 0a | 0a 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|000009d0| 66 75 6e 63 64 65 73 63 | 7d 7b 63 68 6d 6f 64 7d |funcdesc|}{chmod}|
|000009e0| 7b 70 61 74 68 5c 2c 20 | 6d 6f 64 65 7d 0a 43 68 |{path\, |mode}.Ch|
|000009f0| 61 6e 67 65 20 74 68 65 | 20 6d 6f 64 65 20 6f 66 |ange the| mode of|
|00000a00| 20 5c 76 61 72 7b 70 61 | 74 68 7d 20 74 6f 20 74 | \var{pa|th} to t|
|00000a10| 68 65 20 6e 75 6d 65 72 | 69 63 20 5c 76 61 72 7b |he numer|ic \var{|
|00000a20| 6d 6f 64 65 7d 2e 0a 5c | 65 6e 64 7b 66 75 6e 63 |mode}..\|end{func|
|00000a30| 64 65 73 63 7d 0a 0a 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00000a40| 6e 63 64 65 73 63 7d 7b | 63 68 6f 77 6e 7d 7b 70 |ncdesc}{|chown}{p|
|00000a50| 61 74 68 5c 2c 20 75 69 | 64 2c 20 67 69 64 7d 0a |ath\, ui|d, gid}.|
|00000a60| 43 68 61 6e 67 65 20 74 | 68 65 20 6f 77 6e 65 72 |Change t|he owner|
|00000a70| 20 61 6e 64 20 67 72 6f | 75 70 20 69 64 20 6f 66 | and gro|up id of|
|00000a80| 20 5c 76 61 72 7b 70 61 | 74 68 7d 20 74 6f 20 74 | \var{pa|th} to t|
|00000a90| 68 65 20 6e 75 6d 65 72 | 69 63 20 5c 76 61 72 7b |he numer|ic \var{|
|00000aa0| 75 69 64 7d 0a 61 6e 64 | 20 5c 76 61 72 7b 67 69 |uid}.and| \var{gi|
|00000ab0| 64 7d 2e 0a 28 4e 6f 74 | 20 6f 6e 20 4d 53 2d 44 |d}..(Not| on MS-D|
|00000ac0| 4f 53 2e 29 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |OS.).\en|d{funcde|
|00000ad0| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00000ae0| 64 65 73 63 7d 7b 63 6c | 6f 73 65 7d 7b 66 64 7d |desc}{cl|ose}{fd}|
|00000af0| 0a 43 6c 6f 73 65 20 66 | 69 6c 65 20 64 65 73 63 |.Close f|ile desc|
|00000b00| 72 69 70 74 6f 72 20 5c | 76 61 72 7b 66 64 7d 2e |riptor \|var{fd}.|
|00000b10| 0a 0a 4e 6f 74 65 3a 20 | 74 68 69 73 20 66 75 6e |..Note: |this fun|
|00000b20| 63 74 69 6f 6e 20 69 73 | 20 69 6e 74 65 6e 64 65 |ction is| intende|
|00000b30| 64 20 66 6f 72 20 6c 6f | 77 2d 6c 65 76 65 6c 20 |d for lo|w-level |
|00000b40| 49 2f 4f 20 61 6e 64 20 | 6d 75 73 74 20 62 65 20 |I/O and |must be |
|00000b50| 61 70 70 6c 69 65 64 0a | 74 6f 20 61 20 66 69 6c |applied.|to a fil|
|00000b60| 65 20 64 65 73 63 72 69 | 70 74 6f 72 20 61 73 20 |e descri|ptor as |
|00000b70| 72 65 74 75 72 6e 65 64 | 20 62 79 20 5c 63 6f 64 |returned| by \cod|
|00000b80| 65 7b 70 6f 73 69 78 2e | 6f 70 65 6e 28 29 7d 20 |e{posix.|open()} |
|00000b90| 6f 72 0a 5c 63 6f 64 65 | 7b 70 6f 73 69 78 2e 70 |or.\code|{posix.p|
|00000ba0| 69 70 65 28 29 7d 2e 20 | 20 54 6f 20 63 6c 6f 73 |ipe()}. | To clos|
|00000bb0| 65 20 61 20 60 60 66 69 | 6c 65 20 6f 62 6a 65 63 |e a ``fi|le objec|
|00000bc0| 74 27 27 20 72 65 74 75 | 72 6e 65 64 20 62 79 20 |t'' retu|rned by |
|00000bd0| 74 68 65 0a 62 75 69 6c | 74 2d 69 6e 20 66 75 6e |the.buil|t-in fun|
|00000be0| 63 74 69 6f 6e 20 5c 63 | 6f 64 65 7b 6f 70 65 6e |ction \c|ode{open|
|00000bf0| 7d 20 6f 72 20 62 79 20 | 5c 63 6f 64 65 7b 70 6f |} or by |\code{po|
|00000c00| 73 69 78 2e 70 6f 70 65 | 6e 7d 20 6f 72 0a 5c 63 |six.pope|n} or.\c|
|00000c10| 6f 64 65 7b 70 6f 73 69 | 78 2e 66 64 6f 70 65 6e |ode{posi|x.fdopen|
|00000c20| 7d 2c 20 75 73 65 20 69 | 74 73 20 5c 63 6f 64 65 |}, use i|ts \code|
|00000c30| 7b 63 6c 6f 73 65 28 29 | 7d 20 6d 65 74 68 6f 64 |{close()|} method|
|00000c40| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00000c50| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00000c60| 63 7d 7b 64 75 70 7d 7b | 66 64 7d 0a 52 65 74 75 |c}{dup}{|fd}.Retu|
|00000c70| 72 6e 20 61 20 64 75 70 | 6c 69 63 61 74 65 20 6f |rn a dup|licate o|
|00000c80| 66 20 66 69 6c 65 20 64 | 65 73 63 72 69 70 74 6f |f file d|escripto|
|00000c90| 72 20 5c 76 61 72 7b 66 | 64 7d 2e 0a 5c 65 6e 64 |r \var{f|d}..\end|
|00000ca0| 7b 66 75 6e 63 64 65 73 | 63 7d 0a 0a 5c 62 65 67 |{funcdes|c}..\beg|
|00000cb0| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 64 75 70 |in{funcd|esc}{dup|
|00000cc0| 32 7d 7b 66 64 5c 2c 20 | 66 64 32 7d 0a 44 75 70 |2}{fd\, |fd2}.Dup|
|00000cd0| 6c 69 63 61 74 65 20 66 | 69 6c 65 20 64 65 73 63 |licate f|ile desc|
|00000ce0| 72 69 70 74 6f 72 20 5c | 76 61 72 7b 66 64 7d 20 |riptor \|var{fd} |
|00000cf0| 74 6f 20 5c 76 61 72 7b | 66 64 32 7d 2c 20 63 6c |to \var{|fd2}, cl|
|00000d00| 6f 73 69 6e 67 20 74 68 | 65 20 6c 61 74 74 65 72 |osing th|e latter|
|00000d10| 0a 66 69 72 73 74 20 69 | 66 20 6e 65 63 65 73 73 |.first i|f necess|
|00000d20| 61 72 79 2e 20 20 52 65 | 74 75 72 6e 20 5c 63 6f |ary.  Re|turn \co|
|00000d30| 64 65 7b 4e 6f 6e 65 7d | 2e 0a 5c 65 6e 64 7b 66 |de{None}|..\end{f|
|00000d40| 75 6e 63 64 65 73 63 7d | 0a 0a 5c 62 65 67 69 6e |uncdesc}|..\begin|
|00000d50| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 65 78 65 63 76 |{funcdes|c}{execv|
|00000d60| 7d 7b 70 61 74 68 5c 2c | 20 61 72 67 73 7d 0a 45 |}{path\,| args}.E|
|00000d70| 78 65 63 75 74 65 20 74 | 68 65 20 65 78 65 63 75 |xecute t|he execu|
|00000d80| 74 61 62 6c 65 20 5c 76 | 61 72 7b 70 61 74 68 7d |table \v|ar{path}|
|00000d90| 20 77 69 74 68 20 61 72 | 67 75 6d 65 6e 74 20 6c | with ar|gument l|
|00000da0| 69 73 74 20 5c 76 61 72 | 7b 61 72 67 73 7d 2c 0a |ist \var|{args},.|
|00000db0| 72 65 70 6c 61 63 69 6e | 67 20 74 68 65 20 63 75 |replacin|g the cu|
|00000dc0| 72 72 65 6e 74 20 70 72 | 6f 63 65 73 73 20 28 69 |rrent pr|ocess (i|
|00000dd0| 2e 65 2e 2c 20 74 68 65 | 20 50 79 74 68 6f 6e 20 |.e., the| Python |
|00000de0| 69 6e 74 65 72 70 72 65 | 74 65 72 29 2e 0a 54 68 |interpre|ter)..Th|
|00000df0| 65 20 61 72 67 75 6d 65 | 6e 74 20 6c 69 73 74 20 |e argume|nt list |
|00000e00| 6d 61 79 20 62 65 20 61 | 20 74 75 70 6c 65 20 6f |may be a| tuple o|
|00000e10| 72 20 6c 69 73 74 20 6f | 66 20 73 74 72 69 6e 67 |r list o|f string|
|00000e20| 73 2e 0a 28 4e 6f 74 20 | 6f 6e 20 4d 53 2d 44 4f |s..(Not |on MS-DO|
|00000e30| 53 2e 29 0a 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |S.).\end|{funcdes|
|00000e40| 63 7d 0a 0a 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00000e50| 65 73 63 7d 7b 65 78 65 | 63 76 65 7d 7b 70 61 74 |esc}{exe|cve}{pat|
|00000e60| 68 5c 2c 20 61 72 67 73 | 5c 2c 20 65 6e 76 7d 0a |h\, args|\, env}.|
|00000e70| 45 78 65 63 75 74 65 20 | 74 68 65 20 65 78 65 63 |Execute |the exec|
|00000e80| 75 74 61 62 6c 65 20 5c | 76 61 72 7b 70 61 74 68 |utable \|var{path|
|00000e90| 7d 20 77 69 74 68 20 61 | 72 67 75 6d 65 6e 74 20 |} with a|rgument |
|00000ea0| 6c 69 73 74 20 5c 76 61 | 72 7b 61 72 67 73 7d 2c |list \va|r{args},|
|00000eb0| 0a 61 6e 64 20 65 6e 76 | 69 72 6f 6e 6d 65 6e 74 |.and env|ironment|
|00000ec0| 20 5c 76 61 72 7b 65 6e | 76 7d 2c 0a 72 65 70 6c | \var{en|v},.repl|
|00000ed0| 61 63 69 6e 67 20 74 68 | 65 20 63 75 72 72 65 6e |acing th|e curren|
|00000ee0| 74 20 70 72 6f 63 65 73 | 73 20 28 69 2e 65 2e 2c |t proces|s (i.e.,|
|00000ef0| 20 74 68 65 20 50 79 74 | 68 6f 6e 20 69 6e 74 65 | the Pyt|hon inte|
|00000f00| 72 70 72 65 74 65 72 29 | 2e 0a 54 68 65 20 61 72 |rpreter)|..The ar|
|00000f10| 67 75 6d 65 6e 74 20 6c | 69 73 74 20 6d 61 79 20 |gument l|ist may |
|00000f20| 62 65 20 61 20 74 75 70 | 6c 65 20 6f 72 20 6c 69 |be a tup|le or li|
|00000f30| 73 74 20 6f 66 20 73 74 | 72 69 6e 67 73 2e 0a 54 |st of st|rings..T|
|00000f40| 68 65 20 65 6e 76 69 72 | 6f 6e 6d 65 6e 74 20 6d |he envir|onment m|
|00000f50| 75 73 74 20 62 65 20 61 | 20 64 69 63 74 69 6f 6e |ust be a| diction|
|00000f60| 61 72 79 20 6d 61 70 70 | 69 6e 67 20 73 74 72 69 |ary mapp|ing stri|
|00000f70| 6e 67 73 20 74 6f 20 73 | 74 72 69 6e 67 73 2e 0a |ngs to s|trings..|
|00000f80| 28 4e 6f 74 20 6f 6e 20 | 4d 53 2d 44 4f 53 2e 29 |(Not on |MS-DOS.)|
|00000f90| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|00000fa0| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00000fb0| 7d 7b 5f 65 78 69 74 7d | 7b 6e 7d 0a 45 78 69 74 |}{_exit}|{n}.Exit|
|00000fc0| 20 74 6f 20 74 68 65 20 | 73 79 73 74 65 6d 20 77 | to the |system w|
|00000fd0| 69 74 68 20 73 74 61 74 | 75 73 20 5c 76 61 72 7b |ith stat|us \var{|
|00000fe0| 6e 7d 2c 20 77 69 74 68 | 6f 75 74 20 63 61 6c 6c |n}, with|out call|
|00000ff0| 69 6e 67 20 63 6c 65 61 | 6e 75 70 0a 68 61 6e 64 |ing clea|nup.hand|
|00001000| 6c 65 72 73 2c 20 66 6c | 75 73 68 69 6e 67 20 73 |lers, fl|ushing s|
|00001010| 74 64 69 6f 20 62 75 66 | 66 65 72 73 2c 20 65 74 |tdio buf|fers, et|
|00001020| 63 2e 0a 28 4e 6f 74 20 | 6f 6e 20 4d 53 2d 44 4f |c..(Not |on MS-DO|
|00001030| 53 2e 29 0a 0a 4e 6f 74 | 65 3a 20 74 68 65 20 73 |S.)..Not|e: the s|
|00001040| 74 61 6e 64 61 72 64 20 | 77 61 79 20 74 6f 20 65 |tandard |way to e|
|00001050| 78 69 74 20 69 73 20 5c | 63 6f 64 65 7b 73 79 73 |xit is \|code{sys|
|00001060| 2e 65 78 69 74 28 5c 76 | 61 72 7b 6e 7d 29 7d 2e |.exit(\v|ar{n})}.|
|00001070| 0a 5c 63 6f 64 65 7b 70 | 6f 73 69 78 2e 5f 65 78 |.\code{p|osix._ex|
|00001080| 69 74 28 29 7d 20 73 68 | 6f 75 6c 64 20 6e 6f 72 |it()} sh|ould nor|
|00001090| 6d 61 6c 6c 79 20 6f 6e | 6c 79 20 62 65 20 75 73 |mally on|ly be us|
|000010a0| 65 64 20 69 6e 20 74 68 | 65 20 63 68 69 6c 64 20 |ed in th|e child |
|000010b0| 70 72 6f 63 65 73 73 0a | 61 66 74 65 72 20 61 20 |process.|after a |
|000010c0| 5c 63 6f 64 65 7b 66 6f | 72 6b 28 29 7d 2e 0a 5c |\code{fo|rk()}..\|
|000010d0| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0a 0a 5c |end{func|desc}..\|
|000010e0| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|000010f0| 66 64 6f 70 65 6e 7d 7b | 66 64 5c 6f 70 74 69 6f |fdopen}{|fd\optio|
|00001100| 6e 61 6c 7b 5c 2c 20 6d | 6f 64 65 5c 6f 70 74 69 |nal{\, m|ode\opti|
|00001110| 6f 6e 61 6c 7b 5c 2c 20 | 62 75 66 73 69 7a 65 7d |onal{\, |bufsize}|
|00001120| 7d 7d 0a 52 65 74 75 72 | 6e 20 61 6e 20 6f 70 65 |}}.Retur|n an ope|
|00001130| 6e 20 66 69 6c 65 20 6f | 62 6a 65 63 74 20 63 6f |n file o|bject co|
|00001140| 6e 6e 65 63 74 65 64 20 | 74 6f 20 74 68 65 20 66 |nnected |to the f|
|00001150| 69 6c 65 20 64 65 73 63 | 72 69 70 74 6f 72 20 5c |ile desc|riptor \|
|00001160| 76 61 72 7b 66 64 7d 2e | 0a 54 68 65 20 5c 76 61 |var{fd}.|.The \va|
|00001170| 72 7b 6d 6f 64 65 7d 20 | 61 6e 64 20 5c 76 61 72 |r{mode} |and \var|
|00001180| 7b 62 75 66 73 69 7a 65 | 7d 20 61 72 67 75 6d 65 |{bufsize|} argume|
|00001190| 6e 74 73 20 68 61 76 65 | 20 74 68 65 20 73 61 6d |nts have| the sam|
|000011a0| 65 20 6d 65 61 6e 69 6e | 67 20 61 73 0a 74 68 65 |e meanin|g as.the|
|000011b0| 20 63 6f 72 72 65 73 70 | 6f 6e 64 69 6e 67 20 61 | corresp|onding a|
|000011c0| 72 67 75 6d 65 6e 74 73 | 20 74 6f 20 74 68 65 20 |rguments| to the |
|000011d0| 62 75 69 6c 74 2d 69 6e | 20 5c 63 6f 64 65 7b 6f |built-in| \code{o|
|000011e0| 70 65 6e 28 29 7d 20 66 | 75 6e 63 74 69 6f 6e 2e |pen()} f|unction.|
|000011f0| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|00001200| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00001210| 7d 7b 66 6f 72 6b 7d 7b | 7d 0a 46 6f 72 6b 20 61 |}{fork}{|}.Fork a|
|00001220| 20 63 68 69 6c 64 20 70 | 72 6f 63 65 73 73 2e 20 | child p|rocess. |
|00001230| 20 52 65 74 75 72 6e 20 | 30 20 69 6e 20 74 68 65 | Return |0 in the|
|00001240| 20 63 68 69 6c 64 2c 20 | 74 68 65 20 63 68 69 6c | child, |the chil|
|00001250| 64 27 73 20 70 72 6f 63 | 65 73 73 20 69 64 0a 69 |d's proc|ess id.i|
|00001260| 6e 20 74 68 65 20 70 61 | 72 65 6e 74 2e 0a 28 4e |n the pa|rent..(N|
|00001270| 6f 74 20 6f 6e 20 4d 53 | 2d 44 4f 53 2e 29 0a 5c |ot on MS|-DOS.).\|
|00001280| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0a 0a 5c |end{func|desc}..\|
|00001290| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|000012a0| 66 73 74 61 74 7d 7b 66 | 64 7d 0a 52 65 74 75 72 |fstat}{f|d}.Retur|
|000012b0| 6e 20 73 74 61 74 75 73 | 20 66 6f 72 20 66 69 6c |n status| for fil|
|000012c0| 65 20 64 65 73 63 72 69 | 70 74 6f 72 20 5c 76 61 |e descri|ptor \va|
|000012d0| 72 7b 66 64 7d 2c 20 6c | 69 6b 65 20 5c 63 6f 64 |r{fd}, l|ike \cod|
|000012e0| 65 7b 73 74 61 74 28 29 | 7d 2e 0a 5c 65 6e 64 7b |e{stat()|}..\end{|
|000012f0| 66 75 6e 63 64 65 73 63 | 7d 0a 0a 5c 62 65 67 69 |funcdesc|}..\begi|
|00001300| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 67 65 74 63 |n{funcde|sc}{getc|
|00001310| 77 64 7d 7b 7d 0a 52 65 | 74 75 72 6e 20 61 20 73 |wd}{}.Re|turn a s|
|00001320| 74 72 69 6e 67 20 72 65 | 70 72 65 73 65 6e 74 69 |tring re|presenti|
|00001330| 6e 67 20 74 68 65 20 63 | 75 72 72 65 6e 74 20 77 |ng the c|urrent w|
|00001340| 6f 72 6b 69 6e 67 20 64 | 69 72 65 63 74 6f 72 79 |orking d|irectory|
|00001350| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00001360| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00001370| 63 7d 7b 67 65 74 65 67 | 69 64 7d 7b 7d 0a 52 65 |c}{geteg|id}{}.Re|
|00001380| 74 75 72 6e 20 74 68 65 | 20 63 75 72 72 65 6e 74 |turn the| current|
|00001390| 20 70 72 6f 63 65 73 73 | 27 73 20 65 66 66 65 63 | process|'s effec|
|000013a0| 74 69 76 65 20 67 72 6f | 75 70 20 69 64 2e 0a 28 |tive gro|up id..(|
|000013b0| 4e 6f 74 20 6f 6e 20 4d | 53 2d 44 4f 53 2e 29 0a |Not on M|S-DOS.).|
|000013c0| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0a 0a |\end{fun|cdesc}..|
|000013d0| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|000013e0| 7b 67 65 74 65 75 69 64 | 7d 7b 7d 0a 52 65 74 75 |{geteuid|}{}.Retu|
|000013f0| 72 6e 20 74 68 65 20 63 | 75 72 72 65 6e 74 20 70 |rn the c|urrent p|
|00001400| 72 6f 63 65 73 73 27 73 | 20 65 66 66 65 63 74 69 |rocess's| effecti|
|00001410| 76 65 20 75 73 65 72 20 | 69 64 2e 0a 28 4e 6f 74 |ve user |id..(Not|
|00001420| 20 6f 6e 20 4d 53 2d 44 | 4f 53 2e 29 0a 5c 65 6e | on MS-D|OS.).\en|
|00001430| 64 7b 66 75 6e 63 64 65 | 73 63 7d 0a 0a 5c 62 65 |d{funcde|sc}..\be|
|00001440| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 67 65 |gin{func|desc}{ge|
|00001450| 74 67 69 64 7d 7b 7d 0a | 52 65 74 75 72 6e 20 74 |tgid}{}.|Return t|
|00001460| 68 65 20 63 75 72 72 65 | 6e 74 20 70 72 6f 63 65 |he curre|nt proce|
|00001470| 73 73 27 73 20 67 72 6f | 75 70 20 69 64 2e 0a 28 |ss's gro|up id..(|
|00001480| 4e 6f 74 20 6f 6e 20 4d | 53 2d 44 4f 53 2e 29 0a |Not on M|S-DOS.).|
|00001490| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0a 0a |\end{fun|cdesc}..|
|000014a0| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|000014b0| 7b 67 65 74 70 67 72 70 | 7d 7b 7d 0a 52 65 74 75 |{getpgrp|}{}.Retu|
|000014c0| 72 6e 20 74 68 65 20 63 | 75 72 72 65 6e 74 20 70 |rn the c|urrent p|
|000014d0| 72 6f 63 65 73 73 20 67 | 72 6f 75 70 20 69 64 2e |rocess g|roup id.|
|000014e0| 0a 28 4e 6f 74 20 6f 6e | 20 4d 53 2d 44 4f 53 2e |.(Not on| MS-DOS.|
|000014f0| 29 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |).\end{f|uncdesc}|
|00001500| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00001510| 63 7d 7b 67 65 74 70 69 | 64 7d 7b 7d 0a 52 65 74 |c}{getpi|d}{}.Ret|
|00001520| 75 72 6e 20 74 68 65 20 | 63 75 72 72 65 6e 74 20 |urn the |current |
|00001530| 70 72 6f 63 65 73 73 20 | 69 64 2e 0a 28 4e 6f 74 |process |id..(Not|
|00001540| 20 6f 6e 20 4d 53 2d 44 | 4f 53 2e 29 0a 5c 65 6e | on MS-D|OS.).\en|
|00001550| 64 7b 66 75 6e 63 64 65 | 73 63 7d 0a 0a 5c 62 65 |d{funcde|sc}..\be|
|00001560| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 67 65 |gin{func|desc}{ge|
|00001570| 74 70 70 69 64 7d 7b 7d | 0a 52 65 74 75 72 6e 20 |tppid}{}|.Return |
|00001580| 74 68 65 20 70 61 72 65 | 6e 74 27 73 20 70 72 6f |the pare|nt's pro|
|00001590| 63 65 73 73 20 69 64 2e | 0a 28 4e 6f 74 20 6f 6e |cess id.|.(Not on|
|000015a0| 20 4d 53 2d 44 4f 53 2e | 29 0a 5c 65 6e 64 7b 66 | MS-DOS.|).\end{f|
|000015b0| 75 6e 63 64 65 73 63 7d | 0a 0a 5c 62 65 67 69 6e |uncdesc}|..\begin|
|000015c0| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 67 65 74 75 69 |{funcdes|c}{getui|
|000015d0| 64 7d 7b 7d 0a 52 65 74 | 75 72 6e 20 74 68 65 20 |d}{}.Ret|urn the |
|000015e0| 63 75 72 72 65 6e 74 20 | 70 72 6f 63 65 73 73 27 |current |process'|
|000015f0| 73 20 75 73 65 72 20 69 | 64 2e 0a 28 4e 6f 74 20 |s user i|d..(Not |
|00001600| 6f 6e 20 4d 53 2d 44 4f | 53 2e 29 0a 5c 65 6e 64 |on MS-DO|S.).\end|
|00001610| 7b 66 75 6e 63 64 65 73 | 63 7d 0a 0a 5c 62 65 67 |{funcdes|c}..\beg|
|00001620| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 6b 69 6c |in{funcd|esc}{kil|
|00001630| 6c 7d 7b 70 69 64 5c 2c | 20 73 69 67 7d 0a 4b 69 |l}{pid\,| sig}.Ki|
|00001640| 6c 6c 20 74 68 65 20 70 | 72 6f 63 65 73 73 20 5c |ll the p|rocess \|
|00001650| 76 61 72 7b 70 69 64 7d | 20 77 69 74 68 20 73 69 |var{pid}| with si|
|00001660| 67 6e 61 6c 20 5c 76 61 | 72 7b 73 69 67 7d 2e 0a |gnal \va|r{sig}..|
|00001670| 28 4e 6f 74 20 6f 6e 20 | 4d 53 2d 44 4f 53 2e 29 |(Not on |MS-DOS.)|
|00001680| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|00001690| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|000016a0| 7d 7b 6c 69 6e 6b 7d 7b | 73 72 63 5c 2c 20 64 73 |}{link}{|src\, ds|
|000016b0| 74 7d 0a 43 72 65 61 74 | 65 20 61 20 68 61 72 64 |t}.Creat|e a hard|
|000016c0| 20 6c 69 6e 6b 20 70 6f | 69 6e 74 69 6e 67 20 74 | link po|inting t|
|000016d0| 6f 20 5c 76 61 72 7b 73 | 72 63 7d 20 6e 61 6d 65 |o \var{s|rc} name|
|000016e0| 64 20 5c 76 61 72 7b 64 | 73 74 7d 2e 0a 28 4e 6f |d \var{d|st}..(No|
|000016f0| 74 20 6f 6e 20 4d 53 2d | 44 4f 53 2e 29 0a 5c 65 |t on MS-|DOS.).\e|
|00001700| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 62 |nd{funcd|esc}..\b|
|00001710| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 6c |egin{fun|cdesc}{l|
|00001720| 69 73 74 64 69 72 7d 7b | 70 61 74 68 7d 0a 52 65 |istdir}{|path}.Re|
|00001730| 74 75 72 6e 20 61 20 6c | 69 73 74 20 63 6f 6e 74 |turn a l|ist cont|
|00001740| 61 69 6e 69 6e 67 20 74 | 68 65 20 6e 61 6d 65 73 |aining t|he names|
|00001750| 20 6f 66 20 74 68 65 20 | 65 6e 74 72 69 65 73 20 | of the |entries |
|00001760| 69 6e 20 74 68 65 20 64 | 69 72 65 63 74 6f 72 79 |in the d|irectory|
|00001770| 2e 0a 54 68 65 20 6c 69 | 73 74 20 69 73 20 69 6e |..The li|st is in|
|00001780| 20 61 72 62 69 74 72 61 | 72 79 20 6f 72 64 65 72 | arbitra|ry order|
|00001790| 2e 20 20 49 74 20 64 6f | 65 73 20 6e 6f 74 20 69 |.  It do|es not i|
|000017a0| 6e 63 6c 75 64 65 20 74 | 68 65 20 73 70 65 63 69 |nclude t|he speci|
|000017b0| 61 6c 0a 65 6e 74 72 69 | 65 73 20 5c 63 6f 64 65 |al.entri|es \code|
|000017c0| 7b 27 2e 27 7d 20 61 6e | 64 20 5c 63 6f 64 65 7b |{'.'} an|d \code{|
|000017d0| 27 2e 2e 27 7d 20 65 76 | 65 6e 20 69 66 20 74 68 |'..'} ev|en if th|
|000017e0| 65 79 20 61 72 65 20 70 | 72 65 73 65 6e 74 20 69 |ey are p|resent i|
|000017f0| 6e 20 74 68 65 0a 64 69 | 72 65 63 74 6f 72 79 2e |n the.di|rectory.|
|00001800| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|00001810| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00001820| 7d 7b 6c 73 65 65 6b 7d | 7b 66 64 5c 2c 20 70 6f |}{lseek}|{fd\, po|
|00001830| 73 5c 2c 20 68 6f 77 7d | 0a 53 65 74 20 74 68 65 |s\, how}|.Set the|
|00001840| 20 63 75 72 72 65 6e 74 | 20 70 6f 73 69 74 69 6f | current| positio|
|00001850| 6e 20 6f 66 20 66 69 6c | 65 20 64 65 73 63 72 69 |n of fil|e descri|
|00001860| 70 74 6f 72 20 5c 76 61 | 72 7b 66 64 7d 20 74 6f |ptor \va|r{fd} to|
|00001870| 20 70 6f 73 69 74 69 6f | 6e 0a 5c 76 61 72 7b 70 | positio|n.\var{p|
|00001880| 6f 73 7d 2c 20 6d 6f 64 | 69 66 69 65 64 20 62 79 |os}, mod|ified by|
|00001890| 20 5c 76 61 72 7b 68 6f | 77 7d 3a 20 30 20 74 6f | \var{ho|w}: 0 to|
|000018a0| 20 73 65 74 20 74 68 65 | 20 70 6f 73 69 74 69 6f | set the| positio|
|000018b0| 6e 20 72 65 6c 61 74 69 | 76 65 20 74 6f 0a 74 68 |n relati|ve to.th|
|000018c0| 65 20 62 65 67 69 6e 6e | 69 6e 67 20 6f 66 20 74 |e beginn|ing of t|
|000018d0| 68 65 20 66 69 6c 65 3b | 20 31 20 74 6f 20 73 65 |he file;| 1 to se|
|000018e0| 74 20 69 74 20 72 65 6c | 61 74 69 76 65 20 74 6f |t it rel|ative to|
|000018f0| 20 74 68 65 20 63 75 72 | 72 65 6e 74 0a 70 6f 73 | the cur|rent.pos|
|00001900| 69 74 69 6f 6e 3b 20 32 | 20 74 6f 20 73 65 74 20 |ition; 2| to set |
|00001910| 69 74 20 72 65 6c 61 74 | 69 76 65 20 74 6f 20 74 |it relat|ive to t|
|00001920| 68 65 20 65 6e 64 20 6f | 66 20 74 68 65 20 66 69 |he end o|f the fi|
|00001930| 6c 65 2e 0a 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |le..\end|{funcdes|
|00001940| 63 7d 0a 0a 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00001950| 65 73 63 7d 7b 6c 73 74 | 61 74 7d 7b 70 61 74 68 |esc}{lst|at}{path|
|00001960| 7d 0a 4c 69 6b 65 20 5c | 63 6f 64 65 7b 73 74 61 |}.Like \|code{sta|
|00001970| 74 28 29 7d 2c 20 62 75 | 74 20 64 6f 20 6e 6f 74 |t()}, bu|t do not|
|00001980| 20 66 6f 6c 6c 6f 77 20 | 73 79 6d 62 6f 6c 69 63 | follow |symbolic|
|00001990| 20 6c 69 6e 6b 73 2e 20 | 20 28 4f 6e 20 73 79 73 | links. | (On sys|
|000019a0| 74 65 6d 73 0a 77 69 74 | 68 6f 75 74 20 73 79 6d |tems.wit|hout sym|
|000019b0| 62 6f 6c 69 63 20 6c 69 | 6e 6b 73 2c 20 74 68 69 |bolic li|nks, thi|
|000019c0| 73 20 69 73 20 69 64 65 | 6e 74 69 63 61 6c 20 74 |s is ide|ntical t|
|000019d0| 6f 20 5c 63 6f 64 65 7b | 70 6f 73 69 78 2e 73 74 |o \code{|posix.st|
|000019e0| 61 74 7d 2e 29 0a 5c 65 | 6e 64 7b 66 75 6e 63 64 |at}.).\e|nd{funcd|
|000019f0| 65 73 63 7d 0a 0a 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|00001a00| 63 64 65 73 63 7d 7b 6d | 6b 66 69 66 6f 7d 7b 70 |cdesc}{m|kfifo}{p|
|00001a10| 61 74 68 5c 6f 70 74 69 | 6f 6e 61 6c 7b 5c 2c 20 |ath\opti|onal{\, |
|00001a20| 6d 6f 64 65 7d 7d 0a 43 | 72 65 61 74 65 20 61 20 |mode}}.C|reate a |
|00001a30| 46 49 46 4f 20 28 61 20 | 50 4f 53 49 58 20 6e 61 |FIFO (a |POSIX na|
|00001a40| 6d 65 64 20 70 69 70 65 | 29 20 6e 61 6d 65 64 20 |med pipe|) named |
|00001a50| 5c 76 61 72 7b 70 61 74 | 68 7d 20 77 69 74 68 20 |\var{pat|h} with |
|00001a60| 6e 75 6d 65 72 69 63 20 | 6d 6f 64 65 0a 5c 76 61 |numeric |mode.\va|
|00001a70| 72 7b 6d 6f 64 65 7d 2e | 20 20 54 68 65 20 64 65 |r{mode}.|  The de|
|00001a80| 66 61 75 6c 74 20 5c 76 | 61 72 7b 6d 6f 64 65 7d |fault \v|ar{mode}|
|00001a90| 20 69 73 20 30 36 36 36 | 20 28 6f 63 74 61 6c 29 | is 0666| (octal)|
|00001aa0| 2e 20 20 54 68 65 20 63 | 75 72 72 65 6e 74 0a 75 |.  The c|urrent.u|
|00001ab0| 6d 61 73 6b 20 76 61 6c | 75 65 20 69 73 20 66 69 |mask val|ue is fi|
|00001ac0| 72 73 74 20 6d 61 73 6b | 65 64 20 6f 75 74 20 66 |rst mask|ed out f|
|00001ad0| 72 6f 6d 20 74 68 65 20 | 6d 6f 64 65 2e 0a 28 4e |rom the |mode..(N|
|00001ae0| 6f 74 20 6f 6e 20 4d 53 | 2d 44 4f 53 2e 29 0a 0a |ot on MS|-DOS.)..|
|00001af0| 46 49 46 4f 73 20 61 72 | 65 20 70 69 70 65 73 20 |FIFOs ar|e pipes |
|00001b00| 74 68 61 74 20 63 61 6e | 20 62 65 20 61 63 63 65 |that can| be acce|
|00001b10| 73 73 65 64 20 6c 69 6b | 65 20 72 65 67 75 6c 61 |ssed lik|e regula|
|00001b20| 72 20 66 69 6c 65 73 2e | 20 20 46 49 46 4f 73 20 |r files.|  FIFOs |
|00001b30| 65 78 69 73 74 0a 75 6e | 74 69 6c 20 74 68 65 79 |exist.un|til they|
|00001b40| 20 61 72 65 20 64 65 6c | 65 74 65 64 20 28 66 6f | are del|eted (fo|
|00001b50| 72 20 65 78 61 6d 70 6c | 65 20 77 69 74 68 20 5c |r exampl|e with \|
|00001b60| 63 6f 64 65 7b 6f 73 2e | 75 6e 6c 69 6e 6b 7d 29 |code{os.|unlink})|
|00001b70| 2e 0a 47 65 6e 65 72 61 | 6c 6c 79 2c 20 46 49 46 |..Genera|lly, FIF|
|00001b80| 4f 73 20 61 72 65 20 75 | 73 65 64 20 61 73 20 72 |Os are u|sed as r|
|00001b90| 65 6e 64 65 7a 2d 76 6f | 75 73 20 62 65 74 77 65 |endez-vo|us betwe|
|00001ba0| 65 6e 20 60 60 63 6c 69 | 65 6e 74 27 27 20 61 6e |en ``cli|ent'' an|
|00001bb0| 64 0a 60 60 73 65 72 76 | 65 72 27 27 20 74 79 70 |d.``serv|er'' typ|
|00001bc0| 65 20 70 72 6f 63 65 73 | 73 65 73 3a 20 74 68 65 |e proces|ses: the|
|00001bd0| 20 73 65 72 76 65 72 20 | 6f 70 65 6e 73 20 74 68 | server |opens th|
|00001be0| 65 20 46 49 46 4f 20 66 | 6f 72 20 72 65 61 64 69 |e FIFO f|or readi|
|00001bf0| 6e 67 2c 20 61 6e 64 0a | 74 68 65 20 63 6c 69 65 |ng, and.|the clie|
|00001c00| 6e 74 20 6f 70 65 6e 73 | 20 69 74 20 66 6f 72 20 |nt opens| it for |
|00001c10| 77 72 69 74 69 6e 67 2e | 20 20 4e 6f 74 65 20 74 |writing.|  Note t|
|00001c20| 68 61 74 20 5c 63 6f 64 | 65 7b 6d 6b 66 69 66 6f |hat \cod|e{mkfifo|
|00001c30| 28 29 7d 20 64 6f 65 73 | 6e 27 74 0a 6f 70 65 6e |()} does|n't.open|
|00001c40| 20 74 68 65 20 46 49 46 | 4f 20 2d 2d 20 69 74 20 | the FIF|O -- it |
|00001c50| 6a 75 73 74 20 63 72 65 | 61 74 65 73 20 74 68 65 |just cre|ates the|
|00001c60| 20 72 65 6e 64 65 7a 2d | 76 6f 75 73 20 70 6f 69 | rendez-|vous poi|
|00001c70| 6e 74 2e 0a 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |nt..\end|{funcdes|
|00001c80| 63 7d 0a 0a 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00001c90| 65 73 63 7d 7b 6d 6b 64 | 69 72 7d 7b 70 61 74 68 |esc}{mkd|ir}{path|
|00001ca0| 5c 6f 70 74 69 6f 6e 61 | 6c 7b 5c 2c 20 6d 6f 64 |\optiona|l{\, mod|
|00001cb0| 65 7d 7d 0a 43 72 65 61 | 74 65 20 61 20 64 69 72 |e}}.Crea|te a dir|
|00001cc0| 65 63 74 6f 72 79 20 6e | 61 6d 65 64 20 5c 76 61 |ectory n|amed \va|
|00001cd0| 72 7b 70 61 74 68 7d 20 | 77 69 74 68 20 6e 75 6d |r{path} |with num|
|00001ce0| 65 72 69 63 20 6d 6f 64 | 65 20 5c 76 61 72 7b 6d |eric mod|e \var{m|
|00001cf0| 6f 64 65 7d 2e 0a 54 68 | 65 20 64 65 66 61 75 6c |ode}..Th|e defaul|
|00001d00| 74 20 5c 76 61 72 7b 6d | 6f 64 65 7d 20 69 73 20 |t \var{m|ode} is |
|00001d10| 30 37 37 37 20 28 6f 63 | 74 61 6c 29 2e 20 20 4f |0777 (oc|tal).  O|
|00001d20| 6e 20 73 6f 6d 65 20 73 | 79 73 74 65 6d 73 2c 20 |n some s|ystems, |
|00001d30| 5c 76 61 72 7b 6d 6f 64 | 65 7d 0a 69 73 20 69 67 |\var{mod|e}.is ig|
|00001d40| 6e 6f 72 65 64 2e 20 20 | 57 68 65 72 65 20 69 74 |nored.  |Where it|
|00001d50| 20 69 73 20 75 73 65 64 | 2c 20 74 68 65 20 63 75 | is used|, the cu|
|00001d60| 72 72 65 6e 74 20 75 6d | 61 73 6b 20 76 61 6c 75 |rrent um|ask valu|
|00001d70| 65 20 69 73 20 66 69 72 | 73 74 0a 6d 61 73 6b 65 |e is fir|st.maske|
|00001d80| 64 20 6f 75 74 2e 0a 5c | 65 6e 64 7b 66 75 6e 63 |d out..\|end{func|
|00001d90| 64 65 73 63 7d 0a 0a 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00001da0| 6e 63 64 65 73 63 7d 7b | 6e 69 63 65 7d 7b 69 6e |ncdesc}{|nice}{in|
|00001db0| 63 72 65 6d 65 6e 74 7d | 0a 41 64 64 20 5c 76 61 |crement}|.Add \va|
|00001dc0| 72 7b 69 6e 63 72 7d 20 | 74 6f 20 74 68 65 20 70 |r{incr} |to the p|
|00001dd0| 72 6f 63 65 73 73 27 20 | 60 60 6e 69 63 65 6e 65 |rocess' |``nicene|
|00001de0| 73 73 27 27 2e 20 20 52 | 65 74 75 72 6e 20 74 68 |ss''.  R|eturn th|
|00001df0| 65 20 6e 65 77 20 6e 69 | 63 65 6e 65 73 73 2e 0a |e new ni|ceness..|
|00001e00| 28 4e 6f 74 20 6f 6e 20 | 4d 53 2d 44 4f 53 2e 29 |(Not on |MS-DOS.)|
|00001e10| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|00001e20| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00001e30| 7d 7b 6f 70 65 6e 7d 7b | 66 69 6c 65 5c 2c 20 66 |}{open}{|file\, f|
|00001e40| 6c 61 67 73 5c 2c 20 6d | 6f 64 65 7d 0a 4f 70 65 |lags\, m|ode}.Ope|
|00001e50| 6e 20 74 68 65 20 66 69 | 6c 65 20 5c 76 61 72 7b |n the fi|le \var{|
|00001e60| 66 69 6c 65 7d 20 61 6e | 64 20 73 65 74 20 76 61 |file} an|d set va|
|00001e70| 72 69 6f 75 73 20 66 6c | 61 67 73 20 61 63 63 6f |rious fl|ags acco|
|00001e80| 72 64 69 6e 67 20 74 6f | 0a 5c 76 61 72 7b 66 6c |rding to|.\var{fl|
|00001e90| 61 67 73 7d 20 61 6e 64 | 20 70 6f 73 73 69 62 6c |ags} and| possibl|
|00001ea0| 79 20 69 74 73 20 6d 6f | 64 65 20 61 63 63 6f 72 |y its mo|de accor|
|00001eb0| 64 69 6e 67 20 74 6f 20 | 5c 76 61 72 7b 6d 6f 64 |ding to |\var{mod|
|00001ec0| 65 7d 2e 0a 52 65 74 75 | 72 6e 20 74 68 65 20 66 |e}..Retu|rn the f|
|00001ed0| 69 6c 65 20 64 65 73 63 | 72 69 70 74 6f 72 20 66 |ile desc|riptor f|
|00001ee0| 6f 72 20 74 68 65 20 6e | 65 77 6c 79 20 6f 70 65 |or the n|ewly ope|
|00001ef0| 6e 65 64 20 66 69 6c 65 | 2e 0a 0a 4e 6f 74 65 3a |ned file|...Note:|
|00001f00| 20 74 68 69 73 20 66 75 | 6e 63 74 69 6f 6e 20 69 | this fu|nction i|
|00001f10| 73 20 69 6e 74 65 6e 64 | 65 64 20 66 6f 72 20 6c |s intend|ed for l|
|00001f20| 6f 77 2d 6c 65 76 65 6c | 20 49 2f 4f 2e 20 20 46 |ow-level| I/O.  F|
|00001f30| 6f 72 20 6e 6f 72 6d 61 | 6c 20 75 73 61 67 65 2c |or norma|l usage,|
|00001f40| 0a 75 73 65 20 74 68 65 | 20 62 75 69 6c 74 2d 69 |.use the| built-i|
|00001f50| 6e 20 66 75 6e 63 74 69 | 6f 6e 20 5c 63 6f 64 65 |n functi|on \code|
|00001f60| 7b 6f 70 65 6e 7d 2c 20 | 77 68 69 63 68 20 72 65 |{open}, |which re|
|00001f70| 74 75 72 6e 73 20 61 20 | 60 60 66 69 6c 65 20 6f |turns a |``file o|
|00001f80| 62 6a 65 63 74 27 27 0a | 77 69 74 68 20 5c 63 6f |bject''.|with \co|
|00001f90| 64 65 7b 72 65 61 64 28 | 29 7d 20 61 6e 64 20 20 |de{read(|)} and  |
|00001fa0| 5c 63 6f 64 65 7b 77 72 | 69 74 65 28 29 7d 20 6d |\code{wr|ite()} m|
|00001fb0| 65 74 68 6f 64 73 20 28 | 61 6e 64 20 6d 61 6e 79 |ethods (|and many|
|00001fc0| 20 6d 6f 72 65 29 2e 0a | 5c 65 6e 64 7b 66 75 6e | more)..|\end{fun|
|00001fd0| 63 64 65 73 63 7d 0a 0a | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|00001fe0| 75 6e 63 64 65 73 63 7d | 7b 70 69 70 65 7d 7b 7d |uncdesc}|{pipe}{}|
|00001ff0| 0a 43 72 65 61 74 65 20 | 61 20 70 69 70 65 2e 20 |.Create |a pipe. |
|00002000| 20 52 65 74 75 72 6e 20 | 61 20 70 61 69 72 20 6f | Return |a pair o|
|00002010| 66 20 66 69 6c 65 20 64 | 65 73 63 72 69 70 74 6f |f file d|escripto|
|00002020| 72 73 20 5c 63 6f 64 65 | 7b 28 72 2c 20 77 29 7d |rs \code|{(r, w)}|
|00002030| 0a 75 73 61 62 6c 65 20 | 66 6f 72 20 72 65 61 64 |.usable |for read|
|00002040| 69 6e 67 20 61 6e 64 20 | 77 72 69 74 69 6e 67 2c |ing and |writing,|
|00002050| 20 72 65 73 70 65 63 74 | 69 76 65 6c 79 2e 0a 28 | respect|ively..(|
|00002060| 4e 6f 74 20 6f 6e 20 4d | 53 2d 44 4f 53 2e 29 0a |Not on M|S-DOS.).|
|00002070| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0a 0a |\end{fun|cdesc}..|
|00002080| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00002090| 7b 70 6c 6f 63 6b 7d 7b | 6f 70 7d 0a 4c 6f 63 6b |{plock}{|op}.Lock|
|000020a0| 20 70 72 6f 67 72 61 6d | 20 73 65 67 6d 65 6e 74 | program| segment|
|000020b0| 73 20 69 6e 74 6f 20 6d | 65 6d 6f 72 79 2e 20 20 |s into m|emory.  |
|000020c0| 54 68 65 20 76 61 6c 75 | 65 20 6f 66 20 5c 76 61 |The valu|e of \va|
|000020d0| 72 7b 6f 70 7d 0a 28 64 | 65 66 69 6e 65 64 20 69 |r{op}.(d|efined i|
|000020e0| 6e 20 5c 63 6f 64 65 7b | 3c 73 79 73 2f 6c 6f 63 |n \code{|<sys/loc|
|000020f0| 6b 2e 68 3e 7d 29 20 64 | 65 74 65 72 6d 69 6e 65 |k.h>}) d|etermine|
|00002100| 73 20 77 68 69 63 68 20 | 73 65 67 6d 65 6e 74 73 |s which |segments|
|00002110| 20 61 72 65 20 6c 6f 63 | 6b 65 64 2e 0a 28 4e 6f | are loc|ked..(No|
|00002120| 74 20 6f 6e 20 4d 53 2d | 44 4f 53 2e 29 0a 5c 65 |t on MS-|DOS.).\e|
|00002130| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 62 |nd{funcd|esc}..\b|
|00002140| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 70 |egin{fun|cdesc}{p|
|00002150| 6f 70 65 6e 7d 7b 63 6f | 6d 6d 61 6e 64 5c 6f 70 |open}{co|mmand\op|
|00002160| 74 69 6f 6e 61 6c 7b 5c | 2c 20 6d 6f 64 65 5c 6f |tional{\|, mode\o|
|00002170| 70 74 69 6f 6e 61 6c 7b | 5c 2c 20 62 75 66 73 69 |ptional{|\, bufsi|
|00002180| 7a 65 7d 7d 7d 0a 4f 70 | 65 6e 20 61 20 70 69 70 |ze}}}.Op|en a pip|
|00002190| 65 20 74 6f 20 6f 72 20 | 66 72 6f 6d 20 5c 76 61 |e to or |from \va|
|000021a0| 72 7b 63 6f 6d 6d 61 6e | 64 7d 2e 20 20 54 68 65 |r{comman|d}.  The|
|000021b0| 20 72 65 74 75 72 6e 20 | 76 61 6c 75 65 20 69 73 | return |value is|
|000021c0| 20 61 6e 20 6f 70 65 6e | 0a 66 69 6c 65 20 6f 62 | an open|.file ob|
|000021d0| 6a 65 63 74 20 63 6f 6e | 6e 65 63 74 65 64 20 74 |ject con|nected t|
|000021e0| 6f 20 74 68 65 20 70 69 | 70 65 2c 20 77 68 69 63 |o the pi|pe, whic|
|000021f0| 68 20 63 61 6e 20 62 65 | 20 72 65 61 64 20 6f 72 |h can be| read or|
|00002200| 20 77 72 69 74 74 65 6e | 0a 64 65 70 65 6e 64 69 | written|.dependi|
|00002210| 6e 67 20 6f 6e 20 77 68 | 65 74 68 65 72 20 5c 76 |ng on wh|ether \v|
|00002220| 61 72 7b 6d 6f 64 65 7d | 20 69 73 20 5c 63 6f 64 |ar{mode}| is \cod|
|00002230| 65 7b 27 72 27 7d 20 28 | 64 65 66 61 75 6c 74 29 |e{'r'} (|default)|
|00002240| 20 6f 72 20 5c 63 6f 64 | 65 7b 27 77 27 7d 2e 0a | or \cod|e{'w'}..|
|00002250| 54 68 65 20 5c 76 61 72 | 7b 62 75 66 73 69 7a 65 |The \var|{bufsize|
|00002260| 7d 20 61 72 67 75 6d 65 | 6e 74 20 68 61 73 20 74 |} argume|nt has t|
|00002270| 68 65 20 73 61 6d 65 20 | 6d 65 61 6e 69 6e 67 20 |he same |meaning |
|00002280| 61 73 20 74 68 65 20 63 | 6f 72 72 65 73 70 6f 6e |as the c|orrespon|
|00002290| 64 69 6e 67 0a 61 72 67 | 75 6d 65 6e 74 20 74 6f |ding.arg|ument to|
|000022a0| 20 74 68 65 20 62 75 69 | 6c 74 2d 69 6e 20 5c 63 | the bui|lt-in \c|
|000022b0| 6f 64 65 7b 6f 70 65 6e | 28 29 7d 20 66 75 6e 63 |ode{open|()} func|
|000022c0| 74 69 6f 6e 2e 0a 28 4e | 6f 74 20 6f 6e 20 4d 53 |tion..(N|ot on MS|
|000022d0| 2d 44 4f 53 2e 29 0a 5c | 65 6e 64 7b 66 75 6e 63 |-DOS.).\|end{func|
|000022e0| 64 65 73 63 7d 0a 0a 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|000022f0| 6e 63 64 65 73 63 7d 7b | 72 65 61 64 7d 7b 66 64 |ncdesc}{|read}{fd|
|00002300| 5c 2c 20 6e 7d 0a 52 65 | 61 64 20 61 74 20 6d 6f |\, n}.Re|ad at mo|
|00002310| 73 74 20 5c 76 61 72 7b | 6e 7d 20 62 79 74 65 73 |st \var{|n} bytes|
|00002320| 20 66 72 6f 6d 20 66 69 | 6c 65 20 64 65 73 63 72 | from fi|le descr|
|00002330| 69 70 74 6f 72 20 5c 76 | 61 72 7b 66 64 7d 2e 0a |iptor \v|ar{fd}..|
|00002340| 52 65 74 75 72 6e 20 61 | 20 73 74 72 69 6e 67 20 |Return a| string |
|00002350| 63 6f 6e 74 61 69 6e 69 | 6e 67 20 74 68 65 20 62 |containi|ng the b|
|00002360| 79 74 65 73 20 72 65 61 | 64 2e 0a 0a 4e 6f 74 65 |ytes rea|d...Note|
|00002370| 3a 20 74 68 69 73 20 66 | 75 6e 63 74 69 6f 6e 20 |: this f|unction |
|00002380| 69 73 20 69 6e 74 65 6e | 64 65 64 20 66 6f 72 20 |is inten|ded for |
|00002390| 6c 6f 77 2d 6c 65 76 65 | 6c 20 49 2f 4f 20 61 6e |low-leve|l I/O an|
|000023a0| 64 20 6d 75 73 74 20 62 | 65 20 61 70 70 6c 69 65 |d must b|e applie|
|000023b0| 64 0a 74 6f 20 61 20 66 | 69 6c 65 20 64 65 73 63 |d.to a f|ile desc|
|000023c0| 72 69 70 74 6f 72 20 61 | 73 20 72 65 74 75 72 6e |riptor a|s return|
|000023d0| 65 64 20 62 79 20 5c 63 | 6f 64 65 7b 70 6f 73 69 |ed by \c|ode{posi|
|000023e0| 78 2e 6f 70 65 6e 28 29 | 7d 20 6f 72 0a 5c 63 6f |x.open()|} or.\co|
|000023f0| 64 65 7b 70 6f 73 69 78 | 2e 70 69 70 65 28 29 7d |de{posix|.pipe()}|
|00002400| 2e 20 20 54 6f 20 72 65 | 61 64 20 61 20 60 60 66 |.  To re|ad a ``f|
|00002410| 69 6c 65 20 6f 62 6a 65 | 63 74 27 27 20 72 65 74 |ile obje|ct'' ret|
|00002420| 75 72 6e 65 64 20 62 79 | 20 74 68 65 0a 62 75 69 |urned by| the.bui|
|00002430| 6c 74 2d 69 6e 20 66 75 | 6e 63 74 69 6f 6e 20 5c |lt-in fu|nction \|
|00002440| 63 6f 64 65 7b 6f 70 65 | 6e 7d 20 6f 72 20 62 79 |code{ope|n} or by|
|00002450| 20 5c 63 6f 64 65 7b 70 | 6f 73 69 78 2e 70 6f 70 | \code{p|osix.pop|
|00002460| 65 6e 7d 20 6f 72 0a 5c | 63 6f 64 65 7b 70 6f 73 |en} or.\|code{pos|
|00002470| 69 78 2e 66 64 6f 70 65 | 6e 7d 2c 20 6f 72 20 5c |ix.fdope|n}, or \|
|00002480| 63 6f 64 65 7b 73 79 73 | 2e 73 74 64 69 6e 7d 2c |code{sys|.stdin},|
|00002490| 20 75 73 65 20 69 74 73 | 0a 5c 63 6f 64 65 7b 72 | use its|.\code{r|
|000024a0| 65 61 64 28 29 7d 20 6f | 72 20 5c 63 6f 64 65 7b |ead()} o|r \code{|
|000024b0| 72 65 61 64 6c 69 6e 65 | 28 29 7d 20 6d 65 74 68 |readline|()} meth|
|000024c0| 6f 64 73 2e 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |ods..\en|d{funcde|
|000024d0| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|000024e0| 64 65 73 63 7d 7b 72 65 | 61 64 6c 69 6e 6b 7d 7b |desc}{re|adlink}{|
|000024f0| 70 61 74 68 7d 0a 52 65 | 74 75 72 6e 20 61 20 73 |path}.Re|turn a s|
|00002500| 74 72 69 6e 67 20 72 65 | 70 72 65 73 65 6e 74 69 |tring re|presenti|
|00002510| 6e 67 20 74 68 65 20 70 | 61 74 68 20 74 6f 20 77 |ng the p|ath to w|
|00002520| 68 69 63 68 20 74 68 65 | 20 73 79 6d 62 6f 6c 69 |hich the| symboli|
|00002530| 63 20 6c 69 6e 6b 0a 70 | 6f 69 6e 74 73 2e 20 20 |c link.p|oints.  |
|00002540| 28 4f 6e 20 73 79 73 74 | 65 6d 73 20 77 69 74 68 |(On syst|ems with|
|00002550| 6f 75 74 20 73 79 6d 62 | 6f 6c 69 63 20 6c 69 6e |out symb|olic lin|
|00002560| 6b 73 2c 20 74 68 69 73 | 20 61 6c 77 61 79 73 20 |ks, this| always |
|00002570| 72 61 69 73 65 73 0a 5c | 63 6f 64 65 7b 70 6f 73 |raises.\|code{pos|
|00002580| 69 78 2e 65 72 72 6f 72 | 7d 2e 29 0a 5c 65 6e 64 |ix.error|}.).\end|
|00002590| 7b 66 75 6e 63 64 65 73 | 63 7d 0a 0a 5c 62 65 67 |{funcdes|c}..\beg|
|000025a0| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 72 65 6d |in{funcd|esc}{rem|
|000025b0| 6f 76 65 7d 7b 70 61 74 | 68 7d 0a 52 65 6d 6f 76 |ove}{pat|h}.Remov|
|000025c0| 65 20 74 68 65 20 66 69 | 6c 65 20 5c 76 61 72 7b |e the fi|le \var{|
|000025d0| 70 61 74 68 7d 2e 20 20 | 53 65 65 20 5c 63 6f 64 |path}.  |See \cod|
|000025e0| 65 7b 72 6d 64 69 72 7d | 20 62 65 6c 6f 77 20 74 |e{rmdir}| below t|
|000025f0| 6f 20 72 65 6d 6f 76 65 | 20 61 20 64 69 72 65 63 |o remove| a direc|
|00002600| 74 6f 72 79 2e 0a 5c 65 | 6e 64 7b 66 75 6e 63 64 |tory..\e|nd{funcd|
|00002610| 65 73 63 7d 0a 0a 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|00002620| 63 64 65 73 63 7d 7b 72 | 65 6e 61 6d 65 7d 7b 73 |cdesc}{r|ename}{s|
|00002630| 72 63 5c 2c 20 64 73 74 | 7d 0a 52 65 6e 61 6d 65 |rc\, dst|}.Rename|
|00002640| 20 74 68 65 20 66 69 6c | 65 20 6f 72 20 64 69 72 | the fil|e or dir|
|00002650| 65 63 74 6f 72 79 20 5c | 76 61 72 7b 73 72 63 7d |ectory \|var{src}|
|00002660| 20 74 6f 20 5c 76 61 72 | 7b 64 73 74 7d 2e 0a 5c | to \var|{dst}..\|
|00002670| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0a 0a 5c |end{func|desc}..\|
|00002680| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00002690| 72 6d 64 69 72 7d 7b 70 | 61 74 68 7d 0a 52 65 6d |rmdir}{p|ath}.Rem|
|000026a0| 6f 76 65 20 74 68 65 20 | 64 69 72 65 63 74 6f 72 |ove the |director|
|000026b0| 79 20 5c 76 61 72 7b 70 | 61 74 68 7d 2e 0a 5c 65 |y \var{p|ath}..\e|
|000026c0| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 62 |nd{funcd|esc}..\b|
|000026d0| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 73 |egin{fun|cdesc}{s|
|000026e0| 65 74 67 69 64 7d 7b 67 | 69 64 7d 0a 53 65 74 20 |etgid}{g|id}.Set |
|000026f0| 74 68 65 20 63 75 72 72 | 65 6e 74 20 70 72 6f 63 |the curr|ent proc|
|00002700| 65 73 73 27 73 20 67 72 | 6f 75 70 20 69 64 2e 0a |ess's gr|oup id..|
|00002710| 28 4e 6f 74 20 6f 6e 20 | 4d 53 2d 44 4f 53 2e 29 |(Not on |MS-DOS.)|
|00002720| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|00002730| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00002740| 7d 7b 73 65 74 70 67 72 | 70 7d 7b 7d 0a 43 61 6c |}{setpgr|p}{}.Cal|
|00002750| 6c 73 20 74 68 65 20 73 | 79 73 74 65 6d 20 63 61 |ls the s|ystem ca|
|00002760| 6c 6c 20 5c 63 6f 64 65 | 7b 73 65 74 70 67 72 70 |ll \code|{setpgrp|
|00002770| 28 29 7d 20 6f 72 20 5c | 63 6f 64 65 7b 73 65 74 |()} or \|code{set|
|00002780| 70 67 72 70 28 30 2c 20 | 30 29 7d 0a 64 65 70 65 |pgrp(0, |0)}.depe|
|00002790| 6e 64 69 6e 67 20 6f 6e | 20 77 68 69 63 68 20 76 |nding on| which v|
|000027a0| 65 72 73 69 6f 6e 20 69 | 73 20 69 6d 70 6c 65 6d |ersion i|s implem|
|000027b0| 65 6e 74 65 64 20 28 69 | 66 20 61 6e 79 29 2e 20 |ented (i|f any). |
|000027c0| 20 53 65 65 20 74 68 65 | 20 7b 5c 55 4e 49 58 7d | See the| {\UNIX}|
|000027d0| 0a 6d 61 6e 75 61 6c 20 | 66 6f 72 20 74 68 65 20 |.manual |for the |
|000027e0| 73 65 6d 61 6e 74 69 63 | 73 2e 0a 28 4e 6f 74 20 |semantic|s..(Not |
|000027f0| 6f 6e 20 4d 53 2d 44 4f | 53 2e 29 0a 5c 65 6e 64 |on MS-DO|S.).\end|
|00002800| 7b 66 75 6e 63 64 65 73 | 63 7d 0a 0a 5c 62 65 67 |{funcdes|c}..\beg|
|00002810| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 73 65 74 |in{funcd|esc}{set|
|00002820| 70 67 69 64 7d 7b 70 69 | 64 5c 2c 20 70 67 72 70 |pgid}{pi|d\, pgrp|
|00002830| 7d 0a 43 61 6c 6c 73 20 | 74 68 65 20 73 79 73 74 |}.Calls |the syst|
|00002840| 65 6d 20 63 61 6c 6c 20 | 5c 63 6f 64 65 7b 73 65 |em call |\code{se|
|00002850| 74 70 67 69 64 28 29 7d | 2e 20 20 53 65 65 20 74 |tpgid()}|.  See t|
|00002860| 68 65 20 7b 5c 55 4e 49 | 58 7d 20 6d 61 6e 75 61 |he {\UNI|X} manua|
|00002870| 6c 20 66 6f 72 0a 74 68 | 65 20 73 65 6d 61 6e 74 |l for.th|e semant|
|00002880| 69 63 73 2e 0a 28 4e 6f | 74 20 6f 6e 20 4d 53 2d |ics..(No|t on MS-|
|00002890| 44 4f 53 2e 29 0a 5c 65 | 6e 64 7b 66 75 6e 63 64 |DOS.).\e|nd{funcd|
|000028a0| 65 73 63 7d 0a 0a 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|000028b0| 63 64 65 73 63 7d 7b 73 | 65 74 73 69 64 7d 7b 7d |cdesc}{s|etsid}{}|
|000028c0| 0a 43 61 6c 6c 73 20 74 | 68 65 20 73 79 73 74 65 |.Calls t|he syste|
|000028d0| 6d 20 63 61 6c 6c 20 5c | 63 6f 64 65 7b 73 65 74 |m call \|code{set|
|000028e0| 73 69 64 28 29 7d 2e 20 | 20 53 65 65 20 74 68 65 |sid()}. | See the|
|000028f0| 20 7b 5c 55 4e 49 58 7d | 20 6d 61 6e 75 61 6c 20 | {\UNIX}| manual |
|00002900| 66 6f 72 20 74 68 65 0a | 73 65 6d 61 6e 74 69 63 |for the.|semantic|
|00002910| 73 2e 0a 28 4e 6f 74 20 | 6f 6e 20 4d 53 2d 44 4f |s..(Not |on MS-DO|
|00002920| 53 2e 29 0a 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |S.).\end|{funcdes|
|00002930| 63 7d 0a 0a 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00002940| 65 73 63 7d 7b 73 65 74 | 75 69 64 7d 7b 75 69 64 |esc}{set|uid}{uid|
|00002950| 7d 0a 53 65 74 20 74 68 | 65 20 63 75 72 72 65 6e |}.Set th|e curren|
|00002960| 74 20 70 72 6f 63 65 73 | 73 27 73 20 75 73 65 72 |t proces|s's user|
|00002970| 20 69 64 2e 0a 28 4e 6f | 74 20 6f 6e 20 4d 53 2d | id..(No|t on MS-|
|00002980| 44 4f 53 2e 29 0a 5c 65 | 6e 64 7b 66 75 6e 63 64 |DOS.).\e|nd{funcd|
|00002990| 65 73 63 7d 0a 0a 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|000029a0| 63 64 65 73 63 7d 7b 73 | 74 61 74 7d 7b 70 61 74 |cdesc}{s|tat}{pat|
|000029b0| 68 7d 0a 50 65 72 66 6f | 72 6d 20 61 20 7b 5c 65 |h}.Perfo|rm a {\e|
|000029c0| 6d 20 73 74 61 74 7d 20 | 73 79 73 74 65 6d 20 63 |m stat} |system c|
|000029d0| 61 6c 6c 20 6f 6e 20 74 | 68 65 20 67 69 76 65 6e |all on t|he given|
|000029e0| 20 70 61 74 68 2e 20 20 | 54 68 65 20 72 65 74 75 | path.  |The retu|
|000029f0| 72 6e 20 76 61 6c 75 65 | 0a 69 73 20 61 20 74 75 |rn value|.is a tu|
|00002a00| 70 6c 65 20 6f 66 20 61 | 74 20 6c 65 61 73 74 20 |ple of a|t least |
|00002a10| 31 30 20 69 6e 74 65 67 | 65 72 73 20 67 69 76 69 |10 integ|ers givi|
|00002a20| 6e 67 20 74 68 65 20 6d | 6f 73 74 20 69 6d 70 6f |ng the m|ost impo|
|00002a30| 72 74 61 6e 74 20 28 61 | 6e 64 0a 70 6f 72 74 61 |rtant (a|nd.porta|
|00002a40| 62 6c 65 29 20 6d 65 6d | 62 65 72 73 20 6f 66 20 |ble) mem|bers of |
|00002a50| 74 68 65 20 7b 5c 65 6d | 20 73 74 61 74 7d 20 73 |the {\em| stat} s|
|00002a60| 74 72 75 63 74 75 72 65 | 2c 20 69 6e 20 74 68 65 |tructure|, in the|
|00002a70| 20 6f 72 64 65 72 0a 5c | 63 6f 64 65 7b 73 74 5f | order.\|code{st_|
|00002a80| 6d 6f 64 65 7d 2c 0a 5c | 63 6f 64 65 7b 73 74 5f |mode},.\|code{st_|
|00002a90| 69 6e 6f 7d 2c 0a 5c 63 | 6f 64 65 7b 73 74 5f 64 |ino},.\c|ode{st_d|
|00002aa0| 65 76 7d 2c 0a 5c 63 6f | 64 65 7b 73 74 5f 6e 6c |ev},.\co|de{st_nl|
|00002ab0| 69 6e 6b 7d 2c 0a 5c 63 | 6f 64 65 7b 73 74 5f 75 |ink},.\c|ode{st_u|
|00002ac0| 69 64 7d 2c 0a 5c 63 6f | 64 65 7b 73 74 5f 67 69 |id},.\co|de{st_gi|
|00002ad0| 64 7d 2c 0a 5c 63 6f 64 | 65 7b 73 74 5f 73 69 7a |d},.\cod|e{st_siz|
|00002ae0| 65 7d 2c 0a 5c 63 6f 64 | 65 7b 73 74 5f 61 74 69 |e},.\cod|e{st_ati|
|00002af0| 6d 65 7d 2c 0a 5c 63 6f | 64 65 7b 73 74 5f 6d 74 |me},.\co|de{st_mt|
|00002b00| 69 6d 65 7d 2c 0a 5c 63 | 6f 64 65 7b 73 74 5f 63 |ime},.\c|ode{st_c|
|00002b10| 74 69 6d 65 7d 2e 0a 4d | 6f 72 65 20 69 74 65 6d |time}..M|ore item|
|00002b20| 73 20 6d 61 79 20 62 65 | 20 61 64 64 65 64 20 61 |s may be| added a|
|00002b30| 74 20 74 68 65 20 65 6e | 64 20 62 79 20 73 6f 6d |t the en|d by som|
|00002b40| 65 20 69 6d 70 6c 65 6d | 65 6e 74 61 74 69 6f 6e |e implem|entation|
|00002b50| 73 2e 0a 28 4f 6e 20 4d | 53 2d 44 4f 53 2c 20 73 |s..(On M|S-DOS, s|
|00002b60| 6f 6d 65 20 69 74 65 6d | 73 20 61 72 65 20 66 69 |ome item|s are fi|
|00002b70| 6c 6c 65 64 20 77 69 74 | 68 20 64 75 6d 6d 79 20 |lled wit|h dummy |
|00002b80| 76 61 6c 75 65 73 2e 29 | 0a 0a 4e 6f 74 65 3a 20 |values.)|..Note: |
|00002b90| 54 68 65 20 73 74 61 6e | 64 61 72 64 20 6d 6f 64 |The stan|dard mod|
|00002ba0| 75 6c 65 20 5c 63 6f 64 | 65 7b 73 74 61 74 7d 20 |ule \cod|e{stat} |
|00002bb0| 64 65 66 69 6e 65 73 20 | 66 75 6e 63 74 69 6f 6e |defines |function|
|00002bc0| 73 20 61 6e 64 20 63 6f | 6e 73 74 61 6e 74 73 0a |s and co|nstants.|
|00002bd0| 74 68 61 74 20 61 72 65 | 20 75 73 65 66 75 6c 20 |that are| useful |
|00002be0| 66 6f 72 20 65 78 74 72 | 61 63 74 69 6e 67 20 69 |for extr|acting i|
|00002bf0| 6e 66 6f 72 6d 61 74 69 | 6f 6e 20 66 72 6f 6d 20 |nformati|on from |
|00002c00| 61 20 73 74 61 74 20 73 | 74 72 75 63 74 75 72 65 |a stat s|tructure|
|00002c10| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00002c20| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00002c30| 63 7d 7b 73 79 6d 6c 69 | 6e 6b 7d 7b 73 72 63 5c |c}{symli|nk}{src\|
|00002c40| 2c 20 64 73 74 7d 0a 43 | 72 65 61 74 65 20 61 20 |, dst}.C|reate a |
|00002c50| 73 79 6d 62 6f 6c 69 63 | 20 6c 69 6e 6b 20 70 6f |symbolic| link po|
|00002c60| 69 6e 74 69 6e 67 20 74 | 6f 20 5c 76 61 72 7b 73 |inting t|o \var{s|
|00002c70| 72 63 7d 20 6e 61 6d 65 | 64 20 5c 76 61 72 7b 64 |rc} name|d \var{d|
|00002c80| 73 74 7d 2e 20 20 28 4f | 6e 0a 73 79 73 74 65 6d |st}.  (O|n.system|
|00002c90| 73 20 77 69 74 68 6f 75 | 74 20 73 79 6d 62 6f 6c |s withou|t symbol|
|00002ca0| 69 63 20 6c 69 6e 6b 73 | 2c 20 74 68 69 73 20 61 |ic links|, this a|
|00002cb0| 6c 77 61 79 73 20 72 61 | 69 73 65 73 0a 5c 63 6f |lways ra|ises.\co|
|00002cc0| 64 65 7b 70 6f 73 69 78 | 2e 65 72 72 6f 72 7d 2e |de{posix|.error}.|
|00002cd0| 29 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |).\end{f|uncdesc}|
|00002ce0| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00002cf0| 63 7d 7b 73 79 73 74 65 | 6d 7d 7b 63 6f 6d 6d 61 |c}{syste|m}{comma|
|00002d00| 6e 64 7d 0a 45 78 65 63 | 75 74 65 20 74 68 65 20 |nd}.Exec|ute the |
|00002d10| 63 6f 6d 6d 61 6e 64 20 | 28 61 20 73 74 72 69 6e |command |(a strin|
|00002d20| 67 29 20 69 6e 20 61 20 | 73 75 62 73 68 65 6c 6c |g) in a |subshell|
|00002d30| 2e 20 20 54 68 69 73 20 | 69 73 20 69 6d 70 6c 65 |.  This |is imple|
|00002d40| 6d 65 6e 74 65 64 20 62 | 79 0a 63 61 6c 6c 69 6e |mented b|y.callin|
|00002d50| 67 20 74 68 65 20 53 74 | 61 6e 64 61 72 64 20 43 |g the St|andard C|
|00002d60| 20 66 75 6e 63 74 69 6f | 6e 20 5c 63 6f 64 65 7b | functio|n \code{|
|00002d70| 73 79 73 74 65 6d 28 29 | 7d 2c 20 61 6e 64 20 68 |system()|}, and h|
|00002d80| 61 73 20 74 68 65 20 73 | 61 6d 65 0a 6c 69 6d 69 |as the s|ame.limi|
|00002d90| 74 61 74 69 6f 6e 73 2e | 20 20 43 68 61 6e 67 65 |tations.|  Change|
|00002da0| 73 20 74 6f 20 5c 63 6f | 64 65 7b 70 6f 73 69 78 |s to \co|de{posix|
|00002db0| 2e 65 6e 76 69 72 6f 6e | 7d 2c 20 5c 63 6f 64 65 |.environ|}, \code|
|00002dc0| 7b 73 79 73 2e 73 74 64 | 69 6e 7d 20 65 74 63 2e |{sys.std|in} etc.|
|00002dd0| 5c 20 61 72 65 0a 6e 6f | 74 20 72 65 66 6c 65 63 |\ are.no|t reflec|
|00002de0| 74 65 64 20 69 6e 20 74 | 68 65 20 65 6e 76 69 72 |ted in t|he envir|
|00002df0| 6f 6e 6d 65 6e 74 20 6f | 66 20 74 68 65 20 65 78 |onment o|f the ex|
|00002e00| 65 63 75 74 65 64 20 63 | 6f 6d 6d 61 6e 64 2e 20 |ecuted c|ommand. |
|00002e10| 20 54 68 65 20 72 65 74 | 75 72 6e 0a 76 61 6c 75 | The ret|urn.valu|
|00002e20| 65 20 69 73 20 74 68 65 | 20 65 78 69 74 20 73 74 |e is the| exit st|
|00002e30| 61 74 75 73 20 6f 66 20 | 74 68 65 20 70 72 6f 63 |atus of |the proc|
|00002e40| 65 73 73 20 61 73 20 72 | 65 74 75 72 6e 65 64 20 |ess as r|eturned |
|00002e50| 62 79 20 53 74 61 6e 64 | 61 72 64 20 43 0a 5c 63 |by Stand|ard C.\c|
|00002e60| 6f 64 65 7b 73 79 73 74 | 65 6d 28 29 7d 2e 0a 5c |ode{syst|em()}..\|
|00002e70| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0a 0a 5c |end{func|desc}..\|
|00002e80| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00002e90| 74 63 67 65 74 70 67 72 | 70 7d 7b 66 64 7d 0a 52 |tcgetpgr|p}{fd}.R|
|00002ea0| 65 74 75 72 6e 20 74 68 | 65 20 70 72 6f 63 65 73 |eturn th|e proces|
|00002eb0| 73 20 67 72 6f 75 70 20 | 61 73 73 6f 63 69 61 74 |s group |associat|
|00002ec0| 65 64 20 77 69 74 68 20 | 74 68 65 20 74 65 72 6d |ed with |the term|
|00002ed0| 69 6e 61 6c 20 67 69 76 | 65 6e 20 62 79 0a 5c 76 |inal giv|en by.\v|
|00002ee0| 61 72 7b 66 64 7d 20 28 | 61 6e 20 6f 70 65 6e 20 |ar{fd} (|an open |
|00002ef0| 66 69 6c 65 20 64 65 73 | 63 72 69 70 74 6f 72 20 |file des|criptor |
|00002f00| 61 73 20 72 65 74 75 72 | 6e 65 64 20 62 79 20 5c |as retur|ned by \|
|00002f10| 63 6f 64 65 7b 70 6f 73 | 69 78 2e 6f 70 65 6e 28 |code{pos|ix.open(|
|00002f20| 29 7d 29 2e 0a 28 4e 6f | 74 20 6f 6e 20 4d 53 2d |)})..(No|t on MS-|
|00002f30| 44 4f 53 2e 29 0a 5c 65 | 6e 64 7b 66 75 6e 63 64 |DOS.).\e|nd{funcd|
|00002f40| 65 73 63 7d 0a 0a 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|00002f50| 63 64 65 73 63 7d 7b 74 | 63 73 65 74 70 67 72 70 |cdesc}{t|csetpgrp|
|00002f60| 7d 7b 66 64 5c 2c 20 70 | 67 7d 0a 53 65 74 20 74 |}{fd\, p|g}.Set t|
|00002f70| 68 65 20 70 72 6f 63 65 | 73 73 20 67 72 6f 75 70 |he proce|ss group|
|00002f80| 20 61 73 73 6f 63 69 61 | 74 65 64 20 77 69 74 68 | associa|ted with|
|00002f90| 20 74 68 65 20 74 65 72 | 6d 69 6e 61 6c 20 67 69 | the ter|minal gi|
|00002fa0| 76 65 6e 20 62 79 0a 5c | 76 61 72 7b 66 64 7d 20 |ven by.\|var{fd} |
|00002fb0| 28 61 6e 20 6f 70 65 6e | 20 66 69 6c 65 20 64 65 |(an open| file de|
|00002fc0| 73 63 72 69 70 74 6f 72 | 20 61 73 20 72 65 74 75 |scriptor| as retu|
|00002fd0| 72 6e 65 64 20 62 79 20 | 5c 63 6f 64 65 7b 70 6f |rned by |\code{po|
|00002fe0| 73 69 78 2e 6f 70 65 6e | 28 29 7d 29 0a 74 6f 20 |six.open|()}).to |
|00002ff0| 5c 76 61 72 7b 70 67 7d | 2e 0a 28 4e 6f 74 20 6f |\var{pg}|..(Not o|
|00003000| 6e 20 4d 53 2d 44 4f 53 | 2e 29 0a 5c 65 6e 64 7b |n MS-DOS|.).\end{|
|00003010| 66 75 6e 63 64 65 73 63 | 7d 0a 0a 5c 62 65 67 69 |funcdesc|}..\begi|
|00003020| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 74 69 6d 65 |n{funcde|sc}{time|
|00003030| 73 7d 7b 7d 0a 52 65 74 | 75 72 6e 20 61 20 35 2d |s}{}.Ret|urn a 5-|
|00003040| 74 75 70 6c 65 20 6f 66 | 20 66 6c 6f 61 74 69 6e |tuple of| floatin|
|00003050| 67 20 70 6f 69 6e 74 20 | 6e 75 6d 62 65 72 73 20 |g point |numbers |
|00003060| 69 6e 64 69 63 61 74 69 | 6e 67 20 61 63 63 75 6d |indicati|ng accum|
|00003070| 75 6c 61 74 65 64 20 28 | 43 50 55 0a 6f 72 20 6f |ulated (|CPU.or o|
|00003080| 74 68 65 72 29 0a 74 69 | 6d 65 73 2c 20 69 6e 20 |ther).ti|mes, in |
|00003090| 73 65 63 6f 6e 64 73 2e | 20 20 54 68 65 20 69 74 |seconds.|  The it|
|000030a0| 65 6d 73 20 61 72 65 3a | 20 75 73 65 72 20 74 69 |ems are:| user ti|
|000030b0| 6d 65 2c 20 73 79 73 74 | 65 6d 20 74 69 6d 65 2c |me, syst|em time,|
|000030c0| 20 63 68 69 6c 64 72 65 | 6e 27 73 0a 75 73 65 72 | childre|n's.user|
|000030d0| 20 74 69 6d 65 2c 20 63 | 68 69 6c 64 72 65 6e 27 | time, c|hildren'|
|000030e0| 73 20 73 79 73 74 65 6d | 20 74 69 6d 65 2c 20 61 |s system| time, a|
|000030f0| 6e 64 20 65 6c 61 70 73 | 65 64 20 72 65 61 6c 20 |nd elaps|ed real |
|00003100| 74 69 6d 65 20 73 69 6e | 63 65 20 61 20 66 69 78 |time sin|ce a fix|
|00003110| 65 64 0a 70 6f 69 6e 74 | 20 69 6e 20 74 68 65 20 |ed.point| in the |
|00003120| 70 61 73 74 2c 20 69 6e | 20 74 68 61 74 20 6f 72 |past, in| that or|
|00003130| 64 65 72 2e 20 20 53 65 | 65 20 74 68 65 20 5c 55 |der.  Se|e the \U|
|00003140| 4e 49 58 7b 7d 0a 6d 61 | 6e 75 61 6c 20 70 61 67 |NIX{}.ma|nual pag|
|00003150| 65 20 7b 5c 69 74 20 74 | 69 6d 65 73 7d 28 32 29 |e {\it t|imes}(2)|
|00003160| 2e 20 20 28 4e 6f 74 20 | 6f 6e 20 4d 53 2d 44 4f |.  (Not |on MS-DO|
|00003170| 53 2e 29 0a 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |S.).\end|{funcdes|
|00003180| 63 7d 0a 0a 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00003190| 65 73 63 7d 7b 75 6d 61 | 73 6b 7d 7b 6d 61 73 6b |esc}{uma|sk}{mask|
|000031a0| 7d 0a 53 65 74 20 74 68 | 65 20 63 75 72 72 65 6e |}.Set th|e curren|
|000031b0| 74 20 6e 75 6d 65 72 69 | 63 20 75 6d 61 73 6b 20 |t numeri|c umask |
|000031c0| 61 6e 64 20 72 65 74 75 | 72 6e 73 20 74 68 65 20 |and retu|rns the |
|000031d0| 70 72 65 76 69 6f 75 73 | 20 75 6d 61 73 6b 2e 0a |previous| umask..|
|000031e0| 28 4e 6f 74 20 6f 6e 20 | 4d 53 2d 44 4f 53 2e 29 |(Not on |MS-DOS.)|
|000031f0| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|00003200| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00003210| 7d 7b 75 6e 61 6d 65 7d | 7b 7d 0a 52 65 74 75 72 |}{uname}|{}.Retur|
|00003220| 6e 20 61 20 35 2d 74 75 | 70 6c 65 20 63 6f 6e 74 |n a 5-tu|ple cont|
|00003230| 61 69 6e 69 6e 67 20 69 | 6e 66 6f 72 6d 61 74 69 |aining i|nformati|
|00003240| 6f 6e 20 69 64 65 6e 74 | 69 66 79 69 6e 67 20 74 |on ident|ifying t|
|00003250| 68 65 20 63 75 72 72 65 | 6e 74 0a 6f 70 65 72 61 |he curre|nt.opera|
|00003260| 74 69 6e 67 20 73 79 73 | 74 65 6d 2e 20 20 54 68 |ting sys|tem.  Th|
|00003270| 65 20 74 75 70 6c 65 20 | 63 6f 6e 74 61 69 6e 73 |e tuple |contains|
|00003280| 20 35 20 73 74 72 69 6e | 67 73 3a 0a 5c 63 6f 64 | 5 strin|gs:.\cod|
|00003290| 65 7b 28 5c 76 61 72 7b | 73 79 73 6e 61 6d 65 7d |e{(\var{|sysname}|
|000032a0| 2c 20 5c 76 61 72 7b 6e | 6f 64 65 6e 61 6d 65 7d |, \var{n|odename}|
|000032b0| 2c 20 5c 76 61 72 7b 72 | 65 6c 65 61 73 65 7d 2c |, \var{r|elease},|
|000032c0| 20 5c 76 61 72 7b 76 65 | 72 73 69 6f 6e 7d 2c 20 | \var{ve|rsion}, |
|000032d0| 5c 76 61 72 7b 6d 61 63 | 68 69 6e 65 7d 29 7d 2e |\var{mac|hine})}.|
|000032e0| 0a 53 6f 6d 65 20 73 79 | 73 74 65 6d 73 20 74 72 |.Some sy|stems tr|
|000032f0| 75 6e 63 61 74 65 20 74 | 68 65 20 6e 6f 64 65 6e |uncate t|he noden|
|00003300| 61 6d 65 20 74 6f 20 38 | 0a 63 68 61 72 61 63 74 |ame to 8|.charact|
|00003310| 65 72 73 20 6f 72 20 74 | 6f 20 74 68 65 20 6c 65 |ers or t|o the le|
|00003320| 61 64 69 6e 67 20 63 6f | 6d 70 6f 6e 65 6e 74 3b |ading co|mponent;|
|00003330| 20 61 20 62 65 74 74 65 | 72 20 77 61 79 20 74 6f | a bette|r way to|
|00003340| 20 67 65 74 20 74 68 65 | 0a 68 6f 73 74 6e 61 6d | get the|.hostnam|
|00003350| 65 20 69 73 20 5c 63 6f | 64 65 7b 73 6f 63 6b 65 |e is \co|de{socke|
|00003360| 74 2e 67 65 74 68 6f 73 | 74 6e 61 6d 65 28 29 7d |t.gethos|tname()}|
|00003370| 2e 20 20 28 4e 6f 74 20 | 6f 6e 20 4d 53 2d 44 4f |.  (Not |on MS-DO|
|00003380| 53 2c 20 6e 6f 72 20 6f | 6e 20 6f 6c 64 65 72 0a |S, nor o|n older.|
|00003390| 5c 55 4e 49 58 7b 7d 20 | 73 79 73 74 65 6d 73 2e |\UNIX{} |systems.|
|000033a0| 29 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |).\end{f|uncdesc}|
|000033b0| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|000033c0| 63 7d 7b 75 6e 6c 69 6e | 6b 7d 7b 70 61 74 68 7d |c}{unlin|k}{path}|
|000033d0| 0a 52 65 6d 6f 76 65 20 | 74 68 65 20 66 69 6c 65 |.Remove |the file|
|000033e0| 20 5c 76 61 72 7b 70 61 | 74 68 7d 2e 20 20 54 68 | \var{pa|th}.  Th|
|000033f0| 69 73 20 69 73 20 74 68 | 65 20 73 61 6d 65 20 66 |is is th|e same f|
|00003400| 75 6e 63 74 69 6f 6e 20 | 61 73 20 5c 63 6f 64 65 |unction |as \code|
|00003410| 7b 72 65 6d 6f 76 65 7d | 3b 0a 74 68 65 20 5c 63 |{remove}|;.the \c|
|00003420| 6f 64 65 7b 75 6e 6c 69 | 6e 6b 7d 20 6e 61 6d 65 |ode{unli|nk} name|
|00003430| 20 69 73 20 69 74 73 20 | 74 72 61 64 69 74 69 6f | is its |traditio|
|00003440| 6e 61 6c 20 5c 55 4e 49 | 58 7b 7d 20 6e 61 6d 65 |nal \UNI|X{} name|
|00003450| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00003460| 0a 0a 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00003470| 63 7d 7b 75 74 69 6d 65 | 7d 7b 70 61 74 68 5c 2c |c}{utime|}{path\,|
|00003480| 20 5c 28 61 74 69 6d 65 | 5c 2c 20 6d 74 69 6d 65 | \(atime|\, mtime|
|00003490| 5c 29 7d 0a 53 65 74 20 | 74 68 65 20 61 63 63 65 |\)}.Set |the acce|
|000034a0| 73 73 20 61 6e 64 20 6d | 6f 64 69 66 69 65 64 20 |ss and m|odified |
|000034b0| 74 69 6d 65 20 6f 66 20 | 74 68 65 20 66 69 6c 65 |time of |the file|
|000034c0| 20 74 6f 20 74 68 65 20 | 67 69 76 65 6e 20 76 61 | to the |given va|
|000034d0| 6c 75 65 73 2e 0a 28 54 | 68 65 20 73 65 63 6f 6e |lues..(T|he secon|
|000034e0| 64 20 61 72 67 75 6d 65 | 6e 74 20 69 73 20 61 20 |d argume|nt is a |
|000034f0| 74 75 70 6c 65 20 6f 66 | 20 74 77 6f 20 69 74 65 |tuple of| two ite|
|00003500| 6d 73 2e 29 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |ms.).\en|d{funcde|
|00003510| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00003520| 64 65 73 63 7d 7b 77 61 | 69 74 7d 7b 7d 0a 57 61 |desc}{wa|it}{}.Wa|
|00003530| 69 74 20 66 6f 72 20 63 | 6f 6d 70 6c 65 74 69 6f |it for c|ompletio|
|00003540| 6e 20 6f 66 20 61 20 63 | 68 69 6c 64 20 70 72 6f |n of a c|hild pro|
|00003550| 63 65 73 73 2c 20 61 6e | 64 20 72 65 74 75 72 6e |cess, an|d return|
|00003560| 20 61 20 74 75 70 6c 65 | 20 63 6f 6e 74 61 69 6e | a tuple| contain|
|00003570| 69 6e 67 0a 69 74 73 20 | 70 69 64 20 61 6e 64 20 |ing.its |pid and |
|00003580| 65 78 69 74 20 73 74 61 | 74 75 73 20 69 6e 64 69 |exit sta|tus indi|
|00003590| 63 61 74 69 6f 6e 20 28 | 65 6e 63 6f 64 65 64 20 |cation (|encoded |
|000035a0| 61 73 20 62 79 20 5c 55 | 4e 49 58 7b 7d 29 2e 0a |as by \U|NIX{})..|
|000035b0| 28 4e 6f 74 20 6f 6e 20 | 4d 53 2d 44 4f 53 2e 29 |(Not on |MS-DOS.)|
|000035c0| 0a 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0a |.\end{fu|ncdesc}.|
|000035d0| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|000035e0| 7d 7b 77 61 69 74 70 69 | 64 7d 7b 70 69 64 5c 2c |}{waitpi|d}{pid\,|
|000035f0| 20 6f 70 74 69 6f 6e 73 | 7d 0a 57 61 69 74 20 66 | options|}.Wait f|
|00003600| 6f 72 20 63 6f 6d 70 6c | 65 74 69 6f 6e 20 6f 66 |or compl|etion of|
|00003610| 20 61 20 63 68 69 6c 64 | 20 70 72 6f 63 65 73 73 | a child| process|
|00003620| 20 67 69 76 65 6e 20 62 | 79 20 70 72 6f 63 65 73 | given b|y proces|
|00003630| 20 69 64 2c 20 61 6e 64 | 20 72 65 74 75 72 6e 0a | id, and| return.|
|00003640| 61 20 74 75 70 6c 65 20 | 63 6f 6e 74 61 69 6e 69 |a tuple |containi|
|00003650| 6e 67 20 69 74 73 20 70 | 69 64 20 61 6e 64 20 65 |ng its p|id and e|
|00003660| 78 69 74 20 73 74 61 74 | 75 73 20 69 6e 64 69 63 |xit stat|us indic|
|00003670| 61 74 69 6f 6e 20 28 65 | 6e 63 6f 64 65 64 20 61 |ation (e|ncoded a|
|00003680| 73 20 62 79 0a 5c 55 4e | 49 58 7b 7d 29 2e 20 20 |s by.\UN|IX{}).  |
|00003690| 54 68 65 20 73 65 6d 61 | 6e 74 69 63 73 20 6f 66 |The sema|ntics of|
|000036a0| 20 74 68 65 20 63 61 6c | 6c 20 61 72 65 20 61 66 | the cal|l are af|
|000036b0| 66 65 63 74 65 64 20 62 | 79 20 74 68 65 20 76 61 |fected b|y the va|
|000036c0| 6c 75 65 20 6f 66 0a 74 | 68 65 20 69 6e 74 65 67 |lue of.t|he integ|
|000036d0| 65 72 20 6f 70 74 69 6f | 6e 73 2c 20 77 68 69 63 |er optio|ns, whic|
|000036e0| 68 20 73 68 6f 75 6c 64 | 20 62 65 20 30 20 66 6f |h should| be 0 fo|
|000036f0| 72 20 6e 6f 72 6d 61 6c | 20 6f 70 65 72 61 74 69 |r normal| operati|
|00003700| 6f 6e 2e 20 20 28 49 66 | 20 74 68 65 0a 73 79 73 |on.  (If| the.sys|
|00003710| 74 65 6d 20 64 6f 65 73 | 20 6e 6f 74 20 73 75 70 |tem does| not sup|
|00003720| 70 6f 72 74 20 5c 63 6f | 64 65 7b 77 61 69 74 70 |port \co|de{waitp|
|00003730| 69 64 28 29 7d 2c 20 74 | 68 69 73 20 61 6c 77 61 |id()}, t|his alwa|
|00003740| 79 73 20 72 61 69 73 65 | 73 0a 5c 63 6f 64 65 7b |ys raise|s.\code{|
|00003750| 70 6f 73 69 78 2e 65 72 | 72 6f 72 7d 2e 20 20 4e |posix.er|ror}.  N|
|00003760| 6f 74 20 6f 6e 20 4d 53 | 2d 44 4f 53 2e 29 0a 5c |ot on MS|-DOS.).\|
|00003770| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0a 0a 5c |end{func|desc}..\|
|00003780| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00003790| 77 72 69 74 65 7d 7b 66 | 64 5c 2c 20 73 74 72 7d |write}{f|d\, str}|
|000037a0| 0a 57 72 69 74 65 20 74 | 68 65 20 73 74 72 69 6e |.Write t|he strin|
|000037b0| 67 20 5c 76 61 72 7b 73 | 74 72 7d 20 74 6f 20 66 |g \var{s|tr} to f|
|000037c0| 69 6c 65 20 64 65 73 63 | 72 69 70 74 6f 72 20 5c |ile desc|riptor \|
|000037d0| 76 61 72 7b 66 64 7d 2e | 0a 52 65 74 75 72 6e 20 |var{fd}.|.Return |
|000037e0| 74 68 65 20 6e 75 6d 62 | 65 72 20 6f 66 20 62 79 |the numb|er of by|
|000037f0| 74 65 73 20 61 63 74 75 | 61 6c 6c 79 20 77 72 69 |tes actu|ally wri|
|00003800| 74 74 65 6e 2e 0a 0a 4e | 6f 74 65 3a 20 74 68 69 |tten...N|ote: thi|
|00003810| 73 20 66 75 6e 63 74 69 | 6f 6e 20 69 73 20 69 6e |s functi|on is in|
|00003820| 74 65 6e 64 65 64 20 66 | 6f 72 20 6c 6f 77 2d 6c |tended f|or low-l|
|00003830| 65 76 65 6c 20 49 2f 4f | 20 61 6e 64 20 6d 75 73 |evel I/O| and mus|
|00003840| 74 20 62 65 20 61 70 70 | 6c 69 65 64 0a 74 6f 20 |t be app|lied.to |
|00003850| 61 20 66 69 6c 65 20 64 | 65 73 63 72 69 70 74 6f |a file d|escripto|
|00003860| 72 20 61 73 20 72 65 74 | 75 72 6e 65 64 20 62 79 |r as ret|urned by|
|00003870| 20 5c 63 6f 64 65 7b 70 | 6f 73 69 78 2e 6f 70 65 | \code{p|osix.ope|
|00003880| 6e 28 29 7d 20 6f 72 0a | 5c 63 6f 64 65 7b 70 6f |n()} or.|\code{po|
|00003890| 73 69 78 2e 70 69 70 65 | 28 29 7d 2e 20 20 54 6f |six.pipe|()}.  To|
|000038a0| 20 77 72 69 74 65 20 61 | 20 60 60 66 69 6c 65 20 | write a| ``file |
|000038b0| 6f 62 6a 65 63 74 27 27 | 20 72 65 74 75 72 6e 65 |object''| returne|
|000038c0| 64 20 62 79 20 74 68 65 | 0a 62 75 69 6c 74 2d 69 |d by the|.built-i|
|000038d0| 6e 20 66 75 6e 63 74 69 | 6f 6e 20 5c 63 6f 64 65 |n functi|on \code|
|000038e0| 7b 6f 70 65 6e 7d 20 6f | 72 20 62 79 20 5c 63 6f |{open} o|r by \co|
|000038f0| 64 65 7b 70 6f 73 69 78 | 2e 70 6f 70 65 6e 7d 20 |de{posix|.popen} |
|00003900| 6f 72 0a 5c 63 6f 64 65 | 7b 70 6f 73 69 78 2e 66 |or.\code|{posix.f|
|00003910| 64 6f 70 65 6e 7d 2c 20 | 6f 72 20 5c 63 6f 64 65 |dopen}, |or \code|
|00003920| 7b 73 79 73 2e 73 74 64 | 6f 75 74 7d 20 6f 72 20 |{sys.std|out} or |
|00003930| 5c 63 6f 64 65 7b 73 79 | 73 2e 73 74 64 65 72 72 |\code{sy|s.stderr|
|00003940| 7d 2c 20 75 73 65 0a 69 | 74 73 20 5c 63 6f 64 65 |}, use.i|ts \code|
|00003950| 7b 77 72 69 74 65 28 29 | 7d 20 6d 65 74 68 6f 64 |{write()|} method|
|00003960| 2e 0a 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00003970| 0a 0a 5c 62 65 67 69 6e | 7b 64 61 74 61 64 65 73 |..\begin|{datades|
|00003980| 63 7d 7b 57 4e 4f 48 41 | 4e 47 7d 0a 54 68 65 20 |c}{WNOHA|NG}.The |
|00003990| 6f 70 74 69 6f 6e 20 66 | 6f 72 20 5c 63 6f 64 65 |option f|or \code|
|000039a0| 7b 77 61 69 74 70 69 64 | 28 29 7d 20 74 6f 20 61 |{waitpid|()} to a|
|000039b0| 76 6f 69 64 20 68 61 6e | 67 69 6e 67 20 69 66 20 |void han|ging if |
|000039c0| 6e 6f 20 63 68 69 6c 64 | 20 70 72 6f 63 65 73 73 |no child| process|
|000039d0| 0a 73 74 61 74 75 73 20 | 69 73 20 61 76 61 69 6c |.status |is avail|
|000039e0| 61 62 6c 65 20 69 6d 6d | 65 64 69 61 74 65 6c 79 |able imm|ediately|
|000039f0| 2e 0a 5c 65 6e 64 7b 64 | 61 74 61 64 65 73 63 7d |..\end{d|atadesc}|
|00003a00| 0a                      |                         |.       |        |
+--------+-------------------------+-------------------------+--------+--------+