1
1
openmpi/ompi/mca/topo/base/base.h
Jeff Squyres 0af7ac53f2 Fixes trac:1392, #1400
* add "register" function to mca_base_component_t
   * converted coll:basic and paffinity:linux and paffinity:solaris to
     use this function
   * we'll convert the rest over time (I'll file a ticket once all
     this is committed)
 * add 32 bytes of "reserved" space to the end of mca_base_component_t
   and mca_base_component_data_2_0_0_t to make future upgrades
   [slightly] easier
   * new mca_base_component_t size: 196 bytes
   * new mca_base_component_data_2_0_0_t size: 36 bytes
 * MCA base version bumped to v2.0
   * '''We now refuse to load components that are not MCA v2.0.x'''
 * all MCA frameworks versions bumped to v2.0
 * be a little more explicit about version numbers in the MCA base
   * add big comment in mca.h about versioning philosophy

This commit was SVN r19073.

The following Trac tickets were found above:
  Ticket 1392 --> https://svn.open-mpi.org/trac/ompi/ticket/1392
2008-07-28 22:40:57 +00:00

143 строки
5.3 KiB
C

/*
* Copyright (c) 2004-2005 The Trustees of Indiana University and Indiana
* University Research and Technology
* Corporation. All rights reserved.
* Copyright (c) 2004-2005 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-2005 The Regents of the University of California.
* All rights reserved.
* Copyright (c) 2008 Cisco Systems, Inc. All rights reserved.
* $COPYRIGHT$
*
* Additional copyrights may follow
*
* $HEADER$
*/
#ifndef MCA_TOPO_BASE_H
#define MCA_TOPO_BASE_H
#include "ompi_config.h"
#include "mpi.h"
#include "opal/class/opal_list.h"
#include "ompi/mca/topo/topo.h"
#include "ompi/proc/proc.h"
/*
* All stuff goes in here
*/
BEGIN_C_DECLS
#include "opal/mca/mca.h"
OMPI_DECLSPEC int mca_topo_base_open(void);
OMPI_DECLSPEC int mca_topo_base_close(void);
int mca_topo_base_comm_select(struct ompi_communicator_t *comm,
mca_base_component_t *preferred);
int mca_topo_base_comm_unselect(struct ompi_communicator_t *comm);
int mca_topo_base_find_available (bool enable_progress_threads,
bool enable_mpi_threads);
OMPI_DECLSPEC int mca_topo_base_init_comm (struct ompi_communicator_t *comm);
OMPI_DECLSPEC int mca_topo_base_get_param (struct ompi_communicator_t *comm, int keyval);
/*
* All the glue functions which we will provide to the users by
* default. The component authors need to only write back-end
* functions for graph_map() and cart_map() for their topology
* components. But they can implement these glue functions if
* they want.
*/
OMPI_DECLSPEC int mca_topo_base_cart_coords (struct ompi_communicator_t *comm,
int rank,
int maxdims,
int *coords);
OMPI_DECLSPEC int mca_topo_base_cart_create (mca_topo_base_comm_t *topo_data,
int *proc_count,
ompi_proc_t **proc_pointers,
int *new_rank,
int ndims,
int *dims,
int *periods,
bool reorder);
OMPI_DECLSPEC int mca_topo_base_cartdim_get (struct ompi_communicator_t *comm,
int *ndims);
OMPI_DECLSPEC int mca_topo_base_cart_get (struct ompi_communicator_t *comm,
int maxdims,
int *dims,
int *periods,
int *coords);
OMPI_DECLSPEC int mca_topo_base_cart_rank (struct ompi_communicator_t *comm,
int *coords,
int *rank);
OMPI_DECLSPEC int mca_topo_base_cart_shift (struct ompi_communicator_t *comm,
int direction,
int disp,
int *rank_source,
int *rank_dest);
OMPI_DECLSPEC int mca_topo_base_cart_sub (struct ompi_communicator_t *comm,
int *remain_dims,
struct ompi_communicator_t **new_comm);
OMPI_DECLSPEC int mca_topo_base_graph_create (mca_topo_base_comm_t *topo_data,
int *proc_count,
ompi_proc_t **proc_pointers,
int *new_rank,
int nnodes,
int *index,
int *edges,
bool reorder);
OMPI_DECLSPEC int mca_topo_base_graphdims_get (struct ompi_communicator_t *comm,
int *nodes,
int *nedges);
OMPI_DECLSPEC int mca_topo_base_graph_get (struct ompi_communicator_t *comm,
int maxindex,
int maxedges,
int *index,
int *edges);
OMPI_DECLSPEC int mca_topo_base_graph_neighbors (struct ompi_communicator_t *comm,
int rank,
int maxneighbors,
int *neighbors);
OMPI_DECLSPEC int mca_topo_base_graph_neighbors_count (struct ompi_communicator_t *comm,
int rank,
int *nneighbors);
/*
* Globals
*/
OMPI_DECLSPEC extern int mca_topo_base_output;
extern int mca_topo_base_param;
OMPI_DECLSPEC extern opal_list_t mca_topo_base_components_available;
OMPI_DECLSPEC extern opal_list_t mca_topo_base_components_opened;
extern bool mca_topo_base_components_opened_valid;
extern bool mca_topo_base_components_available_valid;
END_C_DECLS
#endif /* MCA_BASE_TOPO_H */