cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 1 | /* |
| 2 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 3 | % % |
| 4 | % % |
| 5 | % % |
| 6 | % EEEEE X X CCCC EEEEE PPPP TTTTT IIIII OOO N N % |
| 7 | % E X X C E P P T I O O NN N % |
| 8 | % EEE X C EEE PPPP T I O O N N N % |
| 9 | % E X X C E P T I O O N NN % |
| 10 | % EEEEE X X CCCC EEEEE P T IIIII OOO N N % |
| 11 | % % |
| 12 | % % |
| 13 | % MagickCore Exception Methods % |
| 14 | % % |
| 15 | % Software Design % |
cristy | de984cd | 2013-12-01 14:49:27 +0000 | [diff] [blame] | 16 | % Cristy % |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 17 | % July 1993 % |
| 18 | % % |
| 19 | % % |
cristy | fe676ee | 2013-11-18 13:03:38 +0000 | [diff] [blame] | 20 | % Copyright 1999-2014 ImageMagick Studio LLC, a non-profit organization % |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 21 | % dedicated to making software imaging solutions freely available. % |
| 22 | % % |
| 23 | % You may not use this file except in compliance with the License. You may % |
| 24 | % obtain a copy of the License at % |
| 25 | % % |
| 26 | % http://www.imagemagick.org/script/license.php % |
| 27 | % % |
| 28 | % Unless required by applicable law or agreed to in writing, software % |
| 29 | % distributed under the License is distributed on an "AS IS" BASIS, % |
| 30 | % WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. % |
| 31 | % See the License for the specific language governing permissions and % |
| 32 | % limitations under the License. % |
| 33 | % % |
| 34 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 35 | % |
| 36 | % |
| 37 | % |
| 38 | */ |
| 39 | |
| 40 | /* |
| 41 | Include declarations. |
| 42 | */ |
cristy | 4c08aed | 2011-07-01 19:47:50 +0000 | [diff] [blame] | 43 | #include "MagickCore/studio.h" |
| 44 | #include "MagickCore/client.h" |
| 45 | #include "MagickCore/exception.h" |
| 46 | #include "MagickCore/exception-private.h" |
| 47 | #include "MagickCore/hashmap.h" |
| 48 | #include "MagickCore/locale_.h" |
| 49 | #include "MagickCore/log.h" |
| 50 | #include "MagickCore/magick.h" |
| 51 | #include "MagickCore/memory_.h" |
| 52 | #include "MagickCore/string_.h" |
| 53 | #include "MagickCore/utility.h" |
cristy | d1dd6e4 | 2011-09-04 01:46:08 +0000 | [diff] [blame] | 54 | #include "MagickCore/utility-private.h" |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 55 | |
| 56 | /* |
| 57 | Forward declarations. |
| 58 | */ |
| 59 | #if defined(__cplusplus) || defined(c_plusplus) |
| 60 | extern "C" { |
| 61 | #endif |
| 62 | |
| 63 | static void |
| 64 | DefaultErrorHandler(const ExceptionType,const char *,const char *), |
| 65 | DefaultFatalErrorHandler(const ExceptionType,const char *,const char *), |
| 66 | DefaultWarningHandler(const ExceptionType,const char *,const char *); |
| 67 | |
| 68 | #if defined(__cplusplus) || defined(c_plusplus) |
| 69 | } |
| 70 | #endif |
| 71 | |
| 72 | /* |
| 73 | Global declarations. |
| 74 | */ |
| 75 | static ErrorHandler |
| 76 | error_handler = DefaultErrorHandler; |
| 77 | |
| 78 | static FatalErrorHandler |
| 79 | fatal_error_handler = DefaultFatalErrorHandler; |
| 80 | |
| 81 | static WarningHandler |
| 82 | warning_handler = DefaultWarningHandler; |
| 83 | |
| 84 | /* |
| 85 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 86 | % % |
| 87 | % % |
| 88 | % % |
| 89 | % A c q u i r e E x c e p t i o n I n f o % |
| 90 | % % |
| 91 | % % |
| 92 | % % |
| 93 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 94 | % |
| 95 | % AcquireExceptionInfo() allocates the ExceptionInfo structure. |
| 96 | % |
| 97 | % The format of the AcquireExceptionInfo method is: |
| 98 | % |
| 99 | % ExceptionInfo *AcquireExceptionInfo(void) |
| 100 | % |
| 101 | */ |
| 102 | MagickExport ExceptionInfo *AcquireExceptionInfo(void) |
| 103 | { |
| 104 | ExceptionInfo |
| 105 | *exception; |
| 106 | |
cristy | 73bd4a5 | 2010-10-05 11:24:23 +0000 | [diff] [blame] | 107 | exception=(ExceptionInfo *) AcquireMagickMemory(sizeof(*exception)); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 108 | if (exception == (ExceptionInfo *) NULL) |
| 109 | ThrowFatalException(ResourceLimitFatalError,"MemoryAllocationFailed"); |
| 110 | GetExceptionInfo(exception); |
| 111 | exception->relinquish=MagickTrue; |
| 112 | return(exception); |
| 113 | } |
| 114 | |
| 115 | /* |
| 116 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 117 | % % |
| 118 | % % |
| 119 | % % |
| 120 | % C l e a r M a g i c k E x c e p t i o n % |
| 121 | % % |
| 122 | % % |
| 123 | % % |
| 124 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 125 | % |
| 126 | % ClearMagickException() clears any exception that may not have been caught |
| 127 | % yet. |
| 128 | % |
| 129 | % The format of the ClearMagickException method is: |
| 130 | % |
| 131 | % ClearMagickException(ExceptionInfo *exception) |
| 132 | % |
| 133 | % A description of each parameter follows: |
| 134 | % |
| 135 | % o exception: the exception info. |
| 136 | % |
| 137 | */ |
| 138 | |
| 139 | static void *DestroyExceptionElement(void *exception) |
| 140 | { |
| 141 | register ExceptionInfo |
| 142 | *p; |
| 143 | |
| 144 | p=(ExceptionInfo *) exception; |
| 145 | if (p->reason != (char *) NULL) |
| 146 | p->reason=DestroyString(p->reason); |
| 147 | if (p->description != (char *) NULL) |
| 148 | p->description=DestroyString(p->description); |
| 149 | p=(ExceptionInfo *) RelinquishMagickMemory(p); |
| 150 | return((void *) NULL); |
| 151 | } |
| 152 | |
| 153 | MagickExport void ClearMagickException(ExceptionInfo *exception) |
| 154 | { |
| 155 | register ExceptionInfo |
| 156 | *p; |
| 157 | |
| 158 | assert(exception != (ExceptionInfo *) NULL); |
| 159 | assert(exception->signature == MagickSignature); |
| 160 | if (exception->exceptions == (void *) NULL) |
| 161 | return; |
cristy | f84a193 | 2010-01-03 18:00:18 +0000 | [diff] [blame] | 162 | LockSemaphoreInfo(exception->semaphore); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 163 | p=(ExceptionInfo *) RemoveLastElementFromLinkedList((LinkedListInfo *) |
| 164 | exception->exceptions); |
| 165 | while (p != (ExceptionInfo *) NULL) |
| 166 | { |
| 167 | (void) DestroyExceptionElement(p); |
| 168 | p=(ExceptionInfo *) RemoveLastElementFromLinkedList((LinkedListInfo *) |
| 169 | exception->exceptions); |
| 170 | } |
| 171 | exception->severity=UndefinedException; |
| 172 | exception->reason=(char *) NULL; |
| 173 | exception->description=(char *) NULL; |
cristy | f84a193 | 2010-01-03 18:00:18 +0000 | [diff] [blame] | 174 | UnlockSemaphoreInfo(exception->semaphore); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 175 | errno=0; |
| 176 | } |
| 177 | |
| 178 | /* |
| 179 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 180 | % % |
| 181 | % % |
| 182 | % % |
| 183 | % C a t c h E x c e p t i o n % |
| 184 | % % |
| 185 | % % |
| 186 | % % |
| 187 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 188 | % |
| 189 | % CatchException() returns if no exceptions is found otherwise it reports |
| 190 | % the exception as a warning, error, or fatal depending on the severity. |
| 191 | % |
| 192 | % The format of the CatchException method is: |
| 193 | % |
| 194 | % CatchException(ExceptionInfo *exception) |
| 195 | % |
| 196 | % A description of each parameter follows: |
| 197 | % |
| 198 | % o exception: the exception info. |
| 199 | % |
| 200 | */ |
| 201 | MagickExport void CatchException(ExceptionInfo *exception) |
| 202 | { |
| 203 | register const ExceptionInfo |
| 204 | *p; |
| 205 | |
| 206 | assert(exception != (ExceptionInfo *) NULL); |
| 207 | assert(exception->signature == MagickSignature); |
| 208 | if (exception->exceptions == (void *) NULL) |
| 209 | return; |
cristy | f84a193 | 2010-01-03 18:00:18 +0000 | [diff] [blame] | 210 | LockSemaphoreInfo(exception->semaphore); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 211 | ResetLinkedListIterator((LinkedListInfo *) exception->exceptions); |
| 212 | p=(const ExceptionInfo *) GetNextValueInLinkedList((LinkedListInfo *) |
| 213 | exception->exceptions); |
| 214 | while (p != (const ExceptionInfo *) NULL) |
| 215 | { |
| 216 | if ((p->severity >= WarningException) && (p->severity < ErrorException)) |
| 217 | MagickWarning(p->severity,p->reason,p->description); |
| 218 | if ((p->severity >= ErrorException) && (p->severity < FatalErrorException)) |
| 219 | MagickError(p->severity,p->reason,p->description); |
cristy | 32cca40 | 2010-01-23 04:02:23 +0000 | [diff] [blame] | 220 | if (p->severity >= FatalErrorException) |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 221 | MagickFatalError(p->severity,p->reason,p->description); |
| 222 | p=(const ExceptionInfo *) GetNextValueInLinkedList((LinkedListInfo *) |
| 223 | exception->exceptions); |
| 224 | } |
cristy | f84a193 | 2010-01-03 18:00:18 +0000 | [diff] [blame] | 225 | UnlockSemaphoreInfo(exception->semaphore); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 226 | ClearMagickException(exception); |
| 227 | } |
| 228 | |
| 229 | /* |
| 230 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 231 | % % |
| 232 | % % |
| 233 | % % |
cristy | c82a27b | 2011-10-21 01:07:16 +0000 | [diff] [blame] | 234 | % C l o n e E x c e p t i o n I n f o % |
| 235 | % % |
| 236 | % % |
| 237 | % % |
| 238 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 239 | % |
| 240 | % CloneExceptionInfo() clones the ExceptionInfo structure. |
| 241 | % |
| 242 | % The format of the CloneExceptionInfo method is: |
| 243 | % |
| 244 | % ExceptionInfo *CloneException(ExceptionInfo *exception) |
| 245 | % |
| 246 | % A description of each parameter follows: |
| 247 | % |
| 248 | % o exception: the exception info. |
| 249 | % |
| 250 | */ |
| 251 | MagickExport ExceptionInfo *CloneExceptionInfo(ExceptionInfo *exception) |
| 252 | { |
| 253 | ExceptionInfo |
| 254 | *clone_exception; |
| 255 | |
| 256 | clone_exception=(ExceptionInfo *) AcquireMagickMemory(sizeof(*exception)); |
| 257 | if (clone_exception == (ExceptionInfo *) NULL) |
| 258 | ThrowFatalException(ResourceLimitFatalError,"MemoryAllocationFailed"); |
| 259 | GetExceptionInfo(clone_exception); |
| 260 | InheritException(clone_exception,exception); |
cristy | 4592b2c | 2014-01-12 14:12:01 +0000 | [diff] [blame] | 261 | clone_exception->relinquish=MagickTrue; |
cristy | a0dfced | 2014-01-12 15:22:46 +0000 | [diff] [blame^] | 262 | return(clone_exception); |
cristy | c82a27b | 2011-10-21 01:07:16 +0000 | [diff] [blame] | 263 | } |
| 264 | |
| 265 | /* |
| 266 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 267 | % % |
| 268 | % % |
| 269 | % % |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 270 | + D e f a u l t E r r o r H a n d l e r % |
| 271 | % % |
| 272 | % % |
| 273 | % % |
| 274 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 275 | % |
| 276 | % DefaultErrorHandler() displays an error reason. |
| 277 | % |
| 278 | % The format of the DefaultErrorHandler method is: |
| 279 | % |
| 280 | % void MagickError(const ExceptionType severity,const char *reason, |
| 281 | % const char *description) |
| 282 | % |
| 283 | % A description of each parameter follows: |
| 284 | % |
| 285 | % o severity: Specifies the numeric error category. |
| 286 | % |
| 287 | % o reason: Specifies the reason to display before terminating the |
| 288 | % program. |
| 289 | % |
| 290 | % o description: Specifies any description to the reason. |
| 291 | % |
| 292 | */ |
| 293 | static void DefaultErrorHandler(const ExceptionType magick_unused(severity), |
| 294 | const char *reason,const char *description) |
| 295 | { |
| 296 | if (reason == (char *) NULL) |
| 297 | return; |
cristy | b51dff5 | 2011-05-19 16:55:47 +0000 | [diff] [blame] | 298 | (void) FormatLocaleFile(stderr,"%s: %s",GetClientName(),reason); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 299 | if (description != (char *) NULL) |
cristy | b51dff5 | 2011-05-19 16:55:47 +0000 | [diff] [blame] | 300 | (void) FormatLocaleFile(stderr," (%s)",description); |
| 301 | (void) FormatLocaleFile(stderr,".\n"); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 302 | (void) fflush(stderr); |
| 303 | } |
| 304 | |
| 305 | /* |
| 306 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 307 | % % |
| 308 | % % |
| 309 | % % |
| 310 | + D e f a u l t F a t a l E r r o r H a n d l e r % |
| 311 | % % |
| 312 | % % |
| 313 | % % |
| 314 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 315 | % |
| 316 | % DefaultFatalErrorHandler() displays an error reason and then terminates the |
| 317 | % program. |
| 318 | % |
| 319 | % The format of the DefaultFatalErrorHandler method is: |
| 320 | % |
| 321 | % void MagickFatalError(const ExceptionType severity,const char *reason, |
| 322 | % const char *description) |
| 323 | % |
| 324 | % A description of each parameter follows: |
| 325 | % |
| 326 | % o severity: Specifies the numeric error category. |
| 327 | % |
cristy | b200b6c | 2012-12-13 15:20:26 +0000 | [diff] [blame] | 328 | % o reason: Specifies the reason to display before terminating the program. |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 329 | % |
| 330 | % o description: Specifies any description to the reason. |
| 331 | % |
| 332 | */ |
cristy | b200b6c | 2012-12-13 15:20:26 +0000 | [diff] [blame] | 333 | static void DefaultFatalErrorHandler(const ExceptionType severity, |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 334 | const char *reason,const char *description) |
| 335 | { |
| 336 | if (reason == (char *) NULL) |
| 337 | return; |
cristy | b51dff5 | 2011-05-19 16:55:47 +0000 | [diff] [blame] | 338 | (void) FormatLocaleFile(stderr,"%s: %s",GetClientName(),reason); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 339 | if (description != (char *) NULL) |
cristy | b51dff5 | 2011-05-19 16:55:47 +0000 | [diff] [blame] | 340 | (void) FormatLocaleFile(stderr," (%s)",description); |
| 341 | (void) FormatLocaleFile(stderr,".\n"); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 342 | (void) fflush(stderr); |
| 343 | MagickCoreTerminus(); |
cristy | b4d552c | 2012-12-13 15:42:17 +0000 | [diff] [blame] | 344 | exit((int) (severity-FatalErrorException)+1); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 345 | } |
| 346 | |
| 347 | /* |
| 348 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 349 | % % |
| 350 | % % |
| 351 | % % |
| 352 | + D e f a u l t W a r n i n g H a n d l e r % |
| 353 | % % |
| 354 | % % |
| 355 | % % |
| 356 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 357 | % |
| 358 | % DefaultWarningHandler() displays a warning reason. |
| 359 | % |
| 360 | % The format of the DefaultWarningHandler method is: |
| 361 | % |
cristy | 3b743bb | 2009-09-14 16:07:59 +0000 | [diff] [blame] | 362 | % void DefaultWarningHandler(const ExceptionType severity, |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 363 | % const char *reason,const char *description) |
| 364 | % |
| 365 | % A description of each parameter follows: |
| 366 | % |
cristy | 3b743bb | 2009-09-14 16:07:59 +0000 | [diff] [blame] | 367 | % o severity: Specifies the numeric warning category. |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 368 | % |
| 369 | % o reason: Specifies the reason to display before terminating the |
| 370 | % program. |
| 371 | % |
| 372 | % o description: Specifies any description to the reason. |
| 373 | % |
| 374 | */ |
| 375 | static void DefaultWarningHandler(const ExceptionType magick_unused(severity), |
| 376 | const char *reason,const char *description) |
| 377 | { |
| 378 | if (reason == (char *) NULL) |
| 379 | return; |
cristy | b51dff5 | 2011-05-19 16:55:47 +0000 | [diff] [blame] | 380 | (void) FormatLocaleFile(stderr,"%s: %s",GetClientName(),reason); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 381 | if (description != (char *) NULL) |
cristy | b51dff5 | 2011-05-19 16:55:47 +0000 | [diff] [blame] | 382 | (void) FormatLocaleFile(stderr," (%s)",description); |
| 383 | (void) FormatLocaleFile(stderr,".\n"); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 384 | (void) fflush(stderr); |
| 385 | } |
| 386 | |
| 387 | /* |
| 388 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 389 | % % |
| 390 | % % |
| 391 | % % |
| 392 | % D e s t r o y E x c e p t i o n I n f o % |
| 393 | % % |
| 394 | % % |
| 395 | % % |
| 396 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 397 | % |
| 398 | % DestroyExceptionInfo() deallocates memory associated with an exception. |
| 399 | % |
| 400 | % The format of the DestroyExceptionInfo method is: |
| 401 | % |
| 402 | % ExceptionInfo *DestroyExceptionInfo(ExceptionInfo *exception) |
| 403 | % |
| 404 | % A description of each parameter follows: |
| 405 | % |
| 406 | % o exception: the exception info. |
| 407 | % |
| 408 | */ |
| 409 | MagickExport ExceptionInfo *DestroyExceptionInfo(ExceptionInfo *exception) |
| 410 | { |
| 411 | MagickBooleanType |
| 412 | relinquish; |
| 413 | |
| 414 | assert(exception != (ExceptionInfo *) NULL); |
| 415 | assert(exception->signature == MagickSignature); |
cristy | 78883b2 | 2010-01-11 16:38:53 +0000 | [diff] [blame] | 416 | if (exception->semaphore == (SemaphoreInfo *) NULL) |
| 417 | AcquireSemaphoreInfo(&exception->semaphore); |
cristy | f84a193 | 2010-01-03 18:00:18 +0000 | [diff] [blame] | 418 | LockSemaphoreInfo(exception->semaphore); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 419 | exception->severity=UndefinedException; |
| 420 | if (exception->exceptions != (void *) NULL) |
| 421 | exception->exceptions=(void *) DestroyLinkedList((LinkedListInfo *) |
| 422 | exception->exceptions,DestroyExceptionElement); |
| 423 | relinquish=exception->relinquish; |
| 424 | if (exception->relinquish != MagickFalse) |
| 425 | exception->signature=(~MagickSignature); |
cristy | f84a193 | 2010-01-03 18:00:18 +0000 | [diff] [blame] | 426 | UnlockSemaphoreInfo(exception->semaphore); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 427 | DestroySemaphoreInfo(&exception->semaphore); |
| 428 | if (relinquish != MagickFalse) |
| 429 | exception=(ExceptionInfo *) RelinquishMagickMemory(exception); |
| 430 | return(exception); |
| 431 | } |
| 432 | |
| 433 | /* |
| 434 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 435 | % % |
| 436 | % % |
| 437 | % % |
| 438 | % G e t E x c e p t i o n I n f o % |
| 439 | % % |
| 440 | % % |
| 441 | % % |
| 442 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 443 | % |
| 444 | % GetExceptionInfo() initializes an exception to default values. |
| 445 | % |
| 446 | % The format of the GetExceptionInfo method is: |
| 447 | % |
| 448 | % GetExceptionInfo(ExceptionInfo *exception) |
| 449 | % |
| 450 | % A description of each parameter follows: |
| 451 | % |
| 452 | % o exception: the exception info. |
| 453 | % |
| 454 | */ |
| 455 | MagickExport void GetExceptionInfo(ExceptionInfo *exception) |
| 456 | { |
| 457 | assert(exception != (ExceptionInfo *) NULL); |
| 458 | (void) ResetMagickMemory(exception,0,sizeof(*exception)); |
| 459 | exception->severity=UndefinedException; |
| 460 | exception->exceptions=(void *) NewLinkedList(0); |
cristy | 18b1744 | 2009-10-25 18:36:48 +0000 | [diff] [blame] | 461 | exception->semaphore=AllocateSemaphoreInfo(); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 462 | exception->signature=MagickSignature; |
| 463 | } |
| 464 | |
| 465 | /* |
| 466 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 467 | % % |
| 468 | % % |
| 469 | % % |
| 470 | % G e t E x c e p t i o n M e s s a g e % |
| 471 | % % |
| 472 | % % |
| 473 | % % |
| 474 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 475 | % |
| 476 | % GetExceptionMessage() returns the error message defined by the specified |
| 477 | % error code. |
| 478 | % |
| 479 | % The format of the GetExceptionMessage method is: |
| 480 | % |
| 481 | % char *GetExceptionMessage(const int error) |
| 482 | % |
| 483 | % A description of each parameter follows: |
| 484 | % |
| 485 | % o error: the error code. |
| 486 | % |
| 487 | */ |
| 488 | MagickExport char *GetExceptionMessage(const int error) |
| 489 | { |
| 490 | char |
| 491 | exception[MaxTextExtent]; |
| 492 | |
cristy | b564169 | 2010-04-08 22:49:59 +0000 | [diff] [blame] | 493 | *exception='\0'; |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 494 | #if defined(MAGICKCORE_HAVE_STRERROR_R) |
cristy | 7d4a1d6 | 2011-10-13 15:54:12 +0000 | [diff] [blame] | 495 | #if !defined(MAGICKCORE_STRERROR_R_CHAR_P) |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 496 | (void) strerror_r(error,exception,sizeof(exception)); |
| 497 | #else |
cristy | 866a02f | 2011-09-07 12:10:32 +0000 | [diff] [blame] | 498 | (void) CopyMagickString(exception,strerror_r(error,exception, |
| 499 | sizeof(exception)),sizeof(exception)); |
| 500 | #endif |
| 501 | #else |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 502 | (void) CopyMagickString(exception,strerror(error),sizeof(exception)); |
| 503 | #endif |
| 504 | return(ConstantString(exception)); |
| 505 | } |
| 506 | |
| 507 | /* |
| 508 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 509 | % % |
| 510 | % % |
| 511 | % % |
| 512 | % G e t L o c a l e E x c e p t i o n M e s s a g e % |
| 513 | % % |
| 514 | % % |
| 515 | % % |
| 516 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 517 | % |
| 518 | % GetLocaleExceptionMessage() converts a enumerated exception severity and tag |
| 519 | % to a message in the current locale. |
| 520 | % |
| 521 | % The format of the GetLocaleExceptionMessage method is: |
| 522 | % |
| 523 | % const char *GetLocaleExceptionMessage(const ExceptionType severity, |
| 524 | % const char *tag) |
| 525 | % |
| 526 | % A description of each parameter follows: |
| 527 | % |
| 528 | % o severity: the severity of the exception. |
| 529 | % |
| 530 | % o tag: the message tag. |
| 531 | % |
| 532 | */ |
| 533 | |
| 534 | static const char *ExceptionSeverityToTag(const ExceptionType severity) |
| 535 | { |
| 536 | switch (severity) |
| 537 | { |
| 538 | case ResourceLimitWarning: return("Resource/Limit/Warning/"); |
| 539 | case TypeWarning: return("Type/Warning/"); |
| 540 | case OptionWarning: return("Option/Warning/"); |
| 541 | case DelegateWarning: return("Delegate/Warning/"); |
| 542 | case MissingDelegateWarning: return("Missing/Delegate/Warning/"); |
| 543 | case CorruptImageWarning: return("Corrupt/Image/Warning/"); |
| 544 | case FileOpenWarning: return("File/Open/Warning/"); |
| 545 | case BlobWarning: return("Blob/Warning/"); |
| 546 | case StreamWarning: return("Stream/Warning/"); |
| 547 | case CacheWarning: return("Cache/Warning/"); |
| 548 | case CoderWarning: return("Coder/Warning/"); |
cristy | 992729d | 2010-01-01 15:45:06 +0000 | [diff] [blame] | 549 | case FilterWarning: return("Filter/Warning/"); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 550 | case ModuleWarning: return("Module/Warning/"); |
| 551 | case DrawWarning: return("Draw/Warning/"); |
| 552 | case ImageWarning: return("Image/Warning/"); |
| 553 | case WandWarning: return("Wand/Warning/"); |
| 554 | case XServerWarning: return("XServer/Warning/"); |
| 555 | case MonitorWarning: return("Monitor/Warning/"); |
| 556 | case RegistryWarning: return("Registry/Warning/"); |
| 557 | case ConfigureWarning: return("Configure/Warning/"); |
| 558 | case PolicyWarning: return("Policy/Warning/"); |
| 559 | case ResourceLimitError: return("Resource/Limit/Error/"); |
| 560 | case TypeError: return("Type/Error/"); |
| 561 | case OptionError: return("Option/Error/"); |
| 562 | case DelegateError: return("Delegate/Error/"); |
| 563 | case MissingDelegateError: return("Missing/Delegate/Error/"); |
| 564 | case CorruptImageError: return("Corrupt/Image/Error/"); |
| 565 | case FileOpenError: return("File/Open/Error/"); |
| 566 | case BlobError: return("Blob/Error/"); |
| 567 | case StreamError: return("Stream/Error/"); |
| 568 | case CacheError: return("Cache/Error/"); |
| 569 | case CoderError: return("Coder/Error/"); |
cristy | 992729d | 2010-01-01 15:45:06 +0000 | [diff] [blame] | 570 | case FilterError: return("Filter/Error/"); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 571 | case ModuleError: return("Module/Error/"); |
| 572 | case DrawError: return("Draw/Error/"); |
| 573 | case ImageError: return("Image/Error/"); |
| 574 | case WandError: return("Wand/Error/"); |
| 575 | case XServerError: return("XServer/Error/"); |
| 576 | case MonitorError: return("Monitor/Error/"); |
| 577 | case RegistryError: return("Registry/Error/"); |
| 578 | case ConfigureError: return("Configure/Error/"); |
| 579 | case PolicyError: return("Policy/Error/"); |
| 580 | case ResourceLimitFatalError: return("Resource/Limit/FatalError/"); |
| 581 | case TypeFatalError: return("Type/FatalError/"); |
| 582 | case OptionFatalError: return("Option/FatalError/"); |
| 583 | case DelegateFatalError: return("Delegate/FatalError/"); |
| 584 | case MissingDelegateFatalError: return("Missing/Delegate/FatalError/"); |
| 585 | case CorruptImageFatalError: return("Corrupt/Image/FatalError/"); |
| 586 | case FileOpenFatalError: return("File/Open/FatalError/"); |
| 587 | case BlobFatalError: return("Blob/FatalError/"); |
| 588 | case StreamFatalError: return("Stream/FatalError/"); |
| 589 | case CacheFatalError: return("Cache/FatalError/"); |
| 590 | case CoderFatalError: return("Coder/FatalError/"); |
cristy | 992729d | 2010-01-01 15:45:06 +0000 | [diff] [blame] | 591 | case FilterFatalError: return("Filter/FatalError/"); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 592 | case ModuleFatalError: return("Module/FatalError/"); |
| 593 | case DrawFatalError: return("Draw/FatalError/"); |
| 594 | case ImageFatalError: return("Image/FatalError/"); |
| 595 | case WandFatalError: return("Wand/FatalError/"); |
| 596 | case XServerFatalError: return("XServer/FatalError/"); |
| 597 | case MonitorFatalError: return("Monitor/FatalError/"); |
| 598 | case RegistryFatalError: return("Registry/FatalError/"); |
| 599 | case ConfigureFatalError: return("Configure/FatalError/"); |
| 600 | case PolicyFatalError: return("Policy/FatalError/"); |
| 601 | default: break; |
| 602 | } |
| 603 | return(""); |
| 604 | } |
| 605 | |
| 606 | MagickExport const char *GetLocaleExceptionMessage(const ExceptionType severity, |
| 607 | const char *tag) |
| 608 | { |
| 609 | char |
| 610 | message[MaxTextExtent]; |
| 611 | |
| 612 | const char |
| 613 | *locale_message; |
| 614 | |
| 615 | assert(tag != (const char *) NULL); |
cristy | b51dff5 | 2011-05-19 16:55:47 +0000 | [diff] [blame] | 616 | (void) FormatLocaleString(message,MaxTextExtent,"Exception/%s%s", |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 617 | ExceptionSeverityToTag(severity),tag); |
| 618 | locale_message=GetLocaleMessage(message); |
| 619 | if (locale_message == (const char *) NULL) |
| 620 | return(tag); |
| 621 | if (locale_message == message) |
| 622 | return(tag); |
| 623 | return(locale_message); |
| 624 | } |
| 625 | |
| 626 | /* |
| 627 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 628 | % % |
| 629 | % % |
| 630 | % % |
| 631 | % I n h e r i t E x c e p t i o n % |
| 632 | % % |
| 633 | % % |
| 634 | % % |
| 635 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 636 | % |
| 637 | % InheritException() inherits an exception from a related exception. |
| 638 | % |
| 639 | % The format of the InheritException method is: |
| 640 | % |
| 641 | % InheritException(ExceptionInfo *exception,const ExceptionInfo *relative) |
| 642 | % |
| 643 | % A description of each parameter follows: |
| 644 | % |
| 645 | % o exception: the exception info. |
| 646 | % |
| 647 | % o relative: the related exception info. |
| 648 | % |
| 649 | */ |
| 650 | MagickExport void InheritException(ExceptionInfo *exception, |
| 651 | const ExceptionInfo *relative) |
| 652 | { |
| 653 | register const ExceptionInfo |
| 654 | *p; |
| 655 | |
| 656 | assert(exception != (ExceptionInfo *) NULL); |
| 657 | assert(exception->signature == MagickSignature); |
| 658 | assert(relative != (ExceptionInfo *) NULL); |
| 659 | assert(relative->signature == MagickSignature); |
| 660 | if (relative->exceptions == (void *) NULL) |
| 661 | return; |
cristy | 9367040 | 2013-02-19 12:42:11 +0000 | [diff] [blame] | 662 | LockSemaphoreInfo(relative->semaphore); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 663 | ResetLinkedListIterator((LinkedListInfo *) relative->exceptions); |
| 664 | p=(const ExceptionInfo *) GetNextValueInLinkedList((LinkedListInfo *) |
| 665 | relative->exceptions); |
| 666 | while (p != (const ExceptionInfo *) NULL) |
| 667 | { |
| 668 | (void) ThrowException(exception,p->severity,p->reason,p->description); |
| 669 | p=(const ExceptionInfo *) GetNextValueInLinkedList((LinkedListInfo *) |
| 670 | relative->exceptions); |
| 671 | } |
cristy | 9367040 | 2013-02-19 12:42:11 +0000 | [diff] [blame] | 672 | UnlockSemaphoreInfo(relative->semaphore); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 673 | } |
| 674 | |
| 675 | /* |
| 676 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 677 | % % |
| 678 | % % |
| 679 | % % |
| 680 | % M a g i c k E r r o r % |
| 681 | % % |
| 682 | % % |
| 683 | % % |
| 684 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 685 | % |
| 686 | % MagickError() calls the exception handler methods with an error reason. |
| 687 | % |
| 688 | % The format of the MagickError method is: |
| 689 | % |
| 690 | % void MagickError(const ExceptionType error,const char *reason, |
| 691 | % const char *description) |
| 692 | % |
| 693 | % A description of each parameter follows: |
| 694 | % |
| 695 | % o exception: Specifies the numeric error category. |
| 696 | % |
| 697 | % o reason: Specifies the reason to display before terminating the |
| 698 | % program. |
| 699 | % |
| 700 | % o description: Specifies any description to the reason. |
| 701 | % |
| 702 | */ |
| 703 | MagickExport void MagickError(const ExceptionType error,const char *reason, |
| 704 | const char *description) |
| 705 | { |
| 706 | if (error_handler != (ErrorHandler) NULL) |
| 707 | (*error_handler)(error,reason,description); |
| 708 | } |
| 709 | |
| 710 | /* |
| 711 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 712 | % % |
| 713 | % % |
| 714 | % % |
| 715 | % M a g i c k F a t al E r r o r % |
| 716 | % % |
| 717 | % % |
| 718 | % % |
| 719 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 720 | % |
| 721 | % MagickFatalError() calls the fatal exception handler methods with an error |
| 722 | % reason. |
| 723 | % |
| 724 | % The format of the MagickError method is: |
| 725 | % |
| 726 | % void MagickFatalError(const ExceptionType error,const char *reason, |
| 727 | % const char *description) |
| 728 | % |
| 729 | % A description of each parameter follows: |
| 730 | % |
| 731 | % o exception: Specifies the numeric error category. |
| 732 | % |
| 733 | % o reason: Specifies the reason to display before terminating the |
| 734 | % program. |
| 735 | % |
| 736 | % o description: Specifies any description to the reason. |
| 737 | % |
| 738 | */ |
| 739 | MagickExport void MagickFatalError(const ExceptionType error,const char *reason, |
| 740 | const char *description) |
| 741 | { |
| 742 | if (fatal_error_handler != (ErrorHandler) NULL) |
| 743 | (*fatal_error_handler)(error,reason,description); |
| 744 | } |
| 745 | |
| 746 | /* |
| 747 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 748 | % % |
| 749 | % % |
| 750 | % % |
| 751 | % M a g i c k W a r n i n g % |
| 752 | % % |
| 753 | % % |
| 754 | % % |
| 755 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 756 | % |
| 757 | % MagickWarning() calls the warning handler methods with a warning reason. |
| 758 | % |
| 759 | % The format of the MagickWarning method is: |
| 760 | % |
| 761 | % void MagickWarning(const ExceptionType warning,const char *reason, |
| 762 | % const char *description) |
| 763 | % |
| 764 | % A description of each parameter follows: |
| 765 | % |
| 766 | % o warning: the warning severity. |
| 767 | % |
| 768 | % o reason: Define the reason for the warning. |
| 769 | % |
| 770 | % o description: Describe the warning. |
| 771 | % |
| 772 | */ |
| 773 | MagickExport void MagickWarning(const ExceptionType warning,const char *reason, |
| 774 | const char *description) |
| 775 | { |
| 776 | if (warning_handler != (WarningHandler) NULL) |
| 777 | (*warning_handler)(warning,reason,description); |
| 778 | } |
| 779 | |
| 780 | /* |
| 781 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 782 | % % |
| 783 | % % |
| 784 | % % |
| 785 | % S e t E r r o r H a n d l e r % |
| 786 | % % |
| 787 | % % |
| 788 | % % |
| 789 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 790 | % |
| 791 | % SetErrorHandler() sets the exception handler to the specified method |
| 792 | % and returns the previous exception handler. |
| 793 | % |
| 794 | % The format of the SetErrorHandler method is: |
| 795 | % |
| 796 | % ErrorHandler SetErrorHandler(ErrorHandler handler) |
| 797 | % |
| 798 | % A description of each parameter follows: |
| 799 | % |
| 800 | % o handler: the method to handle errors. |
| 801 | % |
| 802 | */ |
| 803 | MagickExport ErrorHandler SetErrorHandler(ErrorHandler handler) |
| 804 | { |
| 805 | ErrorHandler |
| 806 | previous_handler; |
| 807 | |
| 808 | previous_handler=error_handler; |
| 809 | error_handler=handler; |
| 810 | return(previous_handler); |
| 811 | } |
| 812 | |
| 813 | /* |
| 814 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 815 | % % |
| 816 | % % |
| 817 | % % |
| 818 | % S e t F a t a l E r r o r H a n d l e r % |
| 819 | % % |
| 820 | % % |
| 821 | % % |
| 822 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 823 | % |
| 824 | % SetFatalErrorHandler() sets the fatal exception handler to the specified |
| 825 | % method and returns the previous fatal exception handler. |
| 826 | % |
| 827 | % The format of the SetErrorHandler method is: |
| 828 | % |
| 829 | % ErrorHandler SetErrorHandler(ErrorHandler handler) |
| 830 | % |
| 831 | % A description of each parameter follows: |
| 832 | % |
| 833 | % o handler: the method to handle errors. |
| 834 | % |
| 835 | */ |
| 836 | MagickExport FatalErrorHandler SetFatalErrorHandler(FatalErrorHandler handler) |
| 837 | { |
| 838 | FatalErrorHandler |
| 839 | previous_handler; |
| 840 | |
| 841 | previous_handler=fatal_error_handler; |
| 842 | fatal_error_handler=handler; |
| 843 | return(previous_handler); |
| 844 | } |
| 845 | |
| 846 | /* |
| 847 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 848 | % % |
| 849 | % % |
| 850 | % % |
| 851 | % S e t W a r n i n g H a n d l e r % |
| 852 | % % |
| 853 | % % |
| 854 | % % |
| 855 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 856 | % |
| 857 | % SetWarningHandler() sets the warning handler to the specified method |
| 858 | % and returns the previous warning handler. |
| 859 | % |
| 860 | % The format of the SetWarningHandler method is: |
| 861 | % |
| 862 | % ErrorHandler SetWarningHandler(ErrorHandler handler) |
| 863 | % |
| 864 | % A description of each parameter follows: |
| 865 | % |
| 866 | % o handler: the method to handle warnings. |
| 867 | % |
| 868 | */ |
| 869 | MagickExport WarningHandler SetWarningHandler(WarningHandler handler) |
| 870 | { |
| 871 | WarningHandler |
| 872 | previous_handler; |
| 873 | |
| 874 | previous_handler=warning_handler; |
| 875 | warning_handler=handler; |
| 876 | return(previous_handler); |
| 877 | } |
| 878 | |
| 879 | /* |
| 880 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 881 | % % |
| 882 | % % |
| 883 | % % |
| 884 | % T h r o w E x c e p t i o n % |
| 885 | % % |
| 886 | % % |
| 887 | % % |
| 888 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 889 | % |
| 890 | % ThrowException() throws an exception with the specified severity code, |
| 891 | % reason, and optional description. |
| 892 | % |
| 893 | % The format of the ThrowException method is: |
| 894 | % |
| 895 | % MagickBooleanType ThrowException(ExceptionInfo *exception, |
| 896 | % const ExceptionType severity,const char *reason, |
| 897 | % const char *description) |
| 898 | % |
| 899 | % A description of each parameter follows: |
| 900 | % |
| 901 | % o exception: the exception info. |
| 902 | % |
| 903 | % o severity: the severity of the exception. |
| 904 | % |
| 905 | % o reason: the reason for the exception. |
| 906 | % |
| 907 | % o description: the exception description. |
| 908 | % |
| 909 | */ |
| 910 | MagickExport MagickBooleanType ThrowException(ExceptionInfo *exception, |
| 911 | const ExceptionType severity,const char *reason,const char *description) |
| 912 | { |
| 913 | register ExceptionInfo |
| 914 | *p; |
| 915 | |
| 916 | assert(exception != (ExceptionInfo *) NULL); |
| 917 | assert(exception->signature == MagickSignature); |
cristy | 9367040 | 2013-02-19 12:42:11 +0000 | [diff] [blame] | 918 | LockSemaphoreInfo(exception->semaphore); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 919 | p=(ExceptionInfo *) GetLastValueInLinkedList((LinkedListInfo *) |
| 920 | exception->exceptions); |
| 921 | if ((p != (ExceptionInfo *) NULL) && (p->severity == severity) && |
| 922 | (LocaleCompare(exception->reason,reason) == 0) && |
| 923 | (LocaleCompare(exception->description,description) == 0)) |
cristy | 9367040 | 2013-02-19 12:42:11 +0000 | [diff] [blame] | 924 | { |
| 925 | UnlockSemaphoreInfo(exception->semaphore); |
| 926 | return(MagickTrue); |
| 927 | } |
cristy | 73bd4a5 | 2010-10-05 11:24:23 +0000 | [diff] [blame] | 928 | p=(ExceptionInfo *) AcquireMagickMemory(sizeof(*p)); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 929 | if (p == (ExceptionInfo *) NULL) |
cristy | 9367040 | 2013-02-19 12:42:11 +0000 | [diff] [blame] | 930 | { |
| 931 | UnlockSemaphoreInfo(exception->semaphore); |
| 932 | ThrowFatalException(ResourceLimitFatalError,"MemoryAllocationFailed"); |
| 933 | } |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 934 | (void) ResetMagickMemory(p,0,sizeof(*p)); |
| 935 | p->severity=severity; |
| 936 | if (reason != (const char *) NULL) |
| 937 | p->reason=ConstantString(reason); |
| 938 | if (description != (const char *) NULL) |
| 939 | p->description=ConstantString(description); |
| 940 | p->signature=MagickSignature; |
| 941 | (void) AppendValueToLinkedList((LinkedListInfo *) exception->exceptions,p); |
cristy | 992f537 | 2013-05-15 12:20:19 +0000 | [diff] [blame] | 942 | if (p->severity >= exception->severity) |
| 943 | { |
| 944 | exception->severity=p->severity; |
| 945 | exception->reason=p->reason; |
| 946 | exception->description=p->description; |
| 947 | } |
cristy | 9367040 | 2013-02-19 12:42:11 +0000 | [diff] [blame] | 948 | UnlockSemaphoreInfo(exception->semaphore); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 949 | return(MagickTrue); |
| 950 | } |
| 951 | |
| 952 | /* |
| 953 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 954 | % % |
| 955 | % % |
| 956 | % % |
| 957 | % T h r o w M a g i c k E x c e p t i o n % |
| 958 | % % |
| 959 | % % |
| 960 | % % |
| 961 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| 962 | % |
anthony | 5216f82 | 2012-04-10 13:02:37 +0000 | [diff] [blame] | 963 | % ThrowMagickException logs an exception as determined by the log |
| 964 | % configuration file. If an error occurs, MagickFalse is returned |
| 965 | % otherwise MagickTrue. |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 966 | % |
| 967 | % The format of the ThrowMagickException method is: |
| 968 | % |
| 969 | % MagickBooleanType ThrowFileException(ExceptionInfo *exception, |
cristy | bb50337 | 2010-05-27 20:51:26 +0000 | [diff] [blame] | 970 | % const char *module,const char *function,const size_t line, |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 971 | % const ExceptionType severity,const char *tag,const char *format,...) |
| 972 | % |
| 973 | % A description of each parameter follows: |
| 974 | % |
| 975 | % o exception: the exception info. |
| 976 | % |
| 977 | % o filename: the source module filename. |
| 978 | % |
| 979 | % o function: the function name. |
| 980 | % |
| 981 | % o line: the line number of the source module. |
| 982 | % |
| 983 | % o severity: Specifies the numeric error category. |
| 984 | % |
| 985 | % o tag: the locale tag. |
| 986 | % |
| 987 | % o format: the output format. |
| 988 | % |
| 989 | */ |
| 990 | |
cristy | 9367040 | 2013-02-19 12:42:11 +0000 | [diff] [blame] | 991 | MagickExport MagickBooleanType ThrowMagickExceptionList( |
| 992 | ExceptionInfo *exception,const char *module,const char *function, |
| 993 | const size_t line,const ExceptionType severity,const char *tag, |
| 994 | const char *format,va_list operands) |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 995 | { |
| 996 | char |
| 997 | message[MaxTextExtent], |
| 998 | path[MaxTextExtent], |
| 999 | reason[MaxTextExtent]; |
| 1000 | |
| 1001 | const char |
cristy | 32cca40 | 2010-01-23 04:02:23 +0000 | [diff] [blame] | 1002 | *locale, |
| 1003 | *type; |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 1004 | |
| 1005 | int |
| 1006 | n; |
| 1007 | |
| 1008 | MagickBooleanType |
| 1009 | status; |
| 1010 | |
| 1011 | size_t |
| 1012 | length; |
| 1013 | |
| 1014 | assert(exception != (ExceptionInfo *) NULL); |
| 1015 | assert(exception->signature == MagickSignature); |
| 1016 | locale=GetLocaleExceptionMessage(severity,tag); |
| 1017 | (void) CopyMagickString(reason,locale,MaxTextExtent); |
| 1018 | (void) ConcatenateMagickString(reason," ",MaxTextExtent); |
| 1019 | length=strlen(reason); |
| 1020 | #if defined(MAGICKCORE_HAVE_VSNPRINTF) |
| 1021 | n=vsnprintf(reason+length,MaxTextExtent-length,format,operands); |
| 1022 | #else |
| 1023 | n=vsprintf(reason+length,format,operands); |
| 1024 | #endif |
| 1025 | if (n < 0) |
| 1026 | reason[MaxTextExtent-1]='\0'; |
| 1027 | status=LogMagickEvent(ExceptionEvent,module,function,line,"%s",reason); |
| 1028 | GetPathComponent(module,TailPath,path); |
cristy | 32cca40 | 2010-01-23 04:02:23 +0000 | [diff] [blame] | 1029 | type="undefined"; |
| 1030 | if ((severity >= WarningException) && (severity < ErrorException)) |
| 1031 | type="warning"; |
| 1032 | if ((severity >= ErrorException) && (severity < FatalErrorException)) |
| 1033 | type="error"; |
| 1034 | if (severity >= FatalErrorException) |
| 1035 | type="fatal"; |
cristy | b51dff5 | 2011-05-19 16:55:47 +0000 | [diff] [blame] | 1036 | (void) FormatLocaleString(message,MaxTextExtent,"%s @ %s/%s/%s/%.20g",reason, |
cristy | e8c25f9 | 2010-06-03 00:53:06 +0000 | [diff] [blame] | 1037 | type,path,function,(double) line); |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 1038 | (void) ThrowException(exception,severity,message,(char *) NULL); |
| 1039 | return(status); |
| 1040 | } |
| 1041 | |
| 1042 | MagickExport MagickBooleanType ThrowMagickException(ExceptionInfo *exception, |
cristy | bb50337 | 2010-05-27 20:51:26 +0000 | [diff] [blame] | 1043 | const char *module,const char *function,const size_t line, |
cristy | 3ed852e | 2009-09-05 21:47:34 +0000 | [diff] [blame] | 1044 | const ExceptionType severity,const char *tag,const char *format,...) |
| 1045 | { |
| 1046 | MagickBooleanType |
| 1047 | status; |
| 1048 | |
| 1049 | va_list |
| 1050 | operands; |
| 1051 | |
| 1052 | va_start(operands,format); |
| 1053 | status=ThrowMagickExceptionList(exception,module,function,line,severity,tag, |
| 1054 | format,operands); |
| 1055 | va_end(operands); |
| 1056 | return(status); |
| 1057 | } |