Changeset 692f0c8 for doc/theses/andrew_beach_MMath
- Timestamp:
- May 4, 2021, 12:21:15 PM (4 years ago)
- Branches:
- ADT, arm-eh, ast-experimental, enum, forall-pointer-decay, jacob/cs343-translation, master, new-ast-unique-expr, pthread-emulation, qualifiedEnum
- Children:
- c0c940a
- Parents:
- 403f287
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
doc/theses/andrew_beach_MMath/implement.tex
r403f287 r692f0c8 14 14 15 15 \subsection{Virtual Type} 16 Virtual types only have one change to their structure, the addition of a 17 pointer to the virtual table. This is always the first field so that 18 if it is cast to a supertype the field's location is still known. 19 20 This field is set as part of all new generated constructors. 16 Virtual types only have one change to their structure: the addition of a 17 pointer to the virtual table, called the \emph{virtual-table pointer}. 18 Internally, the field is called 19 @virtual_table@. 20 This constant pointer is always the first field of the table so when 21 casting to a supertype, the field's location is always known. 22 The field is initialized as part of all generated constructors. 21 23 \todo{They only come as part exceptions and don't work.} 22 After the object is created the field is constant. 23 24 However it can be read from, internally it is just a regular field called 25 @virtual_table@. Dereferencing it gives the virtual table and access to the 24 %After the object is created the field is constant. 25 Dereferencing it gives the virtual table and access to the 26 26 type's virtual members. 27 27 28 28 \subsection{Virtual Table} 29 Every time a virtual type is defined the new virtual table type must also be 30 defined. 31 32 The unique instance is important because the address of the virtual table 33 instance is used as the identifier for the virtual type. So a pointer to the 34 virtual table and the ID for the virtual type are interchangable. 29 % PAB: These 2 paragraphs are repeated below, and maybe some of the paragraph above, too. 30 \begin{comment} 31 Every time a virtual type is defined, a new virtual table-type is 32 instantiated. 33 The uniqueness of the virtual-table 34 instance is important because its address 35 is used as the identifier for the virtual type. Hence, a pointer to the 36 virtual table and the ID for the virtual type are interchangeable. 35 37 \todo{Unique instances might be going so we will have to talk about the new 36 38 system instead.} 37 39 38 The first step in putting it all together is to create the virtual table type. 39 The virtual table type is just a structure and can be described in terms of 40 its fields. The first field is always the parent type ID (or a pointer to 41 the parent virtual table) or 0 (the null pointer). 42 Next are other fields on the parent virtual table are repeated. 43 Finally are the fields used to store any new virtual members of the new 44 The virtual type 45 46 The virtual system is accessed through a private constant field inserted at the 47 beginning of every virtual type, called the virtual-table pointer. This field 48 points at a type's virtual table and is assigned during the object's 49 construction. The address of a virtual table acts as the unique identifier for 40 The first step is creating the virtual-table type. 41 The virtual-table type is a structure and is described in terms of 42 its fields. The first field contains the parent-type ID (or a pointer to 43 the parent virtual-table) or 0 (null pointer). 44 Next are repeated fields from on the parent virtual-table. 45 Finally, the fields used to store any new virtual members of the new 46 the virtual type. 47 \end{comment} 48 49 %The virtual system is accessed through a private constant field inserted at the 50 %beginning of every virtual type. This field 51 The virtual-table pointer 52 points at a type's virtual table (see Figure~\vref{f:VirtualTableLayout}). 53 %and is assigned during the object's 54 %construction. 55 The address of a virtual table acts as the unique identifier for 50 56 the virtual type, and the first field of a virtual table is a pointer to the 51 parent virtual-table or @0p@ . The remaining fields are duplicated from the57 parent virtual-table or @0p@ (null pointer). The remaining fields are duplicated from the 52 58 parent tables in this type's inheritance chain, followed by any fields this type 53 introduces. Parent fields are duplicated so they can be changed (all virtual 54 members are overridable), so that references to the dispatched type 59 introduces. Parent fields are duplicated so they can be changed, \ie all virtual 60 members are overridable, while the parent pointer allows access to the original values. 61 Hence, references to the dispatched type 55 62 are replaced with the current virtual type. 56 63 % These are always taken by pointer or reference. 57 64 65 \begin{figure} 58 66 % Simple ascii diragram: 59 \begin{ verbatim}60 parent_pointer \61 parent_field0 |62 ... | Same layout as parent.63 parent_fieldN /64 child_field0 67 \begin{cfa} 68 parent_pointer // \C{parent pointer to access its fields} 69 parent_field0 // \C{same layout as parent to allow replacement} 70 ... 71 parent_fieldN 72 child_field0 // \C{new types for this virtual table} 65 73 ... 66 74 child_fieldN 67 \end{verbatim} 68 \todo{Refine the diagram} 75 size 76 alignment 77 \end{cfa} 78 %\todo{Refine the diagram} 79 \caption{Virtual Table Layout} 80 \label{f:VirtualTableLayout} 81 \end{figure} 69 82 70 83 % For each virtual type, a virtual table is constructed. This is both a new type … … 73 86 % the type and the instance. 74 87 75 A virtual table is created when the virtual type is created. The name of the 88 \begin{comment} 89 PAB: seems to be said already. 90 A virtual table is created when a virtual type is created. The name of the 76 91 type is created by mangling the name of the base type. The name of the instance 77 92 is also generated by name mangling. The fields are initialized automatically. 78 93 The parent field is initialized by getting the type of the parent field and 79 using that to calculate the mangled name of the parent's virtual table type. 94 using that to calculate the mangled name of the parent's virtual-table type. 95 \end{comment} 80 96 There are two special fields that are included like normal fields but have 81 97 special initialization rules: the @size@ field is the type's size and is … … 86 102 87 103 These operations are split up into several groups depending on where they take 88 place which varies for monomorphic and polymorphic types. The first devision is104 place, which varies for monomorphic and polymorphic types. The first devision is 89 105 between the declarations and the definitions. Declarations, such as a function 90 signature or a aggregate's name, must always be visible but may be repeated in106 signature or an aggregate's name, must always be visible but may be repeated in 91 107 the form of forward declarations in headers. Definitions, such as function 92 108 bodies and a aggregate's layout, can be separately compiled but must occur 93 109 exactly once in a source file. 94 110 95 \begin{sloppypar} 96 The declarations include the virtual type definition and forward declarations 97 of the virtual table instance, constructor, message function and 111 The declarations include the virtual-type definition and forward declarations 112 of the virtual-table instance, constructor, message function and 98 113 @get_exception_vtable@. The definition includes the storage and initialization 99 114 of the virtual table instance and the bodies of the three functions. 100 \end{sloppypar} 101 102 Monomorphic instances put all of these two groups in one place each. 103 Polymorphic instances also split out the core declarations and definitions from 104 the per-instance information. The virtual table type and most of the functions 105 are polymorphic so they are all part of the core. The virtual table instance 106 and the @get_exception_vtable@ function. 107 108 \begin{sloppypar} 115 116 Monomorphic instances put all of these two groups in one place. 117 Polymorphic instances split out the core declarations and definitions from 118 the per-instance information. The virtual-table type and most of the functions 119 are polymorphic so they are all part of the core. The virtual-table instance 120 and the @get_exception_vtable@ function \PAB{ are ...}. 121 109 122 Coroutines and threads need instances of @CoroutineCancelled@ and 110 123 @ThreadCancelled@ respectively to use all of their functionality. When a new 111 data type is declared with @coroutine@ or @thread@ the forward declaration for124 data type is declared with @coroutine@ or @thread@, the forward declaration for 112 125 the instance is created as well. The definition of the virtual table is created 113 126 at the definition of the main function. 114 \end{sloppypar} 127 128 \PAB{You need an example here to show what happens for this case.} 129 115 130 116 131 \subsection{Virtual Cast} … … 121 136 The function is 122 137 \begin{cfa} 123 void * __cfa__virtual_cast( 124 struct __cfa__parent_vtable const * parent, 138 void * __cfa__virtual_cast( struct __cfa__parent_vtable const * parent, 125 139 struct __cfa__parent_vtable const * const * child ); 126 140 \end{cfa} 127 and it is implemented in the standard library. The structure reperents the 128 head of a vtable which is the pointer to the parent virtual table. The 129 @parent@ points directly at the parent type virtual table while the @child@ 130 points at the object of the (possibe) child type. 131 132 In terms of the virtual cast expression, @parent@ comes from looking up the 141 and it is implemented in the standard library. The structure represents the 142 head of a virtual table, which is the pointer to the parent virtual table. The 143 @parent@ points directly at the parent-type virtual-table, while the @child@ 144 points at the object of the (possible) child type. 145 146 \PAB{Need a figure to show this relationship.} 147 148 In terms of the virtual-cast expression, @parent@ comes from looking up the 133 149 type being cast to and @child@ is the result of the expression being cast. 134 Because the complier outputs C code, some type Ctype casts are also used.135 The last bit of glue is a nmap that saves every virtual type the compiler136 sees. This is used to check the type used in a virtual cast is a virtual150 Because the complier outputs C code, some C-type casts are also used. 151 The last bit of glue is a map that saves every virtual type the compiler 152 sees. This table is used to check the type used in a virtual cast is a virtual 137 153 type and to get its virtual table. 138 154 (It also checks for conflicting definitions.) 139 155 140 Inside the function it is a simple conditional. If the type repersented by 141 @parent@ is or is an ancestor of the type repersented by @*child@ (it 142 requires one more level of derefence to pass through the object) then @child@ 156 \PAB{Can this be rolled into the figure above?} 157 158 Inside the function is a simple conditional. If the type represented by 159 @parent@ is an ancestor of the type represented by @*child@ (it 160 requires one more level of dereference to pass through the object) then @child@ 143 161 is returned, otherwise the null pointer is returned. 144 162 145 The check i tself is preformed is a simple linear search. If the child146 virtual table or any of its ancestors (which are retr eved through the first147 field of every virtual table) are the same as the parent virtual 163 The check is a simple linear search (like \Cpp RTTI). If the child 164 virtual table or any of its ancestors (which are retrieved through the first 165 field of every virtual table) are the same as the parent virtual-table then 148 166 the cast succeeds. 149 167 … … 156 174 % resumption doesn't as well. 157 175 158 % Many modern languages work with an inter al stack that function push and pop176 % Many modern languages work with an internal stack that function push and pop 159 177 % their local data to. Stack unwinding removes large sections of the stack, 160 178 % often across functions. 161 179 162 180 Stack unwinding is the process of removing stack frames (activations) from the 163 stack. On function entry and return, unwinding is handled directly by the c ode164 embedded in thefunction. Usually, the stack-frame size is known statically181 stack. On function entry and return, unwinding is handled directly by the call/return code 182 embedded in a function. Usually, the stack-frame size is known statically 165 183 based on parameter and local variable declarations. For dynamically-sized 166 local variables, a runtime computation is necessary to know the frame 184 local variables. 185 (Often called a variable-length array or VLA, even when the variable type is an aggregate.) 186 For VLAs, a runtime computation is necessary to know the frame 167 187 size. Finally, a function's frame-size may change during execution as local 168 variables (static or dynamic sized) go in and out of scope .188 variables (static or dynamic sized) go in and out of scope, which is a form of VLA. 169 189 Allocating/deallocating stack space is usually an $O(1)$ operation achieved by 170 190 bumping the hardware stack-pointer up or down as needed. 171 191 172 Unwinding across multiple stack frames is more complex because individual stack 173 management code associated with each frame isbypassed. That is, the location192 Unwinding across multiple stack frames is more complex because individual stack-management 193 code associated with each frame can be bypassed. That is, the location 174 194 of a function's frame-management code is largely unknown and dispersed 175 195 throughout the function, hence the current frame size managed by that code is … … 191 211 reseting to a snap-shot of an arbitrary but existing function frame on the 192 212 stack. It is up to the programmer to ensure the snap-shot is valid when it is 193 reset, making this unwinding approach fragile with potential errors that are 213 reset and that unwound frames do not have side-effects. 214 Hence, this unwinding approach is fragile with potential errors that are 194 215 difficult to debug because the stack becomes corrupted. 195 216 196 However, many languages define cleanup actions that must be taken when objects 197 are deallocated from the stack or blocks end, such as running a variable's 198 destructor or a @try@ statement's @finally@ clause. Handling these mechanisms 217 With respect to stack side-effects, many languages define cleanup actions that must be taken when objects 218 are deallocated from the stack, when the function of blocks within the function end, such as running a variable's 219 destructor or a @try@ statement's @finally@ clause. 220 The purpose of these side-effects is to reestablish the global state of the program, such as dynamic memory-allocation or file access. 221 Handling these side-effect mechanisms 199 222 requires walking the stack and checking each stack frame for these potential 200 actions .201 202 For exceptions, it must be possible to walk the stack frames in search of @try@223 actions, where a frame can be any block with declarations. 224 225 In languages like \Cpp and Java, it must be possible to walk the stack frames in search of @try@ 203 226 statements to match and execute a handler. For termination exceptions, it must 204 227 also be possible to unwind all stack frames from the throw to the matching 205 catch , and each of these frames must be checked for cleanup actions. Stack228 catch (including the @try@ block), and each of these frames must be checked for cleanup actions. Stack 206 229 walking is where most of the complexity and expense of exception handling 207 230 appears. … … 226 249 LSDA can contain any information but conventionally it is a table with entries 227 250 representing regions of the function and what has to be done there during 228 unwinding. These regions are bracketed by the instruction pointer. If the251 unwinding. These regions are bracketed by instruction addresses. If the 229 252 instruction pointer is within a region's start/end, then execution is currently 230 253 executing in that region. Regions are used to mark out the scopes of objects … … 238 261 239 262 The GCC compilation flag @-fexceptions@ causes the generation of an LSDA and 240 attaches its personality function. However, this 263 attaches its personality function. 264 It attaches a series of opaque directives (@.cfi_personality@ directive) 265 used internally and not part of this work. 266 However, this 241 267 flag only handles the cleanup attribute: 242 \todo{Peter: What is attached? Andrew: It uses the .cfi\_personality directive243 and that's all I know.}244 268 \begin{cfa} 245 269 void clean_up( int * var ) { ... } 246 270 int avar __attribute__(( cleanup(clean_up) )); 247 271 \end{cfa} 248 which is used on a variable and specifies a function, in this case @clean_up@, 249 run when the variable goes out of scope. 250 The function is passed a pointer to the object being removed from the stack 251 so it can be used to mimic destructors. 272 that is used on a variable and specifies a function, in this case @clean_up@, 273 run when the variable goes out of scope, which is used to mimic destructors. 252 274 However, this feature cannot be used to mimic @try@ statements as it cannot 253 275 control the unwinding. … … 257 279 section covers some of the important parts of the interface. 258 280 259 A personality function can p reform different actions depending on how it is281 A personality function can perform different actions depending on how it is 260 282 called. 261 283 \begin{lstlisting}[language=C,{moredelim=**[is][\color{red}]{@}{@}}] … … 268 290 \end{lstlisting} 269 291 The @action@ argument is a bitmask of possible actions: 270 \begin{enumerate} 292 \begin{enumerate}[topsep=5pt] 271 293 \item 272 294 @_UA_SEARCH_PHASE@ specifies a search phase and tells the personality function … … 291 313 @_UA_FORCE_UNWIND@ specifies a forced unwind call. Forced unwind only performs 292 314 the cleanup phase and uses a different means to decide when to stop 293 (see \vref{s:ForcedUnwind}).315 (see Section~\vref{s:ForcedUnwind}). 294 316 \end{enumerate} 295 317 296 318 The @exception_class@ argument is a copy of the 297 319 \lstinline[language=C]|exception|'s @exception_class@ field. 320 \PAB{Say more.} 298 321 299 322 The \lstinline[language=C]|exception| argument is a pointer to the user 300 323 provided storage object. It has two public fields, the exception class, which 301 is actuallyjust a number, identifying the exception handling mechanism that324 is just a number, identifying the exception handling mechanism that 302 325 created it, and the cleanup function. The cleanup function is called if 303 326 required by the exception. … … 309 332 that can be passed several places in libunwind. It includes a number of 310 333 messages for special cases (some of which should never be used by the 311 personality function) and error codes but unless otherwise notedthe334 personality function) and error codes. However, unless otherwise noted, the 312 335 personality function should always return @_URC_CONTINUE_UNWIND@. 313 336 … … 324 347 @_URC_END_OF_STACK@. 325 348 326 Second, when a handler is matched, raise exception continues ontothe cleanup349 Second, when a handler is matched, raise exception walks the stack again performing the cleanup 327 350 phase. 328 351 Once again, it calls the personality functions of each stack frame from newest … … 338 361 Forced Unwind is the other central function in libunwind. 339 362 \begin{cfa} 340 _Unwind_Reason_Code _Unwind_ForcedUnwind( 363 _Unwind_Reason_Code _Unwind_ForcedUnwind(_Unwind_Exception *, 341 364 _Unwind_Stop_Fn, void *); 342 365 \end{cfa} … … 380 403 Each stack must have its own exception context. In a sequential \CFA program, 381 404 there is only one stack with a single global exception-context. However, when 382 the library @libcfathread@ is linked, there are multiple stacks where each405 the library @libcfathread@ is linked, there are multiple stacks, where each 383 406 needs its own exception context. 384 407 385 General access to the exception context is provided by function 386 @this_exception_context@.For sequential execution, this function is defined as408 The function @this_exception_context@ provides general access to the exception context. 409 For sequential execution, this function is defined as 387 410 a weak symbol in the \CFA system-library, @libcfa@. When a \CFA program is 388 411 concurrent, it links with @libcfathread@, where this function is defined with a … … 390 413 391 414 The sequential @this_exception_context@ returns a hard-coded pointer to the 392 global ex ecption context.415 global exception context. 393 416 The concurrent version adds the exception context to the data stored at the 394 base of each stack. When @this_exception_context@ is called it retrieves the417 base of each stack. When @this_exception_context@ is called, it retrieves the 395 418 active stack and returns the address of the context saved there. 396 419 … … 399 422 % catches. Talk about GCC nested functions. 400 423 401 Termination exceptions use libunwind heavily because it matches the intended402 use from\Cpp exceptions closely. The main complication for \CFA is that the424 Termination exceptions use libunwind heavily because \CFA termination exceptions match 425 \Cpp exceptions closely. The main complication for \CFA is that the 403 426 compiler generates C code, making it very difficult to generate the assembly to 404 427 form the LSDA for try blocks or destructors. … … 407 430 The first step of a termination raise is to copy the exception into memory 408 431 managed by the exception system. Currently, the system uses @malloc@, rather 409 than reserved memory or the stack top. The exception 432 than reserved memory or the stack top. The exception-handling mechanism manages 410 433 memory for the exception as well as memory for libunwind and the system's own 411 434 per-exception storage. 412 435 413 [Quick ASCII diagram to get started.] 436 \begin{figure} 414 437 \begin{verbatim} 415 438 Fixed Header | _Unwind_Exception <- pointer target … … 420 443 V ... 421 444 \end{verbatim} 422 423 Exceptions are stored in variable-sized blocks. 424 The first component is a fixed sized data structure that contains the 445 \caption{Exception Layout} 446 \label{f:ExceptionLayout} 447 \end{figure} 448 449 Exceptions are stored in variable-sized blocks (see Figure~\vref{f:ExceptionLayout}). 450 The first component is a fixed-sized data-structure that contains the 425 451 information for libunwind and the exception system. The second component is an 426 452 area of memory big enough to store the exception. Macros with pointer arthritic … … 428 454 @_Unwind_Exception@ to the entire node. 429 455 430 All of these nodes are linked together in a list, one list per stack, with the 456 Multiple exceptions can exist because handlers can call functions that raise 457 exceptions. Figure~\vref{f:MultipleExceptions} shows a \Cpp program where 458 exceptions are handled, and then a function is called from the handler that 459 raises a new exception. The previous exception must persist because it is 460 unhandled, and hence, control can return to the handler and that exception is 461 reraised. 462 463 \begin{figure} 464 \centering 465 \newsavebox{\myboxA} 466 \newsavebox{\myboxB} 467 \begin{lrbox}{\myboxA} 468 \begin{lstlisting}[language=C++,{moredelim=**[is][\color{red}]{@}{@}}] 469 struct E {}; 470 int cnt = 3; 471 void f( int i ) { 472 if ( i == 0 ) @throw E();@ 473 try { 474 @f( i - 1 );@ 475 } catch( E ) { // handler h 476 cnt -= 1; 477 if ( cnt > 0 ) @f( 2 );@ 478 } 479 } 480 int main() { @f( 2 );@ } 481 \end{lstlisting} 482 \end{lrbox} 483 484 \begin{lrbox}{\myboxB} 485 \begin{lstlisting} 486 h $\makebox[0pt][l]{\textbackslash}f$ 487 f 488 f 489 h $\makebox[0pt][l]{\textbackslash}f$ throw E$\(_2\)$ 490 f 491 f 492 h $\makebox[0pt][l]{\textbackslash}f$ throw E$\(_1\)$ 493 f 494 f 495 \end{lstlisting} 496 \end{lrbox} 497 498 {\usebox\myboxA} 499 \hspace{25pt} 500 {\usebox\myboxB} 501 502 \caption{Multiple Exceptions} 503 \label{f:MultipleExceptions} 504 \end{figure} 505 506 In this case, the exception nodes are linked together in a list, one list per stack, with the 431 507 list head stored in the exception context. Within each linked list, the most 432 508 recently thrown exception is at the head followed by older thrown … … 439 515 exception, the copy function, and the free function, so they are specific to an 440 516 exception type. The size and copy function are used immediately to copy an 441 exception into managed memory. After the exception is handled the free function517 exception into managed memory. After the exception is handled, the free function 442 518 is used to clean up the exception and then the entire node is passed to free 443 519 so the memory can be given back to the heap. … … 445 521 \subsection{Try Statements and Catch Clauses} 446 522 The try statement with termination handlers is complex because it must 447 compensate for the lack of assembly -code generated from \CFA. Libunwind523 compensate for the lack of assembly code generated from \CFA. Libunwind 448 524 requires an LSDA and personality function for control to unwind across a 449 525 function. The LSDA in particular is hard to mimic in generated C code. … … 454 530 calls them. 455 531 Because this function is known and fixed (and not an arbitrary function that 456 happens to contain a try statement) this means the LSDA can be generated ahead532 happens to contain a try statement), this means the LSDA can be generated ahead 457 533 of time. 458 534 459 535 Both the LSDA and the personality function are set ahead of time using 460 embedded assembly. This is handcrafted using C @asm@ statements and contains461 enough information for the single try statement the function rep ersents.536 embedded assembly. This assembly code is handcrafted using C @asm@ statements and contains 537 enough information for the single try statement the function represents. 462 538 463 539 The three functions passed to try terminate are: … … 487 563 nested functions and all other functions besides @__cfaehm_try_terminate@ in 488 564 \CFA use the GCC personality function and the @-fexceptions@ flag to generate 489 the LSDA. This allows destructors to be implemented with the cleanup attribute. 565 the LSDA. Through this mechanism, \CFA destructors are implemented via the cleanup attribute. 566 567 \PAB{Try to put together an example try statement illustrating these components.} 490 568 491 569 \section{Resumption} 492 570 % The stack-local data, the linked list of nodes. 493 571 494 Resumption simple to implement because there is no stack unwinding. The 572 Resumption is simpler to implement than termination because there is no stack 573 unwinding. \PAB{You need to explain how the \lstinline{catchResume} clauses are 574 handled. Do you use the personality mechanism in libunwind or do you roll your 575 own mechanism?} 576 577 The 495 578 resumption raise uses a list of nodes for its stack traversal. The head of the 496 579 list is stored in the exception context. The nodes in the list have a pointer 497 580 to the next node and a pointer to the handler function. 498 499 581 A resumption raise traverses this list. At each node the handler function is 500 582 called, passing the exception by pointer. It returns true if the exception is … … 512 594 the stack 513 595 already examined, is accomplished by updating the front of the list as the 514 search continues. Before the handler at a node is called the head of the list596 search continues. Before the handler at a node is called, the head of the list 515 597 is updated to the next node of the current node. After the search is complete, 516 598 successful or not, the head of the list is reset. … … 521 603 the other handler checked up to this point are not checked again. 522 604 523 This structure also supports new handler added while the resumption is being605 This structure also supports new handlers added while the resumption is being 524 606 handled. These are added to the front of the list, pointing back along the 525 607 stack -- the first one points over all the checked handlers -- and the ordering 526 608 is maintained. 609 610 \PAB{Again, a figure to show how this works would be helpful.} 527 611 528 612 \label{p:zero-cost} … … 539 623 % that unwind is required knowledge for that chapter. 540 624 625 \PAB{This paragraph needs to be moved to the start of this Section, where I have have my other comment.} 626 541 627 \section{Finally} 542 628 % Uses destructors and GCC nested functions. 543 Finally clauses is placed into a GCC nested-function with a uniquename, and no629 A finally clause is placed into a GCC nested-function with a unique mangled name, and no 544 630 arguments or return values. This nested function is then set as the cleanup 545 631 function of an empty object that is declared at the beginning of a block placed 546 around the context of theassociated @try@ statement.547 548 The rest is handled by GCC. The try block and all handlers are inside th e632 around the context of an associated @try@ statement. 633 634 The rest is handled by GCC. The try block and all handlers are inside this 549 635 block. At completion, control exits the block and the empty object is cleaned 550 636 up, which runs the function that contains the finally code. … … 554 640 555 641 Cancellation also uses libunwind to do its stack traversal and unwinding, 556 however it uses a different primary function @_Unwind_ForcedUnwind@. Details557 of its interface can be found in the\vref{s:ForcedUnwind}.642 however it uses a different primary function, @_Unwind_ForcedUnwind@. Details 643 of its interface can be found in Section~\vref{s:ForcedUnwind}. 558 644 559 645 The first step of cancellation is to find the cancelled stack and its type: 560 coroutine or thread. Fortunately, the thread library stores the main thread 561 pointer and the current thread pointer, and every thread stores a pointer to 562 its main coroutine and the coroutine it is currently executing. 563 564 So if the active thread's main and current coroutine are the same. If they 565 are then the current stack is a thread stack, otherwise it is a coroutine 566 stack. If it is a thread stack then an equality check with the stored main 567 thread pointer and current thread pointer is enough to tell if the current 568 thread is the main thread or not. 569 646 coroutine or thread. Fortunately, the thread library stores the program-main thread 647 pointer and the current-thread pointer, and every thread stores a pointer to 648 the current coroutine it is executing. 649 650 \PAB{I don't know if my corrections in the previous paragraph are correct.} 651 652 When the active thread and coroutine are the same, the current stack is the thread stack, otherwise it is a coroutine 653 stack. 654 % PAB: repeated? 655 % If it is a thread stack, then an equality check with the stored main 656 % thread pointer and current thread pointer is enough to tell if the current 657 % thread is the main thread or not. 570 658 However, if the threading library is not linked, the sequential execution is on 571 659 the main stack. Hence, the entire check is skipped because the weak-symbol … … 575 663 Regardless of how the stack is chosen, the stop function and parameter are 576 664 passed to the forced-unwind function. The general pattern of all three stop 577 functions is the same: they continue unwinding until the end of stack when they578 do there primary work. 579 665 functions is the same: continue unwinding until the end of stack. 666 %when they 667 %do there primary work. 580 668 For main stack cancellation, the transfer is just a program abort. 581 669 582 For coroutine cancellation, the exception is stored on the coroutine's stack,670 For coroutine cancellation, the exception is stored in the coroutine's stack, 583 671 and the coroutine context switches to its last resumer. The rest is handled on 584 672 the backside of the resume, which check if the resumed coroutine is
Note: See TracChangeset
for help on using the changeset viewer.