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
/*
* 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 (c) 2016-2020 Intel, Inc. All rights reserved.
* Copyright (c) 2021-2022 Nanook Consulting. All rights reserved.
* $COPYRIGHT$
*
* Additional copyrights may follow
*
* $HEADER$
*/
/** @file */
#ifndef PMIX_UTIL_KEYVAL_PARSE_H
#define PMIX_UTIL_KEYVAL_PARSE_H
#include "src/include/pmix_config.h"
BEGIN_C_DECLS
PMIX_EXPORT extern int pmix_util_keyval_parse_lineno;
/**
* Callback triggered for each key = value pair
*
* Callback triggered from pmix_util_keyval_parse for each key = value
* pair. Both key and value will be pointers into static buffers.
* The buffers must not be free()ed and contents may be overwritten
* immediately after the callback returns.
*/
typedef void (*pmix_keyval_parse_fn_t)(const char *file, int lineno,
const char *name,
const char *value);
/**
* Parse \c filename, made up of key = value pairs.
*
* Parse \c filename, made up of key = value pairs. For each line
* that appears to contain a key = value pair, \c callback will be
* called exactly once. In a multithreaded context, calls to
* pmix_util_keyval_parse() will serialize multiple calls.
*/
PMIX_EXPORT int pmix_util_keyval_parse(const char *filename, pmix_keyval_parse_fn_t callback);
PMIX_EXPORT int pmix_util_keyval_parse_init(void);
PMIX_EXPORT void pmix_util_keyval_parse_finalize(void);
PMIX_EXPORT int pmix_util_keyval_save_internal_envars(pmix_keyval_parse_fn_t callback);
END_C_DECLS
#endif