/*
 * Copyright (c) 2004-2005 The Trustees of Indiana University and Indiana
 *                         University Research and Technology
 *                         Corporation.  All rights reserved.
 * Copyright (c) 2004-2006 The University of Tennessee and The University
 *                         of Tennessee Research Foundation.  All rights
 *                         reserved.
 * Copyright (c) 2004-2005 High Performance Computing Center Stuttgart, 
 *                         University of Stuttgart.  All rights reserved.
 * Copyright (c) 2004-2006 The Regents of the University of California.
 *                         All rights reserved.
 * $COPYRIGHT$
 * 
 * Additional copyrights may follow
 * 
 * $HEADER$
 *
 */

#ifndef OPAL_BACKTRACE_BASE_H
#define OPAL_BACKTRACE_BASE_H

#include "opal_config.h"

#include "opal/mca/backtrace/backtrace.h"


/*
 * Global functions for MCA overall backtrace open and close
 */

BEGIN_C_DECLS

    /**
     * Initialize the backtrace MCA framework
     *
     * @retval OPAL_SUCCESS Upon success
     * @retval OPAL_ERROR Upon failure
     *
     * This must be the first function invoked in the backtrace MCA
     * framework.  It initializes the backtrace MCA framework, finds
     * and opens backtrace components, etc.
     *
     * This function is invoked during opal_init() and during the
     * initialization of the special case of the laminfo command.
     * 
     * This function fills in the internal global variable
     * opal_backtrace_base_components_opened, which is a list of all
     * backtrace components that were successfully opened.  This
     * variable should \em only be used by other backtrace base
     * functions -- it is not considered a public interface member --
     * and is only mentioned here for completeness.
     */
    OPAL_DECLSPEC int opal_backtrace_base_open(void);
    

    /**
     * Shut down the backtrace MCA framework.
     *
     * @retval OPAL_SUCCESS Always
     *
     * This function shuts down everything in the backtrace MCA
     * framework, and is called during opal_finalize() and the
     * special case of the laminfo command.
     *
     * It must be the last function invoked on the backtrace MCA framework.
     */
    OPAL_DECLSPEC int opal_backtrace_base_close(void);

    OPAL_DECLSPEC extern opal_list_t opal_backtrace_base_components_opened;
    
END_C_DECLS
#endif /* OPAL_BASE_BACKTRACE_H */