/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / python / pytexdoc / ext / lib / libr / riscosos / 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 72 69 73 63 6f | 73 7d 7d 0a 0a 5c 62 69 |de{risco|s}}..\bi|
|00000030| 6d 6f 64 69 6e 64 65 78 | 7b 72 69 73 63 6f 73 7d |modindex|{riscos}|
|00000040| 0a 0a 54 68 69 73 20 6d | 6f 64 75 6c 65 20 70 72 |..This m|odule pr|
|00000050| 6f 76 69 64 65 73 20 52 | 69 73 63 4f 53 20 70 6f |ovides R|iscOS po|
|00000060| 72 74 73 20 6f 66 20 73 | 6f 6d 65 20 50 4f 53 49 |rts of s|ome POSI|
|00000070| 58 20 66 75 6e 74 69 6f | 6e 73 2c 20 61 6e 64 20 |X funtio|ns, and |
|00000080| 73 6f 6d 65 20 52 69 73 | 63 4f 53 0a 73 70 65 63 |some Ris|cOS.spec|
|00000090| 69 66 69 63 20 66 75 6e | 63 74 69 6f 6e 73 2e 0a |ific fun|ctions..|
|000000a0| 0a 45 72 72 6f 72 73 20 | 61 72 65 20 72 65 70 6f |.Errors |are repo|
|000000b0| 72 74 65 64 20 61 73 20 | 65 78 63 65 70 74 69 6f |rted as |exceptio|
|000000c0| 6e 73 3b 20 74 68 65 20 | 75 73 75 61 6c 20 65 78 |ns; the |usual ex|
|000000d0| 63 65 70 74 69 6f 6e 73 | 20 61 72 65 20 67 69 76 |ceptions| are giv|
|000000e0| 65 6e 0a 66 6f 72 20 74 | 79 70 65 20 65 72 72 6f |en.for t|ype erro|
|000000f0| 72 73 2c 20 77 68 69 6c | 65 20 65 72 72 6f 72 73 |rs, whil|e errors|
|00000100| 20 72 65 70 6f 72 74 65 | 64 20 62 79 20 74 68 65 | reporte|d by the|
|00000110| 20 73 79 73 74 65 6d 20 | 63 61 6c 6c 73 20 72 61 | system |calls ra|
|00000120| 69 73 65 0a 5c 63 6f 64 | 65 7b 72 69 73 63 6f 73 |ise.\cod|e{riscos|
|00000130| 2e 65 72 72 6f 72 7d 2c | 20 64 65 73 63 72 69 62 |.error},| describ|
|00000140| 65 64 20 62 65 6c 6f 77 | 2e 0a 0a 0a 5c 72 65 6e |ed below|....\ren|
|00000150| 65 77 63 6f 6d 6d 61 6e | 64 7b 5c 69 6e 64 65 78 |ewcomman|d{\index|
|00000160| 73 75 62 69 74 65 6d 7d | 7b 28 65 78 63 65 70 74 |subitem}|{(except|
|00000170| 69 6f 6e 20 69 6e 20 6d | 6f 64 75 6c 65 20 72 69 |ion in m|odule ri|
|00000180| 73 63 6f 73 29 7d 0a 5c | 62 65 67 69 6e 7b 65 78 |scos)}.\|begin{ex|
|00000190| 63 64 65 73 63 7d 7b 65 | 72 72 6f 72 7d 0a 54 68 |cdesc}{e|rror}.Th|
|000001a0| 69 73 20 65 78 63 65 70 | 74 69 6f 6e 20 69 73 20 |is excep|tion is |
|000001b0| 72 61 69 73 65 64 20 77 | 68 65 6e 20 61 6e 20 52 |raised w|hen an R|
|000001c0| 69 73 63 4f 53 20 66 75 | 6e 63 74 69 6f 6e 20 72 |iscOS fu|nction r|
|000001d0| 65 74 75 72 6e 73 20 61 | 0a 52 69 73 63 4f 53 2d |eturns a|.RiscOS-|
|000001e0| 72 65 6c 61 74 65 64 20 | 65 72 72 6f 72 20 28 65 |related |error (e|
|000001f0| 2e 67 2e 2c 20 6e 6f 74 | 20 66 6f 72 20 69 6c 6c |.g., not| for ill|
|00000200| 65 67 61 6c 20 61 72 67 | 75 6d 65 6e 74 20 74 79 |egal arg|ument ty|
|00000210| 70 65 73 29 2e 20 20 49 | 74 73 0a 73 74 72 69 6e |pes).  I|ts.strin|
|00000220| 67 20 76 61 6c 75 65 20 | 69 73 20 5c 63 6f 64 65 |g value |is \code|
|00000230| 7b 27 72 69 73 63 6f 73 | 2e 65 72 72 6f 72 27 7d |{'riscos|.error'}|
|00000240| 2e 20 20 54 68 65 20 61 | 63 63 6f 6d 70 61 6e 79 |.  The a|ccompany|
|00000250| 69 6e 67 20 76 61 6c 75 | 65 20 69 73 20 61 0a 73 |ing valu|e is a.s|
|00000260| 74 72 69 6e 67 20 64 65 | 73 63 72 69 62 69 6e 67 |tring de|scribing|
|00000270| 20 74 68 65 20 65 72 72 | 6f 72 2c 20 6f 66 74 65 | the err|or, ofte|
|00000280| 6e 20 74 68 61 74 20 72 | 65 74 75 72 6e 65 64 20 |n that r|eturned |
|00000290| 62 79 20 74 68 65 20 72 | 65 6c 65 76 61 6e 74 20 |by the r|elevant |
|000002a0| 53 57 49 2e 0a 5c 65 6e | 64 7b 65 78 63 64 65 73 |SWI..\en|d{excdes|
|000002b0| 63 7d 0a 0a 49 74 20 64 | 65 66 69 6e 65 73 20 74 |c}..It d|efines t|
|000002c0| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 66 75 6e |he follo|wing fun|
|000002d0| 63 74 69 6f 6e 73 3a 0a | 0a 5c 72 65 6e 65 77 63 |ctions:.|.\renewc|
|000002e0| 6f 6d 6d 61 6e 64 7b 5c | 69 6e 64 65 78 73 75 62 |ommand{\|indexsub|
|000002f0| 69 74 65 6d 7d 7b 28 69 | 6e 20 6d 6f 64 75 6c 65 |item}{(i|n module|
|00000300| 20 72 69 73 63 6f 73 29 | 7d 0a 5c 62 65 67 69 6e | riscos)|}.\begin|
|00000310| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 63 68 64 69 72 |{funcdes|c}{chdir|
|00000320| 7d 7b 70 61 74 68 7d 0a | 43 68 61 6e 67 65 20 74 |}{path}.|Change t|
|00000330| 68 65 20 63 75 72 72 65 | 6e 74 20 77 6f 72 6b 69 |he curre|nt worki|
|00000340| 6e 67 20 64 69 72 65 63 | 74 6f 72 79 20 74 6f 20 |ng direc|tory to |
|00000350| 5c 76 61 72 7b 70 61 74 | 68 7d 2e 0a 5c 65 6e 64 |\var{pat|h}..\end|
|00000360| 7b 66 75 6e 63 64 65 73 | 63 7d 0a 0a 5c 62 65 67 |{funcdes|c}..\beg|
|00000370| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 63 68 6d |in{funcd|esc}{chm|
|00000380| 6f 64 7d 7b 70 61 74 68 | 5c 2c 20 6d 6f 64 65 7d |od}{path|\, mode}|
|00000390| 0a 43 68 61 6e 67 65 20 | 74 68 65 20 6d 6f 64 65 |.Change |the mode|
|000003a0| 20 6f 66 20 5c 76 61 72 | 7b 70 61 74 68 7d 20 74 | of \var|{path} t|
|000003b0| 6f 20 74 68 65 20 6e 75 | 6d 65 72 69 63 20 5c 76 |o the nu|meric \v|
|000003c0| 61 72 7b 6d 6f 64 65 7d | 2e 0a 5c 65 6e 64 7b 66 |ar{mode}|..\end{f|
|000003d0| 75 6e 63 64 65 73 63 7d | 0a 0a 5c 62 65 67 69 6e |uncdesc}|..\begin|
|000003e0| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 65 78 70 61 6e |{funcdes|c}{expan|
|000003f0| 64 7d 7b 70 61 74 68 7d | 0a 52 65 74 75 72 6e 73 |d}{path}|.Returns|
|00000400| 20 74 68 65 20 63 61 6e | 6f 6e 69 63 61 6c 20 65 | the can|onical e|
|00000410| 78 70 61 6e 73 69 6f 6e | 20 6f 66 20 61 20 70 61 |xpansion| of a pa|
|00000420| 74 68 6e 61 6d 65 2e 0a | 5c 65 6e 64 7b 66 75 6e |thname..|\end{fun|
|00000430| 63 64 65 73 63 7d 0a 0a | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|00000440| 75 6e 63 64 65 73 63 7d | 7b 67 65 74 63 77 64 7d |uncdesc}|{getcwd}|
|00000450| 7b 7d 0a 52 65 74 75 72 | 6e 20 61 20 73 74 72 69 |{}.Retur|n a stri|
|00000460| 6e 67 20 72 65 70 72 65 | 73 65 6e 74 69 6e 67 20 |ng repre|senting |
|00000470| 74 68 65 20 63 75 72 72 | 65 6e 74 20 64 69 72 65 |the curr|ent dire|
|00000480| 63 74 6f 72 79 2e 0a 5c | 65 6e 64 7b 66 75 6e 63 |ctory..\|end{func|
|00000490| 64 65 73 63 7d 0a 0a 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|000004a0| 6e 63 64 65 73 63 7d 7b | 67 65 74 65 6e 76 7d 7b |ncdesc}{|getenv}{|
|000004b0| 73 74 72 69 6e 67 7d 0a | 52 65 74 75 72 6e 73 20 |string}.|Returns |
|000004c0| 74 68 65 20 73 74 72 69 | 6e 67 20 76 61 6c 75 65 |the stri|ng value|
|000004d0| 20 6f 66 20 74 68 65 20 | 65 6e 76 69 72 6f 6e 6d | of the |environm|
|000004e0| 65 6e 74 20 76 61 72 69 | 61 62 6c 65 20 5c 76 61 |ent vari|able \va|
|000004f0| 72 7b 73 74 72 69 6e 67 | 7d 0a 6f 72 20 5c 63 6f |r{string|}.or \co|
|00000500| 64 65 7b 4e 6f 6e 65 7d | 20 69 66 20 69 74 20 64 |de{None}| if it d|
|00000510| 6f 65 73 20 6e 6f 74 20 | 65 78 69 73 74 2e 0a 5c |oes not |exist..\|
|00000520| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0a 0a 5c |end{func|desc}..\|
|00000530| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00000540| 6c 69 73 74 64 69 72 7d | 7b 70 61 74 68 7d 0a 52 |listdir}|{path}.R|
|00000550| 65 74 75 72 6e 20 61 20 | 6c 69 73 74 20 63 6f 6e |eturn a |list con|
|00000560| 74 61 69 6e 69 6e 67 20 | 74 68 65 20 6e 61 6d 65 |taining |the name|
|00000570| 73 20 6f 66 20 74 68 65 | 20 65 6e 74 72 69 65 73 |s of the| entries|
|00000580| 20 69 6e 20 74 68 65 20 | 64 69 72 65 63 74 6f 72 | in the |director|
|00000590| 79 2e 0a 54 68 65 20 6c | 69 73 74 20 69 73 20 69 |y..The l|ist is i|
|000005a0| 6e 20 61 72 62 69 74 72 | 61 72 79 20 6f 72 64 65 |n arbitr|ary orde|
|000005b0| 72 2e 0a 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |r..\end{|funcdesc|
|000005c0| 7d 0a 0a 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|000005d0| 73 63 7d 7b 6d 6b 64 69 | 72 7d 7b 70 61 74 68 20 |sc}{mkdi|r}{path |
|000005e0| 5c 6f 70 74 69 6f 6e 61 | 6c 7b 5c 2c 20 6d 6f 64 |\optiona|l{\, mod|
|000005f0| 65 7d 7d 0a 43 72 65 61 | 74 65 20 61 20 64 69 72 |e}}.Crea|te a dir|
|00000600| 65 63 74 6f 72 79 20 6e | 61 6d 65 64 20 5c 76 61 |ectory n|amed \va|
|00000610| 72 7b 70 61 74 68 7d 2c | 20 61 74 20 70 72 65 73 |r{path},| at pres|
|00000620| 65 6e 74 20 5c 76 61 72 | 7b 6d 6f 64 65 7d 20 69 |ent \var|{mode} i|
|00000630| 73 20 69 67 6e 6f 72 65 | 64 2e 0a 5c 65 6e 64 7b |s ignore|d..\end{|
|00000640| 66 75 6e 63 64 65 73 63 | 7d 0a 0a 5c 62 65 67 69 |funcdesc|}..\begi|
|00000650| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 70 75 74 65 |n{funcde|sc}{pute|
|00000660| 6e 76 7d 7b 6e 61 6d 65 | 5c 2c 20 73 74 72 69 6e |nv}{name|\, strin|
|00000670| 67 20 5c 6f 70 74 69 6f | 6e 61 6c 7b 5c 2c 20 74 |g \optio|nal{\, t|
|00000680| 79 70 65 7d 7d 0a 53 65 | 74 73 20 74 68 65 20 65 |ype}}.Se|ts the e|
|00000690| 6e 76 69 72 6f 6e 6d 65 | 6e 74 20 76 61 72 69 61 |nvironme|nt varia|
|000006a0| 62 6c 65 20 5c 76 61 72 | 7b 6e 61 6d 65 7d 20 74 |ble \var|{name} t|
|000006b0| 6f 20 5c 76 61 72 7b 73 | 74 72 69 6e 67 7d 2e 0a |o \var{s|tring}..|
|000006c0| 5c 62 65 67 69 6e 7b 74 | 61 62 6c 65 69 69 7d 7b |\begin{t|ableii}{|
|000006d0| 7c 63 7c 6c 7c 7d 7b 73 | 61 6d 70 7d 7b 74 79 70 ||c|l|}{s|amp}{typ|
|000006e0| 65 7d 7b 4d 65 61 6e 69 | 6e 67 7d 0a 20 20 5c 6c |e}{Meani|ng}.  \l|
|000006f0| 69 6e 65 69 69 7b 30 7d | 7b 47 53 54 72 61 6e 73 |ineii{0}|{GSTrans|
|00000700| 20 74 68 65 20 73 74 72 | 69 6e 67 7d 0a 20 20 5c | the str|ing}.  \|
|00000710| 6c 69 6e 65 69 69 7b 31 | 7d 7b 45 76 61 6c 75 61 |lineii{1|}{Evalua|
|00000720| 74 65 20 74 68 65 20 73 | 74 72 69 6e 67 7d 0a 20 |te the s|tring}. |
|00000730| 20 5c 6c 69 6e 65 69 69 | 7b 33 7d 7b 4d 61 63 72 | \lineii|{3}{Macr|
|00000740| 6f 20 76 61 72 69 61 62 | 6c 65 7d 0a 20 20 5c 6c |o variab|le}.  \l|
|00000750| 69 6e 65 69 69 7b 34 7d | 7b 4e 6f 20 74 72 61 6e |ineii{4}|{No tran|
|00000760| 73 6c 61 74 69 6f 6e 7d | 0a 5c 65 6e 64 7b 74 61 |slation}|.\end{ta|
|00000770| 62 6c 65 69 69 7d 0a 5c | 76 61 72 7b 74 79 70 65 |bleii}.\|var{type|
|00000780| 7d 20 64 65 66 61 75 6c | 74 73 20 74 6f 20 34 20 |} defaul|ts to 4 |
|00000790| 28 6e 6f 20 74 72 61 6e | 73 6c 61 74 69 6f 6e 20 |(no tran|slation |
|000007a0| 6f 66 20 74 68 65 20 76 | 61 6c 75 65 20 73 74 72 |of the v|alue str|
|000007b0| 69 6e 67 29 2e 0a 5c 65 | 6e 64 7b 66 75 6e 63 64 |ing)..\e|nd{funcd|
|000007c0| 65 73 63 7d 0a 0a 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|000007d0| 63 64 65 73 63 7d 7b 72 | 65 6d 6f 76 65 7d 7b 70 |cdesc}{r|emove}{p|
|000007e0| 61 74 68 7d 0a 52 65 6d | 6f 76 65 20 74 68 65 20 |ath}.Rem|ove the |
|000007f0| 64 69 72 65 63 74 6f 72 | 79 20 6f 72 20 66 69 6c |director|y or fil|
|00000800| 65 20 5c 76 61 72 7b 70 | 61 74 68 7d 2e 0a 5c 65 |e \var{p|ath}..\e|
|00000810| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 62 |nd{funcd|esc}..\b|
|00000820| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 72 |egin{fun|cdesc}{r|
|00000830| 65 6e 61 6d 65 7d 7b 73 | 72 63 5c 2c 20 64 73 74 |ename}{s|rc\, dst|
|00000840| 7d 0a 52 65 6e 61 6d 65 | 20 74 68 65 20 66 69 6c |}.Rename| the fil|
|00000850| 65 20 6f 72 20 64 69 72 | 65 63 74 6f 72 79 20 5c |e or dir|ectory \|
|00000860| 76 61 72 7b 73 72 63 7d | 20 74 6f 20 5c 76 61 72 |var{src}| to \var|
|00000870| 7b 64 73 74 7d 2e 0a 5c | 65 6e 64 7b 66 75 6e 63 |{dst}..\|end{func|
|00000880| 64 65 73 63 7d 0a 0a 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00000890| 6e 63 64 65 73 63 7d 7b | 72 6d 64 69 72 7d 7b 70 |ncdesc}{|rmdir}{p|
|000008a0| 61 74 68 7d 0a 52 65 6d | 6f 76 65 20 74 68 65 20 |ath}.Rem|ove the |
|000008b0| 64 69 72 65 63 74 6f 72 | 79 20 6f 72 20 66 69 6c |director|y or fil|
|000008c0| 65 20 5c 76 61 72 7b 70 | 61 74 68 7d 20 28 53 61 |e \var{p|ath} (Sa|
|000008d0| 6d 65 20 61 73 20 72 65 | 6d 6f 76 65 29 2e 0a 5c |me as re|move)..\|
|000008e0| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0a 0a 5c |end{func|desc}..\|
|000008f0| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00000900| 73 65 74 74 79 70 65 7d | 7b 66 69 6c 65 6e 61 6d |settype}|{filenam|
|00000910| 65 5c 2c 20 74 79 70 65 | 7d 0a 53 65 74 73 20 74 |e\, type|}.Sets t|
|00000920| 68 65 20 74 79 70 65 20 | 6f 66 20 5c 76 61 72 7b |he type |of \var{|
|00000930| 66 69 6c 65 6e 61 6d 65 | 7d 2e 20 5c 76 61 72 7b |filename|}. \var{|
|00000940| 74 79 70 65 7d 20 63 61 | 6e 20 62 65 20 61 6e 20 |type} ca|n be an |
|00000950| 69 6e 74 65 67 65 72 20 | 6f 72 20 61 20 73 74 72 |integer |or a str|
|00000960| 69 6e 67 2e 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |ing..\en|d{funcde|
|00000970| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00000980| 64 65 73 63 7d 7b 73 74 | 61 74 7d 7b 70 61 74 68 |desc}{st|at}{path|
|00000990| 7d 0a 50 65 72 66 6f 72 | 6d 20 61 20 7b 5c 65 6d |}.Perfor|m a {\em|
|000009a0| 20 73 74 61 74 7d 20 73 | 79 73 74 65 6d 20 63 61 | stat} s|ystem ca|
|000009b0| 6c 6c 20 6f 6e 20 74 68 | 65 20 67 69 76 65 6e 20 |ll on th|e given |
|000009c0| 70 61 74 68 2e 20 20 54 | 68 65 20 72 65 74 75 72 |path.  T|he retur|
|000009d0| 6e 20 76 61 6c 75 65 0a | 69 73 20 61 20 74 75 70 |n value.|is a tup|
|000009e0| 6c 65 20 6f 66 20 61 74 | 20 6c 65 61 73 74 20 31 |le of at| least 1|
|000009f0| 30 20 69 6e 74 65 67 65 | 72 73 20 67 69 76 69 6e |0 intege|rs givin|
|00000a00| 67 20 74 68 65 20 6d 6f | 73 74 20 69 6d 70 6f 72 |g the mo|st impor|
|00000a10| 74 61 6e 74 20 28 61 6e | 64 0a 70 6f 72 74 61 62 |tant (an|d.portab|
|00000a20| 6c 65 29 20 6d 65 6d 62 | 65 72 73 20 6f 66 20 74 |le) memb|ers of t|
|00000a30| 68 65 20 7b 5c 65 6d 20 | 73 74 61 74 7d 20 73 74 |he {\em |stat} st|
|00000a40| 72 75 63 74 75 72 65 2c | 20 69 6e 20 74 68 65 20 |ructure,| in the |
|00000a50| 6f 72 64 65 72 0a 5c 63 | 6f 64 65 7b 73 74 5f 6d |order.\c|ode{st_m|
|00000a60| 6f 64 65 7d 2c 0a 5c 63 | 6f 64 65 7b 73 74 5f 69 |ode},.\c|ode{st_i|
|00000a70| 6e 6f 7d 2c 0a 5c 63 6f | 64 65 7b 73 74 5f 64 65 |no},.\co|de{st_de|
|00000a80| 76 7d 2c 0a 5c 63 6f 64 | 65 7b 73 74 5f 6e 6c 69 |v},.\cod|e{st_nli|
|00000a90| 6e 6b 7d 2c 0a 5c 63 6f | 64 65 7b 73 74 5f 75 69 |nk},.\co|de{st_ui|
|00000aa0| 64 7d 2c 0a 5c 63 6f 64 | 65 7b 73 74 5f 67 69 64 |d},.\cod|e{st_gid|
|00000ab0| 7d 2c 0a 5c 63 6f 64 65 | 7b 73 74 5f 73 69 7a 65 |},.\code|{st_size|
|00000ac0| 7d 2c 0a 5c 63 6f 64 65 | 7b 73 74 5f 61 74 69 6d |},.\code|{st_atim|
|00000ad0| 65 7d 2c 0a 5c 63 6f 64 | 65 7b 73 74 5f 6d 74 69 |e},.\cod|e{st_mti|
|00000ae0| 6d 65 7d 2c 0a 5c 63 6f | 64 65 7b 73 74 5f 63 74 |me},.\co|de{st_ct|
|00000af0| 69 6d 65 7d 2e 0a 54 68 | 65 20 52 69 73 63 4f 53 |ime}..Th|e RiscOS|
|00000b00| 20 76 65 72 73 69 6f 6e | 20 61 64 64 73 20 74 68 | version| adds th|
|00000b10| 72 65 65 20 65 78 74 72 | 61 20 76 61 6c 75 65 73 |ree extr|a values|
|00000b20| 2c 20 74 68 65 20 66 69 | 6c 65 20 74 79 70 65 2c |, the fi|le type,|
|00000b30| 20 61 74 74 72 69 62 75 | 74 65 73 20 61 6e 64 20 | attribu|tes and |
|00000b40| 0a 6f 62 6a 65 63 74 20 | 74 79 70 65 2c 20 61 73 |.object |type, as|
|00000b50| 20 72 65 74 75 72 6e 65 | 64 20 62 79 20 6f 73 66 | returne|d by osf|
|00000b60| 69 6c 65 5f 72 65 61 64 | 5f 73 74 61 6d 70 65 64 |ile_read|_stamped|
|00000b70| 5f 6e 6f 5f 70 61 74 68 | 2e 0a 54 68 65 20 76 61 |_no_path|..The va|
|00000b80| 6c 75 65 73 20 5c 63 6f | 64 65 7b 73 74 5f 69 6e |lues \co|de{st_in|
|00000b90| 6f 7d 2c 0a 5c 63 6f 64 | 65 7b 73 74 5f 64 65 76 |o},.\cod|e{st_dev|
|00000ba0| 7d 2c 0a 5c 63 6f 64 65 | 7b 73 74 5f 6e 6c 69 6e |},.\code|{st_nlin|
|00000bb0| 6b 7d 2c 0a 5c 63 6f 64 | 65 7b 73 74 5f 75 69 64 |k},.\cod|e{st_uid|
|00000bc0| 7d 20 61 6e 64 0a 5c 63 | 6f 64 65 7b 73 74 5f 67 |} and.\c|ode{st_g|
|00000bd0| 69 64 7d 20 61 72 65 20 | 61 6c 6c 20 7a 65 72 6f |id} are |all zero|
|00000be0| 2e 20 54 68 65 20 74 68 | 72 65 65 20 74 69 6d 65 |. The th|ree time|
|00000bf0| 73 20 61 72 65 20 61 6c | 6c 20 65 71 75 61 6c 2e |s are al|l equal.|
|00000c00| 0a 0a 0a 0a 4e 6f 74 65 | 3a 20 54 68 65 20 73 74 |....Note|: The st|
|00000c10| 61 6e 64 61 72 64 20 6d | 6f 64 75 6c 65 20 5c 63 |andard m|odule \c|
|00000c20| 6f 64 65 7b 73 74 61 74 | 7d 20 64 65 66 69 6e 65 |ode{stat|} define|
|00000c30| 73 20 66 75 6e 63 74 69 | 6f 6e 73 20 61 6e 64 20 |s functi|ons and |
|00000c40| 63 6f 6e 73 74 61 6e 74 | 73 0a 74 68 61 74 20 61 |constant|s.that a|
|00000c50| 72 65 20 75 73 65 66 75 | 6c 20 66 6f 72 20 65 78 |re usefu|l for ex|
|00000c60| 74 72 61 63 74 69 6e 67 | 20 69 6e 66 6f 72 6d 61 |tracting| informa|
|00000c70| 74 69 6f 6e 20 66 72 6f | 6d 20 61 20 73 74 61 74 |tion fro|m a stat|
|00000c80| 20 73 74 72 75 63 74 75 | 72 65 2e 0a 5c 65 6e 64 | structu|re..\end|
|00000c90| 7b 66 75 6e 63 64 65 73 | 63 7d 0a 0a 5c 62 65 67 |{funcdes|c}..\beg|
|00000ca0| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 73 79 73 |in{funcd|esc}{sys|
|00000cb0| 74 65 6d 7d 7b 63 6f 6d | 6d 61 6e 64 7d 0a 45 78 |tem}{com|mand}.Ex|
|00000cc0| 65 63 75 74 65 20 74 68 | 65 20 63 6f 6d 6d 61 6e |ecute th|e comman|
|00000cd0| 64 20 28 61 20 73 74 72 | 69 6e 67 29 2e 20 20 54 |d (a str|ing).  T|
|00000ce0| 68 69 73 20 69 73 20 69 | 6d 70 6c 65 6d 65 6e 74 |his is i|mplement|
|00000cf0| 65 64 20 62 79 0a 63 61 | 6c 6c 69 6e 67 20 74 68 |ed by.ca|lling th|
|00000d00| 65 20 53 74 61 6e 64 61 | 72 64 20 43 20 66 75 6e |e Standa|rd C fun|
|00000d10| 63 74 69 6f 6e 20 5c 63 | 6f 64 65 7b 73 79 73 74 |ction \c|ode{syst|
|00000d20| 65 6d 28 29 7d 2c 20 61 | 6e 64 20 68 61 73 20 74 |em()}, a|nd has t|
|00000d30| 68 65 20 73 61 6d 65 0a | 6c 69 6d 69 74 61 74 69 |he same.|limitati|
|00000d40| 6f 6e 73 2e 0a 20 20 54 | 68 65 20 72 65 74 75 72 |ons..  T|he retur|
|00000d50| 6e 20 76 61 6c 75 65 20 | 69 73 20 74 68 65 20 65 |n value |is the e|
|00000d60| 78 69 74 20 73 74 61 74 | 75 73 20 6f 66 20 74 68 |xit stat|us of th|
|00000d70| 65 20 70 72 6f 63 65 73 | 73 20 61 73 20 72 65 74 |e proces|s as ret|
|00000d80| 75 72 6e 65 64 20 62 79 | 20 53 74 61 6e 64 61 72 |urned by| Standar|
|00000d90| 64 20 43 0a 5c 63 6f 64 | 65 7b 73 79 73 74 65 6d |d C.\cod|e{system|
|00000da0| 28 29 7d 2e 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |()}..\en|d{funcde|
|00000db0| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00000dc0| 64 65 73 63 7d 7b 75 6e | 6c 69 6e 6b 7d 7b 70 61 |desc}{un|link}{pa|
|00000dd0| 74 68 7d 0a 55 6e 6c 69 | 6e 6b 20 5c 76 61 72 7b |th}.Unli|nk \var{|
|00000de0| 70 61 74 68 7d 20 28 53 | 61 6d 65 20 61 73 20 72 |path} (S|ame as r|
|00000df0| 65 6d 6f 76 65 29 2e 0a | 5c 65 6e 64 7b 66 75 6e |emove)..|\end{fun|
|00000e00| 63 64 65 73 63 7d 0a 0a | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|00000e10| 75 6e 63 64 65 73 63 7d | 7b 75 74 69 6d 65 7d 7b |uncdesc}|{utime}{|
|00000e20| 70 61 74 68 5c 2c 20 5c | 28 61 74 69 6d 65 5c 2c |path\, \|(atime\,|
|00000e30| 20 6d 74 69 6d 65 5c 29 | 7d 0a 53 65 74 20 74 68 | mtime\)|}.Set th|
|00000e40| 65 20 74 69 6d 65 20 73 | 74 61 6d 70 20 6f 66 20 |e time s|tamp of |
|00000e50| 74 68 65 20 66 69 6c 65 | 2e 0a 28 54 68 65 20 73 |the file|..(The s|
|00000e60| 65 63 6f 6e 64 20 61 72 | 67 75 6d 65 6e 74 20 69 |econd ar|gument i|
|00000e70| 73 20 61 20 74 75 70 6c | 65 20 6f 66 20 74 77 6f |s a tupl|e of two|
|00000e80| 20 69 74 65 6d 73 2e 29 | 20 41 74 20 70 72 65 73 | items.)| At pres|
|00000e90| 65 6e 74 20 74 68 65 20 | 73 65 63 6f 6e 64 20 61 |ent the |second a|
|00000ea0| 72 67 75 6d 65 6e 74 0a | 69 73 20 69 67 6e 6f 72 |rgument.|is ignor|
|00000eb0| 65 64 20 61 6e 64 20 74 | 68 65 20 74 69 6d 65 20 |ed and t|he time |
|00000ec0| 69 73 20 73 65 74 20 74 | 6f 20 74 68 65 20 63 75 |is set t|o the cu|
|00000ed0| 72 72 65 6e 74 20 74 69 | 6d 65 2e 0a 5c 65 6e 64 |rrent ti|me..\end|
|00000ee0| 7b 66 75 6e 63 64 65 73 | 63 7d 0a                |{funcdes|c}.     |
+--------+-------------------------+-------------------------+--------+--------+