granicus.if.org Git - postgresql/blob - src/include/utils/elog.h

   1 /*-------------------------------------------------------------------------
   2  *
   3  * elog.h
   4  *        POSTGRES error logging definitions.
   5  *
   6  *
   7  * Portions Copyright (c) 1996-2002, PostgreSQL Global Development Group
   8  * Portions Copyright (c) 1994, Regents of the University of California
   9  *
  10  * $Id: elog.h,v 1.47 2003/07/14 23:36:15 tgl Exp $
  11  *
  12  *-------------------------------------------------------------------------
  13  */
  14 #ifndef ELOG_H
  15 #define ELOG_H
  16
  17 /* Error level codes */
  18 #define DEBUG5          10                      /* Debugging messages, in categories of
  19                                                                  * decreasing detail. */
  20 #define DEBUG4          11
  21 #define DEBUG3          12
  22 #define DEBUG2          13
  23 #define DEBUG1          14                      /* used by GUC debug_* variables */
  24 #define LOG                     15                      /* Server operational messages; sent only
  25                                                                  * to server log by default. */
  26 #define COMMERROR       16                      /* Client communication problems; same as
  27                                                                  * LOG for server reporting, but never
  28                                                                  * sent to client. */
  29 #define INFO            17                      /* Informative messages that are always
  30                                                                  * sent to client;      is not affected by
  31                                                                  * client_min_messages */
  32 #define NOTICE          18                      /* Helpful messages to users about query
  33                                                                  * operation;  sent to client and server
  34                                                                  * log by default. */
  35 #define WARNING         19                      /* Warnings */
  36 #define ERROR           20                      /* user error - abort transaction; return
  37                                                                  * to known state */
  38 /* Save ERROR value in PGERROR so it can be restored when Win32 includes
  39  * modify it.  We have to use a constant rather than ERROR because macros
  40  * are expanded only when referenced outside macros.
  41  */
  42 #ifdef WIN32
  43 #define PGERROR         20
  44 #endif
  45 #define FATAL           21                      /* fatal error - abort process */
  46 #define PANIC           22                      /* take down the other backends with me */
  47
  48  /*#define DEBUG DEBUG1*/       /* Backward compatibility with pre-7.3 */
  49
  50
  51 /* macros for representing SQLSTATE strings compactly */
  52 #define PGSIXBIT(ch)    (((ch) - '0') & 0x3F)
  53 #define PGUNSIXBIT(val) (((val) & 0x3F) + '0')
  54
  55 #define MAKE_SQLSTATE(ch1,ch2,ch3,ch4,ch5)      \
  56         (PGSIXBIT(ch1) + (PGSIXBIT(ch2) << 6) + (PGSIXBIT(ch3) << 12) + \
  57          (PGSIXBIT(ch4) << 18) + (PGSIXBIT(ch5) << 24))
  58
  59
  60 /* SQLSTATE codes defined by SQL99 */
  61 #define ERRCODE_AMBIGUOUS_CURSOR_NAME           MAKE_SQLSTATE('3','C', '0','0','0')
  62 #define ERRCODE_CARDINALITY_VIOLATION           MAKE_SQLSTATE('2','1', '0','0','0')
  63 #define ERRCODE_CLI_SPECIFIC_CONDITION          MAKE_SQLSTATE('H','Y', '0','0','0')
  64 #define ERRCODE_CONNECTION_EXCEPTION            MAKE_SQLSTATE('0','8', '0','0','0')
  65 #define ERRCODE_CONNECTION_DOES_NOT_EXIST       MAKE_SQLSTATE('0','8', '0','0','3')
  66 #define ERRCODE_CONNECTION_FAILURE                      MAKE_SQLSTATE('0','8', '0','0','6')
  67 #define ERRCODE_CONNECTION_NAME_IN_USE          MAKE_SQLSTATE('0','8', '0','0','2')
  68 #define ERRCODE_SQLCLIENT_UNABLE_TO_ESTABLISH_SQLCONNECTION             MAKE_SQLSTATE('0','8', '0','0','1')
  69 #define ERRCODE_SQLSERVER_REJECTED_ESTABLISHMENT_OF_SQLCONNECTION       MAKE_SQLSTATE('0','8', '0','0','4')
  70 #define ERRCODE_TRANSACTION_RESOLUTION_UNKNOWN          MAKE_SQLSTATE('0','8', '0','0','7')
  71 #define ERRCODE_DATA_EXCEPTION                          MAKE_SQLSTATE('2','2', '0','0','0')
  72 #define ERRCODE_ARRAY_ELEMENT_ERROR                     MAKE_SQLSTATE('2','2', '0','2','E')
  73 #define ERRCODE_CHARACTER_NOT_IN_REPERTOIRE     MAKE_SQLSTATE('2','2', '0','2','1')
  74 #define ERRCODE_DATETIME_FIELD_OVERFLOW         MAKE_SQLSTATE('2','2', '0','0','8')
  75 #define ERRCODE_DIVISION_BY_ZERO                        MAKE_SQLSTATE('2','2', '0','1','2')
  76 #define ERRCODE_ERROR_IN_ASSIGNMENT                     MAKE_SQLSTATE('2','2', '0','0','5')
  77 #define ERRCODE_ESCAPE_CHARACTER_CONFLICT       MAKE_SQLSTATE('2','2', '0','0','B')
  78 #define ERRCODE_INDICATOR_OVERFLOW                      MAKE_SQLSTATE('2','2', '0','2','2')
  79 #define ERRCODE_INTERVAL_FIELD_OVERFLOW         MAKE_SQLSTATE('2','2', '0','1','5')
  80 #define ERRCODE_INVALID_CHARACTER_VALUE_FOR_CAST                MAKE_SQLSTATE('2','2', '0','1','8')
  81 #define ERRCODE_INVALID_DATETIME_FORMAT         MAKE_SQLSTATE('2','2', '0','0','7')
  82 #define ERRCODE_INVALID_ESCAPE_CHARACTER        MAKE_SQLSTATE('2','2', '0','1','9')
  83 #define ERRCODE_INVALID_ESCAPE_OCTET            MAKE_SQLSTATE('2','2', '0','0','D')
  84 #define ERRCODE_INVALID_ESCAPE_SEQUENCE         MAKE_SQLSTATE('2','2', '0','2','5')
  85 #define ERRCODE_INVALID_INDICATOR_PARAMETER_VALUE               MAKE_SQLSTATE('2','2', '0','1','0')
  86 #define ERRCODE_INVALID_LIMIT_VALUE                     MAKE_SQLSTATE('2','2', '0','2','0')
  87 #define ERRCODE_INVALID_PARAMETER_VALUE         MAKE_SQLSTATE('2','2', '0','2','3')
  88 #define ERRCODE_INVALID_REGULAR_EXPRESSION      MAKE_SQLSTATE('2','2', '0','1','B')
  89 #define ERRCODE_INVALID_TIME_ZONE_DISPLACEMENT_VALUE    MAKE_SQLSTATE('2','2', '0','0','9')
  90 #define ERRCODE_INVALID_USE_OF_ESCAPE_CHARACTER         MAKE_SQLSTATE('2','2', '0','0','C')
  91 #define ERRCODE_NULL_VALUE_NO_INDICATOR_PARAMETER       MAKE_SQLSTATE('2','2', '0','0','G')
  92 #define ERRCODE_MOST_SPECIFIC_TYPE_MISMATCH     MAKE_SQLSTATE('2','2', '0','0','2')
  93 #define ERRCODE_NULL_VALUE_NOT_ALLOWED          MAKE_SQLSTATE('2','2', '0','0','4')
  94 #define ERRCODE_NUMERIC_VALUE_OUT_OF_RANGE      MAKE_SQLSTATE('2','2', '0','0','3')
  95 #define ERRCODE_STRING_DATA_LENGTH_MISMATCH     MAKE_SQLSTATE('2','2', '0','2','6')
  96 #define ERRCODE_STRING_DATA_RIGHT_TRUNCATION            MAKE_SQLSTATE('2','2', '0','0','1')
  97 #define ERRCODE_SUBSTRING_ERROR                         MAKE_SQLSTATE('2','2', '0','1','1')
  98 #define ERRCODE_TRIM_ERROR                                      MAKE_SQLSTATE('2','2', '0','2','7')
  99 #define ERRCODE_UNTERMINATED_C_STRING           MAKE_SQLSTATE('2','2', '0','2','4')
 100 #define ERRCODE_ZERO_LENGTH_CHARACTER_STRING            MAKE_SQLSTATE('2','2', '0','0','F')
 101 #define ERRCODE_DEPENDENT_PRIVILEGE_DESCRIPTORS_STILL_EXIST             MAKE_SQLSTATE('2','B', '0','0','0')
 102 #define ERRCODE_EXTERNAL_ROUTINE_EXCEPTION      MAKE_SQLSTATE('3','8', '0','0','0')
 103 #define ERRCODE_EXTERNAL_ROUTINE_EXCEPTION_CONTAINING_SQL_NOT_PERMITTED MAKE_SQLSTATE('3','8', '0','0','1')
 104 #define ERRCODE_EXTERNAL_ROUTINE_EXCEPTION_MODIFYING_SQL_DATA_NOT_PERMITTED     MAKE_SQLSTATE('3','8', '0','0','2')
 105 #define ERRCODE_EXTERNAL_ROUTINE_EXCEPTION_PROHIBITED_SQL_STATEMENT_ATTEMPTED   MAKE_SQLSTATE('3','8', '0','0','3')
 106 #define ERRCODE_EXTERNAL_ROUTINE_EXCEPTION_READING_SQL_DATA_NOT_PERMITTED       MAKE_SQLSTATE('3','8', '0','0','4')
 107 #define ERRCODE_EXTERNAL_ROUTINE_INVOCATION_EXCEPTION   MAKE_SQLSTATE('3','9', '0','0','0')
 108 #define ERRCODE_EXTERNAL_ROUTINE_INVOCATION_EXCEPTION_INVALID_SQLSTATE_RETURNED MAKE_SQLSTATE('3','9', '0','0','1')
 109 #define ERRCODE_EXTERNAL_ROUTINE_INVOCATION_EXCEPTION_NULL_VALUE_NOT_ALLOWED    MAKE_SQLSTATE('3','9', '0','0','4')
 110 #define ERRCODE_FEATURE_NOT_SUPPORTED           MAKE_SQLSTATE('0','A', '0','0','0')
 111 #define ERRCODE_MULTIPLE_ENVIRONMENT_TRANSACTIONS       MAKE_SQLSTATE('0','A', '0','0','1')
 112 #define ERRCODE_INTEGRITY_CONSTRAINT_VIOLATION          MAKE_SQLSTATE('2','3', '0','0','0')
 113 #define ERRCODE_RESTRICT_VIOLATION                      MAKE_SQLSTATE('2','3', '0','0','1')
 114 #define ERRCODE_INVALID_AUTHORIZATION_SPECIFICATION     MAKE_SQLSTATE('2','8', '0','0','0')
 115 #define ERRCODE_INVALID_CATALOG_NAME            MAKE_SQLSTATE('3','D', '0','0','0')
 116 #define ERRCODE_INVALID_CONDITION_NUMBER        MAKE_SQLSTATE('3','5', '0','0','0')
 117 #define ERRCODE_INVALID_CONNECTION_NAME         MAKE_SQLSTATE('2','E', '0','0','0')
 118 #define ERRCODE_INVALID_CURSOR_NAME                     MAKE_SQLSTATE('3','4', '0','0','0')
 119 #define ERRCODE_INVALID_CURSOR_STATE            MAKE_SQLSTATE('2','4', '0','0','0')
 120 #define ERRCODE_INVALID_GRANTOR_STATE           MAKE_SQLSTATE('0','L', '0','0','0')
 121 #define ERRCODE_INVALID_ROLE_SPECIFICATION      MAKE_SQLSTATE('0','P', '0','0','0')
 122 #define ERRCODE_INVALID_SCHEMA_NAME                     MAKE_SQLSTATE('3','F', '0','0','0')
 123 #define ERRCODE_INVALID_SQL_DESCRIPTOR_NAME     MAKE_SQLSTATE('3','3', '0','0','0')
 124 #define ERRCODE_INVALID_SQL_STATEMENT           MAKE_SQLSTATE('3','0', '0','0','0')
 125 #define ERRCODE_INVALID_SQL_STATEMENT_NAME      MAKE_SQLSTATE('2','6', '0','0','0')
 126 #define ERRCODE_INVALID_TARGET_SPECIFICATION_VALUE      MAKE_SQLSTATE('3','1', '0','0','0')
 127 #define ERRCODE_INVALID_TRANSACTION_STATE       MAKE_SQLSTATE('2','5', '0','0','0')
 128 #define ERRCODE_ACTIVE_SQL_TRANSACTION          MAKE_SQLSTATE('2','5', '0','0','1')
 129 #define ERRCODE_BRANCH_TRANSACTION_ALREADY_ACTIVE       MAKE_SQLSTATE('2','5', '0','0','2')
 130 #define ERRCODE_HELD_CURSOR_REQUIRES_SAME_ISOLATION_LEVEL       MAKE_SQLSTATE('2','5', '0','0','8')
 131 #define ERRCODE_INAPPROPRIATE_ACCESS_MODE_FOR_BRANCH_TRANSACTION        MAKE_SQLSTATE('2','5', '0','0','3')
 132 #define ERRCODE_INAPPROPRIATE_ISOLATION_LEVEL_FOR_BRANCH_TRANSACTION    MAKE_SQLSTATE('2','5', '0','0','4')
 133 #define ERRCODE_NO_ACTIVE_SQL_TRANSACTION_FOR_BRANCH_TRANSACTION        MAKE_SQLSTATE('2','5', '0','0','5')
 134 #define ERRCODE_READ_ONLY_SQL_TRANSACTION       MAKE_SQLSTATE('2','5', '0','0','6')
 135 #define ERRCODE_SCHEMA_AND_DATA_STATEMENT_MIXING_NOT_SUPPORTED  MAKE_SQLSTATE('2','5', '0','0','7')
 136 #define ERRCODE_INVALID_TRANSACTION_INITIATION          MAKE_SQLSTATE('0','B', '0','0','0')
 137 #define ERRCODE_INVALID_TRANSACTION_TERMINATION         MAKE_SQLSTATE('2','D', '0','0','0')
 138 #define ERRCODE_LOCATOR_EXCEPTION                       MAKE_SQLSTATE('0','F', '0','0','0')
 139 #define ERRCODE_LOCATOR_EXCEPTION_INVALID_SPECIFICATION         MAKE_SQLSTATE('0','F', '0','0','1')
 140 #define ERRCODE_NO_DATA                                         MAKE_SQLSTATE('0','2', '0','0','0')
 141 #define ERRCODE_NO_ADDITIONAL_DYNAMIC_RESULT_SETS_RETURNED      MAKE_SQLSTATE('0','2', '0','0','1')
 142 #define ERRCODE_REMOTE_DATABASE_ACCESS          MAKE_SQLSTATE('H','Z', '0','0','0')
 143 #define ERRCODE_SAVEPOINT_EXCEPTION                     MAKE_SQLSTATE('3','B', '0','0','0')
 144 #define ERRCODE_SAVEPOINT_EXCEPTION_INVALID_SPECIFICATION       MAKE_SQLSTATE('3','B', '0','0','1')
 145 #define ERRCODE_SAVEPOINT_EXCEPTION_TOO_MANY            MAKE_SQLSTATE('3','B', '0','0','2')
 146 #define ERRCODE_SQL_ROUTINE_EXCEPTION           MAKE_SQLSTATE('2','F', '0','0','0')
 147 #define ERRCODE_FUNCTION_EXECUTED_NO_RETURN_STATEMENT           MAKE_SQLSTATE('2','F', '0','0','5')
 148 #define ERRCODE_MODIFYING_SQL_DATA_NOT_PERMITTED        MAKE_SQLSTATE('2','F', '0','0','2')
 149 #define ERRCODE_PROHIBITED_SQL_STATEMENT_ATTEMPTED      MAKE_SQLSTATE('2','F', '0','0','3')
 150 #define ERRCODE_READING_SQL_DATA_NOT_PERMITTED          MAKE_SQLSTATE('2','F', '0','0','4')
 151 #define ERRCODE_SQL_STATEMENT_NOT_YET_COMPLETE          MAKE_SQLSTATE('0','3', '0','0','0')
 152 #define ERRCODE_SUCCESSFUL_COMPLETION           MAKE_SQLSTATE('0','0', '0','0','0')
 153 #define ERRCODE_SYNTAX_ERROR_OR_ACCESS_RULE_VIOLATION           MAKE_SQLSTATE('4','2', '0','0','0')
 154 #define ERRCODE_SYNTAX_ERROR_OR_ACCESS_RULE_VIOLATION_IN_DIRECT_STATEMENT       MAKE_SQLSTATE('2','A', '0','0','0')
 155 #define ERRCODE_SYNTAX_ERROR_OR_ACCESS_RULE_VIOLATION_IN_DYNAMIC_STATEMENT      MAKE_SQLSTATE('3','7', '0','0','0')
 156 #define ERRCODE_TRANSACTION_ROLLBACK            MAKE_SQLSTATE('4','0', '0','0','0')
 157 #define ERRCODE_TRANSACTION_ROLLBACK_INTEGRITY_CONSTRAINT_VIOLATION     MAKE_SQLSTATE('4','0', '0','0','2')
 158 #define ERRCODE_TRANSACTION_ROLLBACK_SERIALIZATION_FAILURE      MAKE_SQLSTATE('4','0', '0','0','1')
 159 #define ERRCODE_TRANSACTION_ROLLBACK_STATEMENT_COMPLETION_UNKNOWN       MAKE_SQLSTATE('4','0', '0','0','3')
 160 #define ERRCODE_TRIGGERED_DATA_CHANGE_VIOLATION         MAKE_SQLSTATE('2','7', '0','0','0')
 161 #define ERRCODE_WARNING                                         MAKE_SQLSTATE('0','1', '0','0','0')
 162 #define ERRCODE_CURSOR_OPERATION_CONFLICT       MAKE_SQLSTATE('0','1', '0','0','1')
 163 #define ERRCODE_DISCONNECT_ERROR                        MAKE_SQLSTATE('0','1', '0','0','2')
 164 #define ERRCODE_DYNAMIC_RESULT_SETS_RETURNED            MAKE_SQLSTATE('0','1', '0','0','C')
 165 #define ERRCODE_IMPLICIT_ZERO_BIT_PADDING       MAKE_SQLSTATE('0','1', '0','0','8')
 166 #define ERRCODE_NULL_VALUE_ELIMINATED_IN_SET_FUNCTION   MAKE_SQLSTATE('0','1', '0','0','3')
 167 #define ERRCODE_PRIVILEGE_NOT_GRANTED           MAKE_SQLSTATE('0','1', '0','0','7')
 168 #define ERRCODE_PRIVILEGE_NOT_REVOKED           MAKE_SQLSTATE('0','1', '0','0','6')
 169 #define ERRCODE_QUERY_EXPRESSION_TOO_LONG_FOR_INFORMATION_SCHEMA        MAKE_SQLSTATE('0','1', '0','0','A')
 170 #define ERRCODE_SEARCH_CONDITION_TOO_LONG_FOR_INFORMATION_SCHEMA        MAKE_SQLSTATE('0','1', '0','0','9')
 171 #define ERRCODE_STATEMENT_TOO_LONG_FOR_INFORMATION_SCHEMA       MAKE_SQLSTATE('0','1', '0','0','5')
 172 #define ERRCODE_STRING_DATA_RIGHT_TRUNCATION_WARNING    MAKE_SQLSTATE('0','1', '0','0','4')
 173 #define ERRCODE_WITH_CHECK_OPTION_VIOLATION     MAKE_SQLSTATE('4','4', '0','0','0')
 174
 175 /* Implementation-defined error codes for PostgreSQL */
 176 /* Where appropriate, we borrow SQLSTATE values from DB2 */
 177 #define ERRCODE_INTERNAL_ERROR                          MAKE_SQLSTATE('X','X', '0','0','0')
 178 #define ERRCODE_INSUFFICIENT_PRIVILEGE          MAKE_SQLSTATE('4','2', '5','0','1')
 179 #define ERRCODE_SYNTAX_ERROR                            MAKE_SQLSTATE('4','2', '6','0','1')
 180 #define ERRCODE_UNTERMINATED_LITERAL            MAKE_SQLSTATE('4','2', '6','0','3')
 181 #define ERRCODE_INVALID_LITERAL                         MAKE_SQLSTATE('4','2', '6','0','6')
 182 #define ERRCODE_TOO_MANY_ARGUMENTS                      MAKE_SQLSTATE('4','2', '6','0','5')
 183 #define ERRCODE_UNDEFINED_COLUMN                        MAKE_SQLSTATE('4','2', '7','0','3')
 184 /*
 185  * Note: use the above SQL-standard error codes for undefined catalog, schema,
 186  * prepared statement, or cursor names.  Curiously, they don't define error
 187  * codes for any other kinds of objects.  We choose to define an errcode for
 188  * undefined tables, as well as one for functions (also used for operators);
 189  * all other names (rules, triggers, etc) are lumped as UNDEFINED_OBJECT.
 190  * The same breakdown is used for "ambiguous" and "duplicate" complaints.
 191  */
 192 #define ERRCODE_UNDEFINED_TABLE                         MAKE_SQLSTATE('4','2', '7','0','4')
 193 #define ERRCODE_UNDEFINED_FUNCTION                      MAKE_SQLSTATE('4','2', '8','8','3')
 194 #define ERRCODE_UNDEFINED_OBJECT                        MAKE_SQLSTATE('4','2', '7','0','5')
 195 #define ERRCODE_AMBIGUOUS_COLUMN                        MAKE_SQLSTATE('4','2', '7','0','2')
 196 #define ERRCODE_AMBIGUOUS_FUNCTION                      MAKE_SQLSTATE('4','2', '7','2','5')
 197 #define ERRCODE_DUPLICATE_COLUMN                        MAKE_SQLSTATE('4','2', '7','1','1')
 198 #define ERRCODE_DUPLICATE_TABLE                         MAKE_SQLSTATE('4','2', '7','2','2')
 199 #define ERRCODE_DUPLICATE_FUNCTION                      MAKE_SQLSTATE('4','2', '7','2','3')
 200 #define ERRCODE_DUPLICATE_OBJECT                        MAKE_SQLSTATE('4','2', '7','1','0')
 201 #define ERRCODE_GROUPING_ERROR                          MAKE_SQLSTATE('4','2', '8','0','3')
 202 #define ERRCODE_TYPE_MISMATCH                           MAKE_SQLSTATE('4','2', '8','0','4')
 203 #define ERRCODE_CANNOT_COERCE                           MAKE_SQLSTATE('4','2', '8','4','6')
 204 #define ERRCODE_INVALID_FOREIGN_KEY                     MAKE_SQLSTATE('4','2', '8','3','0')
 205
 206
 207 /* Which __func__ symbol do we have, if any? */
 208 #ifdef HAVE_FUNCNAME__FUNC
 209 #define PG_FUNCNAME_MACRO       __func__
 210 #else
 211 #ifdef HAVE_FUNCNAME__FUNCTION
 212 #define PG_FUNCNAME_MACRO       __FUNCTION__
 213 #else
 214 #define PG_FUNCNAME_MACRO       NULL
 215 #endif
 216 #endif
 217
 218
 219 /*----------
 220  * New-style error reporting API: to be used in this way:
 221  *              ereport(ERROR,
 222  *                              (errcode(ERRCODE_INVALID_CURSOR_NAME),
 223  *                               errmsg("portal \"%s\" not found", stmt->portalname),
 224  *                               ... other errxxx() fields as needed ...));
 225  *
 226  * The error level is required, and so is a primary error message (errmsg
 227  * or errmsg_internal).  All else is optional.  errcode() defaults to
 228  * ERRCODE_INTERNAL_ERROR.
 229  *----------
 230  */
 231 #define ereport(elevel, rest)  \
 232         (errstart(elevel, __FILE__, __LINE__, PG_FUNCNAME_MACRO) ? \
 233          (errfinish rest) : (void) 0)
 234
 235 extern bool errstart(int elevel, const char *filename, int lineno,
 236                                          const char *funcname);
 237 extern void errfinish(int dummy, ...);
 238
 239 extern int errcode(int sqlerrcode);
 240
 241 extern int errmsg(const char *fmt, ...)
 242 /* This extension allows gcc to check the format string for consistency with
 243    the supplied arguments. */
 244 __attribute__((format(printf, 1, 2)));
 245
 246 extern int errmsg_internal(const char *fmt, ...)
 247 /* This extension allows gcc to check the format string for consistency with
 248    the supplied arguments. */
 249 __attribute__((format(printf, 1, 2)));
 250
 251 extern int errdetail(const char *fmt, ...)
 252 /* This extension allows gcc to check the format string for consistency with
 253    the supplied arguments. */
 254 __attribute__((format(printf, 1, 2)));
 255
 256 extern int errhint(const char *fmt, ...)
 257 /* This extension allows gcc to check the format string for consistency with
 258    the supplied arguments. */
 259 __attribute__((format(printf, 1, 2)));
 260
 261 extern int errcontext(const char *fmt, ...)
 262 /* This extension allows gcc to check the format string for consistency with
 263    the supplied arguments. */
 264 __attribute__((format(printf, 1, 2)));
 265
 266 extern int errfunction(const char *funcname);
 267 extern int errposition(int cursorpos);
 268
 269
 270 /*----------
 271  * Old-style error reporting API: to be used in this way:
 272  *              elog(ERROR, "portal \"%s\" not found", stmt->portalname);
 273  *----------
 274  */
 275 #define elog    errstart(ERROR, __FILE__, __LINE__, PG_FUNCNAME_MACRO), elog_finish
 276
 277 extern void
 278 elog_finish(int elevel, const char *fmt, ...)
 279 /* This extension allows gcc to check the format string for consistency with
 280    the supplied arguments. */
 281 __attribute__((format(printf, 2, 3)));
 282
 283
 284 /* Support for attaching context information to error reports */
 285
 286 typedef struct ErrorContextCallback
 287 {
 288         struct ErrorContextCallback *previous;
 289         void (*callback) (void *arg);
 290         void *arg;
 291 } ErrorContextCallback;
 292
 293 extern DLLIMPORT ErrorContextCallback *error_context_stack;
 294
 295
 296 /* GUC-configurable parameters */
 297
 298 typedef enum
 299 {
 300         PGERROR_TERSE,                          /* single-line error messages */
 301         PGERROR_DEFAULT,                        /* recommended style */
 302         PGERROR_VERBOSE                         /* all the facts, ma'am */
 303 } PGErrorVerbosity;
 304
 305 extern PGErrorVerbosity Log_error_verbosity;
 306 extern bool Log_timestamp;
 307 extern bool Log_pid;
 308 #ifdef HAVE_SYSLOG
 309 extern int      Use_syslog;
 310 #endif
 311
 312
 313 /* Other exported functions */
 314 extern void DebugFileOpen(void);
 315
 316 #endif   /* ELOG_H */