3a0d09300b
Comm_spawn still uses the rank=0 method - shifting that algo to the daemons is under study. This commit was SVN r18115.
174 строки
6.2 KiB
C
174 строки
6.2 KiB
C
/*
|
|
* Copyright (c) 2004-2007 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$
|
|
*
|
|
* Additional copyrights may follow
|
|
*
|
|
* $HEADER$
|
|
*/
|
|
/** @file:
|
|
*
|
|
* The OpenRTE Group Communications
|
|
*
|
|
* The OpenRTE Group Comm framework provides communication services that
|
|
* span entire jobs or collections of processes. It is not intended to be
|
|
* used for point-to-point communications (the RML does that), nor should
|
|
* it be viewed as a high-performance communication channel for large-scale
|
|
* data transfers.
|
|
*/
|
|
|
|
#ifndef MCA_GRPCOMM_H
|
|
#define MCA_GRPCOMM_H
|
|
|
|
/*
|
|
* includes
|
|
*/
|
|
|
|
#include "orte_config.h"
|
|
#include "orte/constants.h"
|
|
#include "orte/types.h"
|
|
|
|
#include "opal/mca/mca.h"
|
|
#include "opal/class/opal_list.h"
|
|
#include "opal/class/opal_value_array.h"
|
|
#include "opal/dss/dss_types.h"
|
|
|
|
#include "orte/mca/rmaps/rmaps_types.h"
|
|
#include "orte/mca/rml/rml_types.h"
|
|
#include "orte/mca/odls/odls_types.h"
|
|
|
|
#include "orte/mca/grpcomm/grpcomm_types.h"
|
|
|
|
BEGIN_C_DECLS
|
|
|
|
/*
|
|
* Component functions - all MUST be provided!
|
|
*/
|
|
|
|
/* initialize the selected module */
|
|
typedef int (*orte_grpcomm_base_module_init_fn_t)(void);
|
|
|
|
/* finalize the selected module */
|
|
typedef void (*orte_grpcomm_base_module_finalize_fn_t)(void);
|
|
|
|
/* Send a message to all members of a job - blocking */
|
|
typedef int (*orte_grpcomm_base_module_xcast_fn_t)(orte_jobid_t job,
|
|
opal_buffer_t *buffer,
|
|
orte_rml_tag_t tag);
|
|
|
|
/* allgather - gather data from all procs */
|
|
typedef int (*orte_grpcomm_base_module_allgather_fn_t)(opal_buffer_t *sbuf, opal_buffer_t *rbuf);
|
|
|
|
typedef int (*orte_grpcomm_base_module_allgather_list_fn_t)(opal_list_t *names,
|
|
opal_buffer_t *sbuf, opal_buffer_t *rbuf);
|
|
|
|
/* barrier function */
|
|
typedef int (*orte_grpcomm_base_module_barrier_fn_t)(void);
|
|
|
|
/* daemon collective operations */
|
|
typedef int (*orte_grpcomm_base_module_daemon_collective_fn_t)(orte_jobid_t jobid,
|
|
orte_std_cntr_t num_local_contributors,
|
|
orte_grpcomm_coll_t type,
|
|
opal_buffer_t *data,
|
|
orte_rmaps_dp_t flag,
|
|
opal_value_array_t *participants);
|
|
|
|
/* update the xcast trees - called after a change to the number of daemons
|
|
* in the system
|
|
*/
|
|
typedef int (*orte_grpcomm_base_module_update_trees_fn_t)(void);
|
|
|
|
/* for collectives, return next recipients in the chain */
|
|
typedef opal_list_t* (*orte_gprcomm_base_module_next_recipients_fn_t)(orte_grpcomm_mode_t mode);
|
|
|
|
/** DATA EXCHANGE FUNCTIONS - SEE ompi/runtime/ompi_module_exchange.h FOR A DESCRIPTION
|
|
* OF HOW THIS ALL WORKS
|
|
*/
|
|
|
|
/* send an attribute buffer */
|
|
typedef int (*orte_grpcomm_base_module_modex_set_proc_attr_fn_t)(const char* attr_name,
|
|
const void *buffer, size_t size);
|
|
|
|
/* get an attribute buffer */
|
|
typedef int (*orte_grpcomm_base_module_modex_get_proc_attr_fn_t)(const orte_process_name_t name,
|
|
const char* attr_name,
|
|
void **buffer, size_t *size);
|
|
|
|
/* perform a modex operation */
|
|
typedef int (*orte_grpcomm_base_module_modex_fn_t)(opal_list_t *procs);
|
|
|
|
/* purge the internal attr table */
|
|
typedef int (*orte_grpcomm_base_module_purge_proc_attrs_fn_t)(void);
|
|
|
|
|
|
/*
|
|
* Ver 2.0
|
|
*/
|
|
struct orte_grpcomm_base_module_2_0_0_t {
|
|
orte_grpcomm_base_module_init_fn_t init;
|
|
orte_grpcomm_base_module_finalize_fn_t finalize;
|
|
/* collective operations */
|
|
orte_grpcomm_base_module_xcast_fn_t xcast;
|
|
orte_grpcomm_base_module_allgather_fn_t allgather;
|
|
orte_grpcomm_base_module_allgather_list_fn_t allgather_list;
|
|
orte_grpcomm_base_module_barrier_fn_t barrier;
|
|
orte_grpcomm_base_module_daemon_collective_fn_t daemon_collective;
|
|
orte_grpcomm_base_module_update_trees_fn_t update_trees;
|
|
orte_gprcomm_base_module_next_recipients_fn_t next_recipients;
|
|
/* modex functions */
|
|
orte_grpcomm_base_module_modex_set_proc_attr_fn_t set_proc_attr;
|
|
orte_grpcomm_base_module_modex_get_proc_attr_fn_t get_proc_attr;
|
|
orte_grpcomm_base_module_modex_fn_t modex;
|
|
orte_grpcomm_base_module_purge_proc_attrs_fn_t purge_proc_attrs;
|
|
};
|
|
|
|
typedef struct orte_grpcomm_base_module_2_0_0_t orte_grpcomm_base_module_2_0_0_t;
|
|
typedef orte_grpcomm_base_module_2_0_0_t orte_grpcomm_base_module_t;
|
|
|
|
/**
|
|
* Initialize the selected component.
|
|
*/
|
|
typedef orte_grpcomm_base_module_t* (*orte_grpcomm_base_component_init_fn_t)(int *priority);
|
|
|
|
|
|
/*
|
|
* the standard component data structure
|
|
*/
|
|
|
|
struct orte_grpcomm_base_component_2_0_0_t {
|
|
mca_base_component_t grpcomm_version;
|
|
mca_base_component_data_1_0_0_t grpcomm_data;
|
|
|
|
orte_grpcomm_base_component_init_fn_t grpcomm_init;
|
|
};
|
|
typedef struct orte_grpcomm_base_component_2_0_0_t orte_grpcomm_base_component_2_0_0_t;
|
|
typedef orte_grpcomm_base_component_2_0_0_t orte_grpcomm_base_component_t;
|
|
|
|
|
|
|
|
/*
|
|
* Macro for use in components that are of type grpcomm v2.0.0
|
|
*/
|
|
#define ORTE_GRPCOMM_BASE_VERSION_2_0_0 \
|
|
/* grpcomm v2.0 is chained to MCA v1.0 */ \
|
|
MCA_BASE_VERSION_1_0_0, \
|
|
/* grpcomm v2.0 */ \
|
|
"grpcomm", 2, 0, 0
|
|
|
|
/* Global structure for accessing name server functions
|
|
*/
|
|
ORTE_DECLSPEC extern orte_grpcomm_base_module_t orte_grpcomm; /* holds selected module's function pointers */
|
|
|
|
END_C_DECLS
|
|
|
|
#endif
|