1
1
openmpi/opal/util/path.h
Josh Hursey 0404444dbe * Added 2 new MCA parameters
- mca_base_param_file_prefix
     (Default: NULL)
     This is the fullname of the "-am" mpirun option. Used to specify a ':'
     separated list of AMCA parameter set files.
  - mca_base_param_file_path
     (Default: $SYSCONFDIR/amca-param-sets/:$CWD)
     The path to search for AMCA files with relative paths. A warning will be
     printed if the AMCA file cannot be found.

* Added a new function "mca_base_param_recache_files" the re-reads the file
configurations. This is used internally to help bootstrap the MCA system.

* Added a new orterun/mpirun command line option '-am' that aliases for the
mca_base_param_file_prefix MCA parameter

* Exposed the opal_path_access function as it is generally useful in other
places in the code.

* New function "opal_cmd_line_make_opt_mca" which will allow you to append a
new command line option with MCA parameter identifiers to set at the same
time. Previously this could only be done at command line declaration time.

* Added a new directory under the $pkgdatadir named "amca-param-sets" where all
the 'shipped with' Open MPI AMCA parameter sets are placed. This is the first
place to search for AMCA sets with relative paths.

* An example.conf AMCA parameter set file is located in
contrib/amca-param-sets/.

* Jeff Squyres contributed an OpenIB AMCA set for benchmarking.

Note: You will need to autogen with this commit as it adds a configure param.
  Sorry :(

This commit was SVN r13867.
2007-03-01 13:39:20 +00:00

103 строки
3.5 KiB
C

/*
* 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
*/
#ifndef OPAL_PATH_H
#define OPAL_PATH_H
#include "opal_config.h"
#if defined(c_plusplus) || defined(__cplusplus)
extern "C" {
#endif
/**
* Locates a file with certain permissions
*
* @param fname File name
* @param pathv Array of search directories
* @param mode Permissions which must be satisfied (see access(2))
* @param envv Pointer to string containing environment
*
* @retval Full pathname of located file Success
* @retval NULL Failure
*
* Environment variables can appear in the form $variable at the
* start of a prefix path and will be replaced by the environment
* value if it is defined; otherwise the whole prefix is ignored.
* Environment variables must be followed by a path delimiter or
* end-of-string.
*
* The caller is responsible for freeing the returned string.
*/
OPAL_DECLSPEC char *opal_path_find(char *fname, char **pathv, int mode,
char **envv);
/**
* Locates a file with certain permissions from a list of search
* paths
*
* @param fname File name
* @param mode Target permissions which must be satisfied (see access(2))
* @param envv Pointer to environment list
* @param wrkdir Working directory
*
* @retval Full pathname of located file Success
* @retval NULL Failure
*
* Locates a file with certain permissions from the list of paths
* given by the $PATH environment variable. Replaces "." in the
* path with the working dir.
*
* The caller is responsible for freeing the returned string.
*/
OPAL_DECLSPEC char *opal_path_findv(char *fname, int mode,
char **envv, char *wrkdir);
/**
* Detect if the requested path is absolute or relative.
*
* @param path File name
*
* @retval true if the path is absolute
* @retval false otherwise
*
* Detect if a path is absolute or relative. Handle Windows
* with special care as an absolute path on Windows starts
* with [A-Za-z]: instead of the usual / on UNIX.
*/
OPAL_DECLSPEC bool opal_path_is_absolute( const char *path );
/**
* Forms a complete pathname and checks it for existance and
* permissions
*
* @param fname File name
* @param path Path prefix, if NULL then fname is an absolute path
* @param mode Target permissions which must be satisfied (see access(2))
*
* @retval NULL Failure
* @retval Full pathname of the located file on Success
*/
OPAL_DECLSPEC char *opal_path_access(char *fname, char *path, int mode);
#if defined(c_plusplus) || defined(__cplusplus)
}
#endif
#endif /* OPAL_PATH_H */