home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / tolkit45.zip / os2tk45 / inc / bsexcpt.inc < prev    next >
Text File  |  1999-04-30  |  11KB  |  310 lines
  1. ; static char *SCCSID = "@(#)bsexcpt.h  6.5 91/08/22";  
  2. ;       SCCSID = @(#)bsexcpt.h  6.5 91/08/22   
  3. ;*************************** START OF SPECIFICATION ************************ *                                                                         *
  4. ;* Source File Name: BSEXCPT.H                                             *
  5. ;*                                                                         *
  6. ;* Descriptive Name: Thread Exception Constants and Structure Definitions. *
  7. ;*                                                                         *
  8. ;* Copyright (c) IBM Corporation 1987,1991                                 *
  9. ;* Copyright (c) Microsoft Corporation 1987,1991                           *
  10. ;*                                                                         *
  11. ;* Function: This file provides constants and data structure definitions   *
  12. ;*      required by application programs to use 32-bit thread exceptions   *
  13. ;*      management facility.                                               *
  14. ;*                                                                         *
  15. ;***************************  END OF SPECIFICATION ************************  
  16. ; 
  17. ;* User Exception Handler Return Codes:
  18. ;  
  19. XCPT_CONTINUE_SEARCH    EQU    00000000H       ;  Exception not handled     
  20. XCPT_CONTINUE_EXECUTION    EQU    0FFFFFFFFH       ;  Exception handled         
  21. XCPT_CONTINUE_STOP    EQU    00716668H       ;  Exception handled by      
  22.                                                 ;  debugger (via DosDebug)   
  23. ; 
  24. ;* fHandlerFlags values (see ExceptionReportRecord):
  25. ;*
  26. ;* The user may only set (but not clear) the EH_NONCONTINUABLE flag.
  27. ;* All other flags are set by the system.
  28. ;*
  29. ;  
  30. EH_NONCONTINUABLE    EQU    1H           ;  Noncontinuable exception           
  31. EH_UNWINDING    EQU    2H                ;  Unwind is in progress              
  32. EH_EXIT_UNWIND    EQU    4H              ;  Exit unwind is in progress         
  33. EH_STACK_INVALID    EQU    8H            ;  Stack out of limits or unaligned   
  34. EH_NESTED_CALL    EQU    10H             ;  Nested exception handler call      
  35. EH_SIGFTERM    EQU    20H                ;  Forced SIGTERM                   @SEC
  36. ; 
  37. ;* Unwind all exception handlers (see DosUnwindException API)
  38. ;  
  39. UNWIND_ALL    EQU    0 
  40. ; 
  41. ;*   Exception values are 32-bit values laid out as follows:
  42. ;*
  43. ;*   3 3 2 2 2 2 2 2 2 2 2 2 1 1 1 1 1 1 1 1 1 1
  44. ;*   1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0
  45. ;*   +---+-+-------------------------+-------------------------------+
  46. ;*   |Sev|C|       Facility          |               Code            |
  47. ;*   +---+-+-------------------------+-------------------------------+
  48. ;*
  49. ;*   where
  50. ;*
  51. ;*       Sev - is the severity code
  52. ;*           00 - Success
  53. ;*           01 - Informational
  54. ;*           10 - Warning
  55. ;*           11 - Error
  56. ;*
  57. ;*       C - is the Customer code flag
  58. ;*
  59. ;*       Facility - is the facility code
  60. ;*
  61. ;*       Code - is the facility's status code
  62. ;*
  63. ;*   Exceptions specific to OS/2 2.0 (e.g. XCPT_SIGNAL) will be marked
  64. ;*   with a facility code of 1.
  65. ;*
  66. ;*   System defined exceptions have a facility code of zero.
  67. ;*
  68. ;*   Each exception may also have several pieces of additional information.
  69. ;*   These are stored in the ExceptionInfo fields of the
  70. ;*   ExceptionReportRecord. They are documented here with the exceptions
  71. ;*   only for ease of reference.
  72. ;  
  73. XCPT_FATAL_EXCEPTION    EQU    0C0000000H 
  74. XCPT_SEVERITY_CODE    EQU    0C0000000H 
  75. XCPT_CUSTOMER_CODE    EQU    20000000H 
  76. XCPT_FACILITY_CODE    EQU    1FFF0000H 
  77. XCPT_EXCEPTION_CODE    EQU    0000FFFFH 
  78. ; 
  79. ;* Violation flags in ExceptionInfo
  80. ;  
  81. XCPT_UNKNOWN_ACCESS    EQU    00000000H       ;  Unknown access            
  82. XCPT_READ_ACCESS    EQU    00000001H       ;  Read access               
  83. XCPT_WRITE_ACCESS    EQU    00000002H       ;  Write access              
  84. XCPT_EXECUTE_ACCESS    EQU    00000004H       ;  Execute access            
  85. XCPT_SPACE_ACCESS    EQU    00000008H       ;  Address space access      
  86. XCPT_LIMIT_ACCESS    EQU    00000010H       ;  Address space limit       
  87.                                                 ;  violation                 
  88. XCPT_DATA_UNKNOWN    EQU    0FFFFFFFFH 
  89. ; 
  90. ;* Signal numbers for XCPT_SIGNAL
  91. ;  
  92. XCPT_SIGNAL_INTR    EQU    1 
  93. XCPT_SIGNAL_KILLPROC    EQU    3 
  94. XCPT_SIGNAL_BREAK    EQU    4 
  95. XCPT_SIGNAL_APTERM    EQU    8                                   ; 108449  
  96. ; 
  97. ;* Portable non-fatal software generated exceptions
  98. ;  
  99. XCPT_GUARD_PAGE_VIOLATION    EQU    80000001H 
  100.       ;  ExceptionInfo[ 0 ] - Access Code: XCPT_READ_ACCESS
  101. ;                                          XCPT_WRITE_ACCESS   
  102.       ;  ExceptionInfo[ 1 ] - FaultAddr   
  103. XCPT_UNABLE_TO_GROW_STACK    EQU    80010001H 
  104. ; 
  105. ;* Portable fatal hardware generated exceptions
  106. ;  
  107. XCPT_DATATYPE_MISALIGNMENT    EQU    0C000009EH 
  108.       ;  ExceptionInfo[ 0 ] - Access Code: XCPT_READ_ACCESS
  109. ;                                          XCPT_WRITE_ACCESS   
  110.       ;  ExceptionInfo[ 1 ] - Alignment   
  111.       ;  ExceptionInfo[ 2 ] - FaultAddr   
  112. XCPT_BREAKPOINT    EQU    0C000009FH 
  113. XCPT_SINGLE_STEP    EQU    0C00000A0H 
  114. XCPT_ACCESS_VIOLATION    EQU    0C0000005H 
  115.       ;  ExceptionInfo[ 0 ] - Access Code: XCPT_READ_ACCESS
  116. ;                                          XCPT_WRITE_ACCESS
  117. ;                                          XCPT_SPACE_ACCESS
  118. ;                                          XCPT_LIMIT_ACCESS
  119. ;                                          XCPT_UNKNOWN_ACCESS   
  120.       ;  ExceptionInfo[ 1 ] - FaultAddr (XCPT_READ_ACCESS/XCPT_WRITE_ACCESS)
  121. ;                             Selector  (XCPT_SPACE_ACCESS)
  122. ;                             -1        (XCPT_LIMIT_ACCESS)   
  123. XCPT_ILLEGAL_INSTRUCTION    EQU    0C000001CH 
  124. XCPT_FLOAT_DENORMAL_OPERAND    EQU    0C0000094H 
  125. XCPT_FLOAT_DIVIDE_BY_ZERO    EQU    0C0000095H 
  126. XCPT_FLOAT_INEXACT_RESULT    EQU    0C0000096H 
  127. XCPT_FLOAT_INVALID_OPERATION    EQU    0C0000097H 
  128. XCPT_FLOAT_OVERFLOW    EQU    0C0000098H 
  129. XCPT_FLOAT_STACK_CHECK    EQU    0C0000099H 
  130. XCPT_FLOAT_UNDERFLOW    EQU    0C000009AH 
  131. XCPT_INTEGER_DIVIDE_BY_ZERO    EQU    0C000009BH 
  132. XCPT_INTEGER_OVERFLOW    EQU    0C000009CH 
  133. XCPT_PRIVILEGED_INSTRUCTION    EQU    0C000009DH 
  134. ; 
  135. ;* Portable fatal software generated exceptions
  136. ;  
  137. XCPT_IN_PAGE_ERROR    EQU    0C0000006H 
  138.       ;  ExceptionInfo[ 0 ] - FaultAddr   
  139. XCPT_PROCESS_TERMINATE    EQU    0C0010001H 
  140. XCPT_ASYNC_PROCESS_TERMINATE    EQU    0C0010002H 
  141.       ;  ExceptionInfo[ 0 ] - TID of 'terminator' thread   
  142. XCPT_NONCONTINUABLE_EXCEPTION    EQU    0C0000024H 
  143. XCPT_INVALID_DISPOSITION    EQU    0C0000025H 
  144. ; 
  145. ;* Non-portable fatal exceptions
  146. ;  
  147. XCPT_INVALID_LOCK_SEQUENCE    EQU    0C000001DH 
  148. XCPT_ARRAY_BOUNDS_EXCEEDED    EQU    0C0000093H 
  149. XCPT_B1NPX_ERRATA_02    EQU    0C0010004H 
  150. ; 
  151. ;* Misc exceptions
  152. ;  
  153. XCPT_UNWIND    EQU    0C0000026H 
  154. XCPT_BAD_STACK    EQU    0C0000027H 
  155. XCPT_INVALID_UNWIND_TARGET    EQU    0C0000028H 
  156. ; 
  157. ;* Signal Exceptions
  158. ;  
  159. XCPT_SIGNAL    EQU    0C0010003H 
  160.       ;  ExceptionInfo[ 0 ] - Signal Number   
  161. ; 
  162. ;* ContextRecord
  163. ;*
  164. ;* This is the machine specific register contents for the thread
  165. ;* at the time of the exception. Note that only the register sets
  166. ;* specified by ContextFlags contain valid data. Conversely, only
  167. ;* registers specified in ContextFlags will be restored if an exception
  168. ;* is handled.
  169. ;  
  170. ; 
  171. ;* The following flags control the contents of the ContextRecord.
  172. ;  
  173. CONTEXT_CONTROL    EQU    00000001H   ;  SS:ESP, CS:EIP, EFLAGS,      
  174.                                              ;  EBP                          
  175. CONTEXT_INTEGER    EQU    00000002H   ;  EAX, EBX, ECX, EDX, ESI,     
  176.                                              ;  EDI                          
  177. CONTEXT_SEGMENTS    EQU    00000004H   ;  DS, ES, FS, GS               
  178. CONTEXT_FLOATING_POINT    EQU    00000008H   ;  Numeric coprocessor state    
  179. CONTEXT_FULL    EQU    (CONTEXT_CONTROL  OR  CONTEXT_INTEGER  OR                        CONTEXT_SEGMENTS  OR  CONTEXT_FLOATING_POINT)
  180.  
  181. _fpreg    STRUC
  182. losig    DD    ?
  183. hisig    DD    ?
  184. signexp    DW    ?
  185. _fpreg    ENDS
  186.  
  187. FPREG struc
  188. db size _fpreg dup(?)
  189. FPREG ends
  190.  
  191.  
  192. _CONTEXT    STRUC
  193.   ; 
  194. ;  * The flags values within this flag control the contents of
  195. ;  * a ContextRecord.
  196. ;  *
  197. ;  * If the ContextRecord is used as an input parameter, then
  198. ;  * for each portion of the ContextRecord controlled by a flag
  199. ;  * whose value is set, it is assumed that that portion of the
  200. ;  * ContextRecord contains valid context. If the ContextRecord
  201. ;  * is being used to modify a thread's context, then only that
  202. ;  * portion of the thread's context will be modified.
  203. ;  *
  204. ;  * If the ContextRecord is used as an Input/Output parameter to
  205. ;  * capture the context of a thread, then only those portions of the
  206. ;  * thread's context corresponding to set flags will be returned.
  207. ;    
  208. ContextFlags    DD    ?
  209.   ; 
  210. ;  * This section is specified/returned if the ContextFlags
  211. ;  * contains the flag CONTEXT_FLOATING_POINT.
  212. ;    
  213. ctx_env    DD    7 DUP (?)
  214. ctx_stack    DB    SIZE _fpreg * 8 DUP (?)
  215.   ; 
  216. ;  * This section is specified/returned if the ContextFlags
  217. ;  * contains the flag CONTEXT_SEGMENTS.
  218. ;    
  219. ctx_SegGs    DD    ?
  220. ctx_SegFs    DD    ?
  221. ctx_SegEs    DD    ?
  222. ctx_SegDs    DD    ?
  223.   ; 
  224. ;  * This section is specified/returned if the ContextFlags
  225. ;  * contains the flag CONTEXT_INTEGER.
  226. ;    
  227. ctx_RegEdi    DD    ?
  228. ctx_RegEsi    DD    ?
  229. ctx_RegEax    DD    ?
  230. ctx_RegEbx    DD    ?
  231. ctx_RegEcx    DD    ?
  232. ctx_RegEdx    DD    ?
  233.   ; 
  234. ;  * This section is specified/returned if the ContextFlags
  235. ;  * contains the flag CONTEXT_CONTROL.
  236. ;    
  237. ctx_RegEbp    DD    ?
  238. ctx_RegEip    DD    ?
  239. ctx_SegCs    DD    ?
  240. ctx_EFlags    DD    ?
  241. ctx_RegEsp    DD    ?
  242. ctx_SegSs    DD    ?
  243. _CONTEXT    ENDS
  244.  
  245. CONTEXTRECORD struc
  246. db size _CONTEXT dup(?)
  247. CONTEXTRECORD ends
  248.  
  249. PCONTEXTRECORD struc
  250.     dd ?
  251. PCONTEXTRECORD ends
  252.  
  253. ; 
  254. ;* ExceptionReportRecord
  255. ;*
  256. ;* This structure contains machine independant information about an
  257. ;* exception/unwind. No system exception will ever have more than
  258. ;* EXCEPTION_MAXIMUM_PARAMETERS parameters. User exceptions are not
  259. ;* bound to this limit.
  260. ;  
  261. EXCEPTION_MAXIMUM_PARAMETERS    EQU    4  ;  Enough for all system exceptions   
  262.  
  263. _EXCEPTIONREPORTRECORD    STRUC
  264. ExceptionNum    DD    ?                ;  Exception number                  
  265. fHandlerFlags    DD    ?               ;  Exception attributes              
  266. NestedExceptionReportRecord    DD    ?
  267.                                         ;  Preceding exception's report      
  268.                                         ;  record if nested exception        
  269. ExceptionAddress    DD    ?            ;  Exception address                 
  270. cParameters    DD    ?                 ;  Size of exception specific        
  271.                                         ;  information                       
  272. ExceptionInfo    DD    EXCEPTION_MAXIMUM_PARAMETERS DUP (?)
  273.                                         ;  Exception specfic information     
  274. _EXCEPTIONREPORTRECORD    ENDS
  275.  
  276. EXCEPTIONREPORTRECORD struc
  277. db size _EXCEPTIONREPORTRECORD dup(?)
  278. EXCEPTIONREPORTRECORD ends
  279.  
  280. PEXCEPTIONREPORTRECORD struc
  281.     dd ?
  282. PEXCEPTIONREPORTRECORD ends
  283.  
  284. ; 
  285. ;* ExceptionRegistrationRecord
  286. ;*
  287. ;* These are linked together to form a chain of exception handlers that
  288. ;* will be dispatched to upon receipt of an exception.
  289. ;  
  290.  
  291. _EXCEPTIONREGISTRATIONRECORD    STRUC
  292. prev_structure      DD      ?
  293. ExceptionHandler    DD      ?
  294. _EXCEPTIONREGISTRATIONRECORD    ENDS
  295.  
  296. EXCEPTIONREGISTRATIONRECORD struc
  297.         db size _EXCEPTIONREGISTRATIONRECORD dup(?)
  298. EXCEPTIONREGISTRATIONRECORD ends
  299.  
  300. PEXCEPTIONREGISTRATIONRECORD struc
  301.         dd ?
  302. PEXCEPTIONREGISTRATIONRECORD ends
  303.  
  304.  
  305. ; 
  306. ;* End of exception chain marker.
  307. ;  
  308. END_OF_CHAIN    EQU     -1
  309.  
  310.