7ec19358df
an enumerator's mca_base_var_enum_sfv_fn_t can be NULL. cmr=v1.7.5:ticket=trac:4398:reviewer=ompi-gk1.7 This commit was SVN r31085. The following Trac tickets were found above: Ticket 4398 --> https://svn.open-mpi.org/trac/ompi/ticket/4398
170 строки
6.1 KiB
C
170 строки
6.1 KiB
C
/* -*- Mode: C; c-basic-offset:4 ; indent-tabs-mode:nil -*- */
|
|
/*
|
|
* Copyright (c) 2004-2007 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) 2008-2011 Cisco Systems, Inc. All rights reserved.
|
|
* Copyright (c) 2012-2013 Los Alamos National Security, LLC. All rights
|
|
* reserved.
|
|
* $COPYRIGHT$
|
|
*
|
|
* Additional copyrights may follow
|
|
*
|
|
* $HEADER$
|
|
*/
|
|
|
|
#if !defined(MCA_BASE_VAR_ENUM_H)
|
|
#define MCA_BASE_VAR_ENUM_H
|
|
|
|
#include "opal_config.h"
|
|
|
|
#include "opal/class/opal_object.h"
|
|
#include "opal/constants.h"
|
|
|
|
typedef struct mca_base_var_enum_t mca_base_var_enum_t;
|
|
|
|
/**
|
|
* Get the number of values in the enumerator
|
|
*
|
|
* @param[in] self the enumerator
|
|
* @param[out] count the number of values in the enumerator
|
|
*/
|
|
typedef int (*mca_base_var_enum_get_count_fn_t)(mca_base_var_enum_t *self, int *count);
|
|
|
|
/**
|
|
* Get the value and its string representation for an index 0..get_count()
|
|
*
|
|
* @param[in] self the enumerator
|
|
* @param[in] index the index to get the value of
|
|
* @param[out] value integer value
|
|
* @param[out] string_value string value
|
|
*/
|
|
typedef int (*mca_base_var_enum_get_value_fn_t)(mca_base_var_enum_t *self, int index,
|
|
int *value, const char **string_value);
|
|
|
|
/**
|
|
* Look up the integer value of a string
|
|
*
|
|
* @param[in] self the enumerator
|
|
* @param[in] string_value string to lookup
|
|
* @param[out] value integer value for the string
|
|
*
|
|
* @retval OPAL_SUCCESS if found
|
|
* @retval OPAL_ERR_VALUE_OUT_OF_BOUNDS if not
|
|
*/
|
|
typedef int (*mca_base_var_enum_vfs_fn_t)(mca_base_var_enum_t *self, const char *string_value,
|
|
int *value);
|
|
|
|
/**
|
|
* Dump a textual representation of all the values in an enumerator
|
|
*
|
|
* @param[in] self the enumerator
|
|
* @param[out] out the string representation
|
|
*
|
|
* @retval OPAL_SUCCESS on success
|
|
* @retval opal error on error
|
|
*/
|
|
typedef int (*mca_base_var_enum_dump_fn_t)(mca_base_var_enum_t *self, char **out);
|
|
|
|
/**
|
|
* Get the string representation for an enumerator value
|
|
*
|
|
* @param[in] self the enumerator
|
|
* @param[in] value integer value
|
|
* @param[out] string_value string value for value
|
|
*
|
|
* @retval OPAL_SUCCESS on success
|
|
* @retval OPAL_ERR_VALUE_OUT_OF_BOUNDS if not found
|
|
*
|
|
* @long This function returns the string value for a given interger value in the
|
|
* {string_value} parameter. The {string_value} parameter may be NULL in which case
|
|
* no string is returned.
|
|
*/
|
|
typedef int (*mca_base_var_enum_sfv_fn_t)(mca_base_var_enum_t *self, const int value,
|
|
const char **string_value);
|
|
|
|
/**
|
|
* The default enumerator class takes in a list of integer-string pairs. If a
|
|
* string is read from an environment variable or a file value the matching
|
|
* integer value is used for the MCA variable.
|
|
*/
|
|
struct mca_base_var_enum_value_t {
|
|
int value;
|
|
const char *string;
|
|
};
|
|
|
|
typedef struct mca_base_var_enum_value_t mca_base_var_enum_value_t;
|
|
|
|
/* enumerator base class */
|
|
struct mca_base_var_enum_t {
|
|
opal_object_t super;
|
|
|
|
/** Name of this enumerator. This value is duplicated from the argument provided to
|
|
mca_base_var_enum_create() */
|
|
char *enum_name;
|
|
|
|
/** Get the number of values this enumerator represents. Subclasses should override
|
|
the default function. */
|
|
mca_base_var_enum_get_count_fn_t get_count;
|
|
/** Get the value and string representation for a particular index. Subclasses should
|
|
override the default function */
|
|
mca_base_var_enum_get_value_fn_t get_value;
|
|
/** Given a string return corresponding integer value. If the string does not match a
|
|
valid value return OPAL_ERR_VALUE_OUT_OF_BOUNDS */
|
|
mca_base_var_enum_vfs_fn_t value_from_string;
|
|
/** Given an integer return the corresponding string value. If the integer does not
|
|
match a valid value return OPAL_ERR_VALUE_OUT_OF_BOUNDS */
|
|
mca_base_var_enum_sfv_fn_t string_from_value;
|
|
/** Dump a textual representation of the enumerator. The caller is responsible for
|
|
freeing the string */
|
|
mca_base_var_enum_dump_fn_t dump;
|
|
|
|
int enum_value_count;
|
|
/** Copy of the enumerators values (used by the default functions). This array and
|
|
and the strings it contains are freed by the destructor if not NULL. */
|
|
mca_base_var_enum_value_t *enum_values;
|
|
};
|
|
|
|
/**
|
|
* Object declaration for mca_base_var_enum_t
|
|
*/
|
|
OPAL_DECLSPEC OBJ_CLASS_DECLARATION(mca_base_var_enum_t);
|
|
|
|
/**
|
|
* Create a new default enumerator
|
|
*
|
|
* @param[in] name Name for this enumerator
|
|
* @param[in] values List of values terminated with a NULL .string
|
|
* member.
|
|
* @param[out] enumerator Newly created enumerator.
|
|
*
|
|
* @retval OPAL_SUCCESS On success
|
|
* @retval opal error code On error
|
|
*
|
|
* This function creates a value enumerator for integer variables. The
|
|
* value array is stored by reference in the enumerator so it should
|
|
* not be allocated on the stack. The OUT enumerator value will be a
|
|
* newly OBJ_NEW'ed object that should be released by the caller via
|
|
* OBJ_RELEASE.
|
|
*
|
|
* Note that the output enumerator can be OBJ_RELEASE'd after it has
|
|
* been used in a pvar registration, because variables that use the
|
|
* enumerator will OBJ_RETAIN it.
|
|
*
|
|
* Note that all the strings in the values[] array are strdup'ed into
|
|
* internal storage, meaning that the caller can free all of the
|
|
* strings passed in values[] after mca_base_var_enum_create()
|
|
* returns.
|
|
*/
|
|
OPAL_DECLSPEC int mca_base_var_enum_create (const char *name, const mca_base_var_enum_value_t values[],
|
|
mca_base_var_enum_t **enumerator);
|
|
|
|
#endif /* !defined(MCA_BASE_VAR_ENUM_H) */
|