2008-02-28 01:57:57 +00:00
|
|
|
/*
|
|
|
|
* 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-2005 The Regents of the University of California.
|
|
|
|
* All rights reserved.
|
Per RFC, bring in the following changes:
* Remove paffinity, maffinity, and carto frameworks -- they've been
wholly replaced by hwloc.
* Move ompi_mpi_init() affinity-setting/checking code down to ORTE.
* Update sm, smcuda, wv, and openib components to no longer use carto.
Instead, use hwloc data. There are still optimizations possible in
the sm/smcuda BTLs (i.e., making multiple mpools). Also, the old
carto-based code found out how many NUMA nodes were ''available''
-- not how many were used ''in this job''. The new hwloc-using
code computes the same value -- it was not updated to calculate how
many NUMA nodes are used ''by this job.''
* Note that I cannot compile the smcuda and wv BTLs -- I ''think''
they're right, but they need to be verified by their owners.
* The openib component now does a bunch of stuff to figure out where
"near" OpenFabrics devices are. '''THIS IS A CHANGE IN DEFAULT
BEHAVIOR!!''' and still needs to be verified by OpenFabrics vendors
(I do not have a NUMA machine with an OpenFabrics device that is a
non-uniform distance from multiple different NUMA nodes).
* Completely rewrite the OMPI_Affinity_str() routine from the
"affinity" mpiext extension. This extension now understands
hyperthreads; the output format of it has changed a bit to reflect
this new information.
* Bunches of minor changes around the code base to update names/types
from maffinity/paffinity-based names to hwloc-based names.
* Add some helper functions into the hwloc base, mainly having to do
with the fact that we have the hwloc data reporting ''all''
topology information, but sometimes you really only want the
(online | available) data.
This commit was SVN r26391.
2012-05-07 14:52:54 +00:00
|
|
|
* Copyright (c) 2011-2012 Cisco Systems, Inc. All rights reserved.
|
2012-03-08 22:02:28 +00:00
|
|
|
* Copyright (c) 2012 Oak Ridge National Labs. All rights reserved.
|
2013-02-28 01:35:55 +00:00
|
|
|
* Copyright (c) 2013 Los Alamos National Security, LLC. All rights reserved.
|
2013-10-02 19:03:46 +00:00
|
|
|
* Copyright (c) 2013 Intel, Inc. All rights reserved.
|
2008-02-28 01:57:57 +00:00
|
|
|
* $COPYRIGHT$
|
|
|
|
*
|
|
|
|
* Additional copyrights may follow
|
|
|
|
*
|
|
|
|
* $HEADER$
|
|
|
|
*/
|
|
|
|
/** @file:
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef MCA_ESS_BASE_H
|
|
|
|
#define MCA_ESS_BASE_H
|
|
|
|
|
|
|
|
#include "orte_config.h"
|
|
|
|
#include "orte/types.h"
|
|
|
|
|
|
|
|
#include "opal/mca/mca.h"
|
2011-10-19 20:18:14 +00:00
|
|
|
#include "opal/dss/dss_types.h"
|
2008-04-30 19:49:53 +00:00
|
|
|
|
2008-02-28 01:57:57 +00:00
|
|
|
#include "orte/mca/ess/ess.h"
|
|
|
|
|
|
|
|
BEGIN_C_DECLS
|
|
|
|
|
|
|
|
/*
|
2013-03-27 21:14:43 +00:00
|
|
|
* MCA Framework
|
2008-02-28 01:57:57 +00:00
|
|
|
*/
|
2013-03-27 21:14:43 +00:00
|
|
|
ORTE_DECLSPEC extern mca_base_framework_t orte_ess_base_framework;
|
2008-02-28 01:57:57 +00:00
|
|
|
/**
|
|
|
|
* Select a ess module
|
|
|
|
*/
|
|
|
|
ORTE_DECLSPEC int orte_ess_base_select(void);
|
|
|
|
|
2012-03-08 22:02:28 +00:00
|
|
|
/*
|
|
|
|
* stdout/stderr buffering control parameter
|
|
|
|
*/
|
|
|
|
ORTE_DECLSPEC extern int orte_ess_base_std_buffering;
|
|
|
|
|
2013-03-27 21:09:41 +00:00
|
|
|
ORTE_DECLSPEC extern int orte_ess_base_num_procs;
|
|
|
|
ORTE_DECLSPEC extern char *orte_ess_base_jobid;
|
|
|
|
ORTE_DECLSPEC extern char *orte_ess_base_vpid;
|
|
|
|
|
2008-02-28 01:57:57 +00:00
|
|
|
/*
|
|
|
|
* Internal helper functions used by components
|
|
|
|
*/
|
|
|
|
ORTE_DECLSPEC int orte_ess_env_get(void);
|
|
|
|
|
2008-06-18 03:15:56 +00:00
|
|
|
ORTE_DECLSPEC int orte_ess_base_std_prolog(void);
|
|
|
|
|
2013-10-02 19:03:46 +00:00
|
|
|
ORTE_DECLSPEC int orte_ess_base_app_setup(bool db_restrict_local);
|
2008-02-28 01:57:57 +00:00
|
|
|
ORTE_DECLSPEC int orte_ess_base_app_finalize(void);
|
2012-04-06 14:23:13 +00:00
|
|
|
ORTE_DECLSPEC void orte_ess_base_app_abort(int status, bool report);
|
2008-02-28 01:57:57 +00:00
|
|
|
|
|
|
|
ORTE_DECLSPEC int orte_ess_base_tool_setup(void);
|
|
|
|
ORTE_DECLSPEC int orte_ess_base_tool_finalize(void);
|
|
|
|
|
2009-05-16 04:15:55 +00:00
|
|
|
ORTE_DECLSPEC int orte_ess_base_orted_setup(char **hosts);
|
2008-02-28 01:57:57 +00:00
|
|
|
ORTE_DECLSPEC int orte_ess_base_orted_finalize(void);
|
|
|
|
|
Per RFC, bring in the following changes:
* Remove paffinity, maffinity, and carto frameworks -- they've been
wholly replaced by hwloc.
* Move ompi_mpi_init() affinity-setting/checking code down to ORTE.
* Update sm, smcuda, wv, and openib components to no longer use carto.
Instead, use hwloc data. There are still optimizations possible in
the sm/smcuda BTLs (i.e., making multiple mpools). Also, the old
carto-based code found out how many NUMA nodes were ''available''
-- not how many were used ''in this job''. The new hwloc-using
code computes the same value -- it was not updated to calculate how
many NUMA nodes are used ''by this job.''
* Note that I cannot compile the smcuda and wv BTLs -- I ''think''
they're right, but they need to be verified by their owners.
* The openib component now does a bunch of stuff to figure out where
"near" OpenFabrics devices are. '''THIS IS A CHANGE IN DEFAULT
BEHAVIOR!!''' and still needs to be verified by OpenFabrics vendors
(I do not have a NUMA machine with an OpenFabrics device that is a
non-uniform distance from multiple different NUMA nodes).
* Completely rewrite the OMPI_Affinity_str() routine from the
"affinity" mpiext extension. This extension now understands
hyperthreads; the output format of it has changed a bit to reflect
this new information.
* Bunches of minor changes around the code base to update names/types
from maffinity/paffinity-based names to hwloc-based names.
* Add some helper functions into the hwloc base, mainly having to do
with the fact that we have the hwloc data reporting ''all''
topology information, but sometimes you really only want the
(online | available) data.
This commit was SVN r26391.
2012-05-07 14:52:54 +00:00
|
|
|
/* Detect whether or not this proc is bound - if not,
|
|
|
|
* see if it should bind itself
|
|
|
|
*/
|
|
|
|
ORTE_DECLSPEC int orte_ess_base_proc_binding(void);
|
|
|
|
|
2008-02-28 01:57:57 +00:00
|
|
|
/*
|
|
|
|
* Put functions
|
|
|
|
*/
|
|
|
|
ORTE_DECLSPEC int orte_ess_env_put(orte_std_cntr_t num_procs,
|
|
|
|
orte_std_cntr_t num_local_procs,
|
|
|
|
char ***env);
|
|
|
|
|
|
|
|
END_C_DECLS
|
|
|
|
|
|
|
|
#endif
|