mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2025-01-06 21:15:22 +00:00
5fa5cc37fe
In some cases we report a low level error message which does not have enough information to see what the problem is. To allow improving on this add an API which will prefix the error message with another error message string which can be used to describe where the error comes from. Signed-off-by: Peter Krempa <pkrempa@redhat.com> ACKed-by: Michal Privoznik <mprivozn@redhat.com>
212 lines
8.1 KiB
C
212 lines
8.1 KiB
C
/*
|
|
* virerror.h: error handling and reporting code for libvirt
|
|
*
|
|
* Copyright (C) 2006-2014 Red Hat, Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library. If not, see
|
|
* <http://www.gnu.org/licenses/>.
|
|
*
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "internal.h"
|
|
#include "virautoclean.h"
|
|
|
|
#define VIR_ERROR_MAX_LENGTH 1024
|
|
|
|
extern virErrorFunc virErrorHandler;
|
|
extern void *virUserData;
|
|
|
|
int virErrorInitialize(void);
|
|
void virRaiseErrorFull(const char *filename,
|
|
const char *funcname,
|
|
size_t linenr,
|
|
int domain,
|
|
int code,
|
|
virErrorLevel level,
|
|
const char *str1,
|
|
const char *str2,
|
|
const char *str3,
|
|
int int1,
|
|
int int2,
|
|
const char *fmt, ...)
|
|
ATTRIBUTE_FMT_PRINTF(12, 13);
|
|
|
|
void virRaiseErrorObject(const char *filename,
|
|
const char *funcname,
|
|
size_t linenr,
|
|
virErrorPtr err);
|
|
|
|
void virReportErrorHelper(int domcode, int errcode,
|
|
const char *filename,
|
|
const char *funcname,
|
|
size_t linenr,
|
|
const char *fmt, ...)
|
|
ATTRIBUTE_FMT_PRINTF(6, 7);
|
|
|
|
void virReportSystemErrorFull(int domcode,
|
|
int theerrno,
|
|
const char *filename,
|
|
const char *funcname,
|
|
size_t linenr,
|
|
const char *fmt, ...)
|
|
ATTRIBUTE_FMT_PRINTF(6, 7);
|
|
|
|
#define virReportSystemError(theerrno, fmt,...) \
|
|
virReportSystemErrorFull(VIR_FROM_THIS, \
|
|
(theerrno), \
|
|
__FILE__, __FUNCTION__, __LINE__, \
|
|
(fmt), __VA_ARGS__)
|
|
|
|
#define virReportInvalidNullArg(argname) \
|
|
virRaiseErrorFull(__FILE__, __FUNCTION__, __LINE__, \
|
|
VIR_FROM_THIS, \
|
|
VIR_ERR_INVALID_ARG, \
|
|
VIR_ERR_ERROR, \
|
|
__FUNCTION__, \
|
|
#argname, \
|
|
NULL, \
|
|
0, 0, \
|
|
_("%s in %s must be NULL"), \
|
|
#argname, __FUNCTION__)
|
|
#define virReportInvalidNonNullArg(argname) \
|
|
virRaiseErrorFull(__FILE__, __FUNCTION__, __LINE__, \
|
|
VIR_FROM_THIS, \
|
|
VIR_ERR_INVALID_ARG, \
|
|
VIR_ERR_ERROR, \
|
|
__FUNCTION__, \
|
|
#argname, \
|
|
NULL, \
|
|
0, 0, \
|
|
_("%s in %s must not be NULL"), \
|
|
#argname, __FUNCTION__)
|
|
#define virReportInvalidEmptyStringArg(argname) \
|
|
virRaiseErrorFull(__FILE__, __FUNCTION__, __LINE__, \
|
|
VIR_FROM_THIS, \
|
|
VIR_ERR_INVALID_ARG, \
|
|
VIR_ERR_ERROR, \
|
|
__FUNCTION__, \
|
|
#argname, \
|
|
NULL, \
|
|
0, 0, \
|
|
_("string %s in %s must not be empty"), \
|
|
#argname, __FUNCTION__)
|
|
#define virReportInvalidPositiveArg(argname) \
|
|
virRaiseErrorFull(__FILE__, __FUNCTION__, __LINE__, \
|
|
VIR_FROM_THIS, \
|
|
VIR_ERR_INVALID_ARG, \
|
|
VIR_ERR_ERROR, \
|
|
__FUNCTION__, \
|
|
#argname, \
|
|
NULL, \
|
|
0, 0, \
|
|
_("%s in %s must be greater than zero"), \
|
|
#argname, __FUNCTION__)
|
|
#define virReportInvalidNonZeroArg(argname) \
|
|
virRaiseErrorFull(__FILE__, __FUNCTION__, __LINE__, \
|
|
VIR_FROM_THIS, \
|
|
VIR_ERR_INVALID_ARG, \
|
|
VIR_ERR_ERROR, \
|
|
__FUNCTION__, \
|
|
#argname, \
|
|
NULL, \
|
|
0, 0, \
|
|
_("%s in %s must not be zero"), \
|
|
#argname, __FUNCTION__)
|
|
#define virReportInvalidZeroArg(argname) \
|
|
virRaiseErrorFull(__FILE__, __FUNCTION__, __LINE__, \
|
|
VIR_FROM_THIS, \
|
|
VIR_ERR_INVALID_ARG, \
|
|
VIR_ERR_ERROR, \
|
|
__FUNCTION__, \
|
|
#argname, \
|
|
NULL, \
|
|
0, 0, \
|
|
_("%s in %s must be zero"), \
|
|
#argname, __FUNCTION__)
|
|
#define virReportInvalidNonNegativeArg(argname) \
|
|
virRaiseErrorFull(__FILE__, __FUNCTION__, __LINE__, \
|
|
VIR_FROM_THIS, \
|
|
VIR_ERR_INVALID_ARG, \
|
|
VIR_ERR_ERROR, \
|
|
__FUNCTION__, \
|
|
#argname, \
|
|
NULL, \
|
|
0, 0, \
|
|
_("%s in %s must be zero or greater"), \
|
|
#argname, __FUNCTION__)
|
|
#define virReportInvalidArg(argname, fmt, ...) \
|
|
virRaiseErrorFull(__FILE__, __FUNCTION__, __LINE__, \
|
|
VIR_FROM_THIS, \
|
|
VIR_ERR_INVALID_ARG, \
|
|
VIR_ERR_ERROR, \
|
|
__FUNCTION__, \
|
|
#argname, \
|
|
NULL, \
|
|
0, 0, \
|
|
(fmt), __VA_ARGS__)
|
|
|
|
#define virReportUnsupportedError() \
|
|
virReportErrorHelper(VIR_FROM_THIS, VIR_ERR_NO_SUPPORT, \
|
|
__FILE__, __FUNCTION__, __LINE__, __FUNCTION__)
|
|
#define virReportRestrictedError(...) \
|
|
virReportErrorHelper(VIR_FROM_THIS, VIR_ERR_OPERATION_DENIED, \
|
|
__FILE__, __FUNCTION__, __LINE__, __VA_ARGS__)
|
|
/* The sizeof(...) comparison here is a hack to catch typos
|
|
* in the name of the enum by triggering a compile error, as well
|
|
* as detecting if you passed a typename that refers to a function
|
|
* or struct type, instead of an enum. It should get optimized away
|
|
* since sizeof() is known at compile time */
|
|
#define virReportEnumRangeError(typname, value) \
|
|
virReportErrorHelper(VIR_FROM_THIS, VIR_ERR_INTERNAL_ERROR, \
|
|
__FILE__, __FUNCTION__, __LINE__, \
|
|
"Unexpected enum value %d for %s", \
|
|
value, sizeof((typname)1) != 0 ? #typname : #typname);
|
|
|
|
void virReportOOMErrorFull(int domcode,
|
|
const char *filename,
|
|
const char *funcname,
|
|
size_t linenr);
|
|
|
|
#define virReportOOMError() \
|
|
virReportOOMErrorFull(VIR_FROM_THIS, __FILE__, __FUNCTION__, __LINE__)
|
|
|
|
#define virReportError(code, ...) \
|
|
virReportErrorHelper(VIR_FROM_THIS, code, __FILE__, \
|
|
__FUNCTION__, __LINE__, __VA_ARGS__)
|
|
|
|
#define virReportErrorObject(obj) \
|
|
virRaiseErrorObject(__FILE__, __FUNCTION__, __LINE__, obj)
|
|
|
|
int virSetError(virErrorPtr newerr);
|
|
virErrorPtr virErrorCopyNew(virErrorPtr err);
|
|
void virDispatchError(virConnectPtr conn);
|
|
const char *virStrerror(int theerrno, char *errBuf, size_t errBufLen);
|
|
|
|
typedef int (*virErrorLogPriorityFunc)(virErrorPtr, int);
|
|
void virSetErrorLogPriorityFunc(virErrorLogPriorityFunc func);
|
|
|
|
void virErrorSetErrnoFromLastError(void);
|
|
|
|
bool virLastErrorIsSystemErrno(int errnum);
|
|
|
|
void virErrorPreserveLast(virErrorPtr *saveerr);
|
|
void virErrorRestore(virErrorPtr *savederr);
|
|
|
|
void virLastErrorPrefixMessage(const char *fmt, ...)
|
|
ATTRIBUTE_FMT_PRINTF(1, 2);
|
|
|
|
VIR_DEFINE_AUTOPTR_FUNC(virError, virFreeError);
|