1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
/*
* Copyright (c) 2004-2007 The Trustees of Indiana University and Indiana
* University Research and Technology
* Corporation. All rights reserved.
* Copyright (c) 2004-2020 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) 2015 Research Organization for Information Science
* and Technology (RIST). All rights reserved.
* Copyright (c) 2022 Triad National Security, LLC. All rights
* reserved.
* $COPYRIGHT$
*
* Additional copyrights may follow
*
* $HEADER$
*/
#include "ompi_config.h"
#include "ompi/mpi/c/bindings.h"
#include "ompi/runtime/params.h"
#include "ompi/communicator/communicator.h"
#include "ompi/errhandler/errhandler.h"
#include "ompi/info/info.h"
#include "opal/util/string_copy.h"
#include <string.h>
#if OMPI_BUILD_MPI_PROFILING
#if OPAL_HAVE_WEAK_SYMBOLS
#pragma weak MPI_Info_get_nthkey = PMPI_Info_get_nthkey
#endif
#define MPI_Info_get_nthkey PMPI_Info_get_nthkey
#endif
static const char FUNC_NAME[] = "MPI_Info_get_nthkey";
/**
* MPI_Info_get_nthkey - Get a key indexed by integer from an 'MPI_Info' obje
*
* @param info info object (handle)
* @param n index of key to retrieve (integer)
* @param key character string of at least 'MPI_MAX_INFO_KEY' characters
*
* @retval MPI_SUCCESS
* @retval MPI_ERR_ARG
* @retval MPI_ERR_INFO
* @retval MPI_ERR_INFO_KEY
*/
int MPI_Info_get_nthkey(MPI_Info info, int n, char *key)
{
int nkeys;
int err;
/*
* 1. Check if info is a valid handle
* 2. Check if there are at least (n+1) elements
* 3. If so, give the nth defined key
*/
if (NULL == info || MPI_INFO_NULL == info) {
return OMPI_ERRHANDLER_NOHANDLE_INVOKE(MPI_ERR_INFO, FUNC_NAME);
}
if (MPI_PARAM_CHECK) {
if (ompi_info_is_freed(info)) {
return OMPI_ERRHANDLER_NOHANDLE_INVOKE(MPI_ERR_INFO, FUNC_NAME);
}
if (0 > n) {
return OMPI_ERRHANDLER_NOHANDLE_INVOKE(MPI_ERR_ARG, FUNC_NAME);
}
if (NULL == key) {
return OMPI_ERRHANDLER_NOHANDLE_INVOKE(MPI_ERR_INFO_KEY, FUNC_NAME);
}
}
/* Keys are indexed on 0, which makes the "n" parameter offset by
1 from the value returned by get_nkeys(). So be sure to
compare appropriately. */
err = ompi_info_get_nkeys(info, &nkeys);
OMPI_ERRHANDLER_NOHANDLE_CHECK(err, err, FUNC_NAME);
if (n > (nkeys - 1)) {
return OMPI_ERRHANDLER_NOHANDLE_INVOKE (MPI_ERR_INFO_KEY, FUNC_NAME);
}
/* Everything seems alright. Call the back end key copy */
opal_cstring_t *key_str = NULL;
err = ompi_info_get_nthkey (info, n, &key_str);
if (NULL != key_str) {
opal_string_copy(key, key_str->string, MPI_MAX_INFO_KEY);
OBJ_RELEASE(key_str);
}
OMPI_ERRHANDLER_NOHANDLE_RETURN(err, err, FUNC_NAME);
}
|
