/* * Copyright (c) 2004-2005 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: * Part of the bproc launcher. * See odls_bproc.h for an overview of how it works. */ #include "orte_config.h" #include #include #include #include #include #include #include "opal/mca/base/mca_base_param.h" #include "opal/runtime/opal_progress.h" #include "opal/threads/condition.h" #include "opal/util/os_dirpath.h" #include "opal/util/os_path.h" #include "opal/util/output.h" #include "orte/dss/dss.h" #include "orte/util/sys_info.h" #include "orte/orte_constants.h" #include "orte/mca/errmgr/errmgr.h" #include "orte/mca/gpr/gpr.h" #include "orte/mca/iof/iof.h" #include "orte/mca/iof/base/iof_base_setup.h" #include "orte/mca/ns/base/base.h" #include "orte/mca/oob/base/base.h" #include "orte/mca/rml/rml.h" #include "orte/util/session_dir.h" #include "orte/util/univ_info.h" #include "odls_bproc.h" /** * Initialization of the bproc_orted module with all the needed function pointers */ orte_odls_base_module_t orte_odls_bproc_module = { orte_odls_bproc_subscribe_launch_data, orte_odls_bproc_get_add_procs_data, orte_odls_bproc_launch_local_procs, orte_odls_bproc_kill_local_procs, orte_odls_bproc_signal_local_procs }; static int odls_bproc_make_dir(char *directory); static char * odls_bproc_get_base_dir_name(int proc_rank, orte_jobid_t jobid, orte_std_cntr_t app_context); static void odls_bproc_delete_dir_tree(char * path); static int odls_bproc_remove_dir(void); static void odls_bproc_send_cb(int status, orte_process_name_t * peer, orte_buffer_t* buffer, int tag, void* cbdata); static int odls_bproc_setup_stdio(orte_process_name_t *proc_name, int proc_rank, orte_jobid_t jobid, orte_std_cntr_t app_context, bool connect_stdin); int orte_odls_bproc_get_add_procs_data(orte_gpr_notify_data_t **data, orte_job_map_t *map) { return ORTE_ERR_NOT_IMPLEMENTED; } /** * Creates the passed directory. If the directory already exists, it and its * contents will be deleted then the directory will be created. * @param directory The directory to be created. * @retval ORTE_SUCCESS * @retval error */ static int odls_bproc_make_dir(char *directory) { struct stat buf; mode_t my_mode = S_IRWXU; /* at the least, I need to be able to do anything */ if (0 == stat(directory, &buf)) { /* exists - delete it and its contents */ odls_bproc_delete_dir_tree(directory); } /* try to create it with proper mode */ return(opal_os_dirpath_create(directory, my_mode)); } /** * Returns a path of the form: * @code * /tmp/openmpi-bproc-//-// * @endcode * which is used to put links to the pty/pipes in * @param proc_rank the process's rank on the node * @param jobid the jobid the proc belongs to * @param app_context the application context number within the job * @retval path */ static char * odls_bproc_get_base_dir_name(int proc_rank, orte_jobid_t jobid, orte_std_cntr_t app_context) { char *path = NULL, *user = NULL, *job = NULL; int rc; /* ensure that system info is set */ orte_sys_info(); if (NULL == orte_universe_info.name) { /* error condition */ ORTE_ERROR_LOG(ORTE_ERROR); return NULL; } rc = orte_ns.convert_jobid_to_string(&job, jobid); if(ORTE_SUCCESS != rc) { ORTE_ERROR_LOG(rc); return NULL; } /* get the username set by the bproc pls. We need to get it from here * because on many bproc systems the method we use to get the username * from the system on the backend fails and we only get the uid. */ rc = mca_base_param_register_string("pls", "bproc", "username", NULL, orte_system_info.user); mca_base_param_lookup_string(rc,&user); if (0 > asprintf(&path, OPAL_PATH_SEP"tmp"OPAL_PATH_SEP"openmpi-bproc-%s"OPAL_PATH_SEP"%s"OPAL_PATH_SEP"%s-%d"OPAL_PATH_SEP"%d", user, orte_universe_info.name, job, (int) app_context, proc_rank)) { ORTE_ERROR_LOG(ORTE_ERROR); path = NULL; } if(0 < mca_odls_bproc_component.debug) { opal_output(0, "odls bproc io setup. Path: %s\n", path); } free(user); free(job); return path; } /** * deletes the passed directory tree recursively * @param path the path to the base directory to delete */ static void odls_bproc_delete_dir_tree(char * path) { DIR *dp; struct dirent *ep; char *filenm; int ret; struct stat buf; dp = opendir(path); if (NULL == dp) { return; } while (NULL != (ep = readdir(dp)) ) { /* skip: . and .. */ if ((0 != strcmp(ep->d_name, ".")) && (0 != strcmp(ep->d_name, ".."))) { filenm = opal_os_path(false, path, ep->d_name, NULL); ret = stat(filenm, &buf); if (ret < 0 || S_ISDIR(buf.st_mode)) { odls_bproc_delete_dir_tree(filenm); free(filenm); continue; } unlink(filenm); free(filenm); } } closedir(dp); rmdir(path); } /** * Removes the bproc directory * @code /tmp/openmpi-bproc-/ @endcode and all of its contents * @retval ORTE_SUCCESS * @retval error */ static int odls_bproc_remove_dir() { char *frontend = NULL, *user = NULL, *filename = NULL; int id; /* get the username set by the bproc pls. We need to get it from here * because on many bproc systems the method we use to get the username * from the system on the backend fails and we only get the uid. */ id = mca_base_param_register_string("pls", "bproc", "username", NULL, orte_system_info.user); mca_base_param_lookup_string(id,&user); asprintf(&filename, "openmpi-bproc-%s", user ); if( NULL == filename ) { ORTE_ERROR_LOG(ORTE_ERR_OUT_OF_RESOURCE); return ORTE_ERROR; } frontend = opal_os_path(false, "tmp", filename, NULL ); free(filename); /* Always free the filename */ if (NULL == frontend) { ORTE_ERROR_LOG(ORTE_ERR_OUT_OF_RESOURCE); return ORTE_ERROR; } /* we do our best to clean up the directory tree, but we ignore errors*/ odls_bproc_delete_dir_tree(frontend); free(frontend); return ORTE_SUCCESS; } /** * Callback function for when we tell mpirun we are ready * @param status * @param peer * @param buffer * @param tag * @param cbdata */ static void odls_bproc_send_cb(int status, orte_process_name_t * peer, orte_buffer_t* buffer, int tag, void* cbdata) { OBJ_RELEASE(buffer); } /** * Create Standard I/O symlinks in the filesystem for a given proc * * Create Standard I/O symlinks in the filesystem for a given proc. * The symlinks will be placed in: * @code * /tmp/openmpi-bproc-//-// * @endcode * * The symlinks will be to FIFOs for stdin and stderr. stdout will either * be to a FIFO or pty, depending on the configuration of Open MPI. * * @param proc_rank the process's rank on the node * @param jobid the jobid the proc belongs to * @param app_context the application context number within the job * @param connect_stdin if true, stdin will be connected, otherwise it will be * set to /dev/null * * @retval ORTE_SUCCESS * @retval error */ static int odls_bproc_setup_stdio(orte_process_name_t *proc_name, int proc_rank, orte_jobid_t jobid, orte_std_cntr_t app_context, bool connect_stdin) { char *path_prefix, *fd_link_path = NULL; int rc = ORTE_SUCCESS, fd; #if defined(HAVE_OPENPTY) && (OMPI_ENABLE_PTY_SUPPORT != 0) int amaster, aslave; char pty_name[256]; struct termios term_attrs; #endif path_prefix = odls_bproc_get_base_dir_name(proc_rank, jobid, (size_t)app_context); if (NULL == path_prefix) { rc = ORTE_ERROR; ORTE_ERROR_LOG(rc); goto cleanup; } /* check for existence and access, or create it */ if (ORTE_SUCCESS != (rc = odls_bproc_make_dir(path_prefix))) { ORTE_ERROR_LOG(rc); goto cleanup; } /* setup the stdin FIFO. Always use a fifo for the same reason we always use a pipe in the iof_setup code -- don't want to flush onto the floor during close */ fd_link_path = opal_os_path( false, path_prefix, "0", NULL ); if (NULL == fd_link_path) { rc = ORTE_ERROR; ORTE_ERROR_LOG(rc); goto cleanup; } if (connect_stdin) { if (0 != mkfifo(fd_link_path, S_IRWXU)) { perror("odls_bproc mkfifo failed"); rc = ORTE_ERROR; ORTE_ERROR_LOG(rc); goto cleanup; } fd = open(fd_link_path, O_RDWR); if (-1 == fd) { perror("odls_bproc open failed"); rc = ORTE_ERROR; ORTE_ERROR_LOG(rc); goto cleanup; } orte_iof.iof_publish(proc_name, ORTE_IOF_SINK, ORTE_IOF_STDIN, fd); } else { if(0 != symlink("/dev/null", fd_link_path)) { perror("odls_bproc could not create symlink"); rc = ORTE_ERROR; ORTE_ERROR_LOG(rc); goto cleanup; } } free(fd_link_path); fd_link_path = NULL; /* setup the stdout PTY / FIFO */ fd_link_path = opal_os_path( false, path_prefix, "1", NULL ); if (NULL == fd_link_path) { rc = ORTE_ERROR; ORTE_ERROR_LOG(rc); goto cleanup; } #if defined(HAVE_OPENPTY) && (OMPI_ENABLE_PTY_SUPPORT != 0) if (0 != openpty(&amaster, &aslave, pty_name, NULL, NULL)) { opal_output(0, "odls_bproc: openpty failed, using pipes instead"); goto stdout_fifo_setup; } if (0 != symlink(pty_name, fd_link_path)) { rc = ORTE_ERROR; ORTE_ERROR_LOG(rc); goto cleanup; } if (tcgetattr(aslave, &term_attrs) < 0) { rc = ORTE_ERROR; ORTE_ERROR_LOG(rc); goto cleanup; } term_attrs.c_lflag &= ~ (ECHO | ECHOE | ECHOK | ECHOCTL | ECHOKE | ECHONL); term_attrs.c_iflag &= ~ (ICRNL | INLCR | ISTRIP | INPCK | IXON); term_attrs.c_oflag &= ~ (OCRNL | ONLCR); if (tcsetattr(aslave, TCSANOW, &term_attrs) == -1) { rc = ORTE_ERROR; ORTE_ERROR_LOG(rc); goto cleanup; } orte_iof.iof_publish(proc_name, ORTE_IOF_SOURCE, ORTE_IOF_STDOUT, amaster); goto stderr_fifo_setup; stdout_fifo_setup: #endif if (0 != mkfifo(fd_link_path, S_IRWXU)) { perror("odls_bproc mkfifo failed"); rc = ORTE_ERROR; goto cleanup; } fd = open(fd_link_path, O_RDWR); if (-1 == fd) { perror("odls_bproc open failed"); rc = ORTE_ERROR; goto cleanup; } orte_iof.iof_publish(proc_name, ORTE_IOF_SOURCE, ORTE_IOF_STDOUT, fd); #if defined(HAVE_OPENPTY) && (OMPI_ENABLE_PTY_SUPPORT != 0) stderr_fifo_setup: #endif free(fd_link_path); fd_link_path = NULL; /* setup the stderr FIFO. Always a fifo */ fd_link_path = opal_os_path( false, path_prefix, "2", NULL ); if (NULL == fd_link_path) { rc = ORTE_ERROR; ORTE_ERROR_LOG(rc); goto cleanup; } if (0 != mkfifo(fd_link_path, S_IRWXU)) { perror("odls_bproc mkfifo failed"); rc = ORTE_ERROR; goto cleanup; } fd = open(fd_link_path, O_RDWR); if (-1 == fd) { perror("odls_bproc open failed"); rc = ORTE_ERROR; goto cleanup; } orte_iof.iof_publish(proc_name, ORTE_IOF_SOURCE, ORTE_IOF_STDERR, fd); cleanup: if (NULL != path_prefix) { free(path_prefix); } if (NULL != fd_link_path) { free(fd_link_path); } return rc; } /* this entire function gets called within a GPR compound command, * so the subscription actually doesn't get done until the orted * executes the compound command */ int orte_odls_bproc_subscribe_launch_data(orte_jobid_t job, orte_gpr_notify_cb_fn_t cbfunc) { char *segment; orte_gpr_value_t *values[1]; orte_gpr_subscription_t *subs, sub=ORTE_GPR_SUBSCRIPTION_EMPTY; orte_gpr_trigger_t *trigs, trig=ORTE_GPR_TRIGGER_EMPTY; char* keys[] = { ORTE_PROC_NAME_KEY, ORTE_PROC_APP_CONTEXT_KEY, ORTE_NODE_NAME_KEY, }; int num_keys = 3; int i, rc; /* get the job segment name */ if (ORTE_SUCCESS != (rc = orte_schema.get_job_segment_name(&segment, job))) { ORTE_ERROR_LOG(rc); return rc; } /* attach ourselves to the "standard" orted trigger */ if (ORTE_SUCCESS != (rc = orte_schema.get_std_trigger_name(&(trig.name), ORTED_LAUNCH_STAGE_GATE_TRIGGER, job))) { ORTE_ERROR_LOG(rc); free(segment); return rc; } /* ask for return of all data required for launching local processes */ subs = ⊂ sub.action = ORTE_GPR_NOTIFY_DELETE_AFTER_TRIG; if (ORTE_SUCCESS != (rc = orte_schema.get_std_subscription_name(&(sub.name), ORTED_LAUNCH_STG_SUB, job))) { ORTE_ERROR_LOG(rc); free(segment); free(trig.name); return rc; } sub.cnt = 1; sub.values = values; if (ORTE_SUCCESS != (rc = orte_gpr.create_value(&(values[0]), ORTE_GPR_KEYS_OR | ORTE_GPR_TOKENS_OR, segment, num_keys, 0))) { ORTE_ERROR_LOG(rc); free(segment); free(sub.name); free(trig.name); return rc; } for (i=0; i < num_keys; i++) { if (ORTE_SUCCESS != (rc = orte_gpr.create_keyval(&(values[0]->keyvals[i]), keys[i], ORTE_UNDEF, NULL))) { ORTE_ERROR_LOG(rc); free(segment); free(sub.name); free(trig.name); OBJ_RELEASE(values[0]); return rc; } } sub.cbfunc = cbfunc; trigs = &trig; /* do the subscription */ if (ORTE_SUCCESS != (rc = orte_gpr.subscribe(1, &subs, 1, &trigs))) { ORTE_ERROR_LOG(rc); } free(segment); free(sub.name); free(trig.name); OBJ_RELEASE(values[0]); return rc; } /** * Setup io for the current node, then tell orterun we are ready for the actual * processes. * @retval ORTE_SUCCESS * @retval error */ int orte_odls_bproc_launch_local_procs(orte_gpr_notify_data_t *data, char **base_environ) { odls_bproc_child_t *child; opal_list_item_t* item; orte_gpr_value_t *value, **values; orte_gpr_keyval_t *kval; char *node_name; int rc; orte_std_cntr_t i, j, kv, kv2, *sptr; int src = 0; orte_buffer_t *ack; bool connect_stdin; orte_jobid_t jobid; int cycle = 0; /* first, retrieve the job number we are to launch from the * returned data - we can extract the jobid directly from the * subscription name we created */ if (ORTE_SUCCESS != (rc = orte_schema.extract_jobid_from_std_trigger_name(&jobid, data->target))) { ORTE_ERROR_LOG(rc); return rc; } /** * hack for bproc4, change process group so that we do not receive signals * from the parent/front-end process, as bproc4 does not currently allow the * process to intercept the signal */ setpgid(0,0); /* loop through the returned data to find the global info and * the info for processes going onto this node */ values = (orte_gpr_value_t**)(data->values)->addr; for (j=0, i=0; i < data->cnt && j < (data->values)->size; j++) { /* loop through all returned values */ if (NULL != values[j]) { i++; value = values[j]; /* this must have come from one of the process containers, so it must * contain data for a proc structure - see if it belongs to this node */ for (kv=0; kv < value->cnt; kv++) { kval = value->keyvals[kv]; if (strcmp(kval->key, ORTE_NODE_NAME_KEY) == 0) { /* Most C-compilers will bark if we try to directly compare the string in the * kval data area against a regular string, so we need to "get" the data * so we can access it */ if (ORTE_SUCCESS != (rc = orte_dss.get((void**)&node_name, kval->value, ORTE_STRING))) { ORTE_ERROR_LOG(rc); return rc; } /* if this is our node...must also protect against a zero-length string */ if (NULL != node_name && 0 == strcmp(node_name, orte_system_info.nodename)) { /* ...harvest the info into a new child structure */ child = OBJ_NEW(odls_bproc_child_t); for (kv2 = 0; kv2 < value->cnt; kv2++) { kval = value->keyvals[kv2]; if(strcmp(kval->key, ORTE_PROC_NAME_KEY) == 0) { /* copy the name into the child object */ if (ORTE_SUCCESS != (rc = orte_dss.copy((void**)&(child->name), kval->value->data, ORTE_NAME))) { ORTE_ERROR_LOG(rc); return rc; } continue; } if(strcmp(kval->key, ORTE_PROC_APP_CONTEXT_KEY) == 0) { if (ORTE_SUCCESS != (rc = orte_dss.get((void**)&sptr, kval->value, ORTE_STD_CNTR))) { ORTE_ERROR_LOG(rc); return rc; } child->app_idx = *sptr; /* save the index into the app_context objects */ continue; } } /* kv2 */ /* protect operation on the global list of children */ OPAL_THREAD_LOCK(&mca_odls_bproc_component.mutex); opal_list_append(&mca_odls_bproc_component.children, &child->super); opal_condition_signal(&mca_odls_bproc_component.cond); OPAL_THREAD_UNLOCK(&mca_odls_bproc_component.mutex); } } } /* for kv */ } /* for j */ } /* set up the io files for our children */ for(item = opal_list_get_first(&mca_odls_bproc_component.children); item != opal_list_get_end(&mca_odls_bproc_component.children); item = opal_list_get_next(item)) { child = (odls_bproc_child_t *) item; if(0 < mca_odls_bproc_component.debug) { opal_output(0, "orte_odls_bproc_launch: setting up io for " "[%lu,%lu,%lu] proc rank %lu\n", ORTE_NAME_ARGS((child->name)), child->name->vpid); } /* only setup to forward stdin if it is rank 0, otherwise connect * to /dev/null */ if(0 == child->name->vpid) { connect_stdin = true; } else { connect_stdin = false; } rc = odls_bproc_setup_stdio(child->name, cycle, jobid, child->app_idx, connect_stdin); if (ORTE_SUCCESS != rc) { ORTE_ERROR_LOG(rc); goto cleanup; } cycle++; } /* message to indicate that we are ready */ ack = OBJ_NEW(orte_buffer_t); rc = orte_dss.pack(ack, &src, 1, ORTE_INT); if(ORTE_SUCCESS != rc) { ORTE_ERROR_LOG(rc); } rc = mca_oob_send_packed_nb(ORTE_PROC_MY_HNP, ack, ORTE_RML_TAG_BPROC, 0, odls_bproc_send_cb, NULL); if (0 > rc) { ORTE_ERROR_LOG(rc); goto cleanup; } rc = ORTE_SUCCESS; cleanup: return rc; } /** * Function to terminate a job. Since this component only runs on remote nodes * and doesn't actually launch any processes, this function is not needed * so is a noop. */ int orte_odls_bproc_kill_local_procs(orte_jobid_t job, bool set_state) { orte_iof.iof_flush(); return ORTE_SUCCESS; } /** * Function to signal a process. Since this component only runs on remote nodes * and doesn't actually launch any processes, this function is not needed * so is a noop. * @param proc the process's name * @param signal The signal to send * @retval ORTE_SUCCESS */ int orte_odls_bproc_signal_local_procs(const orte_process_name_t* proc, int32_t signal) { orte_iof.iof_flush(); return ORTE_SUCCESS; } /** * Finalizes the bproc module. Cleanup tmp directory/files * used for I/O forwarding. * @retval ORTE_SUCCESS */ int orte_odls_bproc_finalize(void) { orte_iof.iof_flush(); odls_bproc_remove_dir(); orte_session_dir_finalize(orte_process_info.my_name); return ORTE_SUCCESS; }