/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / programming / python / pytex / pytexdoc / lib1 / signal / tex

MacOS 8.1

Win98

DOS

browse contents

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 73 69 67 6e 61 | 6c 7d 7d 0a 0a 5c 62 69 |de{signa|l}}..\bi|
|00000030| 6d 6f 64 69 6e 64 65 78 | 7b 73 69 67 6e 61 6c 7d |modindex|{signal}|
|00000040| 0a 54 68 69 73 20 6d 6f | 64 75 6c 65 20 70 72 6f |.This mo|dule pro|
|00000050| 76 69 64 65 73 20 6d 65 | 63 68 61 6e 69 73 6d 73 |vides me|chanisms|
|00000060| 20 74 6f 20 75 73 65 20 | 73 69 67 6e 61 6c 20 68 | to use |signal h|
|00000070| 61 6e 64 6c 65 72 73 20 | 69 6e 20 50 79 74 68 6f |andlers |in Pytho|
|00000080| 6e 2e 0a 53 6f 6d 65 20 | 67 65 6e 65 72 61 6c 20 |n..Some |general |
|00000090| 72 75 6c 65 73 20 66 6f | 72 20 77 6f 72 6b 69 6e |rules fo|r workin|
|000000a0| 67 20 77 69 74 68 20 73 | 69 67 6e 61 6c 73 20 68 |g with s|ignals h|
|000000b0| 61 6e 64 6c 65 72 73 3a | 0a 0a 5c 62 65 67 69 6e |andlers:|..\begin|
|000000c0| 7b 69 74 65 6d 69 7a 65 | 7d 0a 0a 5c 69 74 65 6d |{itemize|}..\item|
|000000d0| 0a 41 20 68 61 6e 64 6c | 65 72 20 66 6f 72 20 61 |.A handl|er for a|
|000000e0| 20 70 61 72 74 69 63 75 | 6c 61 72 20 73 69 67 6e | particu|lar sign|
|000000f0| 61 6c 2c 20 6f 6e 63 65 | 20 73 65 74 2c 20 72 65 |al, once| set, re|
|00000100| 6d 61 69 6e 73 20 69 6e | 73 74 61 6c 6c 65 64 20 |mains in|stalled |
|00000110| 75 6e 74 69 6c 0a 69 74 | 20 69 73 20 65 78 70 6c |until.it| is expl|
|00000120| 69 63 69 74 6c 79 20 72 | 65 73 65 74 20 28 69 2e |icitly r|eset (i.|
|00000130| 65 2e 20 50 79 74 68 6f | 6e 20 65 6d 75 6c 61 74 |e. Pytho|n emulat|
|00000140| 65 73 20 74 68 65 20 42 | 53 44 20 73 74 79 6c 65 |es the B|SD style|
|00000150| 20 69 6e 74 65 72 66 61 | 63 65 0a 72 65 67 61 72 | interfa|ce.regar|
|00000160| 64 6c 65 73 73 20 6f 66 | 20 74 68 65 20 75 6e 64 |dless of| the und|
|00000170| 65 72 6c 79 69 6e 67 20 | 69 6d 70 6c 65 6d 65 6e |erlying |implemen|
|00000180| 74 61 74 69 6f 6e 29 2c | 20 77 69 74 68 20 74 68 |tation),| with th|
|00000190| 65 20 65 78 63 65 70 74 | 69 6f 6e 20 6f 66 0a 74 |e except|ion of.t|
|000001a0| 68 65 20 68 61 6e 64 6c | 65 72 20 66 6f 72 20 5c |he handl|er for \|
|000001b0| 63 6f 64 65 7b 53 49 47 | 43 48 4c 44 7d 2c 20 77 |code{SIG|CHLD}, w|
|000001c0| 68 69 63 68 20 66 6f 6c | 6c 6f 77 73 20 74 68 65 |hich fol|lows the|
|000001d0| 20 75 6e 64 65 72 6c 79 | 69 6e 67 0a 69 6d 70 6c | underly|ing.impl|
|000001e0| 65 6d 65 6e 74 61 74 69 | 6f 6e 2e 0a 0a 5c 69 74 |ementati|on...\it|
|000001f0| 65 6d 0a 54 68 65 72 65 | 20 69 73 20 6e 6f 20 77 |em.There| is no w|
|00000200| 61 79 20 74 6f 20 60 60 | 62 6c 6f 63 6b 27 27 20 |ay to ``|block'' |
|00000210| 73 69 67 6e 61 6c 73 20 | 74 65 6d 70 6f 72 61 72 |signals |temporar|
|00000220| 69 6c 79 20 66 72 6f 6d | 20 63 72 69 74 69 63 61 |ily from| critica|
|00000230| 6c 0a 73 65 63 74 69 6f | 6e 73 20 28 73 69 6e 63 |l.sectio|ns (sinc|
|00000240| 65 20 74 68 69 73 20 69 | 73 20 6e 6f 74 20 73 75 |e this i|s not su|
|00000250| 70 70 6f 72 74 65 64 20 | 62 79 20 61 6c 6c 20 5c |pported |by all \|
|00000260| 55 4e 49 58 7b 7d 20 66 | 6c 61 76 6f 72 73 29 2e |UNIX{} f|lavors).|
|00000270| 0a 0a 5c 69 74 65 6d 0a | 41 6c 74 68 6f 75 67 68 |..\item.|Although|
|00000280| 20 50 79 74 68 6f 6e 20 | 73 69 67 6e 61 6c 20 68 | Python |signal h|
|00000290| 61 6e 64 6c 65 72 73 20 | 61 72 65 20 63 61 6c 6c |andlers |are call|
|000002a0| 65 64 20 61 73 79 6e 63 | 68 72 6f 6e 6f 75 73 6c |ed async|hronousl|
|000002b0| 79 20 61 73 20 66 61 72 | 20 61 73 0a 74 68 65 20 |y as far| as.the |
|000002c0| 50 79 74 68 6f 6e 20 75 | 73 65 72 20 69 73 20 63 |Python u|ser is c|
|000002d0| 6f 6e 63 65 72 6e 65 64 | 2c 20 74 68 65 79 20 63 |oncerned|, they c|
|000002e0| 61 6e 20 6f 6e 6c 79 20 | 6f 63 63 75 72 20 62 65 |an only |occur be|
|000002f0| 74 77 65 65 6e 20 74 68 | 65 0a 60 60 61 74 6f 6d |tween th|e.``atom|
|00000300| 69 63 27 27 20 69 6e 73 | 74 72 75 63 74 69 6f 6e |ic'' ins|truction|
|00000310| 73 20 6f 66 20 74 68 65 | 20 50 79 74 68 6f 6e 20 |s of the| Python |
|00000320| 69 6e 74 65 72 70 72 65 | 74 65 72 2e 20 20 54 68 |interpre|ter.  Th|
|00000330| 69 73 20 6d 65 61 6e 73 | 20 74 68 61 74 0a 73 69 |is means| that.si|
|00000340| 67 6e 61 6c 73 20 61 72 | 72 69 76 69 6e 67 20 64 |gnals ar|riving d|
|00000350| 75 72 69 6e 67 20 6c 6f | 6e 67 20 63 61 6c 63 75 |uring lo|ng calcu|
|00000360| 6c 61 74 69 6f 6e 73 20 | 69 6d 70 6c 65 6d 65 6e |lations |implemen|
|00000370| 74 65 64 20 70 75 72 65 | 6c 79 20 69 6e 20 43 0a |ted pure|ly in C.|
|00000380| 28 65 2e 67 2e 5c 20 72 | 65 67 75 6c 61 72 20 65 |(e.g.\ r|egular e|
|00000390| 78 70 72 65 73 73 69 6f | 6e 20 6d 61 74 63 68 65 |xpressio|n matche|
|000003a0| 73 20 6f 6e 20 6c 61 72 | 67 65 20 62 6f 64 69 65 |s on lar|ge bodie|
|000003b0| 73 20 6f 66 20 74 65 78 | 74 29 20 6d 61 79 20 62 |s of tex|t) may b|
|000003c0| 65 0a 64 65 6c 61 79 65 | 64 20 66 6f 72 20 61 6e |e.delaye|d for an|
|000003d0| 20 61 72 62 69 74 72 61 | 72 79 20 61 6d 6f 75 6e | arbitra|ry amoun|
|000003e0| 74 20 6f 66 20 74 69 6d | 65 2e 0a 0a 5c 69 74 65 |t of tim|e...\ite|
|000003f0| 6d 0a 57 68 65 6e 20 61 | 20 73 69 67 6e 61 6c 20 |m.When a| signal |
|00000400| 61 72 72 69 76 65 73 20 | 64 75 72 69 6e 67 20 61 |arrives |during a|
|00000410| 6e 20 49 2f 4f 20 6f 70 | 65 72 61 74 69 6f 6e 2c |n I/O op|eration,|
|00000420| 20 69 74 20 69 73 20 70 | 6f 73 73 69 62 6c 65 20 | it is p|ossible |
|00000430| 74 68 61 74 20 74 68 65 | 0a 49 2f 4f 20 6f 70 65 |that the|.I/O ope|
|00000440| 72 61 74 69 6f 6e 20 72 | 61 69 73 65 73 20 61 6e |ration r|aises an|
|00000450| 20 65 78 63 65 70 74 69 | 6f 6e 20 61 66 74 65 72 | excepti|on after|
|00000460| 20 74 68 65 20 73 69 67 | 6e 61 6c 20 68 61 6e 64 | the sig|nal hand|
|00000470| 6c 65 72 20 72 65 74 75 | 72 6e 73 2e 0a 54 68 69 |ler retu|rns..Thi|
|00000480| 73 20 69 73 20 64 65 70 | 65 6e 64 65 6e 74 20 6f |s is dep|endent o|
|00000490| 6e 20 74 68 65 20 75 6e | 64 65 72 6c 79 69 6e 67 |n the un|derlying|
|000004a0| 20 5c 55 4e 49 58 7b 7d | 20 73 79 73 74 65 6d 27 | \UNIX{}| system'|
|000004b0| 73 20 73 65 6d 61 6e 74 | 69 63 73 20 72 65 67 61 |s semant|ics rega|
|000004c0| 72 64 69 6e 67 0a 69 6e | 74 65 72 72 75 70 74 65 |rding.in|terrupte|
|000004d0| 64 20 73 79 73 74 65 6d | 20 63 61 6c 6c 73 2e 0a |d system| calls..|
|000004e0| 0a 5c 69 74 65 6d 0a 42 | 65 63 61 75 73 65 20 74 |.\item.B|ecause t|
|000004f0| 68 65 20 43 20 73 69 67 | 6e 61 6c 20 68 61 6e 64 |he C sig|nal hand|
|00000500| 6c 65 72 20 61 6c 77 61 | 79 73 20 72 65 74 75 72 |ler alwa|ys retur|
|00000510| 6e 73 2c 20 69 74 20 6d | 61 6b 65 73 20 6c 69 74 |ns, it m|akes lit|
|00000520| 74 6c 65 20 73 65 6e 73 | 65 20 74 6f 0a 63 61 74 |tle sens|e to.cat|
|00000530| 63 68 20 73 79 6e 63 68 | 72 6f 6e 6f 75 73 20 65 |ch synch|ronous e|
|00000540| 72 72 6f 72 73 20 6c 69 | 6b 65 20 5c 63 6f 64 65 |rrors li|ke \code|
|00000550| 7b 53 49 47 46 50 45 7d | 20 6f 72 20 5c 63 6f 64 |{SIGFPE}| or \cod|
|00000560| 65 7b 53 49 47 53 45 47 | 56 7d 2e 0a 0a 5c 69 74 |e{SIGSEG|V}...\it|
|00000570| 65 6d 0a 50 79 74 68 6f | 6e 20 69 6e 73 74 61 6c |em.Pytho|n instal|
|00000580| 6c 73 20 61 20 73 6d 61 | 6c 6c 20 6e 75 6d 62 65 |ls a sma|ll numbe|
|00000590| 72 20 6f 66 20 73 69 67 | 6e 61 6c 20 68 61 6e 64 |r of sig|nal hand|
|000005a0| 6c 65 72 73 20 62 79 20 | 64 65 66 61 75 6c 74 3a |lers by |default:|
|000005b0| 0a 5c 63 6f 64 65 7b 53 | 49 47 50 49 50 45 7d 20 |.\code{S|IGPIPE} |
|000005c0| 69 73 20 69 67 6e 6f 72 | 65 64 20 28 73 6f 20 77 |is ignor|ed (so w|
|000005d0| 72 69 74 65 20 65 72 72 | 6f 72 73 20 6f 6e 20 70 |rite err|ors on p|
|000005e0| 69 70 65 73 20 61 6e 64 | 20 73 6f 63 6b 65 74 73 |ipes and| sockets|
|000005f0| 20 63 61 6e 20 62 65 0a | 72 65 70 6f 72 74 65 64 | can be.|reported|
|00000600| 20 61 73 20 6f 72 64 69 | 6e 61 72 79 20 50 79 74 | as ordi|nary Pyt|
|00000610| 68 6f 6e 20 65 78 63 65 | 70 74 69 6f 6e 73 29 2c |hon exce|ptions),|
|00000620| 20 5c 63 6f 64 65 7b 53 | 49 47 49 4e 54 7d 20 69 | \code{S|IGINT} i|
|00000630| 73 20 74 72 61 6e 73 6c | 61 74 65 64 0a 69 6e 74 |s transl|ated.int|
|00000640| 6f 20 61 20 5c 63 6f 64 | 65 7b 4b 65 79 62 6f 61 |o a \cod|e{Keyboa|
|00000650| 72 64 49 6e 74 65 72 72 | 75 70 74 7d 20 65 78 63 |rdInterr|upt} exc|
|00000660| 65 70 74 69 6f 6e 2c 20 | 61 6e 64 20 5c 63 6f 64 |eption, |and \cod|
|00000670| 65 7b 53 49 47 54 45 52 | 4d 7d 20 69 73 0a 63 61 |e{SIGTER|M} is.ca|
|00000680| 75 67 68 74 20 73 6f 20 | 74 68 61 74 20 6e 65 63 |ught so |that nec|
|00000690| 65 73 73 61 72 79 20 63 | 6c 65 61 6e 75 70 20 28 |essary c|leanup (|
|000006a0| 65 73 70 65 63 69 61 6c | 6c 79 20 5c 63 6f 64 65 |especial|ly \code|
|000006b0| 7b 73 79 73 2e 65 78 69 | 74 66 75 6e 63 7d 29 20 |{sys.exi|tfunc}) |
|000006c0| 63 61 6e 0a 62 65 20 70 | 65 72 66 6f 72 6d 65 64 |can.be p|erformed|
|000006d0| 20 62 65 66 6f 72 65 20 | 61 63 74 75 61 6c 6c 79 | before |actually|
|000006e0| 20 74 65 72 6d 69 6e 61 | 74 69 6e 67 2e 20 20 41 | termina|ting.  A|
|000006f0| 6c 6c 20 6f 66 20 74 68 | 65 73 65 20 63 61 6e 20 |ll of th|ese can |
|00000700| 62 65 0a 6f 76 65 72 72 | 69 64 64 65 6e 2e 0a 0a |be.overr|idden...|
|00000710| 5c 69 74 65 6d 0a 53 6f | 6d 65 20 63 61 72 65 20 |\item.So|me care |
|00000720| 6d 75 73 74 20 62 65 20 | 74 61 6b 65 6e 20 69 66 |must be |taken if|
|00000730| 20 62 6f 74 68 20 73 69 | 67 6e 61 6c 73 20 61 6e | both si|gnals an|
|00000740| 64 20 74 68 72 65 61 64 | 73 20 61 72 65 20 75 73 |d thread|s are us|
|00000750| 65 64 20 69 6e 20 74 68 | 65 0a 73 61 6d 65 20 70 |ed in th|e.same p|
|00000760| 72 6f 67 72 61 6d 2e 20 | 20 54 68 65 20 66 75 6e |rogram. | The fun|
|00000770| 64 61 6d 65 6e 74 61 6c | 20 74 68 69 6e 67 20 74 |damental| thing t|
|00000780| 6f 20 72 65 6d 65 6d 62 | 65 72 20 69 6e 20 75 73 |o rememb|er in us|
|00000790| 69 6e 67 20 73 69 67 6e | 61 6c 73 20 61 6e 64 0a |ing sign|als and.|
|000007a0| 74 68 72 65 61 64 73 20 | 73 69 6d 75 6c 74 61 6e |threads |simultan|
|000007b0| 65 6f 75 73 6c 79 20 69 | 73 3a 5c 20 61 6c 77 61 |eously i|s:\ alwa|
|000007c0| 79 73 20 70 65 72 66 6f | 72 6d 20 5c 63 6f 64 65 |ys perfo|rm \code|
|000007d0| 7b 73 69 67 6e 61 6c 28 | 29 7d 20 6f 70 65 72 61 |{signal(|)} opera|
|000007e0| 74 69 6f 6e 73 0a 69 6e | 20 74 68 65 20 6d 61 69 |tions.in| the mai|
|000007f0| 6e 20 74 68 72 65 61 64 | 20 6f 66 20 65 78 65 63 |n thread| of exec|
|00000800| 75 74 69 6f 6e 2e 20 20 | 41 6e 79 20 74 68 72 65 |ution.  |Any thre|
|00000810| 61 64 20 63 61 6e 20 70 | 65 72 66 6f 72 6d 20 61 |ad can p|erform a|
|00000820| 6e 0a 5c 63 6f 64 65 7b | 61 6c 61 72 6d 28 29 7d |n.\code{|alarm()}|
|00000830| 2c 20 5c 63 6f 64 65 7b | 67 65 74 73 69 67 6e 61 |, \code{|getsigna|
|00000840| 6c 28 29 7d 2c 20 6f 72 | 20 5c 63 6f 64 65 7b 70 |l()}, or| \code{p|
|00000850| 61 75 73 65 28 29 7d 3b | 20 6f 6e 6c 79 20 74 68 |ause()};| only th|
|00000860| 65 20 6d 61 69 6e 0a 74 | 68 72 65 61 64 20 63 61 |e main.t|hread ca|
|00000870| 6e 20 73 65 74 20 61 20 | 6e 65 77 20 73 69 67 6e |n set a |new sign|
|00000880| 61 6c 20 68 61 6e 64 6c | 65 72 2c 20 61 6e 64 20 |al handl|er, and |
|00000890| 74 68 65 20 6d 61 69 6e | 20 74 68 72 65 61 64 20 |the main| thread |
|000008a0| 77 69 6c 6c 20 62 65 20 | 74 68 65 0a 6f 6e 6c 79 |will be |the.only|
|000008b0| 20 6f 6e 65 20 74 6f 20 | 72 65 63 65 69 76 65 20 | one to |receive |
|000008c0| 73 69 67 6e 61 6c 73 20 | 28 74 68 69 73 20 69 73 |signals |(this is|
|000008d0| 20 65 6e 66 6f 72 63 65 | 64 20 62 79 20 74 68 65 | enforce|d by the|
|000008e0| 20 50 79 74 68 6f 6e 20 | 73 69 67 6e 61 6c 0a 6d | Python |signal.m|
|000008f0| 6f 64 75 6c 65 2c 20 65 | 76 65 6e 20 69 66 20 74 |odule, e|ven if t|
|00000900| 68 65 20 75 6e 64 65 72 | 6c 79 69 6e 67 20 74 68 |he under|lying th|
|00000910| 72 65 61 64 20 69 6d 70 | 6c 65 6d 65 6e 74 61 74 |read imp|lementat|
|00000920| 69 6f 6e 20 73 75 70 70 | 6f 72 74 73 20 73 65 6e |ion supp|orts sen|
|00000930| 64 69 6e 67 0a 73 69 67 | 6e 61 6c 73 20 74 6f 20 |ding.sig|nals to |
|00000940| 69 6e 64 69 76 69 64 75 | 61 6c 20 74 68 72 65 61 |individu|al threa|
|00000950| 64 73 29 2e 20 20 54 68 | 69 73 20 6d 65 61 6e 73 |ds).  Th|is means|
|00000960| 20 74 68 61 74 20 73 69 | 67 6e 61 6c 73 20 63 61 | that si|gnals ca|
|00000970| 6e 27 74 20 62 65 20 75 | 73 65 64 0a 61 73 20 61 |n't be u|sed.as a|
|00000980| 20 6d 65 61 6e 73 20 6f | 66 20 69 6e 74 65 72 74 | means o|f intert|
|00000990| 68 72 65 61 64 20 63 6f | 6d 6d 75 6e 69 63 61 74 |hread co|mmunicat|
|000009a0| 69 6f 6e 2e 20 20 55 73 | 65 20 6c 6f 63 6b 73 20 |ion.  Us|e locks |
|000009b0| 69 6e 73 74 65 61 64 2e | 0a 0a 5c 65 6e 64 7b 69 |instead.|..\end{i|
|000009c0| 74 65 6d 69 7a 65 7d 0a | 0a 54 68 65 20 76 61 72 |temize}.|.The var|
|000009d0| 69 61 62 6c 65 73 20 64 | 65 66 69 6e 65 64 20 69 |iables d|efined i|
|000009e0| 6e 20 74 68 65 20 73 69 | 67 6e 61 6c 20 6d 6f 64 |n the si|gnal mod|
|000009f0| 75 6c 65 20 61 72 65 3a | 0a 0a 5c 72 65 6e 65 77 |ule are:|..\renew|
|00000a00| 63 6f 6d 6d 61 6e 64 7b | 5c 69 6e 64 65 78 73 75 |command{|\indexsu|
|00000a10| 62 69 74 65 6d 7d 7b 28 | 69 6e 20 6d 6f 64 75 6c |bitem}{(|in modul|
|00000a20| 65 20 73 69 67 6e 61 6c | 29 7d 0a 5c 62 65 67 69 |e signal|)}.\begi|
|00000a30| 6e 7b 64 61 74 61 64 65 | 73 63 7d 7b 53 49 47 5f |n{datade|sc}{SIG_|
|00000a40| 44 46 4c 7d 0a 20 20 54 | 68 69 73 20 69 73 20 6f |DFL}.  T|his is o|
|00000a50| 6e 65 20 6f 66 20 74 77 | 6f 20 73 74 61 6e 64 61 |ne of tw|o standa|
|00000a60| 72 64 20 73 69 67 6e 61 | 6c 20 68 61 6e 64 6c 69 |rd signa|l handli|
|00000a70| 6e 67 20 6f 70 74 69 6f | 6e 73 3b 20 69 74 20 77 |ng optio|ns; it w|
|00000a80| 69 6c 6c 20 73 69 6d 70 | 6c 79 0a 20 20 70 65 72 |ill simp|ly.  per|
|00000a90| 66 6f 72 6d 20 74 68 65 | 20 64 65 66 61 75 6c 74 |form the| default|
|00000aa0| 20 66 75 6e 63 74 69 6f | 6e 20 66 6f 72 20 74 68 | functio|n for th|
|00000ab0| 65 20 73 69 67 6e 61 6c | 2e 20 20 46 6f 72 20 65 |e signal|.  For e|
|00000ac0| 78 61 6d 70 6c 65 2c 20 | 6f 6e 20 6d 6f 73 74 0a |xample, |on most.|
|00000ad0| 20 20 73 79 73 74 65 6d | 73 20 74 68 65 20 64 65 |  system|s the de|
|00000ae0| 66 61 75 6c 74 20 61 63 | 74 69 6f 6e 20 66 6f 72 |fault ac|tion for|
|00000af0| 20 53 49 47 51 55 49 54 | 20 69 73 20 74 6f 20 64 | SIGQUIT| is to d|
|00000b00| 75 6d 70 20 63 6f 72 65 | 20 61 6e 64 20 65 78 69 |ump core| and exi|
|00000b10| 74 2c 0a 20 20 77 68 69 | 6c 65 20 74 68 65 20 64 |t,.  whi|le the d|
|00000b20| 65 66 61 75 6c 74 20 61 | 63 74 69 6f 6e 20 66 6f |efault a|ction fo|
|00000b30| 72 20 53 49 47 43 4c 44 | 20 69 73 20 74 6f 20 73 |r SIGCLD| is to s|
|00000b40| 69 6d 70 6c 79 20 69 67 | 6e 6f 72 65 20 69 74 2e |imply ig|nore it.|
|00000b50| 0a 5c 65 6e 64 7b 64 61 | 74 61 64 65 73 63 7d 0a |.\end{da|tadesc}.|
|00000b60| 0a 5c 62 65 67 69 6e 7b | 64 61 74 61 64 65 73 63 |.\begin{|datadesc|
|00000b70| 7d 7b 53 49 47 5f 49 47 | 4e 7d 0a 20 20 54 68 69 |}{SIG_IG|N}.  Thi|
|00000b80| 73 20 69 73 20 61 6e 6f | 74 68 65 72 20 73 74 61 |s is ano|ther sta|
|00000b90| 6e 64 61 72 64 20 73 69 | 67 6e 61 6c 20 68 61 6e |ndard si|gnal han|
|00000ba0| 64 6c 65 72 2c 20 77 68 | 69 63 68 20 77 69 6c 6c |dler, wh|ich will|
|00000bb0| 20 73 69 6d 70 6c 79 20 | 69 67 6e 6f 72 65 0a 20 | simply |ignore. |
|00000bc0| 20 74 68 65 20 67 69 76 | 65 6e 20 73 69 67 6e 61 | the giv|en signa|
|00000bd0| 6c 2e 0a 5c 65 6e 64 7b | 64 61 74 61 64 65 73 63 |l..\end{|datadesc|
|00000be0| 7d 0a 0a 5c 62 65 67 69 | 6e 7b 64 61 74 61 64 65 |}..\begi|n{datade|
|00000bf0| 73 63 7d 7b 53 49 47 2a | 7d 0a 20 20 41 6c 6c 20 |sc}{SIG*|}.  All |
|00000c00| 74 68 65 20 73 69 67 6e | 61 6c 20 6e 75 6d 62 65 |the sign|al numbe|
|00000c10| 72 73 20 61 72 65 20 64 | 65 66 69 6e 65 64 20 73 |rs are d|efined s|
|00000c20| 79 6d 62 6f 6c 69 63 61 | 6c 6c 79 2e 20 20 46 6f |ymbolica|lly.  Fo|
|00000c30| 72 20 65 78 61 6d 70 6c | 65 2c 20 74 68 65 0a 20 |r exampl|e, the. |
|00000c40| 20 68 61 6e 67 75 70 20 | 73 69 67 6e 61 6c 20 69 | hangup |signal i|
|00000c50| 73 20 64 65 66 69 6e 65 | 64 20 61 73 20 5c 63 6f |s define|d as \co|
|00000c60| 64 65 7b 73 69 67 6e 61 | 6c 2e 53 49 47 48 55 50 |de{signa|l.SIGHUP|
|00000c70| 7d 3b 20 74 68 65 20 76 | 61 72 69 61 62 6c 65 20 |}; the v|ariable |
|00000c80| 6e 61 6d 65 73 0a 20 20 | 61 72 65 20 69 64 65 6e |names.  |are iden|
|00000c90| 74 69 63 61 6c 20 74 6f | 20 74 68 65 20 6e 61 6d |tical to| the nam|
|00000ca0| 65 73 20 75 73 65 64 20 | 69 6e 20 43 20 70 72 6f |es used |in C pro|
|00000cb0| 67 72 61 6d 73 2c 20 61 | 73 20 66 6f 75 6e 64 20 |grams, a|s found |
|00000cc0| 69 6e 0a 20 20 5c 66 69 | 6c 65 7b 73 69 67 6e 61 |in.  \fi|le{signa|
|00000cd0| 6c 2e 68 7d 2e 0a 20 20 | 54 68 65 20 5c 55 4e 49 |l.h}..  |The \UNI|
|00000ce0| 58 7b 7d 20 6d 61 6e 20 | 70 61 67 65 20 66 6f 72 |X{} man |page for|
|00000cf0| 20 5c 66 69 6c 65 7b 73 | 69 67 6e 61 6c 7d 20 6c | \file{s|ignal} l|
|00000d00| 69 73 74 73 20 74 68 65 | 20 65 78 69 73 74 69 6e |ists the| existin|
|00000d10| 67 20 73 69 67 6e 61 6c | 73 20 28 6f 6e 0a 20 20 |g signal|s (on.  |
|00000d20| 73 6f 6d 65 20 73 79 73 | 74 65 6d 73 20 74 68 69 |some sys|tems thi|
|00000d30| 73 20 69 73 20 5c 66 69 | 6c 65 7b 73 69 67 6e 61 |s is \fi|le{signa|
|00000d40| 6c 28 32 29 7d 2c 20 6f | 6e 20 6f 74 68 65 72 73 |l(2)}, o|n others|
|00000d50| 20 74 68 65 20 6c 69 73 | 74 20 69 73 20 69 6e 0a | the lis|t is in.|
|00000d60| 20 20 5c 66 69 6c 65 7b | 73 69 67 6e 61 6c 28 37 |  \file{|signal(7|
|00000d70| 29 7d 29 2e 0a 20 20 4e | 6f 74 65 20 74 68 61 74 |)})..  N|ote that|
|00000d80| 20 6e 6f 74 20 61 6c 6c | 20 73 79 73 74 65 6d 73 | not all| systems|
|00000d90| 20 64 65 66 69 6e 65 20 | 74 68 65 20 73 61 6d 65 | define |the same|
|00000da0| 20 73 65 74 20 6f 66 20 | 73 69 67 6e 61 6c 20 6e | set of |signal n|
|00000db0| 61 6d 65 73 3b 20 6f 6e | 6c 79 0a 20 20 74 68 6f |ames; on|ly.  tho|
|00000dc0| 73 65 20 6e 61 6d 65 73 | 20 64 65 66 69 6e 65 64 |se names| defined|
|00000dd0| 20 62 79 20 74 68 65 20 | 73 79 73 74 65 6d 20 61 | by the |system a|
|00000de0| 72 65 20 64 65 66 69 6e | 65 64 20 62 79 20 74 68 |re defin|ed by th|
|00000df0| 69 73 20 6d 6f 64 75 6c | 65 2e 0a 5c 65 6e 64 7b |is modul|e..\end{|
|00000e00| 64 61 74 61 64 65 73 63 | 7d 0a 0a 5c 62 65 67 69 |datadesc|}..\begi|
|00000e10| 6e 7b 64 61 74 61 64 65 | 73 63 7d 7b 4e 53 49 47 |n{datade|sc}{NSIG|
|00000e20| 7d 0a 20 20 4f 6e 65 20 | 6d 6f 72 65 20 74 68 61 |}.  One |more tha|
|00000e30| 6e 20 74 68 65 20 6e 75 | 6d 62 65 72 20 6f 66 20 |n the nu|mber of |
|00000e40| 74 68 65 20 68 69 67 68 | 65 73 74 20 73 69 67 6e |the high|est sign|
|00000e50| 61 6c 20 6e 75 6d 62 65 | 72 2e 0a 5c 65 6e 64 7b |al numbe|r..\end{|
|00000e60| 64 61 74 61 64 65 73 63 | 7d 0a 0a 54 68 65 20 73 |datadesc|}..The s|
|00000e70| 69 67 6e 61 6c 20 6d 6f | 64 75 6c 65 20 64 65 66 |ignal mo|dule def|
|00000e80| 69 6e 65 73 20 74 68 65 | 20 66 6f 6c 6c 6f 77 69 |ines the| followi|
|00000e90| 6e 67 20 66 75 6e 63 74 | 69 6f 6e 73 3a 0a 0a 5c |ng funct|ions:..\|
|00000ea0| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00000eb0| 61 6c 61 72 6d 7d 7b 74 | 69 6d 65 7d 0a 20 20 49 |alarm}{t|ime}.  I|
|00000ec0| 66 20 5c 76 61 72 7b 74 | 69 6d 65 7d 20 69 73 20 |f \var{t|ime} is |
|00000ed0| 6e 6f 6e 2d 7a 65 72 6f | 2c 20 74 68 69 73 20 66 |non-zero|, this f|
|00000ee0| 75 6e 63 74 69 6f 6e 20 | 72 65 71 75 65 73 74 73 |unction |requests|
|00000ef0| 20 74 68 61 74 20 61 0a | 20 20 5c 63 6f 64 65 7b | that a.|  \code{|
|00000f00| 53 49 47 41 4c 52 4d 7d | 20 73 69 67 6e 61 6c 20 |SIGALRM}| signal |
|00000f10| 62 65 20 73 65 6e 74 20 | 74 6f 20 74 68 65 20 70 |be sent |to the p|
|00000f20| 72 6f 63 65 73 73 20 69 | 6e 20 5c 76 61 72 7b 74 |rocess i|n \var{t|
|00000f30| 69 6d 65 7d 20 73 65 63 | 6f 6e 64 73 2e 0a 20 20 |ime} sec|onds..  |
|00000f40| 41 6e 79 20 70 72 65 76 | 69 6f 75 73 6c 79 20 73 |Any prev|iously s|
|00000f50| 63 68 65 64 75 6c 65 64 | 20 61 6c 61 72 6d 20 69 |cheduled| alarm i|
|00000f60| 73 20 63 61 6e 63 65 6c | 65 64 20 28 69 2e 65 2e |s cancel|ed (i.e.|
|00000f70| 5c 20 6f 6e 6c 79 20 6f | 6e 65 20 61 6c 61 72 6d |\ only o|ne alarm|
|00000f80| 20 63 61 6e 0a 20 20 62 | 65 20 73 63 68 65 64 75 | can.  b|e schedu|
|00000f90| 6c 65 64 20 61 74 20 61 | 6e 79 20 74 69 6d 65 29 |led at a|ny time)|
|00000fa0| 2e 20 20 54 68 65 20 72 | 65 74 75 72 6e 65 64 20 |.  The r|eturned |
|00000fb0| 76 61 6c 75 65 20 69 73 | 20 74 68 65 6e 20 74 68 |value is| then th|
|00000fc0| 65 20 6e 75 6d 62 65 72 | 20 6f 66 0a 20 20 73 65 |e number| of.  se|
|00000fd0| 63 6f 6e 64 73 20 62 65 | 66 6f 72 65 20 61 6e 79 |conds be|fore any|
|00000fe0| 20 70 72 65 76 69 6f 75 | 73 6c 79 20 73 65 74 20 | previou|sly set |
|00000ff0| 61 6c 61 72 6d 20 77 61 | 73 20 74 6f 20 68 61 76 |alarm wa|s to hav|
|00001000| 65 20 62 65 65 6e 20 64 | 65 6c 69 76 65 72 65 64 |e been d|elivered|
|00001010| 2e 0a 20 20 49 66 20 5c | 76 61 72 7b 74 69 6d 65 |..  If \|var{time|
|00001020| 7d 20 69 73 20 7a 65 72 | 6f 2c 20 6e 6f 20 61 6c |} is zer|o, no al|
|00001030| 61 72 6d 20 69 64 20 73 | 63 68 65 64 75 6c 65 64 |arm id s|cheduled|
|00001040| 2c 20 61 6e 64 20 61 6e | 79 20 73 63 68 65 64 75 |, and an|y schedu|
|00001050| 6c 65 64 0a 20 20 61 6c | 61 72 6d 20 69 73 20 63 |led.  al|arm is c|
|00001060| 61 6e 63 65 6c 65 64 2e | 20 20 54 68 65 20 72 65 |anceled.|  The re|
|00001070| 74 75 72 6e 20 76 61 6c | 75 65 20 69 73 20 74 68 |turn val|ue is th|
|00001080| 65 20 6e 75 6d 62 65 72 | 20 6f 66 20 73 65 63 6f |e number| of seco|
|00001090| 6e 64 73 0a 20 20 72 65 | 6d 61 69 6e 69 6e 67 20 |nds.  re|maining |
|000010a0| 62 65 66 6f 72 65 20 61 | 20 70 72 65 76 69 6f 75 |before a| previou|
|000010b0| 73 6c 79 20 73 63 68 65 | 64 75 6c 65 64 20 61 6c |sly sche|duled al|
|000010c0| 61 72 6d 2e 20 20 49 66 | 20 74 68 65 20 72 65 74 |arm.  If| the ret|
|000010d0| 75 72 6e 20 76 61 6c 75 | 65 0a 20 20 69 73 20 7a |urn valu|e.  is z|
|000010e0| 65 72 6f 2c 20 6e 6f 20 | 61 6c 61 72 6d 20 69 73 |ero, no |alarm is|
|000010f0| 20 63 75 72 72 65 6e 74 | 6c 79 20 73 63 68 65 64 | current|ly sched|
|00001100| 75 6c 65 64 2e 20 20 28 | 53 65 65 20 74 68 65 20 |uled.  (|See the |
|00001110| 5c 55 4e 49 58 7b 7d 20 | 6d 61 6e 20 70 61 67 65 |\UNIX{} |man page|
|00001120| 0a 20 20 5c 63 6f 64 65 | 7b 61 6c 61 72 6d 28 32 |.  \code|{alarm(2|
|00001130| 29 7d 2e 29 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |)}.).\en|d{funcde|
|00001140| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00001150| 64 65 73 63 7d 7b 67 65 | 74 73 69 67 6e 61 6c 7d |desc}{ge|tsignal}|
|00001160| 7b 73 69 67 6e 61 6c 6e | 75 6d 7d 0a 20 20 52 65 |{signaln|um}.  Re|
|00001170| 74 75 72 6e 20 74 68 65 | 20 63 75 72 72 65 6e 74 |turn the| current|
|00001180| 20 73 69 67 6e 61 6c 20 | 68 61 6e 64 6c 65 72 20 | signal |handler |
|00001190| 66 6f 72 20 74 68 65 20 | 73 69 67 6e 61 6c 20 5c |for the |signal \|
|000011a0| 76 61 72 7b 73 69 67 6e | 61 6c 6e 75 6d 7d 2e 0a |var{sign|alnum}..|
|000011b0| 20 20 54 68 65 20 72 65 | 74 75 72 6e 65 64 20 76 |  The re|turned v|
|000011c0| 61 6c 75 65 20 6d 61 79 | 20 62 65 20 61 20 63 61 |alue may| be a ca|
|000011d0| 6c 6c 61 62 6c 65 20 50 | 79 74 68 6f 6e 20 6f 62 |llable P|ython ob|
|000011e0| 6a 65 63 74 2c 20 6f 72 | 20 6f 6e 65 20 6f 66 20 |ject, or| one of |
|000011f0| 74 68 65 0a 20 20 73 70 | 65 63 69 61 6c 20 76 61 |the.  sp|ecial va|
|00001200| 6c 75 65 73 20 5c 63 6f | 64 65 7b 73 69 67 6e 61 |lues \co|de{signa|
|00001210| 6c 2e 53 49 47 5f 49 47 | 4e 7d 2c 20 5c 63 6f 64 |l.SIG_IG|N}, \cod|
|00001220| 65 7b 73 69 67 6e 61 6c | 2e 53 49 47 5f 44 46 4c |e{signal|.SIG_DFL|
|00001230| 7d 20 6f 72 0a 20 20 5c | 63 6f 64 65 7b 4e 6f 6e |} or.  \|code{Non|
|00001240| 65 7d 2e 20 20 48 65 72 | 65 2c 20 5c 63 6f 64 65 |e}.  Her|e, \code|
|00001250| 7b 73 69 67 6e 61 6c 2e | 53 49 47 5f 49 47 4e 7d |{signal.|SIG_IGN}|
|00001260| 20 6d 65 61 6e 73 20 74 | 68 61 74 20 74 68 65 20 | means t|hat the |
|00001270| 73 69 67 6e 61 6c 20 77 | 61 73 0a 20 20 70 72 65 |signal w|as.  pre|
|00001280| 76 69 6f 75 73 6c 79 20 | 69 67 6e 6f 72 65 64 2c |viously |ignored,|
|00001290| 20 5c 63 6f 64 65 7b 73 | 69 67 6e 61 6c 2e 53 49 | \code{s|ignal.SI|
|000012a0| 47 5f 44 46 4c 7d 20 6d | 65 61 6e 73 20 74 68 61 |G_DFL} m|eans tha|
|000012b0| 74 20 74 68 65 20 64 65 | 66 61 75 6c 74 20 77 61 |t the de|fault wa|
|000012c0| 79 0a 20 20 6f 66 20 68 | 61 6e 64 6c 69 6e 67 20 |y.  of h|andling |
|000012d0| 74 68 65 20 73 69 67 6e | 61 6c 20 77 61 73 20 70 |the sign|al was p|
|000012e0| 72 65 76 69 6f 75 73 6c | 79 20 69 6e 20 75 73 65 |reviousl|y in use|
|000012f0| 2c 20 61 6e 64 20 5c 63 | 6f 64 65 7b 4e 6f 6e 65 |, and \c|ode{None|
|00001300| 7d 20 6d 65 61 6e 73 0a | 20 20 74 68 61 74 20 74 |} means.|  that t|
|00001310| 68 65 20 70 72 65 76 69 | 6f 75 73 20 73 69 67 6e |he previ|ous sign|
|00001320| 61 6c 20 68 61 6e 64 6c | 65 72 20 77 61 73 20 6e |al handl|er was n|
|00001330| 6f 74 20 69 6e 73 74 61 | 6c 6c 65 64 20 66 72 6f |ot insta|lled fro|
|00001340| 6d 20 50 79 74 68 6f 6e | 2e 0a 5c 65 6e 64 7b 66 |m Python|..\end{f|
|00001350| 75 6e 63 64 65 73 63 7d | 0a 0a 5c 62 65 67 69 6e |uncdesc}|..\begin|
|00001360| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 70 61 75 73 65 |{funcdes|c}{pause|
|00001370| 7d 7b 7d 0a 20 20 43 61 | 75 73 65 20 74 68 65 20 |}{}.  Ca|use the |
|00001380| 70 72 6f 63 65 73 73 20 | 74 6f 20 73 6c 65 65 70 |process |to sleep|
|00001390| 20 75 6e 74 69 6c 20 61 | 20 73 69 67 6e 61 6c 20 | until a| signal |
|000013a0| 69 73 20 72 65 63 65 69 | 76 65 64 3b 20 74 68 65 |is recei|ved; the|
|000013b0| 0a 20 20 61 70 70 72 6f | 70 72 69 61 74 65 20 68 |.  appro|priate h|
|000013c0| 61 6e 64 6c 65 72 20 77 | 69 6c 6c 20 74 68 65 6e |andler w|ill then|
|000013d0| 20 62 65 20 63 61 6c 6c | 65 64 2e 20 20 52 65 74 | be call|ed.  Ret|
|000013e0| 75 72 6e 73 20 6e 6f 74 | 68 69 6e 67 2e 20 20 28 |urns not|hing.  (|
|000013f0| 53 65 65 20 74 68 65 0a | 20 20 5c 55 4e 49 58 7b |See the.|  \UNIX{|
|00001400| 7d 20 6d 61 6e 20 70 61 | 67 65 20 5c 63 6f 64 65 |} man pa|ge \code|
|00001410| 7b 73 69 67 6e 61 6c 28 | 32 29 7d 2e 29 0a 5c 65 |{signal(|2)}.).\e|
|00001420| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 62 |nd{funcd|esc}..\b|
|00001430| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 73 |egin{fun|cdesc}{s|
|00001440| 69 67 6e 61 6c 7d 7b 73 | 69 67 6e 61 6c 6e 75 6d |ignal}{s|ignalnum|
|00001450| 5c 2c 20 68 61 6e 64 6c | 65 72 7d 0a 20 20 53 65 |\, handl|er}.  Se|
|00001460| 74 20 74 68 65 20 68 61 | 6e 64 6c 65 72 20 66 6f |t the ha|ndler fo|
|00001470| 72 20 73 69 67 6e 61 6c | 20 5c 76 61 72 7b 73 69 |r signal| \var{si|
|00001480| 67 6e 61 6c 6e 75 6d 7d | 20 74 6f 20 74 68 65 20 |gnalnum}| to the |
|00001490| 66 75 6e 63 74 69 6f 6e | 0a 20 20 5c 76 61 72 7b |function|.  \var{|
|000014a0| 68 61 6e 64 6c 65 72 7d | 2e 20 20 5c 76 61 72 7b |handler}|.  \var{|
|000014b0| 68 61 6e 64 6c 65 72 7d | 20 63 61 6e 20 62 65 20 |handler}| can be |
|000014c0| 61 6e 79 20 63 61 6c 6c | 61 62 6c 65 20 50 79 74 |any call|able Pyt|
|000014d0| 68 6f 6e 20 6f 62 6a 65 | 63 74 2c 20 6f 72 0a 20 |hon obje|ct, or. |
|000014e0| 20 6f 6e 65 20 6f 66 20 | 74 68 65 20 73 70 65 63 | one of |the spec|
|000014f0| 69 61 6c 20 76 61 6c 75 | 65 73 20 5c 63 6f 64 65 |ial valu|es \code|
|00001500| 7b 73 69 67 6e 61 6c 2e | 53 49 47 5f 49 47 4e 7d |{signal.|SIG_IGN}|
|00001510| 20 6f 72 0a 20 20 5c 63 | 6f 64 65 7b 73 69 67 6e | or.  \c|ode{sign|
|00001520| 61 6c 2e 53 49 47 5f 44 | 46 4c 7d 2e 20 20 54 68 |al.SIG_D|FL}.  Th|
|00001530| 65 20 70 72 65 76 69 6f | 75 73 20 73 69 67 6e 61 |e previo|us signa|
|00001540| 6c 20 68 61 6e 64 6c 65 | 72 20 77 69 6c 6c 20 62 |l handle|r will b|
|00001550| 65 20 72 65 74 75 72 6e | 65 64 0a 20 20 28 73 65 |e return|ed.  (se|
|00001560| 65 20 74 68 65 20 64 65 | 73 63 72 69 70 74 69 6f |e the de|scriptio|
|00001570| 6e 20 6f 66 20 5c 63 6f | 64 65 7b 67 65 74 73 69 |n of \co|de{getsi|
|00001580| 67 6e 61 6c 28 29 7d 20 | 61 62 6f 76 65 29 2e 20 |gnal()} |above). |
|00001590| 20 28 53 65 65 20 74 68 | 65 20 5c 55 4e 49 58 7b | (See th|e \UNIX{|
|000015a0| 7d 0a 20 20 6d 61 6e 20 | 70 61 67 65 20 5c 63 6f |}.  man |page \co|
|000015b0| 64 65 7b 73 69 67 6e 61 | 6c 28 32 29 7d 2e 29 0a |de{signa|l(2)}.).|
|000015c0| 0a 20 20 57 68 65 6e 20 | 74 68 72 65 61 64 73 20 |.  When |threads |
|000015d0| 61 72 65 20 65 6e 61 62 | 6c 65 64 2c 20 74 68 69 |are enab|led, thi|
|000015e0| 73 20 66 75 6e 63 74 69 | 6f 6e 20 63 61 6e 20 6f |s functi|on can o|
|000015f0| 6e 6c 79 20 62 65 20 63 | 61 6c 6c 65 64 20 66 72 |nly be c|alled fr|
|00001600| 6f 6d 20 74 68 65 0a 20 | 20 6d 61 69 6e 20 74 68 |om the. | main th|
|00001610| 72 65 61 64 3b 20 61 74 | 74 65 6d 70 74 69 6e 67 |read; at|tempting|
|00001620| 20 74 6f 20 63 61 6c 6c | 20 69 74 20 66 72 6f 6d | to call| it from|
|00001630| 20 6f 74 68 65 72 20 74 | 68 72 65 61 64 73 20 77 | other t|hreads w|
|00001640| 69 6c 6c 20 63 61 75 73 | 65 20 61 0a 20 20 5c 63 |ill caus|e a.  \c|
|00001650| 6f 64 65 7b 56 61 6c 75 | 65 45 72 72 6f 72 7d 20 |ode{Valu|eError} |
|00001660| 65 78 63 65 70 74 69 6f | 6e 20 74 6f 20 62 65 20 |exceptio|n to be |
|00001670| 72 61 69 73 65 64 2e 0a | 0a 20 20 54 68 65 20 5c |raised..|.  The \|
|00001680| 76 61 72 7b 68 61 6e 64 | 6c 65 72 7d 20 69 73 20 |var{hand|ler} is |
|00001690| 63 61 6c 6c 65 64 20 77 | 69 74 68 20 74 77 6f 20 |called w|ith two |
|000016a0| 61 72 67 75 6d 65 6e 74 | 73 3a 20 74 68 65 20 73 |argument|s: the s|
|000016b0| 69 67 6e 61 6c 20 6e 75 | 6d 62 65 72 0a 20 20 61 |ignal nu|mber.  a|
|000016c0| 6e 64 20 74 68 65 20 63 | 75 72 72 65 6e 74 20 73 |nd the c|urrent s|
|000016d0| 74 61 63 6b 20 66 72 61 | 6d 65 20 28 5c 63 6f 64 |tack fra|me (\cod|
|000016e0| 65 7b 4e 6f 6e 65 7d 20 | 6f 72 20 61 20 66 72 61 |e{None} |or a fra|
|000016f0| 6d 65 20 6f 62 6a 65 63 | 74 3b 20 73 65 65 20 74 |me objec|t; see t|
|00001700| 68 65 0a 20 20 72 65 66 | 65 72 65 6e 63 65 20 6d |he.  ref|erence m|
|00001710| 61 6e 75 61 6c 20 66 6f | 72 20 61 20 64 65 73 63 |anual fo|r a desc|
|00001720| 72 69 70 74 69 6f 6e 20 | 6f 66 20 66 72 61 6d 65 |ription |of frame|
|00001730| 20 6f 62 6a 65 63 74 73 | 29 2e 0a 5c 6f 62 69 6e | objects|)..\obin|
|00001740| 64 65 78 7b 66 72 61 6d | 65 7d 0a 5c 65 6e 64 7b |dex{fram|e}.\end{|
|00001750| 66 75 6e 63 64 65 73 63 | 7d 0a                   |funcdesc|}.      |
+--------+-------------------------+-------------------------+--------+--------+