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
|
/*
* Copyright (c) 2004-2005 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$
*
* Additional copyrights may follow
*
* $HEADER$
*/
#ifndef OPAL_UTIL_ERROR_H
#define OPAL_UTIL_ERROR_H
#include "opal_config.h"
BEGIN_C_DECLS
/**
* Prints error message for errnum on stderr
*
* Print the error message corresponding to the value of \c errnum and
* writes it, followed by a newline, to the standard error file
* descriptor. If the argument \c msg is non-NULL, this string is
* prepended to the message string and separated from it by a colon
* and a space. Otherwise, only the error message string is printed.
*
* If errnum is OPAL_ERR_IN_ERRNO, the system perror is called with
* the argument \c msg.
*/
OPAL_DECLSPEC void opal_perror(int errnum, const char *msg);
/**
* Return string for given error message
*
* Accepts an error number argument \c errnum and returns a pointer to
* the corresponding message string. The result is returned in a
* static buffer that should not be released with free().
*
* If errnum is \c OPAL_ERR_IN_ERRNO, the system strerror is called
* with an argument of the current value of \c errno and the resulting
* string is returned.
*
* If the errnum is not a known value, the returned value may be
* overwritten by subsequent calls to opal_strerror.
*/
OPAL_DECLSPEC const char *opal_strerror(int errnum);
/**
* Return string for given error message
*
* Similar to opal_strerror, but a buffer is passed in which is filled
* with a string (up to buflen - 1 characters long) containing the
* error message corresponding to \c errnum. Unlike opal_strerror(),
* if an unknown value for \c errnum is passed, the returned buffer
* will not be overwritten by subsequent calls to opal_strerror_r().
*/
OPAL_DECLSPEC int opal_strerror_r(int errnum, char *strerrbuf, size_t buflen);
typedef const char * (*opal_err2str_fn_t)(int errnum);
/**
* \internal
*
* Register a handler for converting errnums to error strings
*
* Handlers will be invoked by opal_perror() , opal_strerror(), and
* opal_strerror_r() to return the appropriate values.
*
* \note A maximum of 5 converters can be registered. The 6th
* converter registration attempt will return OPAL_ERR_OUT_OF_RESOURCE
*/
OPAL_DECLSPEC int opal_error_register(const char *project,
int err_base, int err_max,
opal_err2str_fn_t converter);
END_C_DECLS
#endif /* OPAL_UTIL_ERROR_H */
|
