include/got_error.h

   1 /*
   2  * Copyright (c) 2018, 2019, 2020 Stefan Sperling <stsp@openbsd.org>
   3  * Copyright (c) 2020 Ori Bernstein <ori@openbsd.org>
   4  *
   5  * Permission to use, copy, modify, and distribute this software for any
   6  * purpose with or without fee is hereby granted, provided that the above
   7  * copyright notice and this permission notice appear in all copies.
   8  *
   9  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  10  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  11  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  12  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  13  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  14  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  15  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  16  */
  17
  18 #include "got_compat.h"
  19
  20 /* Error codes */
  21 #define GOT_ERR_OK              0
  22 #define GOT_ERR_ERRNO           1
  23 #define GOT_ERR_NOT_GIT_REPO    2
  24 #define GOT_ERR_BAD_FILETYPE    3
  25 #define GOT_ERR_BAD_PATH        4
  26 #define GOT_ERR_NOT_REF         5
  27 #define GOT_ERR_IO              6
  28 #define GOT_ERR_EOF             7
  29 #define GOT_ERR_DECOMPRESSION   8
  30 #define GOT_ERR_NO_SPACE        9
  31 #define GOT_ERR_BAD_OBJ_HDR     10
  32 #define GOT_ERR_OBJ_TYPE        11
  33 #define GOT_ERR_BAD_OBJ_DATA    12
  34 #define GOT_ERR_AMBIGUOUS_ID    13
  35 #define GOT_ERR_BAD_PACKIDX     14
  36 #define GOT_ERR_PACKIDX_CSUM    15
  37 #define GOT_ERR_BAD_PACKFILE    16
  38 #define GOT_ERR_NO_OBJ          17
  39 #define GOT_ERR_NOT_IMPL        18
  40 #define GOT_ERR_OBJ_NOT_PACKED  19
  41 #define GOT_ERR_BAD_DELTA_CHAIN 20
  42 #define GOT_ERR_BAD_DELTA       21
  43 #define GOT_ERR_COMPRESSION     22
  44 #define GOT_ERR_BAD_OBJ_ID_STR  23
  45 #define GOT_ERR_WORKTREE_EXISTS 26
  46 #define GOT_ERR_WORKTREE_META   27
  47 #define GOT_ERR_WORKTREE_VERS   28
  48 #define GOT_ERR_WORKTREE_BUSY   29
  49 #define GOT_ERR_DIR_OBSTRUCTED  30
  50 #define GOT_ERR_FILE_OBSTRUCTED 31
  51 #define GOT_ERR_RECURSION       32
  52 #define GOT_ERR_TIMEOUT         33
  53 #define GOT_ERR_INTERRUPT       34
  54 #define GOT_ERR_PRIVSEP_READ    35
  55 #define GOT_ERR_PRIVSEP_LEN     36
  56 #define GOT_ERR_PRIVSEP_PIPE    37
  57 #define GOT_ERR_PRIVSEP_NO_FD   38
  58 #define GOT_ERR_PRIVSEP_MSG     39
  59 #define GOT_ERR_PRIVSEP_DIED    40
  60 #define GOT_ERR_PRIVSEP_EXIT    41
  61 #define GOT_ERR_PACK_OFFSET     42
  62 #define GOT_ERR_OBJ_EXISTS      43
  63 #define GOT_ERR_BAD_OBJ_ID      44
  64 #define GOT_ERR_ITER_BUSY       45
  65 #define GOT_ERR_ITER_COMPLETED  46
  66 #define GOT_ERR_RANGE           47
  67 #define GOT_ERR_EXPECTED        48 /* for use in regress tests only */
  68 #define GOT_ERR_CANCELLED       49
  69 #define GOT_ERR_NO_TREE_ENTRY   50
  70 #define GOT_ERR_FILEIDX_SIG     51
  71 #define GOT_ERR_FILEIDX_VER     52
  72 #define GOT_ERR_FILEIDX_CSUM    53
  73 #define GOT_ERR_PATH_PREFIX     54
  74 #define GOT_ERR_ANCESTRY        55
  75 #define GOT_ERR_FILEIDX_BAD     56
  76 #define GOT_ERR_BAD_REF_DATA    57
  77 #define GOT_ERR_TREE_DUP_ENTRY  58
  78 #define GOT_ERR_DIR_DUP_ENTRY   59
  79 #define GOT_ERR_NOT_WORKTREE    60
  80 #define GOT_ERR_UUID_VERSION    61
  81 #define GOT_ERR_UUID_INVALID    62
  82 #define GOT_ERR_UUID            63
  83 #define GOT_ERR_LOCKFILE_TIMEOUT 64
  84 #define GOT_ERR_BAD_REF_NAME    65
  85 #define GOT_ERR_WORKTREE_REPO   66
  86 #define GOT_ERR_FILE_MODIFIED   67
  87 #define GOT_ERR_FILE_STATUS     68
  88 #define GOT_ERR_COMMIT_CONFLICT 69
  89 #define GOT_ERR_BAD_REF_TYPE    70
  90 #define GOT_ERR_COMMIT_NO_AUTHOR 71
  91 #define GOT_ERR_COMMIT_HEAD_CHANGED 72
  92 #define GOT_ERR_COMMIT_OUT_OF_DATE 73
  93 #define GOT_ERR_COMMIT_MSG_EMPTY 74
  94 #define GOT_ERR_DIR_NOT_EMPTY   75
  95 #define GOT_ERR_COMMIT_NO_CHANGES 76
  96 #define GOT_ERR_BRANCH_MOVED    77
  97 #define GOT_ERR_OBJ_TOO_LARGE   78
  98 #define GOT_ERR_SAME_BRANCH     79
  99 #define GOT_ERR_ROOT_COMMIT     80
 100 #define GOT_ERR_MIXED_COMMITS   81
 101 #define GOT_ERR_CONFLICTS       82
 102 #define GOT_ERR_BRANCH_EXISTS   83
 103 #define GOT_ERR_MODIFIED        84
 104 #define GOT_ERR_NOT_REBASING    85
 105 #define GOT_ERR_EMPTY_REBASE    86
 106 #define GOT_ERR_REBASE_COMMITID 87
 107 #define GOT_ERR_REBASING        88
 108 #define GOT_ERR_REBASE_PATH     89
 109 #define GOT_ERR_NOT_HISTEDIT    90
 110 #define GOT_ERR_EMPTY_HISTEDIT  91
 111 #define GOT_ERR_NO_HISTEDIT_CMD 92
 112 #define GOT_ERR_HISTEDIT_SYNTAX 93
 113 #define GOT_ERR_HISTEDIT_CANCEL 94
 114 /* 95 is currently unused */
 115 #define GOT_ERR_HISTEDIT_BUSY   96
 116 #define GOT_ERR_HISTEDIT_CMD    97
 117 #define GOT_ERR_HISTEDIT_PATH   98
 118 /* 99 is currently unused */
 119 #define GOT_ERR_COMMIT_BRANCH   100
 120 #define GOT_ERR_FILE_STAGED     101
 121 #define GOT_ERR_STAGE_NO_CHANGE 102
 122 #define GOT_ERR_STAGE_CONFLICT  103
 123 #define GOT_ERR_STAGE_OUT_OF_DATE 104
 124 #define GOT_ERR_FILE_NOT_STAGED 105
 125 #define GOT_ERR_STAGED_PATHS    106
 126 #define GOT_ERR_PATCH_CHOICE    107
 127 #define GOT_ERR_COMMIT_NO_EMAIL 108
 128 #define GOT_ERR_TAG_EXISTS      109
 129 #define GOT_ERR_GIT_REPO_FORMAT 110
 130 #define GOT_ERR_REBASE_REQUIRED 111
 131 #define GOT_ERR_REGEX           112
 132 #define GOT_ERR_REF_NAME_MINUS  113
 133 #define GOT_ERR_GITCONFIG_SYNTAX 114
 134 #define GOT_ERR_REBASE_OUT_OF_DATE 115
 135 #define GOT_ERR_CACHE_DUP_ENTRY 116
 136 #define GOT_ERR_QUERYSTRING     117
 137 #define GOT_ERR_FETCH_FAILED    118
 138 #define GOT_ERR_PARSE_URI       119
 139 #define GOT_ERR_BAD_PROTO       120
 140 #define GOT_ERR_ADDRINFO        121
 141 #define GOT_ERR_BAD_PACKET      122
 142 #define GOT_ERR_NO_REMOTE       123
 143 #define GOT_ERR_FETCH_NO_BRANCH 124
 144 #define GOT_ERR_FETCH_BAD_REF   125
 145 #define GOT_ERR_TREE_ENTRY_TYPE 126
 146 #define GOT_ERR_PARSE_CONFIG    127
 147 #define GOT_ERR_NO_CONFIG_FILE  128
 148 #define GOT_ERR_BAD_SYMLINK     129
 149 #define GOT_ERR_GIT_REPO_EXT    130
 150 #define GOT_ERR_CANNOT_PACK     131
 151 #define GOT_ERR_LONELY_PACKIDX  132
 152 #define GOT_ERR_OBJ_CSUM        133
 153 #define GOT_ERR_SEND_BAD_REF    134
 154 #define GOT_ERR_SEND_FAILED     135
 155 #define GOT_ERR_SEND_EMPTY      136
 156 #define GOT_ERR_SEND_ANCESTRY   137
 157 #define GOT_ERR_CAPA_DELETE_REFS 138
 158 #define GOT_ERR_SEND_DELETE_REF 139
 159 #define GOT_ERR_SEND_TAG_EXISTS 140
 160 #define GOT_ERR_NOT_MERGING     141
 161 #define GOT_ERR_MERGE_OUT_OF_DATE 142
 162 #define GOT_ERR_MERGE_STAGED_PATHS 143
 163 #define GOT_ERR_MERGE_COMMIT_OUT_OF_DATE 143
 164 #define GOT_ERR_MERGE_BUSY      144
 165 #define GOT_ERR_MERGE_PATH      145
 166 #define GOT_ERR_FILE_BINARY     146
 167 #define GOT_ERR_PATCH_MALFORMED 147
 168 #define GOT_ERR_PATCH_TRUNCATED 148
 169 #define GOT_ERR_NO_PATCH        149
 170 #define GOT_ERR_HUNK_FAILED     150
 171 #define GOT_ERR_PATCH_FAILED    151
 172 #define GOT_ERR_FILEIDX_DUP_ENTRY 152
 173 #define GOT_ERR_PIN_PACK        153
 174 #define GOT_ERR_BAD_TAG_SIGNATURE 154
 175 #define GOT_ERR_VERIFY_TAG_SIGNATURE 155
 176 #define GOT_ERR_SIGNING_TAG     156
 177
 178 struct got_error {
 179         int code;
 180         const char *msg;
 181 };
 182
 183 /*
 184  * Get an error object from the above list, for a given error code.
 185  * The error message is fixed.
 186  */
 187 const struct got_error *got_error(int);
 188
 189 /*
 190  * Get an error object from the above list, for a given error code.
 191  * Use the specified error message instead of the default one.
 192  * Caution: If the message buffer lives in dynamically allocated memory,
 193  * then this memory likely won't be freed.
 194  */
 195 const struct got_error *got_error_msg(int, const char *);
 196
 197 /*
 198  * Get a statically allocated error object with code GOT_ERR_ERRNO
 199  * and an error message obtained from strerror(3), prefixed with a
 200  * string.
 201  */
 202 const struct got_error *got_error_from_errno(const char *);
 203
 204 /*
 205  * Get a statically allocated error object with code GOT_ERR_ERRNO
 206  * and an error message obtained from strerror(3), prefixed with two
 207  * strings.
 208  */
 209 const struct got_error *got_error_from_errno2(const char *, const char *);
 210
 211 /*
 212  * Get a statically allocated error object with code GOT_ERR_ERRNO
 213  * and an error message obtained from strerror(3), prefixed with three
 214  * strings.
 215  */
 216 const struct got_error *got_error_from_errno3(const char *, const char *,
 217     const char *);
 218
 219 /*
 220  * Get a statically allocated error object with code GOT_ERR_ERRNO
 221  * and an error message obtained from strerror(3), prefixed with a
 222  * string built with vsnprintf(3) from the provided format string
 223  * and the variable-length list of additional arguments.
 224  */
 225 const struct got_error *got_error_from_errno_fmt(const char *, ...);
 226
 227 /*
 228  * Set errno to the specified error code and return a statically
 229  * allocated error object with code GOT_ERR_ERRNO and an error
 230  * message obtained from strerror(3), optionally prefixed with a
 231  * string.
 232  */
 233 const struct got_error *got_error_set_errno(int, const char *);
 234
 235 /*
 236  * If ferror(3) indicates an error status for the FILE, obtain an error
 237  * from got_error_from_errno(). Else, obtain the error via got_error()
 238  * with the error code provided in the second argument.
 239  */
 240 const struct got_error *got_ferror(FILE *, int);
 241
 242 /*
 243  * Obtain an error with code GOT_ERR_NO_OBJ and an error message which
 244  * contains the specified object ID. The message buffer is statically
 245  * allocated; future invocations of this function will overwrite the
 246  * message set during earlier invocations.
 247  */
 248 struct got_object_id; /* forward declaration */
 249 const struct got_error *got_error_no_obj(struct got_object_id *);
 250
 251 /*
 252  * Obtain an error with code GOT_ERR_NOT_REF and an error message which
 253  * contains the specified reference name. The message buffer is statically
 254  * allocated; future invocations of this function will overwrite the
 255  * message set during earlier invocations.
 256  */
 257 const struct got_error *got_error_not_ref(const char *);
 258
 259 /* Return an error based on a uuid(3) status code. */
 260 const struct got_error *got_error_uuid(uint32_t, const char *);
 261
 262 /* Return an error with a path prefixed to the error message. */
 263 const struct got_error *got_error_path(const char *, int);
 264
 265 /*
 266  * Return an error with an error message prefix built by vsnprintf(3)
 267  * from the provided format string and the variable-length list of
 268  * additional arguments.
 269 */
 270 const struct got_error *got_error_fmt(int, const char *, ...);
 271
 272 /*
 273  * Check whether open(2) with O_NOFOLLOW failed on a symlink.
 274  * This must be called directly after open(2) because it uses errno!
 275  */
 276 int got_err_open_nofollow_on_symlink(void);