4fff584a68
The primary change that underlies all this is in the OOB. Specifically, the problem in the code until now has been that the OOB attempts to resolve an address when we call the "send" to an unknown recipient. The OOB would then wait forever if that recipient never actually started (and hence, never reported back its OOB contact info). In the case of an orted that failed to start, we would correctly detect that the orted hadn't started, but then we would attempt to order all orteds (including the one that failed to start) to die. This would cause the OOB to "hang" the system. Unfortunately, revising how the OOB resolves addresses introduced a number of additional problems. Specifically, and most troublesome, was the fact that comm_spawn involved the immediate transmission of the rendezvous point from parent-to-child after the child was spawned. The current code used the OOB address resolution as a "barrier" - basically, the parent would attempt to send the info to the child, and then "hold" there until the child's contact info had arrived (meaning the child had started) and the send could be completed. Note that this also caused comm_spawn to "hang" the entire system if the child never started... The app-failed-to-start helped improve that behavior - this code provides additional relief. With this change, the OOB will return an ADDRESSEE_UNKNOWN error if you attempt to send to a recipient whose contact info isn't already in the OOB's hash tables. To resolve comm_spawn issues, we also now force the cross-sharing of connection info between parent and child jobs during spawn. Finally, to aid in setting triggers to the right values, we introduce the "arith" API for the GPR. This function allows you to atomically change the value in a registry location (either divide, multiply, add, or subtract) by the provided operand. It is equivalent to first fetching the value using a "get", then modifying it, and then putting the result back into the registry via a "put". This commit was SVN r14711.
168 строки
5.7 KiB
C
168 строки
5.7 KiB
C
/*
|
|
* 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.
|
|
* Copyright (c) 2007 Sun Microsystems, Inc. All rights reserved.
|
|
* $COPYRIGHT$
|
|
*
|
|
* Additional copyrights may follow
|
|
*
|
|
* $HEADER$
|
|
*/
|
|
|
|
/**
|
|
* @file
|
|
*
|
|
* Interface into the Open MPI Run Time Environment
|
|
*/
|
|
#ifndef ORTE_RUNTIME_H
|
|
#define ORTE_RUNTIME_H
|
|
|
|
#include "orte_config.h"
|
|
|
|
#ifdef HAVE_SYS_TYPES_H
|
|
#include <sys/types.h>
|
|
#endif
|
|
|
|
#include "orte/mca/gpr/gpr_types.h"
|
|
#include "opal/util/cmd_line.h"
|
|
|
|
#include "orte/runtime/runtime_types.h"
|
|
#include "orte/util/univ_info.h"
|
|
#include "orte/mca/ns/ns.h"
|
|
|
|
/* some convenience definitions for code clarity */
|
|
#define ORTE_INFRASTRUCTURE true
|
|
#define ORTE_NON_INFRASTRUCTURE false
|
|
|
|
#define ORTE_USE_BARRIER true
|
|
#define ORTE_NON_BARRIER false
|
|
|
|
#if defined(c_plusplus) || defined(__cplusplus)
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* Abort the current application
|
|
*
|
|
* Aborts currently running application, NOTE: We do NOT call the
|
|
* regular C-library "abort" function, even
|
|
* though that would have alerted us to the fact that this is
|
|
* an abnormal termination, because it would automatically cause
|
|
* a core file to be generated. The "report" flag indicates if the
|
|
* function should create an appropriate file to alert the local
|
|
* orted that termination was abnormal.
|
|
*/
|
|
ORTE_DECLSPEC int orte_abort(int status, bool report);
|
|
|
|
|
|
/**
|
|
* Initialize the Open Run Time Environment
|
|
*
|
|
* Initlize the Open Run Time Environment, including process
|
|
* control, malloc debugging and threads, and out of band messaging.
|
|
* This function should be called exactly once. This function should
|
|
* be called by every application using the RTE interface, including
|
|
* MPI applications and mpirun.
|
|
*
|
|
* @param infrastructure Whether we are ORTE infrastructure or an ORTE
|
|
* application
|
|
*/
|
|
ORTE_DECLSPEC int orte_init(bool infrastructure, bool barrier);
|
|
ORTE_DECLSPEC int orte_system_init(bool infrastructure, bool barrier);
|
|
ORTE_DECLSPEC int orte_init_stage1(bool infrastructure);
|
|
ORTE_DECLSPEC int orte_init_stage2(char *trigger);
|
|
|
|
/**
|
|
* Initialize parameters for ORTE.
|
|
*
|
|
* @retval ORTE_SUCCESS Upon success.
|
|
* @retval ORTE_ERROR Upon failure.
|
|
*/
|
|
ORTE_DECLSPEC int orte_register_params(bool infrastructure);
|
|
|
|
/**
|
|
* Re-init the Open run time environment.
|
|
*
|
|
* Restart selected components with a new process name.
|
|
*/
|
|
ORTE_DECLSPEC int orte_restart(orte_process_name_t* name, const char* uri);
|
|
|
|
/**
|
|
* Finalize the Open run time environment. Any function calling \code
|
|
* orte_init should call \code orte_finalize.
|
|
*
|
|
*/
|
|
ORTE_DECLSPEC int orte_finalize(void);
|
|
ORTE_DECLSPEC int orte_system_finalize(void);
|
|
|
|
/*
|
|
* Change state as processes complete registration/unregistration
|
|
*/
|
|
|
|
ORTE_DECLSPEC void orte_all_procs_registered(orte_gpr_notify_message_t* match, void* cbdata);
|
|
|
|
ORTE_DECLSPEC void orte_all_procs_unregistered(orte_gpr_notify_message_t* match, void* cbdata);
|
|
|
|
ORTE_DECLSPEC int orte_monitor_procs_registered(void);
|
|
|
|
ORTE_DECLSPEC int orte_monitor_procs_unregistered(void);
|
|
|
|
/**
|
|
* Obtain a listing of all the universes on the machine
|
|
*
|
|
* @param univ_list An opal_list_t is returned to the user.
|
|
* This is not initalized in the function, the caller retains
|
|
* the responsibility for this variable.
|
|
* @retval ORTE_SUCCESS Upon successful search.
|
|
* @retval ORTE_ERROR Upon unsuccessful search.
|
|
*/
|
|
ORTE_DECLSPEC int orte_universe_search(opal_list_t *universe_list, bool report_broken_files,
|
|
bool remove_broken_files);
|
|
|
|
/**
|
|
* Check for universe existence
|
|
*
|
|
* Checks to see if a specified universe exists. If so, attempts
|
|
* to connect to verify that the universe is accepting connections.
|
|
* If both ns and gpr replicas provided, first checks for those
|
|
* connections. Gets any missing info from the universe contact.
|
|
*
|
|
* @param univ Pointer to universe info struct where any found info
|
|
* is to be stored
|
|
*
|
|
* @retval ORTE_SUCCESS Universe found and connection accepted
|
|
* @retval ORTE_ERR_NO_CONNECTION_ALLOWED Universe found, but not persistent or
|
|
* restricted to local scope
|
|
* @retval ORTE_ERR_CONNECTION_FAILED Universe found, but connection attempt
|
|
* failed. Probably caused by unclean termination of the universe seed
|
|
* daemon.
|
|
*/
|
|
ORTE_DECLSPEC int orte_universe_exists(orte_universe_t *univ);
|
|
|
|
/**
|
|
* Establish a Head Node Process on a cluster's front end
|
|
*/
|
|
ORTE_DECLSPEC int orte_setup_hnp(char *target_cluster, char *headnode, char *username);
|
|
|
|
/**
|
|
* Clean out all directories in a session directory except for the one
|
|
* handed in.
|
|
* @param my_universe Name of universe to not remove
|
|
* @param verbose Print out information as directories are removed
|
|
*/
|
|
ORTE_DECLSPEC void orte_universe_clean_directories(char *my_universe, int verbose);
|
|
|
|
#if defined(c_plusplus) || defined(__cplusplus)
|
|
}
|
|
#endif
|
|
|
|
#endif /* RUNTIME_H */
|