epicsStackTrace.h File Reference

#include "libComAPI.h"

Include dependency graph for epicsStackTrace.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	EPICS_STACKTRACE_ADDRESSES   (1<<0)
#define	EPICS_STACKTRACE_DYN_SYMBOLS   (1<<1)
#define	EPICS_STACKTRACE_GBL_SYMBOLS   (1<<2)
#define	EPICS_STACKTRACE_LCL_SYMBOLS   (1<<3)

Functions
LIBCOM_API void	epicsStackTrace (void)
LIBCOM_API int	epicsStackTraceGetFeatures (void)

Macro Definition Documentation

#define EPICS_STACKTRACE_ADDRESSES   (1<<0)

Definition at line 25 of file epicsStackTrace.h.

#define EPICS_STACKTRACE_DYN_SYMBOLS   (1<<1)

Definition at line 28 of file epicsStackTrace.h.

#define EPICS_STACKTRACE_GBL_SYMBOLS   (1<<2)

Definition at line 31 of file epicsStackTrace.h.

#define EPICS_STACKTRACE_LCL_SYMBOLS   (1<<3)

Definition at line 34 of file epicsStackTrace.h.

Function Documentation

LIBCOM_API void epicsStackTrace

(

void

)

Definition at line 62 of file epicsStackTrace.c.

{
void        **buf;
int         i,n;
epicsSymbol sym;

    if ( 0 == epicsStackTraceGetFeatures() ) {
        /* unsupported on this platform */
        return;
    }

    if ( ! (buf = malloc(sizeof(*buf) * MAXDEPTH))) {
        free(buf);
        errlogPrintf("epicsStackTrace(): not enough memory for backtrace\n");
        return;
    }

    n = epicsBackTrace(buf, MAXDEPTH);

    if ( n > 0 ) {

        stackTraceLock();

        errlogPrintf("Dumping a stack trace of thread '%s':\n", epicsThreadGetNameSelf());

        errlogFlush();

        for ( i=0; i<n; i++ ) {
            if ( 0 == epicsFindAddr(buf[i], &sym) )
                dumpInfo(buf[i], &sym);
            else
                dumpInfo(buf[i], 0);
        }

        errlogFlush();

        stackTraceUnlock();

    }

    free(buf);
}

LIBCOM_API int epicsStackTraceGetFeatures

(

void

)

Definition at line 105 of file epicsStackTrace.c.

{
void *test[2];

static int initflag = 10; /* init to a value larger than the test snapshot */

    /* don't bother about epicsOnce -- if there should be a race and
     * the detection code is executed multiple times that is no big deal.
     */
    if ( 10 == initflag ) {
        initflag = epicsBackTrace(test, sizeof(test)/sizeof(test[0]));
    }

    if ( initflag <= 0 )
        return 0; /* backtrace doesn't work or is not supported */

    return ( EPICS_STACKTRACE_ADDRESSES | epicsFindAddrGetFeatures() );
}