Changes between Version 5 and Version 6 of DiagnosticsApi


Ignore:
Timestamp:
Dec 18, 2008, 4:22:43 PM (15 years ago)
Author:
davea
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • DiagnosticsApi

    v5 v6  
    11= The BOINC diagnostics API =
     2
     3The diagnostics API determines where stdout and stderr are sent,
     4and what's written to them.
     5'''BOINC's initialization functions - boinc_init() etc. -
     6set reasonable defaults for these settings.
     7If for some reason you want different settings, this API lets you do it.'''
    28
    39BOINC applications can call
     
    915int boinc_init_graphics_diagnostics(int flags)
    1016}}}
    11 to initialize various diagnostic functions. '''This call should be made early in the program - before `boinc_init()` - so that error info is routed appropriately.''' `flags` is formed by or'ing together a subset of the following flags:
    12 {{{
    13 #define BOINC_DIAG_DUMPCALLSTACKENABLED     0x00000001L
    14 #define BOINC_DIAG_HEAPCHECKENABLED         0x00000002L
    15 #define BOINC_DIAG_MEMORYLEAKCHECKENABLED   0x00000004L
    16 #define BOINC_DIAG_ARCHIVESTDERR            0x00000008L
    17 #define BOINC_DIAG_ARCHIVESTDOUT            0x00000010L
    18 #define BOINC_DIAG_REDIRECTSTDERR           0x00000020L
    19 #define BOINC_DIAG_REDIRECTSTDOUT           0x00000040L
    20 #define BOINC_DIAG_REDIRECTSTDERROVERWRITE  0x00000080L
    21 #define BOINC_DIAG_REDIRECTSTDOUTOVERWRITE  0x00000100L
    22 #define BOINC_DIAG_TRACETOSTDERR            0x00000200L
    23 #define BOINC_DIAG_TRACETOSTDOUT            0x00000400L
    24 }}}
     17to initialize various diagnostic functions. '''This call should be made early in the program - before `boinc_init()` - so that error info is routed appropriately.''' `flags` is formed by or'ing together a subset of the following flags.
    2518
    26 The flags are as follows. Applications are advised to use at least `BOINC_DIAG_DUMPCALLSTACKENABLED`, `BOINC_DIAG_REDIRECTSTDERR`, and `BOINC_DIAG_TRACETOSTDERR`.
     19Applications are advised to use at least `BOINC_DIAG_DUMPCALLSTACKENABLED`, `BOINC_DIAG_REDIRECTSTDERR`, and `BOINC_DIAG_TRACETOSTDERR`.
     20
     21The default is BOINC_DIAG_DUMPCALLSTACKENABLED, BOINC_DIAG_HEAPCHECKENABLED, BOINC_DIAG_MEMORYLEAKCHECKENABLED, BOINC_DIAG_REDIRECTSTDERR, BOINC_DIAG_TRACETOSTDERR
     22
    2723
    2824 '''BOINC_DIAG_DUMPCALLSTACKENABLED'''::