/* * Copyright (c) 2004-2005 The Trustees of Indiana University. * All rights reserved. * Copyright (c) 2004-2005 The Trustees of the University of Tennessee. * 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 * * Most of the description of the data layout is in the * coll_sm_module.c file. */ #include "ompi_config.h" #include "ompi/include/constants.h" #include "ompi/communicator/communicator.h" #include "ompi/mca/coll/coll.h" #include "opal/util/show_help.h" #include "coll_sm.h" /* * Public string showing the coll ompi_sm component version number */ const char *mca_coll_sm_component_version_string = "Open MPI sm collective MCA component version " OMPI_VERSION; /* * Local functions */ static int sm_open(void); static int sm_close(void); /* * Instantiate the public struct with all of our public information * and pointers to our public functions in it */ mca_coll_sm_component_t mca_coll_sm_component = { /* First, fill in the super (mca_coll_base_component_1_0_0_t) */ { /* First, the mca_component_t struct containing meta information about the component itself */ { /* Indicate that we are a coll v1.0.0 component (which also implies a specific MCA version) */ MCA_COLL_BASE_VERSION_1_0_0, /* Component name and version */ "sm", OMPI_MAJOR_VERSION, OMPI_MINOR_VERSION, OMPI_RELEASE_VERSION, /* Component open and close functions */ sm_open, sm_close, }, /* Next the MCA v1.0.0 component meta data */ { /* Whether the component is checkpointable or not */ true }, /* Initialization / querying functions */ mca_coll_sm_init_query, mca_coll_sm_comm_query, mca_coll_sm_comm_unquery, }, /* sm-component specifc information */ /* (default) priority */ /* JMS temporarily lowered until we can get more testing */ 0, /* (default) control size (bytes) */ 4096, /* (default) bootstrap filename */ "coll-sm-bootstrap", /* (default) number of segments in bootstrap file */ 8, /* (default) mpool name to use */ "sm", /* (default) number of "in use" flags for each communicator's area in the mpool */ 2, /* (default) number of segments for each communicator in the mpool area */ 8, /* (default) fragment size */ 8192, /* (default) degree of tree for tree-based operations (must be <= control unit size) */ 4, /* (default) number of processes in coll_sm_shared_mem_size information variable */ 4, /* default values for non-MCA parameters */ 0, /* bootstrap size -- filled in below */ 0, /* mpool data size -- filled in below */ NULL, /* data mpool pointer */ false, /* whether this process created the data mpool */ NULL, /* pointer to meta data about bootstrap area */ false, /* whether the component sm has been [lazily] inited or not */ false /* whether lazy init was successful or not */ /* the lock for lazy initialization is not initialized here -- there is no static initializer for opal_atomic_lock_t */ }; /* * Open the component */ static int sm_open(void) { size_t size1, size2; mca_base_component_t *c = &mca_coll_sm_component.super.collm_version; mca_coll_sm_component_t *cs = &mca_coll_sm_component; /* If we want to be selected (i.e., all procs on one node), then we should have a high priority */ mca_base_param_reg_int(c, "priority", "Priority of the sm coll component", false, false, cs->sm_priority, &cs->sm_priority); mca_base_param_reg_int(c, "control_size", "Length of the control data -- should usually be either the length of a cache line on most SMPs, or the size of a page on machines that support direct memory affinity page placement (in bytes)", false, false, cs->sm_control_size, &cs->sm_control_size); mca_base_param_reg_string(c, "bootstrap_filename", "Filename (in the Open MPI session directory) of the coll sm component bootstrap rendezvous mmap file", false, false, cs->sm_bootstrap_filename, &cs->sm_bootstrap_filename); mca_base_param_reg_int(c, "bootstrap_num_segments", "Number of segments in the bootstrap file", false, false, cs->sm_bootstrap_num_segments, &cs->sm_bootstrap_num_segments); mca_base_param_reg_int(c, "fragment_size", "Fragment size (in bytes) used for passing data through shared memory (will be rounded up to the nearest control_size size)", false, false, cs->sm_fragment_size, &cs->sm_fragment_size); if (0 != (cs->sm_fragment_size % cs->sm_control_size)) { cs->sm_fragment_size += cs->sm_control_size - (cs->sm_fragment_size % cs->sm_control_size); } mca_base_param_reg_string(c, "mpool", "Name of the mpool component to use", false, false, cs->sm_mpool_name, &cs->sm_mpool_name); mca_base_param_reg_int(c, "comm_in_use_flags", "Number of \"in use\" flags, used to mark a message passing area segment as currently being used or not (must be >= 2 and <= comm_num_segments)", false, false, cs->sm_comm_num_in_use_flags, &cs->sm_comm_num_in_use_flags); if (cs->sm_comm_num_in_use_flags < 2) { cs->sm_comm_num_in_use_flags = 2; } mca_base_param_reg_int(c, "comm_num_segments", "Number of segments in each communicator's shared memory message passing area (must be >= 2, and must be a multiple of comm_in_use_flags)", false, false, cs->sm_comm_num_segments, &cs->sm_comm_num_segments); if (cs->sm_comm_num_segments < cs->sm_comm_num_in_use_flags) { cs->sm_comm_num_segments = cs->sm_comm_num_in_use_flags; } if (0 != (cs->sm_comm_num_segments % cs->sm_comm_num_in_use_flags)) { cs->sm_comm_num_segments += cs->sm_comm_num_in_use_flags - (cs->sm_comm_num_segments % cs->sm_comm_num_in_use_flags); } cs->sm_segs_per_inuse_flag = cs->sm_comm_num_segments / cs->sm_comm_num_in_use_flags; mca_base_param_reg_int(c, "tree_degree", "Degree of the tree for tree-based operations (must be => 1 and <= min(control_size, 255))", false, false, cs->sm_tree_degree, &cs->sm_tree_degree); if (cs->sm_tree_degree > cs->sm_control_size) { opal_show_help("help-coll-sm.txt", "tree-degree-larger-than-control", true, cs->sm_tree_degree, cs->sm_control_size); cs->sm_tree_degree = cs->sm_control_size; } if (cs->sm_tree_degree > 255) { opal_show_help("help-coll-sm.txt", "tree-degree-larger-than-255", true, cs->sm_tree_degree); cs->sm_tree_degree = 255; } /* Size of the bootstrap shared memory area. */ size1 = sizeof(mca_coll_sm_bootstrap_header_extension_t) + (mca_coll_sm_component.sm_bootstrap_num_segments * sizeof(mca_coll_sm_bootstrap_comm_setup_t)) + (sizeof(uint32_t) * mca_coll_sm_component.sm_bootstrap_num_segments); mca_base_param_reg_int(c, "shared_mem_used_bootstrap", "Amount of shared memory used in the shared memory bootstrap area (in bytes)", false, true, size1, NULL); /* Calculate how much space we need in the data mpool. This formula taken directly from coll_sm_module.c. */ mca_base_param_reg_int(c, "info_num_procs", "Number of processes to use for the calculation of the shared_mem_size MCA information parameter (must be => 2)", false, false, cs->sm_info_comm_size, &cs->sm_info_comm_size); size2 = 4 * cs->sm_control_size + (cs->sm_comm_num_in_use_flags * cs->sm_control_size) + (cs->sm_comm_num_segments * (cs->sm_info_comm_size * cs->sm_control_size * 2)) + (cs->sm_comm_num_segments * (cs->sm_info_comm_size * cs->sm_fragment_size)); mca_base_param_reg_int(c, "shared_mem_used_data", "Amount of shared memory used in the shared memory data area for info_num_procs processes (in bytes)", false, true, size2, NULL); return OMPI_SUCCESS; } /* * Close the component */ static int sm_close(void) { if (NULL != mca_coll_sm_component.sm_mpool_name) { free(mca_coll_sm_component.sm_mpool_name); mca_coll_sm_component.sm_mpool_name = NULL; } mca_coll_sm_bootstrap_finalize(); return OMPI_SUCCESS; }