openmpi/opal/mca/db/print/db_print.h

/*
 * Copyright (c) 2012-2013 Los Alamos National Security, Inc. All rights reserved.
 * $COPYRIGHT$
 * 
 * Additional copyrights may follow
 * 
 * $HEADER$
 */

#ifndef OPAL_DB_PRINT_H
#define OPAL_DB_PRINT_H

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

BEGIN_C_DECLS

typedef struct {
    opal_db_base_component_t super;
    char *filename;
} opal_db_print_component_t;
OPAL_MODULE_DECLSPEC extern opal_db_print_component_t mca_db_print_component;

OPAL_DECLSPEC extern opal_db_base_module_t opal_db_print_module;

END_C_DECLS

#endif /* OPAL_DB_PRINT_H */
Per the meeting on moving the BTLs to OPAL, move the ORTE database "db" framework to OPAL so the relocated BTLs can access it. Because the data is indexed by process, this requires that we define a new "opal_identifier_t" that corresponds to the orte_process_name_t struct. In order to support multiple run-times, this is defined in opal/mca/db/db_types.h as a uint64_t without identifying the meaning of any part of that data. A few changes were required to support this move: 1. the PMI component used to identify rte-related data (e.g., host name, bind level) and package them as a unit to reduce the number of PMI keys. This code was moved up to the ORTE layer as the OPAL layer has no understanding of these concepts. In addition, the component locally stored data based on process jobid/vpid - this could no longer be supported (see below for the solution). 2. the hash component was updated to use the new opal_identifier_t instead of orte_process_name_t as its index for storing data in the hash tables. Previously, we did a hash on the vpid and stored the data in a 32-bit hash table. In the revised system, we don't see a separate "vpid" field - we only have a 64-bit opaque value. The orte_process_name_t hash turned out to do nothing useful, so we now store the data in a 64-bit hash table. Preliminary tests didn't show any identifiable change in behavior or performance, but we'll have to see if a move back to the 32-bit table is required at some later time. 3. the db framework was a "select one" system. However, since the PMI component could no longer use its internal storage system, the framework has now been changed to a "select many" mode of operation. This allows the hash component to handle all internal storage, while the PMI component only handles pushing/pulling things from the PMI system. This was something we had planned for some time - when fetching data, we first check internal storage to see if we already have it, and then automatically go to the global system to look for it if we don't. Accordingly, the framework was provided with a custom query function used during "select" that lets you seperately specify the "store" and "fetch" ordering. 4. the ORTE grpcomm and ess/pmi components, and the nidmap code, were updated to work with the new db framework and to specify internal/global storage options. No changes were made to the MPI layer, except for modifying the ORTE component of the OMPI/rte framework to support the new db framework. This commit was SVN r28112. 2013-02-26 17:50:04 +00:00			`/*`
			`* Copyright (c) 2012-2013 Los Alamos National Security, Inc. All rights reserved.`
			`* $COPYRIGHT$`
			`*`
			`* Additional copyrights may follow`
			`*`
			`* $HEADER$`
			`*/`

			`#ifndef OPAL_DB_PRINT_H`
			`#define OPAL_DB_PRINT_H`

			`#include "opal/mca/db/db.h"`

			`BEGIN_C_DECLS`

			`typedef struct {`
			`opal_db_base_component_t super;`
			`char *filename;`
			`} opal_db_print_component_t;`
			`OPAL_MODULE_DECLSPEC extern opal_db_print_component_t mca_db_print_component;`

			`OPAL_DECLSPEC extern opal_db_base_module_t opal_db_print_module;`

			`END_C_DECLS`

			`#endif /* OPAL_DB_PRINT_H */`