Museum

ERRLOG_$TRACEBACK                 Domain/OS                  ERRLOG_$TRACEBACK


NAME
     errlog_$traceback - log a stack traceback

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/errlog.h>

     void errlog_$traceback(
          short &stream_id,
          short &traceback_options,
          long &max_frames)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/errlog.ins.pas';

     procedure errlog_$traceback(
          in stream_id: ios_$id_t;
          in traceback_options: errlog_$tb_opt_set_t;
          in max_frames: integer32);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/errlog.ins.ftn'

           integer*2 traceback_options
           integer*4 stream_id, max_frames

           call errlog_$traceback(stream_id, traceback_options, max_frames)

DESCRIPTION
     Errlog_$traceback writes a list of stack frames to the stream open on
     stream_id.  The traceback identifies the name and line number of each
     routine on the call stack.  If no option is specified in
     traceback_options , the traceback starts with the routine that called
     errlog_$traceback.

     stream_id
          A stream ID.

     traceback_options
          A small set of options for modifying how tracebacks are logged.
          There is currently only one possible value:

          errlog_$fault_tb
               Start the traceback at the last fault that occurred in the cal-
               ling process.  This option is most useful within a fault
               handler.

     max_frames
          The maximum number of call frames to include in the traceback.  If
          max_frames is negative or zero, all frames on the stack are included
          in the traceback.