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.58 2003/07/25 20:18:00 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 /*
  61  * SQLSTATE codes for errors.
  62  *
  63  * The SQL99 code set is rather impoverished, especially in the area of
  64  * syntactical and semantic errors.  We have borrowed codes from IBM's DB2
  65  * and invented our own codes to develop a useful code set.
  66  *
  67  * When adding a new code, make sure it is placed in the most appropriate
  68  * class (the first two characters of the code value identify the class).
  69  * The listing is organized by class to make this prominent.
  70  *
  71  * The generic '000' class code should be used for an error only when there
  72  * is not a more-specific code defined.
  73  */
  74
  75 /* Class 00 - Successful Completion */
  76 #define ERRCODE_SUCCESSFUL_COMPLETION           MAKE_SQLSTATE('0','0', '0','0','0')
  77
  78 /* Class 01 - Warning */
  79 /* (do not use this class for failure conditions!) */
  80 #define ERRCODE_WARNING                                         MAKE_SQLSTATE('0','1', '0','0','0')
  81 #define ERRCODE_WARNING_DYNAMIC_RESULT_SETS_RETURNED            MAKE_SQLSTATE('0','1', '0','0','C')
  82 #define ERRCODE_WARNING_IMPLICIT_ZERO_BIT_PADDING       MAKE_SQLSTATE('0','1', '0','0','8')
  83 #define ERRCODE_WARNING_NULL_VALUE_ELIMINATED_IN_SET_FUNCTION   MAKE_SQLSTATE('0','1', '0','0','3')
  84 #define ERRCODE_WARNING_STRING_DATA_RIGHT_TRUNCATION    MAKE_SQLSTATE('0','1', '0','0','4')
  85
  86 /* Class 02 - No Data --- this is also a warning class per SQL99 */
  87 /* (do not use this class for failure conditions!) */
  88 #define ERRCODE_NO_DATA                                         MAKE_SQLSTATE('0','2', '0','0','0')
  89 #define ERRCODE_NO_ADDITIONAL_DYNAMIC_RESULT_SETS_RETURNED      MAKE_SQLSTATE('0','2', '0','0','1')
  90
  91 /* Class 03 - SQL Statement Not Yet Complete */
  92 #define ERRCODE_SQL_STATEMENT_NOT_YET_COMPLETE          MAKE_SQLSTATE('0','3', '0','0','0')
  93
  94 /* Class 08 - Connection Exception */
  95 #define ERRCODE_CONNECTION_EXCEPTION            MAKE_SQLSTATE('0','8', '0','0','0')
  96 #define ERRCODE_CONNECTION_DOES_NOT_EXIST       MAKE_SQLSTATE('0','8', '0','0','3')
  97 #define ERRCODE_CONNECTION_FAILURE                      MAKE_SQLSTATE('0','8', '0','0','6')
  98 #define ERRCODE_SQLCLIENT_UNABLE_TO_ESTABLISH_SQLCONNECTION             MAKE_SQLSTATE('0','8', '0','0','1')
  99 #define ERRCODE_SQLSERVER_REJECTED_ESTABLISHMENT_OF_SQLCONNECTION       MAKE_SQLSTATE('0','8', '0','0','4')
 100 #define ERRCODE_TRANSACTION_RESOLUTION_UNKNOWN          MAKE_SQLSTATE('0','8', '0','0','7')
 101 #define ERRCODE_PROTOCOL_VIOLATION                      MAKE_SQLSTATE('0','8', 'P','0','1')
 102
 103 /* Class 09 - Triggered Action Exception */
 104 #define ERRCODE_TRIGGERED_ACTION_EXCEPTION      MAKE_SQLSTATE('0','9', '0','0','0')
 105
 106 /* Class 0A - Feature Not Supported */
 107 #define ERRCODE_FEATURE_NOT_SUPPORTED           MAKE_SQLSTATE('0','A', '0','0','0')
 108
 109 /* Class 0B - Invalid Transaction Initiation */
 110 #define ERRCODE_INVALID_TRANSACTION_INITIATION          MAKE_SQLSTATE('0','B', '0','0','0')
 111
 112 /* Class 0F - Locator Exception */
 113 #define ERRCODE_LOCATOR_EXCEPTION                       MAKE_SQLSTATE('0','F', '0','0','0')
 114 #define ERRCODE_L_E_INVALID_SPECIFICATION       MAKE_SQLSTATE('0','F', '0','0','1')
 115
 116 /* Class 0L - Invalid Grantor */
 117 #define ERRCODE_INVALID_GRANTOR                         MAKE_SQLSTATE('0','L', '0','0','0')
 118 #define ERRCODE_INVALID_GRANT_OPERATION         MAKE_SQLSTATE('0','L', 'P','0','1')
 119
 120 /* Class 0P - Invalid Role Specification */
 121 #define ERRCODE_INVALID_ROLE_SPECIFICATION      MAKE_SQLSTATE('0','P', '0','0','0')
 122
 123 /* Class 21 - Cardinality Violation */
 124 /* (this means something returned the wrong number of rows) */
 125 #define ERRCODE_CARDINALITY_VIOLATION           MAKE_SQLSTATE('2','1', '0','0','0')
 126
 127 /* Class 22 - Data Exception */
 128 #define ERRCODE_DATA_EXCEPTION                          MAKE_SQLSTATE('2','2', '0','0','0')
 129 #define ERRCODE_ARRAY_ELEMENT_ERROR                     MAKE_SQLSTATE('2','2', '0','2','E')
 130 /* SQL99's actual definition of "array element error" is subscript error */
 131 #define ERRCODE_ARRAY_SUBSCRIPT_ERROR           ERRCODE_ARRAY_ELEMENT_ERROR
 132 #define ERRCODE_CHARACTER_NOT_IN_REPERTOIRE     MAKE_SQLSTATE('2','2', '0','2','1')
 133 #define ERRCODE_DATETIME_FIELD_OVERFLOW         MAKE_SQLSTATE('2','2', '0','0','8')
 134 #define ERRCODE_DIVISION_BY_ZERO                        MAKE_SQLSTATE('2','2', '0','1','2')
 135 #define ERRCODE_ERROR_IN_ASSIGNMENT                     MAKE_SQLSTATE('2','2', '0','0','5')
 136 #define ERRCODE_ESCAPE_CHARACTER_CONFLICT       MAKE_SQLSTATE('2','2', '0','0','B')
 137 #define ERRCODE_INDICATOR_OVERFLOW                      MAKE_SQLSTATE('2','2', '0','2','2')
 138 #define ERRCODE_INTERVAL_FIELD_OVERFLOW         MAKE_SQLSTATE('2','2', '0','1','5')
 139 #define ERRCODE_INVALID_CHARACTER_VALUE_FOR_CAST                MAKE_SQLSTATE('2','2', '0','1','8')
 140 #define ERRCODE_INVALID_DATETIME_FORMAT         MAKE_SQLSTATE('2','2', '0','0','7')
 141 #define ERRCODE_INVALID_ESCAPE_CHARACTER        MAKE_SQLSTATE('2','2', '0','1','9')
 142 #define ERRCODE_INVALID_ESCAPE_OCTET            MAKE_SQLSTATE('2','2', '0','0','D')
 143 #define ERRCODE_INVALID_ESCAPE_SEQUENCE         MAKE_SQLSTATE('2','2', '0','2','5')
 144 #define ERRCODE_INVALID_INDICATOR_PARAMETER_VALUE               MAKE_SQLSTATE('2','2', '0','1','0')
 145 #define ERRCODE_INVALID_LIMIT_VALUE                     MAKE_SQLSTATE('2','2', '0','2','0')
 146 #define ERRCODE_INVALID_PARAMETER_VALUE         MAKE_SQLSTATE('2','2', '0','2','3')
 147 #define ERRCODE_INVALID_REGULAR_EXPRESSION      MAKE_SQLSTATE('2','2', '0','1','B')
 148 #define ERRCODE_INVALID_TIME_ZONE_DISPLACEMENT_VALUE    MAKE_SQLSTATE('2','2', '0','0','9')
 149 #define ERRCODE_INVALID_USE_OF_ESCAPE_CHARACTER         MAKE_SQLSTATE('2','2', '0','0','C')
 150 #define ERRCODE_MOST_SPECIFIC_TYPE_MISMATCH     MAKE_SQLSTATE('2','2', '0','0','2')
 151 #define ERRCODE_NULL_VALUE_NOT_ALLOWED          MAKE_SQLSTATE('2','2', '0','0','4')
 152 #define ERRCODE_NULL_VALUE_NO_INDICATOR_PARAMETER       MAKE_SQLSTATE('2','2', '0','0','G')
 153 #define ERRCODE_NUMERIC_VALUE_OUT_OF_RANGE      MAKE_SQLSTATE('2','2', '0','0','3')
 154 #define ERRCODE_STRING_DATA_LENGTH_MISMATCH     MAKE_SQLSTATE('2','2', '0','2','6')
 155 #define ERRCODE_STRING_DATA_RIGHT_TRUNCATION            MAKE_SQLSTATE('2','2', '0','0','1')
 156 #define ERRCODE_SUBSTRING_ERROR                         MAKE_SQLSTATE('2','2', '0','1','1')
 157 #define ERRCODE_TRIM_ERROR                                      MAKE_SQLSTATE('2','2', '0','2','7')
 158 #define ERRCODE_UNTERMINATED_C_STRING           MAKE_SQLSTATE('2','2', '0','2','4')
 159 #define ERRCODE_ZERO_LENGTH_CHARACTER_STRING            MAKE_SQLSTATE('2','2', '0','0','F')
 160 #define ERRCODE_BAD_COPY_FILE_FORMAT            MAKE_SQLSTATE('2','2', 'P','0','1')
 161 #define ERRCODE_INVALID_BINARY_REPRESENTATION   MAKE_SQLSTATE('2','2', 'P','0','2')
 162 #define ERRCODE_FLOATING_POINT_EXCEPTION        MAKE_SQLSTATE('2','2', 'P','0','3')
 163 #define ERRCODE_UNTRANSLATABLE_CHARACTER        MAKE_SQLSTATE('2','2', 'P','0','4')
 164
 165 /* Class 23 - Integrity Constraint Violation */
 166 #define ERRCODE_INTEGRITY_CONSTRAINT_VIOLATION          MAKE_SQLSTATE('2','3', '0','0','0')
 167 #define ERRCODE_RESTRICT_VIOLATION                      MAKE_SQLSTATE('2','3', '0','0','1')
 168 #define ERRCODE_NOT_NULL_VIOLATION                      MAKE_SQLSTATE('2','3', '5','0','2')
 169 #define ERRCODE_FOREIGN_KEY_VIOLATION           MAKE_SQLSTATE('2','3', '5','0','3')
 170 #define ERRCODE_UNIQUE_VIOLATION                        MAKE_SQLSTATE('2','3', '5','0','5')
 171 #define ERRCODE_CHECK_VIOLATION                         MAKE_SQLSTATE('2','3', '5','1','4')
 172
 173 /* Class 24 - Invalid Cursor State */
 174 #define ERRCODE_INVALID_CURSOR_STATE            MAKE_SQLSTATE('2','4', '0','0','0')
 175
 176 /* Class 25 - Invalid Transaction State */
 177 #define ERRCODE_INVALID_TRANSACTION_STATE       MAKE_SQLSTATE('2','5', '0','0','0')
 178 #define ERRCODE_ACTIVE_SQL_TRANSACTION          MAKE_SQLSTATE('2','5', '0','0','1')
 179 #define ERRCODE_BRANCH_TRANSACTION_ALREADY_ACTIVE       MAKE_SQLSTATE('2','5', '0','0','2')
 180 #define ERRCODE_HELD_CURSOR_REQUIRES_SAME_ISOLATION_LEVEL       MAKE_SQLSTATE('2','5', '0','0','8')
 181 #define ERRCODE_INAPPROPRIATE_ACCESS_MODE_FOR_BRANCH_TRANSACTION        MAKE_SQLSTATE('2','5', '0','0','3')
 182 #define ERRCODE_INAPPROPRIATE_ISOLATION_LEVEL_FOR_BRANCH_TRANSACTION    MAKE_SQLSTATE('2','5', '0','0','4')
 183 #define ERRCODE_NO_ACTIVE_SQL_TRANSACTION_FOR_BRANCH_TRANSACTION        MAKE_SQLSTATE('2','5', '0','0','5')
 184 #define ERRCODE_READ_ONLY_SQL_TRANSACTION       MAKE_SQLSTATE('2','5', '0','0','6')
 185 #define ERRCODE_SCHEMA_AND_DATA_STATEMENT_MIXING_NOT_SUPPORTED  MAKE_SQLSTATE('2','5', '0','0','7')
 186 #define ERRCODE_NO_ACTIVE_SQL_TRANSACTION       MAKE_SQLSTATE('2','5', 'P','0','1')
 187 #define ERRCODE_IN_FAILED_SQL_TRANSACTION       MAKE_SQLSTATE('2','5', 'P','0','2')
 188
 189 /* Class 26 - Invalid SQL Statement Name */
 190 /* (we take this to mean prepared statements) */
 191 #define ERRCODE_INVALID_SQL_STATEMENT_NAME      MAKE_SQLSTATE('2','6', '0','0','0')
 192
 193 /* Class 27 - Triggered Data Change Violation */
 194 #define ERRCODE_TRIGGERED_DATA_CHANGE_VIOLATION         MAKE_SQLSTATE('2','7', '0','0','0')
 195
 196 /* Class 28 - Invalid Authorization Specification */
 197 #define ERRCODE_INVALID_AUTHORIZATION_SPECIFICATION     MAKE_SQLSTATE('2','8', '0','0','0')
 198
 199 /* Class 2B - Dependent Privilege Descriptors Still Exist */
 200 #define ERRCODE_DEPENDENT_PRIVILEGE_DESCRIPTORS_STILL_EXIST             MAKE_SQLSTATE('2','B', '0','0','0')
 201 #define ERRCODE_DEPENDENT_OBJECTS_STILL_EXIST           MAKE_SQLSTATE('2','B', 'P','0','1')
 202
 203 /* Class 2D - Invalid Transaction Termination */
 204 #define ERRCODE_INVALID_TRANSACTION_TERMINATION         MAKE_SQLSTATE('2','D', '0','0','0')
 205
 206 /* Class 2F - SQL Routine Exception */
 207 #define ERRCODE_SQL_ROUTINE_EXCEPTION           MAKE_SQLSTATE('2','F', '0','0','0')
 208 #define ERRCODE_S_R_E_FUNCTION_EXECUTED_NO_RETURN_STATEMENT     MAKE_SQLSTATE('2','F', '0','0','5')
 209 #define ERRCODE_S_R_E_MODIFYING_SQL_DATA_NOT_PERMITTED          MAKE_SQLSTATE('2','F', '0','0','2')
 210 #define ERRCODE_S_R_E_PROHIBITED_SQL_STATEMENT_ATTEMPTED        MAKE_SQLSTATE('2','F', '0','0','3')
 211 #define ERRCODE_S_R_E_READING_SQL_DATA_NOT_PERMITTED            MAKE_SQLSTATE('2','F', '0','0','4')
 212
 213 /* Class 34 - Invalid Cursor Name */
 214 #define ERRCODE_INVALID_CURSOR_NAME                     MAKE_SQLSTATE('3','4', '0','0','0')
 215
 216 /* Class 38 - External Routine Exception */
 217 #define ERRCODE_EXTERNAL_ROUTINE_EXCEPTION      MAKE_SQLSTATE('3','8', '0','0','0')
 218 #define ERRCODE_E_R_E_CONTAINING_SQL_NOT_PERMITTED      MAKE_SQLSTATE('3','8', '0','0','1')
 219 #define ERRCODE_E_R_E_MODIFYING_SQL_DATA_NOT_PERMITTED  MAKE_SQLSTATE('3','8', '0','0','2')
 220 #define ERRCODE_E_R_E_PROHIBITED_SQL_STATEMENT_ATTEMPTED        MAKE_SQLSTATE('3','8', '0','0','3')
 221 #define ERRCODE_E_R_E_READING_SQL_DATA_NOT_PERMITTED    MAKE_SQLSTATE('3','8', '0','0','4')
 222
 223 /* Class 39 - External Routine Invocation Exception */
 224 #define ERRCODE_EXTERNAL_ROUTINE_INVOCATION_EXCEPTION   MAKE_SQLSTATE('3','9', '0','0','0')
 225 #define ERRCODE_E_R_I_E_INVALID_SQLSTATE_RETURNED       MAKE_SQLSTATE('3','9', '0','0','1')
 226 #define ERRCODE_E_R_I_E_NULL_VALUE_NOT_ALLOWED  MAKE_SQLSTATE('3','9', '0','0','4')
 227 #define ERRCODE_E_R_I_E_TRIGGER_PROTOCOL_VIOLATED       MAKE_SQLSTATE('3','9', 'P','0','1')
 228 #define ERRCODE_E_R_I_E_SRF_PROTOCOL_VIOLATED   MAKE_SQLSTATE('3','9', 'P','0','2')
 229
 230 /* Class 3D - Invalid Catalog Name */
 231 #define ERRCODE_INVALID_CATALOG_NAME            MAKE_SQLSTATE('3','D', '0','0','0')
 232
 233 /* Class 3F - Invalid Schema Name */
 234 #define ERRCODE_INVALID_SCHEMA_NAME                     MAKE_SQLSTATE('3','F', '0','0','0')
 235
 236 /* Class 40 - Transaction Rollback */
 237 #define ERRCODE_TRANSACTION_ROLLBACK            MAKE_SQLSTATE('4','0', '0','0','0')
 238 #define ERRCODE_T_R_INTEGRITY_CONSTRAINT_VIOLATION      MAKE_SQLSTATE('4','0', '0','0','2')
 239 #define ERRCODE_T_R_SERIALIZATION_FAILURE       MAKE_SQLSTATE('4','0', '0','0','1')
 240 #define ERRCODE_T_R_STATEMENT_COMPLETION_UNKNOWN        MAKE_SQLSTATE('4','0', '0','0','3')
 241 #define ERRCODE_T_R_DEADLOCK_DETECTED           MAKE_SQLSTATE('4','0', 'P','0','1')
 242
 243 /* Class 42 - Syntax Error or Access Rule Violation */
 244 #define ERRCODE_SYNTAX_ERROR_OR_ACCESS_RULE_VIOLATION           MAKE_SQLSTATE('4','2', '0','0','0')
 245 /* never use the above; use one of these two if no specific code exists: */
 246 #define ERRCODE_SYNTAX_ERROR                            MAKE_SQLSTATE('4','2', '6','0','1')
 247 #define ERRCODE_INSUFFICIENT_PRIVILEGE          MAKE_SQLSTATE('4','2', '5','0','1')
 248 #define ERRCODE_CANNOT_COERCE                           MAKE_SQLSTATE('4','2', '8','4','6')
 249 #define ERRCODE_GROUPING_ERROR                          MAKE_SQLSTATE('4','2', '8','0','3')
 250 #define ERRCODE_INVALID_FOREIGN_KEY                     MAKE_SQLSTATE('4','2', '8','3','0')
 251 #define ERRCODE_INVALID_NAME                            MAKE_SQLSTATE('4','2', '6','0','2')
 252 #define ERRCODE_NAME_TOO_LONG                           MAKE_SQLSTATE('4','2', '6','2','2')
 253 #define ERRCODE_RESERVED_NAME                           MAKE_SQLSTATE('4','2', '9','3','9')
 254 #define ERRCODE_DATATYPE_MISMATCH                       MAKE_SQLSTATE('4','2', '8','0','4')
 255 #define ERRCODE_INDETERMINATE_DATATYPE          MAKE_SQLSTATE('4','2', 'P','1','8')
 256 #define ERRCODE_WRONG_OBJECT_TYPE                       MAKE_SQLSTATE('4','2', '8','0','9')
 257 /*
 258  * Note: for ERRCODE purposes, we divide namable objects into these categories:
 259  * databases, schemas, prepared statements, cursors, tables, columns,
 260  * functions (including operators), and all else (lumped as "objects").
 261  * (The first four categories are mandated by the existence of separate
 262  * SQLSTATE classes for them in the spec; in this file, however, we group
 263  * the ERRCODE names with all the rest under class 42.)  Parameters are
 264  * sort-of-named objects and get their own ERRCODE.
 265  *
 266  * The same breakdown is used for "duplicate" and "ambiguous" complaints,
 267  * as well as complaints associated with incorrect declarations.
 268  */
 269 #define ERRCODE_UNDEFINED_COLUMN                        MAKE_SQLSTATE('4','2', '7','0','3')
 270 #define ERRCODE_UNDEFINED_CURSOR                        ERRCODE_INVALID_CURSOR_NAME
 271 #define ERRCODE_UNDEFINED_DATABASE                      ERRCODE_INVALID_CATALOG_NAME
 272 #define ERRCODE_UNDEFINED_FUNCTION                      MAKE_SQLSTATE('4','2', '8','8','3')
 273 #define ERRCODE_UNDEFINED_PSTATEMENT            ERRCODE_INVALID_SQL_STATEMENT_NAME
 274 #define ERRCODE_UNDEFINED_SCHEMA                        ERRCODE_INVALID_SCHEMA_NAME
 275 #define ERRCODE_UNDEFINED_TABLE                         MAKE_SQLSTATE('4','2', 'P','0','1')
 276 #define ERRCODE_UNDEFINED_PARAMETER                     MAKE_SQLSTATE('4','2', 'P','0','2')
 277 #define ERRCODE_UNDEFINED_OBJECT                        MAKE_SQLSTATE('4','2', '7','0','4')
 278 #define ERRCODE_DUPLICATE_COLUMN                        MAKE_SQLSTATE('4','2', '7','0','1')
 279 #define ERRCODE_DUPLICATE_CURSOR                        MAKE_SQLSTATE('4','2', 'P','0','3')
 280 #define ERRCODE_DUPLICATE_DATABASE                      MAKE_SQLSTATE('4','2', 'P','0','4')
 281 #define ERRCODE_DUPLICATE_FUNCTION                      MAKE_SQLSTATE('4','2', '7','2','3')
 282 #define ERRCODE_DUPLICATE_PSTATEMENT            MAKE_SQLSTATE('4','2', 'P','0','5')
 283 #define ERRCODE_DUPLICATE_SCHEMA                        MAKE_SQLSTATE('4','2', 'P','0','6')
 284 #define ERRCODE_DUPLICATE_TABLE                         MAKE_SQLSTATE('4','2', 'P','0','7')
 285 #define ERRCODE_DUPLICATE_ALIAS                         MAKE_SQLSTATE('4','2', '7','1','2')
 286 #define ERRCODE_DUPLICATE_OBJECT                        MAKE_SQLSTATE('4','2', '7','1','0')
 287 #define ERRCODE_AMBIGUOUS_COLUMN                        MAKE_SQLSTATE('4','2', '7','0','2')
 288 #define ERRCODE_AMBIGUOUS_FUNCTION                      MAKE_SQLSTATE('4','2', '7','2','5')
 289 #define ERRCODE_AMBIGUOUS_PARAMETER                     MAKE_SQLSTATE('4','2', 'P','0','8')
 290 #define ERRCODE_AMBIGUOUS_ALIAS                         MAKE_SQLSTATE('4','2', 'P','0','9')
 291 #define ERRCODE_INVALID_COLUMN_REFERENCE        MAKE_SQLSTATE('4','2', 'P','1','0')
 292 #define ERRCODE_INVALID_COLUMN_DEFINITION       MAKE_SQLSTATE('4','2', '6','1','1')
 293 #define ERRCODE_INVALID_CURSOR_DEFINITION       MAKE_SQLSTATE('4','2', 'P','1','1')
 294 #define ERRCODE_INVALID_DATABASE_DEFINITION     MAKE_SQLSTATE('4','2', 'P','1','2')
 295 #define ERRCODE_INVALID_FUNCTION_DEFINITION     MAKE_SQLSTATE('4','2', 'P','1','3')
 296 #define ERRCODE_INVALID_PSTATEMENT_DEFINITION   MAKE_SQLSTATE('4','2', 'P','1','4')
 297 #define ERRCODE_INVALID_SCHEMA_DEFINITION       MAKE_SQLSTATE('4','2', 'P','1','5')
 298 #define ERRCODE_INVALID_TABLE_DEFINITION        MAKE_SQLSTATE('4','2', 'P','1','6')
 299 #define ERRCODE_INVALID_OBJECT_DEFINITION       MAKE_SQLSTATE('4','2', 'P','1','7')
 300
 301 /* Class 44 - WITH CHECK OPTION Violation */
 302 #define ERRCODE_WITH_CHECK_OPTION_VIOLATION     MAKE_SQLSTATE('4','4', '0','0','0')
 303
 304 /* Class 53 - Insufficient Resources (PostgreSQL-specific error class) */
 305 #define ERRCODE_INSUFFICIENT_RESOURCES          MAKE_SQLSTATE('5','3', '0','0','0')
 306 #define ERRCODE_DISK_FULL                                       MAKE_SQLSTATE('5','3', '1','0','0')
 307 #define ERRCODE_OUT_OF_MEMORY                           MAKE_SQLSTATE('5','3', '2','0','0')
 308 #define ERRCODE_TOO_MANY_CONNECTIONS            MAKE_SQLSTATE('5','3', '3','0','0')
 309
 310 /* Class 54 - Program Limit Exceeded (class borrowed from DB2) */
 311 /* (this is for wired-in limits, not resource exhaustion problems) */
 312 #define ERRCODE_PROGRAM_LIMIT_EXCEEDED          MAKE_SQLSTATE('5','4', '0','0','0')
 313 #define ERRCODE_STATEMENT_TOO_COMPLEX           MAKE_SQLSTATE('5','4', '0','0','1')
 314 #define ERRCODE_TOO_MANY_COLUMNS                        MAKE_SQLSTATE('5','4', '0','1','1')
 315 #define ERRCODE_TOO_MANY_ARGUMENTS                      MAKE_SQLSTATE('5','4', '0','2','3')
 316
 317 /* Class 55 - Object Not In Prerequisite State (class borrowed from DB2) */
 318 #define ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE        MAKE_SQLSTATE('5','5', '0','0','0')
 319 #define ERRCODE_OBJECT_IN_USE                           MAKE_SQLSTATE('5','5', '0','0','6')
 320 #define ERRCODE_INDEXES_DEACTIVATED                     MAKE_SQLSTATE('5','5', 'P','0','1')
 321 #define ERRCODE_CANT_CHANGE_RUNTIME_PARAM       MAKE_SQLSTATE('5','5', 'P','0','2')
 322
 323 /* Class 57 - Operator Intervention (class borrowed from DB2) */
 324 #define ERRCODE_OPERATOR_INTERVENTION           MAKE_SQLSTATE('5','7', '0','0','0')
 325 #define ERRCODE_QUERY_CANCELED                          MAKE_SQLSTATE('5','7', '0','1','4')
 326 #define ERRCODE_ADMIN_SHUTDOWN                          MAKE_SQLSTATE('5','7', 'P','0','1')
 327 #define ERRCODE_CRASH_SHUTDOWN                          MAKE_SQLSTATE('5','7', 'P','0','2')
 328 #define ERRCODE_CANNOT_CONNECT_NOW                      MAKE_SQLSTATE('5','7', 'P','0','3')
 329
 330 /* Class 58 - System Error (class borrowed from DB2) */
 331 /* (we define this as errors external to PostgreSQL itself) */
 332 #define ERRCODE_IO_ERROR                                        MAKE_SQLSTATE('5','8', '0','3','0')
 333
 334 /* Class F0 - Configuration File Error (PostgreSQL-specific error class) */
 335 #define ERRCODE_CONFIG_FILE_ERROR                       MAKE_SQLSTATE('F','0', '0','0','0')
 336
 337 /* Class XX - Internal Error (PostgreSQL-specific error class) */
 338 /* (this is for "can't-happen" conditions and software bugs) */
 339 #define ERRCODE_INTERNAL_ERROR                          MAKE_SQLSTATE('X','X', '0','0','0')
 340 #define ERRCODE_DATA_CORRUPTED                          MAKE_SQLSTATE('X','X', '0','0','1')
 341 #define ERRCODE_INDEX_CORRUPTED                         MAKE_SQLSTATE('X','X', '0','0','2')
 342
 343
 344 /* Which __func__ symbol do we have, if any? */
 345 #ifdef HAVE_FUNCNAME__FUNC
 346 #define PG_FUNCNAME_MACRO       __func__
 347 #else
 348 #ifdef HAVE_FUNCNAME__FUNCTION
 349 #define PG_FUNCNAME_MACRO       __FUNCTION__
 350 #else
 351 #define PG_FUNCNAME_MACRO       NULL
 352 #endif
 353 #endif
 354
 355
 356 /*----------
 357  * New-style error reporting API: to be used in this way:
 358  *              ereport(ERROR,
 359  *                              (errcode(ERRCODE_UNDEFINED_CURSOR),
 360  *                               errmsg("portal \"%s\" not found", stmt->portalname),
 361  *                               ... other errxxx() fields as needed ...));
 362  *
 363  * The error level is required, and so is a primary error message (errmsg
 364  * or errmsg_internal).  All else is optional.  errcode() defaults to
 365  * ERRCODE_INTERNAL_ERROR if elevel is ERROR or more, ERRCODE_WARNING
 366  * if elevel is WARNING, or ERRCODE_SUCCESSFUL_COMPLETION if elevel is
 367  * NOTICE or below.
 368  *----------
 369  */
 370 #define ereport(elevel, rest)  \
 371         (errstart(elevel, __FILE__, __LINE__, PG_FUNCNAME_MACRO) ? \
 372          (errfinish rest) : (void) 0)
 373
 374 extern bool errstart(int elevel, const char *filename, int lineno,
 375                                          const char *funcname);
 376 extern void errfinish(int dummy, ...);
 377
 378 extern int errcode(int sqlerrcode);
 379
 380 extern int errcode_for_file_access(void);
 381 extern int errcode_for_socket_access(void);
 382
 383 extern int errmsg(const char *fmt, ...)
 384 /* This extension allows gcc to check the format string for consistency with
 385    the supplied arguments. */
 386 __attribute__((format(printf, 1, 2)));
 387
 388 extern int errmsg_internal(const char *fmt, ...)
 389 /* This extension allows gcc to check the format string for consistency with
 390    the supplied arguments. */
 391 __attribute__((format(printf, 1, 2)));
 392
 393 extern int errdetail(const char *fmt, ...)
 394 /* This extension allows gcc to check the format string for consistency with
 395    the supplied arguments. */
 396 __attribute__((format(printf, 1, 2)));
 397
 398 extern int errhint(const char *fmt, ...)
 399 /* This extension allows gcc to check the format string for consistency with
 400    the supplied arguments. */
 401 __attribute__((format(printf, 1, 2)));
 402
 403 extern int errcontext(const char *fmt, ...)
 404 /* This extension allows gcc to check the format string for consistency with
 405    the supplied arguments. */
 406 __attribute__((format(printf, 1, 2)));
 407
 408 extern int errfunction(const char *funcname);
 409 extern int errposition(int cursorpos);
 410
 411
 412 /*----------
 413  * Old-style error reporting API: to be used in this way:
 414  *              elog(ERROR, "portal \"%s\" not found", stmt->portalname);
 415  *----------
 416  */
 417 #define elog    errstart(ERROR, __FILE__, __LINE__, PG_FUNCNAME_MACRO), elog_finish
 418
 419 extern void
 420 elog_finish(int elevel, const char *fmt, ...)
 421 /* This extension allows gcc to check the format string for consistency with
 422    the supplied arguments. */
 423 __attribute__((format(printf, 2, 3)));
 424
 425
 426 /* Support for attaching context information to error reports */
 427
 428 typedef struct ErrorContextCallback
 429 {
 430         struct ErrorContextCallback *previous;
 431         void (*callback) (void *arg);
 432         void *arg;
 433 } ErrorContextCallback;
 434
 435 extern DLLIMPORT ErrorContextCallback *error_context_stack;
 436
 437
 438 /* GUC-configurable parameters */
 439
 440 typedef enum
 441 {
 442         PGERROR_TERSE,                          /* single-line error messages */
 443         PGERROR_DEFAULT,                        /* recommended style */
 444         PGERROR_VERBOSE                         /* all the facts, ma'am */
 445 } PGErrorVerbosity;
 446
 447 extern PGErrorVerbosity Log_error_verbosity;
 448 extern bool Log_timestamp;
 449 extern bool Log_pid;
 450 #ifdef HAVE_SYSLOG
 451 extern int      Use_syslog;
 452 #endif
 453
 454
 455 /* Other exported functions */
 456 extern void DebugFileOpen(void);
 457
 458 #endif   /* ELOG_H */