c3df744a3b
This commit was SVN r30746.
753 lines
28 KiB
C
753 lines
28 KiB
C
/*
|
|
* Copyright (c) 2004-2010 The Trustees of Indiana University and Indiana
|
|
* University Research and Technology
|
|
* Corporation. All rights reserved.
|
|
* Copyright (c) 2004-2011 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) 2007-2010 Oracle and/or its affiliates. All rights reserved.
|
|
* Copyright (c) 2007-2012 Cisco Systems, Inc. All rights reserved.
|
|
* Copyright (c) 2011-2013 Los Alamos National Security, LLC.
|
|
* All rights reserved.
|
|
* Copyright (c) 2013-2014 Intel, Inc. All rights reserved
|
|
* $COPYRIGHT$
|
|
*
|
|
* Additional copyrights may follow
|
|
*
|
|
* $HEADER$
|
|
*/
|
|
|
|
/**
|
|
* @file
|
|
*
|
|
* Global params for OpenRTE
|
|
*/
|
|
#ifndef ORTE_RUNTIME_ORTE_GLOBALS_H
|
|
#define ORTE_RUNTIME_ORTE_GLOBALS_H
|
|
|
|
#include "orte_config.h"
|
|
#include "orte/types.h"
|
|
|
|
#include <sys/types.h>
|
|
#ifdef HAVE_SYS_TIME_H
|
|
#include <sys/time.h>
|
|
#endif
|
|
|
|
#include "opal/class/opal_hash_table.h"
|
|
#include "opal/class/opal_pointer_array.h"
|
|
#include "opal/class/opal_value_array.h"
|
|
#include "opal/class/opal_ring_buffer.h"
|
|
#include "opal/threads/threads.h"
|
|
#include "opal/mca/event/event.h"
|
|
#include "opal/mca/hwloc/hwloc.h"
|
|
#include "opal/mca/hwloc/base/base.h"
|
|
|
|
#include "orte/mca/plm/plm_types.h"
|
|
#include "orte/mca/rml/rml_types.h"
|
|
#include "orte/util/proc_info.h"
|
|
#include "orte/util/name_fns.h"
|
|
#include "orte/util/error_strings.h"
|
|
#include "orte/runtime/runtime.h"
|
|
#include "orte/runtime/orte_wait.h"
|
|
|
|
|
|
BEGIN_C_DECLS
|
|
|
|
ORTE_DECLSPEC extern int orte_debug_verbosity; /* instantiated in orte/runtime/orte_init.c */
|
|
ORTE_DECLSPEC extern char *orte_prohibited_session_dirs; /* instantiated in orte/runtime/orte_init.c */
|
|
ORTE_DECLSPEC extern bool orte_xml_output; /* instantiated in orte/runtime/orte_globals.c */
|
|
ORTE_DECLSPEC extern FILE *orte_xml_fp; /* instantiated in orte/runtime/orte_globals.c */
|
|
ORTE_DECLSPEC extern bool orte_help_want_aggregate; /* instantiated in orte/util/show_help.c */
|
|
ORTE_DECLSPEC extern char *orte_job_ident; /* instantiated in orte/runtime/orte_globals.c */
|
|
ORTE_DECLSPEC extern bool orte_create_session_dirs; /* instantiated in orte/runtime/orte_init.c */
|
|
ORTE_DECLSPEC extern bool orte_execute_quiet; /* instantiated in orte/runtime/orte_globals.c */
|
|
ORTE_DECLSPEC extern bool orte_report_silent_errors; /* instantiated in orte/runtime/orte_globals.c */
|
|
ORTE_DECLSPEC extern opal_event_base_t *orte_event_base; /* instantiated in orte/runtime/orte_init.c */
|
|
ORTE_DECLSPEC extern bool orte_event_base_active; /* instantiated in orte/runtime/orte_init.c */
|
|
ORTE_DECLSPEC extern bool orte_proc_is_bound; /* instantiated in orte/runtime/orte_init.c */
|
|
ORTE_DECLSPEC extern int orte_progress_thread_debug; /* instantiated in orte/runtime/orte_init.c */
|
|
|
|
|
|
#if OPAL_HAVE_HWLOC
|
|
/**
|
|
* Global indicating where this process was bound to at launch (will
|
|
* be NULL if !orte_proc_is_bound)
|
|
*/
|
|
OPAL_DECLSPEC extern hwloc_cpuset_t orte_proc_applied_binding; /* instantiated in orte/runtime/orte_init.c */
|
|
#endif
|
|
|
|
|
|
/* Shortcut for some commonly used names */
|
|
#define ORTE_NAME_WILDCARD (&orte_name_wildcard)
|
|
ORTE_DECLSPEC extern orte_process_name_t orte_name_wildcard; /** instantiated in orte/runtime/orte_init.c */
|
|
#define ORTE_NAME_INVALID (&orte_name_invalid)
|
|
ORTE_DECLSPEC extern orte_process_name_t orte_name_invalid; /** instantiated in orte/runtime/orte_init.c */
|
|
|
|
#define ORTE_PROC_MY_NAME (&orte_process_info.my_name)
|
|
|
|
/* define a special name that point to my parent (aka the process that spawned me) */
|
|
#define ORTE_PROC_MY_PARENT (&orte_process_info.my_parent)
|
|
|
|
/* define a special name that belongs to orterun */
|
|
#define ORTE_PROC_MY_HNP (&orte_process_info.my_hnp)
|
|
|
|
/* define the name of my daemon */
|
|
#define ORTE_PROC_MY_DAEMON (&orte_process_info.my_daemon)
|
|
|
|
/* define the name of my scheduler */
|
|
#define ORTE_PROC_MY_SCHEDULER (&orte_process_info.my_scheduler)
|
|
|
|
ORTE_DECLSPEC extern bool orte_in_parallel_debugger;
|
|
|
|
/* error manager callback function */
|
|
typedef void (*orte_err_cb_fn_t)(orte_process_name_t *proc, orte_proc_state_t state, void *cbdata);
|
|
|
|
ORTE_DECLSPEC extern int orte_exit_status;
|
|
|
|
/* ORTE event priorities - we define these
|
|
* at levels that permit higher layers such as
|
|
* OMPI to handle their events at higher priority,
|
|
* with the exception of errors. Errors generally
|
|
* require exception handling (e.g., ctrl-c termination)
|
|
* that overrides the need to process MPI messages
|
|
*/
|
|
#define ORTE_ERROR_PRI OPAL_EV_ERROR_PRI
|
|
#define ORTE_MSG_PRI OPAL_EV_MSG_LO_PRI
|
|
#define ORTE_SYS_PRI OPAL_EV_SYS_LO_PRI
|
|
#define ORTE_INFO_PRI OPAL_EV_INFO_LO_PRI
|
|
|
|
/* define some common keys used in ORTE */
|
|
#define ORTE_DB_HOSTNAME "orte.hostname"
|
|
#define ORTE_DB_DAEMON_VPID "orte.daemon.vpid"
|
|
#define ORTE_DB_NODERANK "orte.node.rank"
|
|
#define ORTE_DB_ARCH "orte.arch"
|
|
#define ORTE_DB_NPROCS "orte.nprocs"
|
|
#define ORTE_DB_NPROC_OFFSET "orte.nproc.offset"
|
|
#define ORTE_DB_RMLURI "orte.rmluri"
|
|
#define ORTE_DB_HOSTID "orte.hostid"
|
|
#define ORTE_DB_GLOBAL_RANK "orte.global.rank"
|
|
|
|
/* State Machine lists */
|
|
ORTE_DECLSPEC extern opal_list_t orte_job_states;
|
|
ORTE_DECLSPEC extern opal_list_t orte_proc_states;
|
|
|
|
/* a clean output channel without prefix */
|
|
ORTE_DECLSPEC extern int orte_clean_output;
|
|
|
|
ORTE_DECLSPEC extern opal_thread_t orte_progress_thread;
|
|
|
|
#define ORTE_GLOBAL_ARRAY_BLOCK_SIZE 64
|
|
#define ORTE_GLOBAL_ARRAY_MAX_SIZE INT_MAX
|
|
|
|
/* define a default error return code for ORTE */
|
|
#define ORTE_ERROR_DEFAULT_EXIT_CODE 1
|
|
|
|
/**
|
|
* Define a macro for updating the orte_exit_status
|
|
* The macro provides a convenient way of doing this
|
|
* so that we can add thread locking at some point
|
|
* since the orte_exit_status is a global variable.
|
|
*
|
|
* Ensure that we do not overwrite the exit status if it has
|
|
* already been set to some non-zero value. If we don't make
|
|
* this check, then different parts of the code could overwrite
|
|
* each other's exit status in the case of abnormal termination.
|
|
*
|
|
* For example, if a process aborts, we would record the initial
|
|
* exit code from the aborted process. However, subsequent processes
|
|
* will have been aborted by signal as we kill the job. We don't want
|
|
* the subsequent processes to overwrite the original exit code so
|
|
* we can tell the user the exit code from the process that caused
|
|
* the whole thing to happen.
|
|
*/
|
|
#define ORTE_UPDATE_EXIT_STATUS(newstatus) \
|
|
do { \
|
|
if (0 == orte_exit_status && 0 != newstatus) { \
|
|
OPAL_OUTPUT_VERBOSE((1, orte_debug_output, \
|
|
"%s:%s(%d) updating exit status to %d", \
|
|
ORTE_NAME_PRINT(ORTE_PROC_MY_NAME), \
|
|
__FILE__, __LINE__, newstatus)); \
|
|
orte_exit_status = newstatus; \
|
|
} \
|
|
} while(0);
|
|
|
|
/* sometimes we need to reset the exit status - for example, when we
|
|
* are restarting a failed process
|
|
*/
|
|
#define ORTE_RESET_EXIT_STATUS() \
|
|
do { \
|
|
OPAL_OUTPUT_VERBOSE((1, orte_debug_output, \
|
|
"%s:%s(%d) reseting exit status", \
|
|
ORTE_NAME_PRINT(ORTE_PROC_MY_NAME), \
|
|
__FILE__, __LINE__)); \
|
|
orte_exit_status = 0; \
|
|
} while(0);
|
|
|
|
|
|
/* define a macro for computing time differences - used for timing tests
|
|
* across the code base
|
|
*/
|
|
#define ORTE_COMPUTE_TIME_DIFF(r, ur, s1, us1, s2, us2) \
|
|
do { \
|
|
(r) = (s2) - (s1); \
|
|
if ((us2) >= (us1)) { \
|
|
(ur) = (us2) - (us1); \
|
|
} else { \
|
|
(r)--; \
|
|
(ur) = 1000000 - (us1) + (us2); \
|
|
} \
|
|
} while(0);
|
|
|
|
/* define a set of flags to control the launch of a job */
|
|
typedef uint16_t orte_job_controls_t;
|
|
#define ORTE_JOB_CONTROL OPAL_UINT16
|
|
|
|
#define ORTE_JOB_CONTROL_NON_ORTE_JOB 0x0002
|
|
#define ORTE_JOB_CONTROL_DEBUGGER_DAEMON 0x0014
|
|
#define ORTE_JOB_CONTROL_FORWARD_OUTPUT 0x0008
|
|
#define ORTE_JOB_CONTROL_DO_NOT_MONITOR 0x0010
|
|
#define ORTE_JOB_CONTROL_FORWARD_COMM 0x0020
|
|
#define ORTE_JOB_CONTROL_CONTINUOUS_OP 0x0040
|
|
#define ORTE_JOB_CONTROL_RECOVERABLE 0x0080
|
|
#define ORTE_JOB_CONTROL_SPIN_FOR_DEBUG 0x0100
|
|
#define ORTE_JOB_CONTROL_RESTART 0x0200
|
|
#define ORTE_JOB_CONTROL_PROCS_MIGRATING 0x0400
|
|
#define ORTE_JOB_CONTROL_MAPPER 0x0800
|
|
#define ORTE_JOB_CONTROL_REDUCER 0x1000
|
|
#define ORTE_JOB_CONTROL_COMBINER 0x2000
|
|
#define ORTE_JOB_CONTROL_NO_VM 0x4000
|
|
#define ORTE_JOB_CONTROL_INDEX_ARGV 0x8000
|
|
|
|
/* global type definitions used by RTE - instanced in orte_globals.c */
|
|
|
|
/************
|
|
* Declare this to allow us to use it before fully
|
|
* defining it - resolves potential circular definition
|
|
*/
|
|
struct orte_proc_t;
|
|
struct orte_job_map_t;
|
|
/************/
|
|
|
|
/**
|
|
* Information about a specific application to be launched in the RTE.
|
|
*/
|
|
typedef struct {
|
|
/** Parent object */
|
|
opal_object_t super;
|
|
/** Unique index when multiple apps per job */
|
|
orte_app_idx_t idx;
|
|
/** Absolute pathname of argv[0] */
|
|
char *app;
|
|
/** Number of copies of this process that are to be launched */
|
|
orte_std_cntr_t num_procs;
|
|
/** Array of pointers to the proc objects for procs of this app_context
|
|
* NOTE - not always used
|
|
*/
|
|
opal_pointer_array_t procs;
|
|
/** State of the app_context */
|
|
orte_app_state_t state;
|
|
/** First MPI rank of this app_context in the job */
|
|
orte_vpid_t first_rank;
|
|
/** Standard argv-style array, including a final NULL pointer */
|
|
char **argv;
|
|
/** Standard environ-style array, including a final NULL pointer */
|
|
char **env;
|
|
/** Current working directory for this app */
|
|
char *cwd;
|
|
/** Whether the cwd was set by the user or by the system */
|
|
bool user_specified_cwd;
|
|
/** Whether to set the current working directory to the proc session dir */
|
|
bool set_cwd_to_session_dir;
|
|
/* Any hostfile that was specified */
|
|
char *hostfile;
|
|
/* Hostfile for adding hosts to an existing allocation */
|
|
char *add_hostfile;
|
|
/* Hosts to be added to an existing allocation - analagous to -host */
|
|
char **add_host;
|
|
/** argv of hosts passed in to -host */
|
|
char ** dash_host;
|
|
/** list of resource constraints to be applied
|
|
* when selecting hosts for this app
|
|
*/
|
|
opal_list_t resource_constraints;
|
|
/** Prefix directory for this app (or NULL if no override necessary) */
|
|
char *prefix_dir;
|
|
/** Preload the binary on the remote machine (in PLM via FileM) */
|
|
bool preload_binary;
|
|
/** Preload the comma separated list of files to the remote machines cwd */
|
|
char * preload_files;
|
|
/* is being used on the local node */
|
|
bool used_on_node;
|
|
#if OPAL_ENABLE_FT_CR == 1
|
|
/** What files SStore should load before local launch, if any */
|
|
char *sstore_load;
|
|
#endif
|
|
/* recovery policy has been defined */
|
|
bool recovery_defined;
|
|
/* max number of times a process can be restarted */
|
|
int32_t max_restarts;
|
|
/* maximum number of procs/node for this app */
|
|
orte_vpid_t max_procs_per_node;
|
|
/* flag if nodes requested in -host are "mandatory" vs "optional" */
|
|
bool mandatory;
|
|
/* min number of nodes required */
|
|
int64_t min_number_of_nodes;
|
|
} orte_app_context_t;
|
|
|
|
ORTE_DECLSPEC OBJ_CLASS_DECLARATION(orte_app_context_t);
|
|
|
|
|
|
typedef struct {
|
|
/** Base object so this can be put on a list */
|
|
opal_list_item_t super;
|
|
/* index of this node object in global array */
|
|
orte_std_cntr_t index;
|
|
/** String node name */
|
|
char *name;
|
|
/* serial number - used if node is a coprocessor */
|
|
char *serial_number;
|
|
/* argv-like array of aliases for this node */
|
|
char **alias;
|
|
/* if this "node" is a coprocessor being hosted on a
|
|
* different node, then we need to know the id of our
|
|
* "host" to help any procs on us to determine locality
|
|
*/
|
|
orte_vpid_t hostid;
|
|
/* daemon on this node */
|
|
struct orte_proc_t *daemon;
|
|
/* whether or not this daemon has been launched */
|
|
bool daemon_launched;
|
|
/* whether or not the location has been verified - used
|
|
* for environments where the daemon's final destination
|
|
* is uncertain
|
|
*/
|
|
bool location_verified;
|
|
/** Launch id - needed by some systems to launch a proc on this node */
|
|
int32_t launch_id;
|
|
/** number of procs on this node */
|
|
orte_vpid_t num_procs;
|
|
/* array of pointers to procs on this node */
|
|
opal_pointer_array_t *procs;
|
|
/* next node rank on this node */
|
|
orte_node_rank_t next_node_rank;
|
|
/* whether or not we are oversubscribed */
|
|
bool oversubscribed;
|
|
/* whether we have been added to the current map */
|
|
bool mapped;
|
|
/** State of this node */
|
|
orte_node_state_t state;
|
|
/** A "soft" limit on the number of slots available on the node.
|
|
This will typically correspond to the number of physical CPUs
|
|
that we have been allocated on this note and would be the
|
|
"ideal" number of processes for us to launch. */
|
|
orte_std_cntr_t slots;
|
|
/* a flag indicating that the number of slots was specified - used
|
|
* only in non-managed environments
|
|
*/
|
|
bool slots_given;
|
|
/** How many processes have already been launched, used by one or
|
|
more jobs on this node. */
|
|
orte_std_cntr_t slots_inuse;
|
|
/** A "hard" limit (if set -- a value of 0 implies no hard limit)
|
|
on the number of slots that can be allocated on a given
|
|
node. This is for some environments (e.g. grid) there may be
|
|
fixed limits on the number of slots that can be used.
|
|
|
|
This value also could have been a boolean - but we may want to
|
|
allow the hard limit be different than the soft limit - in
|
|
other words allow the node to be oversubscribed up to a
|
|
specified limit. For example, if we have two processors, we
|
|
may want to allow up to four processes but no more. */
|
|
orte_std_cntr_t slots_max;
|
|
/** Username on this node, if specified */
|
|
char *username;
|
|
#if OPAL_HAVE_HWLOC
|
|
/* system topology for this node */
|
|
hwloc_topology_t topology;
|
|
#endif
|
|
/* history of resource usage - sized by sensor framework */
|
|
opal_ring_buffer_t stats;
|
|
} orte_node_t;
|
|
ORTE_DECLSPEC OBJ_CLASS_DECLARATION(orte_node_t);
|
|
|
|
typedef struct {
|
|
/** Base object so this can be put on a list */
|
|
opal_list_item_t super;
|
|
/* jobid for this job */
|
|
orte_jobid_t jobid;
|
|
/* offset to the total number of procs */
|
|
orte_vpid_t offset;
|
|
/* flag indicating that the job has been updated
|
|
* and needs to be included in the pidmap message
|
|
*/
|
|
bool updated;
|
|
/* app_context array for this job */
|
|
opal_pointer_array_t *apps;
|
|
/* number of app_contexts in the array */
|
|
orte_app_idx_t num_apps;
|
|
/* flags to control the launch of this job - see above
|
|
* for description of supported flags
|
|
*/
|
|
orte_job_controls_t controls;
|
|
/* timer event for failure detect/response if fails to launch */
|
|
orte_timer_t *failure_timer;
|
|
/* flag to indicate that MPI is allowed on this job - i.e.,
|
|
* that all members of the job are being simultaneously
|
|
* launched
|
|
*/
|
|
bool gang_launched;
|
|
/* rank desiring stdin - for now, either one rank, all ranks
|
|
* (wildcard), or none (invalid)
|
|
*/
|
|
orte_vpid_t stdin_target;
|
|
/* job that is to receive the stdout (on its stdin) from this one */
|
|
orte_jobid_t stdout_target;
|
|
/* collective ids */
|
|
orte_grpcomm_coll_id_t peer_modex;
|
|
orte_grpcomm_coll_id_t peer_init_barrier;
|
|
orte_grpcomm_coll_id_t peer_fini_barrier;
|
|
/* total slots allocated to this job */
|
|
orte_std_cntr_t total_slots_alloc;
|
|
/* number of procs in this job */
|
|
orte_vpid_t num_procs;
|
|
/* array of pointers to procs in this job */
|
|
opal_pointer_array_t *procs;
|
|
/* map of the job */
|
|
struct orte_job_map_t *map;
|
|
/* bookmark for where we are in mapping - this
|
|
* indicates the node where we stopped
|
|
*/
|
|
orte_node_t *bookmark;
|
|
/* state of the overall job */
|
|
orte_job_state_t state;
|
|
/* some procs in this job are being restarted */
|
|
bool restart;
|
|
/* number of procs mapped */
|
|
orte_vpid_t num_mapped;
|
|
/* number of procs launched */
|
|
orte_vpid_t num_launched;
|
|
/* number of procs reporting contact info */
|
|
orte_vpid_t num_reported;
|
|
/* number of procs terminated */
|
|
orte_vpid_t num_terminated;
|
|
/* number of daemons reported launched so we can track progress */
|
|
orte_vpid_t num_daemons_reported;
|
|
/* number of procs with non-zero exit codes */
|
|
int32_t num_non_zero_exit;
|
|
/* originator of a dynamic spawn */
|
|
orte_process_name_t originator;
|
|
/* did this job abort? */
|
|
bool abort;
|
|
/* proc that caused that to happen */
|
|
struct orte_proc_t *aborted_proc;
|
|
/* recovery policy has been defined */
|
|
bool recovery_defined;
|
|
/* enable recovery of these processes */
|
|
bool enable_recovery;
|
|
/* time launch message was sent */
|
|
struct timeval launch_msg_sent;
|
|
/* time launch message was recvd */
|
|
struct timeval launch_msg_recvd;
|
|
/* max time for launch msg to be received */
|
|
struct timeval max_launch_msg_recvd;
|
|
orte_vpid_t num_local_procs;
|
|
/* file maps associates with this job */
|
|
opal_buffer_t *file_maps;
|
|
#if OPAL_ENABLE_FT_CR == 1
|
|
/* ckpt state */
|
|
size_t ckpt_state;
|
|
/* snapshot reference */
|
|
char *ckpt_snapshot_ref;
|
|
/* snapshot location */
|
|
char *ckpt_snapshot_loc;
|
|
/* collective ids */
|
|
orte_grpcomm_coll_id_t snapc_init_barrier;
|
|
orte_grpcomm_coll_id_t snapc_fini_barrier;
|
|
#endif
|
|
} orte_job_t;
|
|
ORTE_DECLSPEC OBJ_CLASS_DECLARATION(orte_job_t);
|
|
|
|
struct orte_proc_t {
|
|
/** Base object so this can be put on a list */
|
|
opal_list_item_t super;
|
|
/* process name */
|
|
orte_process_name_t name;
|
|
/* the vpid of my parent */
|
|
orte_vpid_t parent;
|
|
/* pid */
|
|
pid_t pid;
|
|
/* local rank amongst my peers on the node
|
|
* where this is running - this value is
|
|
* needed by MPI procs so that the lowest
|
|
* rank on a node can perform certain fns -
|
|
* e.g., open an sm backing file
|
|
*/
|
|
orte_local_rank_t local_rank;
|
|
/* local rank on the node across all procs
|
|
* and jobs known to this HNP - this is
|
|
* needed so that procs can do things like
|
|
* know which static IP port to use
|
|
*/
|
|
orte_node_rank_t node_rank;
|
|
/* rank of this proc within its app context - this
|
|
* will just equal its vpid for single app_context
|
|
* applications
|
|
*/
|
|
int32_t app_rank;
|
|
/* Last state used to trigger the errmgr for this proc */
|
|
orte_proc_state_t last_errmgr_state;
|
|
/* process state */
|
|
orte_proc_state_t state;
|
|
/* shortcut for determinng proc has been launched
|
|
* and has not yet terminated
|
|
*/
|
|
bool alive;
|
|
/* flag if it called abort */
|
|
bool aborted;
|
|
/* flag that the proc has been updated and need to be
|
|
* included in the next pidmap message
|
|
*/
|
|
bool updated;
|
|
/* exit code */
|
|
orte_exit_code_t exit_code;
|
|
/* the app_context that generated this proc */
|
|
orte_app_idx_t app_idx;
|
|
#if OPAL_HAVE_HWLOC
|
|
/* hwloc object to which this process was mapped */
|
|
hwloc_obj_t locale;
|
|
/* hwloc object to which this process is bound */
|
|
hwloc_obj_t bind_location;
|
|
/* string representation of cpu bindings */
|
|
char *cpu_bitmap;
|
|
#endif
|
|
/* pointer to the node where this proc is executing */
|
|
orte_node_t *node;
|
|
/* indicate that this proc is local */
|
|
bool local_proc;
|
|
/* indicate that this proc should not barrier - used
|
|
* for restarting processes
|
|
*/
|
|
bool do_not_barrier;
|
|
/* pointer to the node where this proc last executed */
|
|
orte_node_t *prior_node;
|
|
/* name of the node where this proc is executing - this
|
|
* is used simply to pass that info to a calling
|
|
* tool since it may not have a node array available
|
|
*/
|
|
char *nodename;
|
|
/* RML contact info */
|
|
char *rml_uri;
|
|
/* number of times this process has been restarted */
|
|
int32_t restarts;
|
|
/* time of last restart */
|
|
struct timeval last_failure;
|
|
/* number of failures in "fast" window */
|
|
int32_t fast_failures;
|
|
/* flag to indicate proc has reported in */
|
|
bool reported;
|
|
/* if heartbeat recvd during last time period */
|
|
int beat;
|
|
/* history of resource usage - sized by sensor framework */
|
|
opal_ring_buffer_t stats;
|
|
/* track finalization */
|
|
bool registered;
|
|
bool mpi_proc;
|
|
bool deregistered;
|
|
bool iof_complete;
|
|
bool waitpid_recvd;
|
|
#if OPAL_ENABLE_FT_CR == 1
|
|
/* ckpt state */
|
|
size_t ckpt_state;
|
|
/* snapshot reference */
|
|
char *ckpt_snapshot_ref;
|
|
/* snapshot location */
|
|
char *ckpt_snapshot_loc;
|
|
#endif
|
|
};
|
|
typedef struct orte_proc_t orte_proc_t;
|
|
ORTE_DECLSPEC OBJ_CLASS_DECLARATION(orte_proc_t);
|
|
|
|
/**
|
|
* Get a job data object
|
|
* We cannot just reference a job data object with its jobid as
|
|
* the jobid is no longer an index into the array. This change
|
|
* was necessitated by modification of the jobid to include
|
|
* an mpirun-unique qualifer to eliminate any global name
|
|
* service
|
|
*/
|
|
ORTE_DECLSPEC orte_job_t* orte_get_job_data_object(orte_jobid_t job);
|
|
|
|
/**
|
|
* Get a proc data object
|
|
*/
|
|
ORTE_DECLSPEC orte_proc_t* orte_get_proc_object(orte_process_name_t *proc);
|
|
|
|
/**
|
|
* Get the daemon vpid hosting a given proc
|
|
*/
|
|
ORTE_DECLSPEC orte_vpid_t orte_get_proc_daemon_vpid(orte_process_name_t *proc);
|
|
|
|
/* Get the hostname of a proc */
|
|
ORTE_DECLSPEC char* orte_get_proc_hostname(orte_process_name_t *proc);
|
|
|
|
/* get the node rank of a proc */
|
|
ORTE_DECLSPEC orte_node_rank_t orte_get_proc_node_rank(orte_process_name_t *proc);
|
|
|
|
/* Find the lowest vpid alive in a given job */
|
|
ORTE_DECLSPEC orte_vpid_t orte_get_lowest_vpid_alive(orte_jobid_t job);
|
|
|
|
/* global variables used by RTE - instanced in orte_globals.c */
|
|
ORTE_DECLSPEC extern bool orte_timing;
|
|
ORTE_DECLSPEC extern FILE *orte_timing_output;
|
|
ORTE_DECLSPEC extern bool orte_timing_details;
|
|
ORTE_DECLSPEC extern bool orte_debug_daemons_flag;
|
|
ORTE_DECLSPEC extern bool orte_debug_daemons_file_flag;
|
|
ORTE_DECLSPEC extern bool orte_leave_session_attached;
|
|
ORTE_DECLSPEC extern bool orte_do_not_launch;
|
|
ORTE_DECLSPEC extern bool orted_spin_flag;
|
|
ORTE_DECLSPEC extern char *orte_local_cpu_type;
|
|
ORTE_DECLSPEC extern char *orte_local_cpu_model;
|
|
ORTE_DECLSPEC extern char *orte_basename;
|
|
ORTE_DECLSPEC extern bool orte_coprocessors_detected;
|
|
ORTE_DECLSPEC extern opal_hash_table_t *orte_coprocessors;
|
|
|
|
/* ORTE OOB port flags */
|
|
ORTE_DECLSPEC extern bool orte_static_ports;
|
|
ORTE_DECLSPEC extern char *orte_oob_static_ports;
|
|
ORTE_DECLSPEC extern bool orte_standalone_operation;
|
|
|
|
/* nodename flags */
|
|
ORTE_DECLSPEC extern bool orte_keep_fqdn_hostnames;
|
|
ORTE_DECLSPEC extern bool orte_have_fqdn_allocation;
|
|
ORTE_DECLSPEC extern bool orte_show_resolved_nodenames;
|
|
ORTE_DECLSPEC extern bool orte_retain_aliases;
|
|
ORTE_DECLSPEC extern int orte_use_hostname_alias;
|
|
|
|
/* debug flags */
|
|
ORTE_DECLSPEC extern int orted_debug_failure;
|
|
ORTE_DECLSPEC extern int orted_debug_failure_delay;
|
|
|
|
/* homegeneity flags */
|
|
ORTE_DECLSPEC extern bool orte_homogeneous_nodes;
|
|
ORTE_DECLSPEC extern bool orte_hetero_apps;
|
|
ORTE_DECLSPEC extern bool orte_hetero_nodes;
|
|
|
|
ORTE_DECLSPEC extern bool orte_never_launched;
|
|
ORTE_DECLSPEC extern bool orte_devel_level_output;
|
|
ORTE_DECLSPEC extern bool orte_display_topo_with_map;
|
|
ORTE_DECLSPEC extern bool orte_display_diffable_output;
|
|
|
|
ORTE_DECLSPEC extern char **orte_launch_environ;
|
|
|
|
ORTE_DECLSPEC extern bool orte_hnp_is_allocated;
|
|
ORTE_DECLSPEC extern bool orte_allocation_required;
|
|
ORTE_DECLSPEC extern bool orte_managed_allocation;
|
|
ORTE_DECLSPEC extern char *orte_set_slots;
|
|
ORTE_DECLSPEC extern bool orte_display_allocation;
|
|
ORTE_DECLSPEC extern bool orte_display_devel_allocation;
|
|
ORTE_DECLSPEC extern bool orte_soft_locations;
|
|
ORTE_DECLSPEC extern bool orte_hnp_connected;
|
|
|
|
/* launch agents */
|
|
ORTE_DECLSPEC extern char *orte_launch_agent;
|
|
ORTE_DECLSPEC extern char **orted_cmd_line;
|
|
ORTE_DECLSPEC extern char **orte_fork_agent;
|
|
|
|
/* debugger job */
|
|
ORTE_DECLSPEC extern bool orte_debugger_dump_proctable;
|
|
ORTE_DECLSPEC extern char *orte_debugger_test_daemon;
|
|
ORTE_DECLSPEC extern bool orte_debugger_test_attach;
|
|
ORTE_DECLSPEC extern int orte_debugger_check_rate;
|
|
|
|
/* exit flags */
|
|
ORTE_DECLSPEC extern bool orte_abnormal_term_ordered;
|
|
ORTE_DECLSPEC extern bool orte_routing_is_enabled;
|
|
ORTE_DECLSPEC extern bool orte_job_term_ordered;
|
|
ORTE_DECLSPEC extern bool orte_orteds_term_ordered;
|
|
ORTE_DECLSPEC extern bool orte_allowed_exit_without_sync;
|
|
ORTE_DECLSPEC extern int orte_startup_timeout;
|
|
|
|
ORTE_DECLSPEC extern int orte_timeout_usec_per_proc;
|
|
ORTE_DECLSPEC extern float orte_max_timeout;
|
|
ORTE_DECLSPEC extern orte_timer_t *orte_mpiexec_timeout;
|
|
ORTE_DECLSPEC extern opal_buffer_t *orte_tree_launch_cmd;
|
|
|
|
/* global arrays for data storage */
|
|
ORTE_DECLSPEC extern opal_pointer_array_t *orte_job_data;
|
|
ORTE_DECLSPEC extern opal_pointer_array_t *orte_node_pool;
|
|
ORTE_DECLSPEC extern opal_pointer_array_t *orte_node_topologies;
|
|
ORTE_DECLSPEC extern opal_pointer_array_t *orte_local_children;
|
|
ORTE_DECLSPEC extern orte_vpid_t orte_total_procs;
|
|
|
|
/* whether or not to forward SIGTSTP and SIGCONT signals */
|
|
ORTE_DECLSPEC extern bool orte_forward_job_control;
|
|
|
|
/* IOF controls */
|
|
ORTE_DECLSPEC extern bool orte_tag_output;
|
|
ORTE_DECLSPEC extern bool orte_timestamp_output;
|
|
ORTE_DECLSPEC extern char *orte_output_filename;
|
|
/* generate new xterm windows to display output from specified ranks */
|
|
ORTE_DECLSPEC extern char *orte_xterm;
|
|
|
|
/* whether or not to report launch progress */
|
|
ORTE_DECLSPEC extern bool orte_report_launch_progress;
|
|
|
|
/* allocation specification */
|
|
ORTE_DECLSPEC extern char *orte_default_hostfile;
|
|
ORTE_DECLSPEC extern bool orte_default_hostfile_given;
|
|
ORTE_DECLSPEC extern char *orte_rankfile;
|
|
ORTE_DECLSPEC extern int orte_num_allocated_nodes;
|
|
ORTE_DECLSPEC extern char *orte_node_regex;
|
|
|
|
/* tool communication controls */
|
|
ORTE_DECLSPEC extern bool orte_report_events;
|
|
ORTE_DECLSPEC extern char *orte_report_events_uri;
|
|
|
|
/* process recovery */
|
|
ORTE_DECLSPEC extern bool orte_enable_recovery;
|
|
ORTE_DECLSPEC extern int32_t orte_max_restarts;
|
|
/* barrier control */
|
|
ORTE_DECLSPEC extern bool orte_do_not_barrier;
|
|
|
|
/* exit status reporting */
|
|
ORTE_DECLSPEC extern bool orte_report_child_jobs_separately;
|
|
ORTE_DECLSPEC extern struct timeval orte_child_time_to_exit;
|
|
ORTE_DECLSPEC extern bool orte_abort_non_zero_exit;
|
|
|
|
/* length of stat history to keep */
|
|
ORTE_DECLSPEC extern int orte_stat_history_size;
|
|
|
|
/* envars to forward */
|
|
ORTE_DECLSPEC extern char *orte_forward_envars;
|
|
ORTE_DECLSPEC extern char **orte_forwarded_envars;
|
|
|
|
/* map-reduce mode */
|
|
ORTE_DECLSPEC extern bool orte_map_reduce;
|
|
ORTE_DECLSPEC extern bool orte_staged_execution;
|
|
|
|
/* map stddiag output to stderr so it isn't forwarded to mpirun */
|
|
ORTE_DECLSPEC extern bool orte_map_stddiag_to_stderr;
|
|
|
|
/* maximum size of virtual machine - used to subdivide allocation */
|
|
ORTE_DECLSPEC extern int orte_max_vm_size;
|
|
|
|
/* global nidmap/pidmap for daemons to give to apps */
|
|
ORTE_DECLSPEC extern opal_byte_object_t orte_nidmap;
|
|
ORTE_DECLSPEC extern opal_byte_object_t orte_pidmap;
|
|
|
|
/* user debugger */
|
|
ORTE_DECLSPEC extern char *orte_base_user_debugger;
|
|
|
|
/* binding directives for daemons to restrict them
|
|
* to certain cores
|
|
*/
|
|
ORTE_DECLSPEC extern char *orte_daemon_cores;
|
|
|
|
END_C_DECLS
|
|
|
|
#endif /* ORTE_RUNTIME_ORTE_GLOBALS_H */
|