/*
 * Copyright (c) 2004-2006 The University of Tennessee and The University
 *                         of Tennessee Research Foundation.  All rights
 *                         reserved.
 * $COPYRIGHT$
 * 
 * Additional copyrights may follow
 * 
 * $HEADER$
 *
 */

#ifndef OPAL_MEMCPY_BASE_H
#define OPAL_MEMCPY_BASE_H

#include "opal_config.h"

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


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

#if defined(c_plusplus) || defined(__cplusplus)
extern "C" {
#endif

    /**
     * Initialize the memcpy MCA framework
     *
     * @retval OPAL_SUCCESS Upon success
     * @retval OPAL_ERROR Upon failure
     *
     * This must be the first function invoked in the memcpy MCA
     * framework.  It initializes the memcpy MCA framework, finds
     * and opens memcpy 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_memcpy_base_components_opened, which is a list of all
     * memcpy components that were successfully opened.  This
     * variable should \em only be used by other memcpy base
     * functions -- it is not considered a public interface member --
     * and is only mentioned here for completeness.
     */
    OPAL_DECLSPEC int opal_memcpy_base_open(void);
    

    /**
     * Shut down the memcpy MCA framework.
     *
     * @retval OPAL_SUCCESS Always
     *
     * This function shuts down everything in the memcpy 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 memcpy MCA framework.
     */
    OPAL_DECLSPEC int opal_memcpy_base_close(void);

    OPAL_DECLSPEC extern opal_list_t opal_memcpy_base_components_opened;
    
#if defined(c_plusplus) || defined(__cplusplus)
}
#endif

/* include implementation to call */
#include MCA_timer_IMPLEMENTATION_HEADER

#endif /* OPAL_BASE_MEMCPY_H */