*
* elog.h
* openGauss error reporting/logging definitions.
*
*
* Portions Copyright (c) 1996-2012, PostgreSQL Global Development Group
* Portions Copyright (c) 1994, Regents of the University of California
*
* src/include/utils/elog.h
*
* -------------------------------------------------------------------------
*/
#ifndef ELOG_H
#define ELOG_H
#include <setjmp.h>
#ifdef __GNUC__
#include <cxxabi.h>
#endif
#include "c.h"
#include "gs_threadlocal.h"
#include "gstrace/gstrace_infra.h"
#include "utils/be_module.h"
#include "utils/syscall_lock.h"
#include "securec.h"
#include "securec_check.h"
#include "nodes/pg_list.h"
#define DEBUG5 \
10
* decreasing detail. */
#define DEBUG4 11
#define DEBUG3 12
#define DEBUG2 13
#define DEBUG1 14
#define LOG \
15
* server log by default. */
#define COMMERROR \
16
* for server reporting, but never sent to \
* client. */
#define INFO \
17
* VACUUM VERBOSE output); always sent to \
* client regardless of client_min_messages, \
* but by default not sent to server log. */
#define NOTICE \
18
* operation; sent to client and server log by \
* default. */
#define WARNING \
19
* like implicit sequence creation by SERIAL. \
* WARNING is for unexpected messages. */
#define ERROR \
20
* known state */
#define VERBOSEMESSAGE \
9
* for DNs means to send info back to CN */
* modify it. We have to use a constant rather than ERROR because macros
* are expanded only when referenced outside macros.
*/
#ifdef WIN32
#define PGERROR 20
#endif
#define FATAL 21
#define PANIC 22
#define CUSTOM_ERRCODE_P1 96
#define PGSIXBIT(ch) (((ch) - '0') & 0x3F)
#define PGUNSIXBIT(val) (((val)&0x3F) + '0')
#define MAKE_SQLSTATE(ch1, ch2, ch3, ch4, ch5) \
(PGSIXBIT(ch1) + (PGSIXBIT(ch2) << 6) + (PGSIXBIT(ch3) << 12) + (PGSIXBIT(ch4) << 18) + (PGSIXBIT(ch5) << 24))
#define ERRCODE_TO_CATEGORY(ec) ((ec) & ((1 << 12) - 1))
#define ERRCODE_IS_CATEGORY(ec) (((ec) & ~((1 << 12) - 1)) == 0)
#define MYSQL_ERRNO_MAX 65535
#include "utils/errcodes.h"
#ifdef HAVE_FUNCNAME__FUNC
#define PG_FUNCNAME_MACRO __func__
#else
#ifdef HAVE_FUNCNAME__FUNCTION
#define PG_FUNCNAME_MACRO __FUNCTION__
#else
#define PG_FUNCNAME_MACRO NULL
#endif
#endif
* New-style error reporting API: to be used in this way:
* ereport(ERROR,
* (errcode(ERRCODE_UNDEFINED_CURSOR),
* errmsg("portal \"%s\" not found", stmt->portalname),
* ... other errxxx() fields as needed ...));
*
* The error level is required, and so is a primary error message (errmsg
* or errmsg_internal). All else is optional. errcode() defaults to
* ERRCODE_INTERNAL_ERROR if elevel is ERROR or more, ERRCODE_WARNING
* if elevel is WARNING, or ERRCODE_SUCCESSFUL_COMPLETION if elevel is
* NOTICE or below.
*
* ereport_domain() allows a message domain to be specified, for modules that
* wish to use a different message catalog from the backend's. To avoid having
* one copy of the default text domain per .o file, we define it as NULL here
* and have errstart insert the default text domain. Modules can either use
* ereport_domain() directly, or preferably they can override the TEXTDOMAIN
* macro.
* ----------
*/
#define ereport_domain(elevel, domain, rest) \
(errstart(elevel, __FILE__, __LINE__, PG_FUNCNAME_MACRO, domain) ? (errfinish rest) : (void)0)
extern THR_LOCAL int log_min_messages;
extern THR_LOCAL int client_min_messages;
#ifdef PC_LINT
#define ereport(elevel, rest) \
do { \
if (elevel >= ERROR) \
exit((int)(rest)); \
} while (0)
#else
#define ereport(elevel, rest) \
(((elevel) > DEBUG1 || (elevel) < DEBUG5 || log_min_messages <= (elevel) || client_min_messages <= (elevel)) ? \
ereport_domain(elevel, TEXTDOMAIN, rest) : (void)0)
#endif
#undef TEXTDOMAIN
#define TEXTDOMAIN NULL
extern bool errstart(int elevel, const char* filename, int lineno, const char* funcname, const char* domain);
extern void errfinish(int dummy, ...);
#ifdef PC_LINT
#define errcode(sqlerrcode) (1 == (int)(sqlerrcode))
#else
#if !defined(WIN32)
extern int errcode(int sqlerrcode);
#endif
#endif
extern int errcode_for_file_access(void);
extern int errcode_for_socket_access(void);
extern int errmodule(ModuleId id);
extern const char* mask_encrypted_key(const char* query_string, int str_len);
extern char* maskPassword(const char* query_string);
extern char* mask_error_password(const char* query_string, int str_len);
#define MASK_PASSWORD_START(mask_string, query_string) \
do { \
mask_string = maskPassword(query_string); \
if (NULL == mask_string) \
mask_string = (char*)query_string; \
} while (0)
#define MASK_PASSWORD_END(mask_string, query_string) \
do { \
if (mask_string != query_string) \
selfpfree(mask_string); \
} while (0)
extern int errmsg(const char* fmt, ...)
the supplied arguments. */
__attribute__((format(PG_PRINTF_ATTRIBUTE, 1, 2)));
extern int errmsg_internal(const char* fmt, ...)
the supplied arguments. */
__attribute__((format(PG_PRINTF_ATTRIBUTE, 1, 2)));
extern int errmsg_plural(const char* fmt_singular, const char* fmt_plural, unsigned long n, ...)
the supplied arguments. */
__attribute__((format(PG_PRINTF_ATTRIBUTE, 1, 4))) __attribute__((format(PG_PRINTF_ATTRIBUTE, 2, 4)));
extern int errdetail(const char* fmt, ...)
the supplied arguments. */
__attribute__((format(PG_PRINTF_ATTRIBUTE, 1, 2)));
extern int errdetail_internal(const char* fmt, ...)
the supplied arguments. */
__attribute__((format(PG_PRINTF_ATTRIBUTE, 1, 2)));
extern int errdetail_log(const char* fmt, ...)
the supplied arguments. */
__attribute__((format(PG_PRINTF_ATTRIBUTE, 1, 2)));
extern int errdetail_plural(const char* fmt_singular, const char* fmt_plural, unsigned long n, ...)
the supplied arguments. */
__attribute__((format(PG_PRINTF_ATTRIBUTE, 1, 4))) __attribute__((format(PG_PRINTF_ATTRIBUTE, 2, 4)));
extern int errhint(const char* fmt, ...)
the supplied arguments. */
__attribute__((format(PG_PRINTF_ATTRIBUTE, 1, 2)));
extern int errcause(const char* fmt, ...)
* the supplied arguments. */
__attribute__((format(printf, 1, 2)));
extern int erraction(const char* fmt, ...)
* * the supplied arguments. */
__attribute__((format(printf, 1, 2)));
extern int errquery(const char* fmt, ...)
the supplied arguments. */
__attribute__((format(PG_PRINTF_ATTRIBUTE, 1, 2)));
extern int errcontext(const char* fmt, ...)
the supplied arguments. */
__attribute__((format(PG_PRINTF_ATTRIBUTE, 1, 2)));
extern int errhidestmt(bool hide_stmt);
extern int errhideprefix(bool hide_prefix);
extern int errposition(int cursorpos);
extern int internalerrposition(int cursorpos);
extern int internalerrquery(const char* query);
extern int ErrOutToClient(bool outToClient);
extern int geterrcode(void);
extern int geterrposition(void);
extern int getinternalerrposition(void);
extern const char* translate_errno(int errcode);
extern int signal_is_warnings_throw(bool is_warning_throw);
extern int signal_returnd_sqlstate(const char *returnd_sqlstate);
extern int signal_class_origin(const char *class_origin);
extern int signal_subclass_origin(const char *subclass_origin);
extern int signal_constraint_catalog(const char *constraint_catalog);
extern int signal_constraint_schema(const char *constraint_schema);
extern int signal_constraint_name(const char *constraint_name);
extern int signal_catalog_name(const char *catalog_name);
extern int signal_schema_name(const char *schema_name);
extern int signal_table_name(const char *table_name);
extern int signal_column_name(const char *column_name);
extern int signal_cursor_name(const char *cursor_name);
extern int signal_mysql_errno(const char *mysql_errno);
extern int signal_is_signal(int is_signal);
extern void save_error_message(void);
extern int handle_in_client(bool handle);
extern int ignore_interrupt(bool ignore);
extern int onlyfrontmsg(bool onlyfront);
* Old-style error reporting API: to be used in this way:
* elog(ERROR, "portal \"%s\" not found", stmt->portalname);
* ----------
*/
#ifdef PC_LINT
#define elog(level, ...) \
do { \
if (level >= ERROR) \
exit(0); \
} while (0)
#else
#define elog elog_start(__FILE__, __LINE__, PG_FUNCNAME_MACRO), elog_finish
#endif
extern void elog_start(const char* filename, int lineno, const char* funcname);
extern void elog_finish(int elevel, const char* fmt, ...)
the supplied arguments. */
__attribute__((format(PG_PRINTF_ATTRIBUTE, 2, 3)));
extern void pre_format_elog_string(int errnumber, const char* domain);
extern char* format_elog_string(const char* fmt, ...)
the supplied arguments. */
__attribute__((format(PG_PRINTF_ATTRIBUTE, 1, 2)));
typedef struct ErrorContextCallback {
struct ErrorContextCallback* previous;
void (*callback)(void* arg);
void* arg;
} ErrorContextCallback;
typedef struct FormatCallStack {
struct FormatCallStack* prev;
void* elem;
} FormatCallStack;
#ifndef FRONTEND
#define securec_check(errno, charList, ...) \
{ \
if (unlikely(EOK != errno)) { \
freeSecurityFuncSpace(charList, ##__VA_ARGS__); \
switch (errno) { \
case EINVAL: \
elog(ERROR, \
"%s : %d : The destination buffer is NULL or not terminated. The second case only occures in " \
"function strcat_s/strncat_s.", \
__FILE__, \
__LINE__); \
break; \
case EINVAL_AND_RESET: \
elog(ERROR, "%s : %d : The Source Buffer is NULL.", __FILE__, __LINE__); \
break; \
case ERANGE: \
elog(ERROR, \
"%s : %d : The parameter destMax is equal to zero or larger than the macro : " \
"SECUREC_STRING_MAX_LEN.", \
__FILE__, \
__LINE__); \
break; \
case ERANGE_AND_RESET: \
elog(ERROR, \
"%s : %d : The parameter destMax is too small or parameter count is larger than macro " \
"parameter SECUREC_STRING_MAX_LEN. The second case only occures in functions " \
"strncat_s/strncpy_s.", \
__FILE__, \
__LINE__); \
break; \
case EOVERLAP_AND_RESET: \
elog(ERROR, \
"%s : %d : The destination buffer and source buffer are overlapped.", \
__FILE__, \
__LINE__); \
break; \
default: \
elog(ERROR, "%s : %d : Unrecognized return type.", __FILE__, __LINE__); \
break; \
} \
} \
}
#else
#define securec_check(errno, charList, ...) \
{ \
if (unlikely(errno == -1)) { \
freeSecurityFuncSpace_c(static_cast<char*>(charList), ##__VA_ARGS__); \
printf("ERROR at %s : %d : The destination buffer or format is a NULL pointer or the invalid parameter " \
"handle is invoked..\n", \
__FILE__, \
__LINE__); \
exit(1); \
} \
}
#endif
#define securec_check_ss(errno, charList, ...) \
{ \
if (unlikely(errno == -1)) { \
freeSecurityFuncSpace(static_cast<char*>(charList), ##__VA_ARGS__); \
elog(ERROR, \
"%s : %d : The destination buffer or format is a NULL pointer or the invalid parameter handle is " \
"invoked.", \
__FILE__, \
__LINE__); \
} \
}
* API for catching ereport(ERROR) exits. Use these macros like so:
*
* PG_TRY();
* {
* ... code that might throw ereport(ERROR) ...
* }
* PG_CATCH();
* {
* ... error recovery code ...
* }
* PG_END_TRY();
*
* (The braces are not actually necessary, but are recommended so that
* pg_indent will indent the construct nicely.) The error recovery code
* can optionally do PG_RE_THROW() to propagate the same error outwards.
*
* Note: while the system will correctly propagate any new ereport(ERROR)
* occurring in the recovery section, there is a small limit on the number
* of levels this will work for. It's best to keep the error recovery
* section simple enough that it can't generate any new errors, at least
* not before popping the error stack.
*
* Note: an ereport(FATAL) will not be caught by this construct; control will
* exit straight through proc_exit(). Therefore, do NOT put any cleanup
* of non-process-local resources into the error recovery section, at least
* not without taking thought for what will happen during ereport(FATAL).
* The PG_ENSURE_ERROR_CLEANUP macros provided by storage/ipc.h may be
* helpful in such cases.
*
* Note: Don't execute statements such as break, continue, goto, or return in
* PG_TRY. If you need to use these statements, you must recovery
* PG_exception_stack first.
* ----------
*/
#define PG_TRY() \
do { \
sigjmp_buf* save_exception_stack = t_thrd.log_cxt.PG_exception_stack; \
ErrorContextCallback* save_context_stack = t_thrd.log_cxt.error_context_stack; \
sigjmp_buf local_sigjmp_buf; \
int tryCounter, *oldTryCounter = NULL; \
if (sigsetjmp(local_sigjmp_buf, 0) == 0) { \
t_thrd.log_cxt.PG_exception_stack = &local_sigjmp_buf; \
oldTryCounter = gstrace_tryblock_entry(&tryCounter)
#define PG_CATCH() \
} \
else \
{ \
t_thrd.log_cxt.PG_exception_stack = save_exception_stack; \
t_thrd.log_cxt.error_context_stack = save_context_stack; \
gstrace_tryblock_exit(true, oldTryCounter)
#define PG_END_TRY() \
} \
t_thrd.log_cxt.PG_exception_stack = save_exception_stack; \
t_thrd.log_cxt.error_context_stack = save_context_stack; \
gstrace_tryblock_exit(false, oldTryCounter); \
} \
while (0)
#define PG_TRY_RETURN(ret) \
t_thrd.log_cxt.PG_exception_stack = save_exception_stack; \
t_thrd.log_cxt.error_context_stack = save_context_stack; \
gstrace_tryblock_exit(false, oldTryCounter); \
return ret;
#ifndef ENABLE_LITE_MODE
#define ADIO_RUN() if (g_instance.attr.attr_storage.enable_adio_function) {
#else
#define ADIO_RUN() if (false) {
#endif
#define ADIO_ELSE() \
} \
else \
{
#define ADIO_END() }
#define BFIO_RUN() if (!g_instance.attr.attr_storage.enable_adio_function) {
#define BFIO_ELSE() \
} \
else \
{
#define BFIO_END() }
#define ADIO_LOG_DB(A) \
do { \
if (u_sess->attr.attr_storage.enable_adio_debug) { \
A; \
} \
} while (0)
* gcc understands __attribute__((noreturn)); for other compilers, insert
* a useless exit() call so that the compiler gets the point.
*/
#ifdef __GNUC__
#define PG_RE_THROW() pg_re_throw()
#else
#define PG_RE_THROW() (pg_re_throw(), exit(1))
#endif
* ErrorData holds the data accumulated during any one ereport() cycle.
* Any non-NULL pointers must point to palloc'd data.
* (The const pointers are an exception; we assume they point at non-freeable
* constant strings.)
*/
typedef struct ErrorData {
int elevel;
bool output_to_server;
bool output_to_client;
bool handle_in_client;
bool show_funcname;
bool hide_stmt;
bool hide_prefix;
char* filename;
int lineno;
char* funcname;
const char* domain;
int sqlerrcode;
ModuleId mod_id;
char* message;
char* detail;
char* detail_log;
char* hint;
char* context;
int cursorpos;
int internalpos;
char* internalquery;
int saved_errno;
char* backtrace_log;
int internalerrcode;
bool verbose;
bool ignore_interrupt;
char* cause;
char* action;
char* sqlstate;
char* class_origin;
char* subclass_origin;
char* cons_catalog;
char* cons_schema;
char* cons_name;
char* catalog_name;
char* schema_name;
char* table_name;
char* column_name;
char* cursor_name;
char* mysql_errno;
bool is_warnings_throw;
int is_signal;
bool onlyfrontmsg;
} ErrorData;
typedef struct RemoteErrorData {
int internalerrcode;
char* errorfuncname;
char* filename;
int lineno;
ModuleId mod_id;
} RemoteErrorData;
extern int combiner_errdata(RemoteErrorData* pErrData);
extern char *Geterrmsg(void);
extern void EmitErrorReport(void);
extern void stream_send_message_to_server_log(void);
extern void stream_send_message_to_consumer(void);
extern ErrorData* CopyErrorData(void);
extern void UpdateErrorData(ErrorData* edata, ErrorData* newData);
extern void FreeErrorData(ErrorData* edata);
extern void FlushErrorState(void);
extern void FlushErrorStateWithoutDeleteChildrenContext(void);
extern void ReThrowError(ErrorData* edata);
extern void pg_re_throw(void) __attribute__((noreturn));
extern void PgRethrowAsFatal(void);
extern char* pg_strdup(const char* in);
extern void send_message_to_frontend(ErrorData* edata);
enum enum_dolphin_error_level { B_NOTE, B_WARNING, B_ERROR, B_END };
typedef struct ErrorDataArea {
List *sqlErrorDataList;
uint64 current_edata_count;
uint64 *current_edata_count_by_level;
} ErrorDataArea;
typedef struct {
enum_dolphin_error_level elevel;
char *sqlstatestr;
char *class_origin;
char *subclass_origin;
char *constraint_catalog;
char *constraint_schema;
char *constraint_name;
char *catalog_name;
char *schema_name;
char *table_name;
char *column_name;
char *cursor_name;
char *errorcode;
char *message_text;
} DolphinErrorData;
extern enum_dolphin_error_level errorLevelToDolphin(int elevel);
extern ErrorDataArea *initErrorDataArea();
extern void resetErrorDataArea(bool, bool);
extern void pushErrorData(ErrorData *);
extern void copyErrorDataArea(ErrorDataArea *from, ErrorDataArea *to);
extern uint64 SqlErrorDataErrorCount();
extern uint64 SqlErrorDataWarnCount();
extern int SqlErrorDataCount();
extern int getUserVarVal(char* str);
typedef enum {
PGERROR_TERSE,
PGERROR_DEFAULT,
PGERROR_VERBOSE
} PGErrorVerbosity;
#define LOG_DESTINATION_STDERR 1
#define LOG_DESTINATION_SYSLOG 2
#define LOG_DESTINATION_EVENTLOG 4
#define LOG_DESTINATION_CSVLOG 8
#define LOG_DESTINATION_QUERYLOG 16
#define LOG_DESTINATION_ASPLOG 32
extern void DebugFileOpen(void);
extern const char* unpack_sql_state(int sql_state);
extern const char *plpgsql_get_sqlstate(int sqlcode);
extern bool in_error_recursion_trouble(void);
#ifdef HAVE_SYSLOG
extern void set_syslog_parameters(const char* ident, int facility);
#endif
#ifndef WIN32
* @Description: according to module logging rules,
* check this module logging is enable or disable.
* @IN elevel: error level
* @IN mod_id: module id
* @Return: true, enable server log to write; false, disable server logging.
* @See also: send_message_to_server_log()
*/
extern inline bool is_errmodule_enable(int elevel, ModuleId mod_id)
{
return (elevel >= LOG || module_logging_is_on(mod_id));
}
extern inline int defence_errlevel(void)
{
#ifdef USE_ASSERT_CHECKING
return PANIC;
#else
return ERROR;
#endif
}
#endif
* Write errors to stderr (or by equal means when stderr is
* not available). Used before ereport/elog can be used
* safely (memory context, GUC load etc)
*/
extern void write_stderr(const char* fmt, ...)
the supplied arguments. */
__attribute__((format(PG_PRINTF_ATTRIBUTE, 1, 2)));
extern void write_stderr_with_prefix(const char* fmt, ...)
the supplied arguments. */
__attribute__((format(PG_PRINTF_ATTRIBUTE, 1, 2)));
extern void getElevelAndSqlstate(int* eLevel, int* sqlState);
extern void get_time_now(char* nowTime, int timeLen);
void freeSecurityFuncSpace(const char* charList, ...);
extern void SimpleLogToServer(int elevel, bool silent, const char* fmt, ...)
__attribute__((format(PG_PRINTF_ATTRIBUTE, 3, 4)));
#define TRANSLATE_ERRNO (translate_errno(errno))
#define AssertEreport(condition, module, msg) \
do { \
Assert(condition); \
if (unlikely(!(condition))) \
ereport(ERROR, \
(errmodule(module), \
errcode(ERRORCODE_ASSERT_FAILED), \
errmsg("failed on assertion in %s line %d. %s", __FILE__, __LINE__, msg))); \
} while (0)
#define DISTRIBUTED_FEATURE_NOT_SUPPORTED() \
do { \
ereport(ERROR, \
(errcode(ERRCODE_FEATURE_NOT_SUPPORTED), \
errmsg("Un-support feature"), \
errdetail("The distributed capability is not supported currently."))); \
} while (0)
#define FEATURE_ON_LITE_MODE_NOT_SUPPORTED() \
do { \
ereport(ERROR, \
(errcode(ERRCODE_FEATURE_NOT_SUPPORTED), \
errmsg("Un-support feature"), \
errdetail("The feature is not supported on lite mode currently."))); \
} while (0)
#define IPC_PERFORMANCE_LOG_OUTPUT(errorMessage) \
do \
if (module_logging_is_on(MOD_COMM_IPC) && \
(t_thrd.proc && t_thrd.proc->workingVersionNum >= 92060)) { \
ereport(LOG, (errmodule(MOD_COMM_IPC), errmsg((char*)errorMessage))); \
} \
while (0)
#define IPC_PERFORMANCE_LOG_COLLECT(msgLog, buffer, bufferLen, remoteNode, fd, msgOpr) \
do \
if (module_logging_is_on(MOD_COMM_IPC) && bufferLen > 0 && \
(t_thrd.proc && t_thrd.proc->workingVersionNum >= 92060)) { \
msgLog = gs_comm_ipc_performance(msgLog, buffer, bufferLen, remoteNode, fd, msgOpr); \
} \
while (0)
#define MODULE_LOG_TRACE(trace_mode, ...) \
do \
if (module_logging_is_on(trace_mode)) { \
ereport(LOG, (errmodule(trace_mode), errmsg(__VA_ARGS__))); \
} \
while (0) \
#endif