2 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
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 %
13 % MagickCore Exception Methods %
20 % Copyright 1999-2010 ImageMagick Studio LLC, a non-profit organization %
21 % dedicated to making software imaging solutions freely available. %
23 % You may not use this file except in compliance with the License. You may %
24 % obtain a copy of the License at %
26 % http://www.imagemagick.org/script/license.php %
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. %
34 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
43 #include "magick/studio.h"
44 #include "magick/client.h"
45 #include "magick/exception.h"
46 #include "magick/exception-private.h"
47 #include "magick/hashmap.h"
48 #include "magick/locale_.h"
49 #include "magick/log.h"
50 #include "magick/magick.h"
51 #include "magick/memory_.h"
52 #include "magick/string_.h"
53 #include "magick/utility.h"
58 #if defined(__cplusplus) || defined(c_plusplus)
63 DefaultErrorHandler(const ExceptionType,const char *,const char *),
64 DefaultFatalErrorHandler(const ExceptionType,const char *,const char *),
65 DefaultWarningHandler(const ExceptionType,const char *,const char *);
67 #if defined(__cplusplus) || defined(c_plusplus)
75 error_handler = DefaultErrorHandler;
77 static FatalErrorHandler
78 fatal_error_handler = DefaultFatalErrorHandler;
81 warning_handler = DefaultWarningHandler;
84 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
88 % A c q u i r e E x c e p t i o n I n f o %
92 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
94 % AcquireExceptionInfo() allocates the ExceptionInfo structure.
96 % The format of the AcquireExceptionInfo method is:
98 % ExceptionInfo *AcquireExceptionInfo(void)
101 MagickExport ExceptionInfo *AcquireExceptionInfo(void)
106 exception=(ExceptionInfo *) AcquireMagickMemory(sizeof(*exception));
107 if (exception == (ExceptionInfo *) NULL)
108 ThrowFatalException(ResourceLimitFatalError,"MemoryAllocationFailed");
109 GetExceptionInfo(exception);
110 exception->relinquish=MagickTrue;
115 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
119 % C l e a r M a g i c k E x c e p t i o n %
123 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
125 % ClearMagickException() clears any exception that may not have been caught
128 % The format of the ClearMagickException method is:
130 % ClearMagickException(ExceptionInfo *exception)
132 % A description of each parameter follows:
134 % o exception: the exception info.
138 static void *DestroyExceptionElement(void *exception)
140 register ExceptionInfo
143 p=(ExceptionInfo *) exception;
144 if (p->reason != (char *) NULL)
145 p->reason=DestroyString(p->reason);
146 if (p->description != (char *) NULL)
147 p->description=DestroyString(p->description);
148 p=(ExceptionInfo *) RelinquishMagickMemory(p);
149 return((void *) NULL);
152 MagickExport void ClearMagickException(ExceptionInfo *exception)
154 register ExceptionInfo
157 assert(exception != (ExceptionInfo *) NULL);
158 assert(exception->signature == MagickSignature);
159 if (exception->exceptions == (void *) NULL)
161 LockSemaphoreInfo(exception->semaphore);
162 p=(ExceptionInfo *) RemoveLastElementFromLinkedList((LinkedListInfo *)
163 exception->exceptions);
164 while (p != (ExceptionInfo *) NULL)
166 (void) DestroyExceptionElement(p);
167 p=(ExceptionInfo *) RemoveLastElementFromLinkedList((LinkedListInfo *)
168 exception->exceptions);
170 exception->severity=UndefinedException;
171 exception->reason=(char *) NULL;
172 exception->description=(char *) NULL;
173 UnlockSemaphoreInfo(exception->semaphore);
178 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
182 % C a t c h E x c e p t i o n %
186 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
188 % CatchException() returns if no exceptions is found otherwise it reports
189 % the exception as a warning, error, or fatal depending on the severity.
191 % The format of the CatchException method is:
193 % CatchException(ExceptionInfo *exception)
195 % A description of each parameter follows:
197 % o exception: the exception info.
200 MagickExport void CatchException(ExceptionInfo *exception)
202 register const ExceptionInfo
205 assert(exception != (ExceptionInfo *) NULL);
206 assert(exception->signature == MagickSignature);
207 if (exception->exceptions == (void *) NULL)
209 LockSemaphoreInfo(exception->semaphore);
210 ResetLinkedListIterator((LinkedListInfo *) exception->exceptions);
211 p=(const ExceptionInfo *) GetNextValueInLinkedList((LinkedListInfo *)
212 exception->exceptions);
213 while (p != (const ExceptionInfo *) NULL)
215 if ((p->severity >= WarningException) && (p->severity < ErrorException))
216 MagickWarning(p->severity,p->reason,p->description);
217 if ((p->severity >= ErrorException) && (p->severity < FatalErrorException))
218 MagickError(p->severity,p->reason,p->description);
219 if (p->severity >= FatalErrorException)
220 MagickFatalError(p->severity,p->reason,p->description);
221 p=(const ExceptionInfo *) GetNextValueInLinkedList((LinkedListInfo *)
222 exception->exceptions);
224 UnlockSemaphoreInfo(exception->semaphore);
225 ClearMagickException(exception);
229 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
233 + D e f a u l t E r r o r H a n d l e r %
237 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
239 % DefaultErrorHandler() displays an error reason.
241 % The format of the DefaultErrorHandler method is:
243 % void MagickError(const ExceptionType severity,const char *reason,
244 % const char *description)
246 % A description of each parameter follows:
248 % o severity: Specifies the numeric error category.
250 % o reason: Specifies the reason to display before terminating the
253 % o description: Specifies any description to the reason.
256 static void DefaultErrorHandler(const ExceptionType magick_unused(severity),
257 const char *reason,const char *description)
259 if (reason == (char *) NULL)
261 (void) fprintf(stderr,"%s: %s",GetClientName(),reason);
262 if (description != (char *) NULL)
263 (void) fprintf(stderr," (%s)",description);
264 (void) fprintf(stderr,".\n");
265 (void) fflush(stderr);
269 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
273 + D e f a u l t F a t a l E r r o r H a n d l e r %
277 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
279 % DefaultFatalErrorHandler() displays an error reason and then terminates the
282 % The format of the DefaultFatalErrorHandler method is:
284 % void MagickFatalError(const ExceptionType severity,const char *reason,
285 % const char *description)
287 % A description of each parameter follows:
289 % o severity: Specifies the numeric error category.
291 % o reason: Specifies the reason to display before terminating the
294 % o description: Specifies any description to the reason.
297 static void DefaultFatalErrorHandler(
298 const ExceptionType magick_unused(severity),
299 const char *reason,const char *description)
301 if (reason == (char *) NULL)
303 (void) fprintf(stderr,"%s: %s",GetClientName(),reason);
304 if (description != (char *) NULL)
305 (void) fprintf(stderr," (%s)",description);
306 (void) fprintf(stderr,".\n");
307 (void) fflush(stderr);
308 MagickCoreTerminus();
313 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
317 + D e f a u l t W a r n i n g H a n d l e r %
321 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
323 % DefaultWarningHandler() displays a warning reason.
325 % The format of the DefaultWarningHandler method is:
327 % void DefaultWarningHandler(const ExceptionType severity,
328 % const char *reason,const char *description)
330 % A description of each parameter follows:
332 % o severity: Specifies the numeric warning category.
334 % o reason: Specifies the reason to display before terminating the
337 % o description: Specifies any description to the reason.
340 static void DefaultWarningHandler(const ExceptionType magick_unused(severity),
341 const char *reason,const char *description)
343 if (reason == (char *) NULL)
345 (void) fprintf(stderr,"%s: %s",GetClientName(),reason);
346 if (description != (char *) NULL)
347 (void) fprintf(stderr," (%s)",description);
348 (void) fprintf(stderr,".\n");
349 (void) fflush(stderr);
353 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
357 % D e s t r o y E x c e p t i o n I n f o %
361 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
363 % DestroyExceptionInfo() deallocates memory associated with an exception.
365 % The format of the DestroyExceptionInfo method is:
367 % ExceptionInfo *DestroyExceptionInfo(ExceptionInfo *exception)
369 % A description of each parameter follows:
371 % o exception: the exception info.
374 MagickExport ExceptionInfo *DestroyExceptionInfo(ExceptionInfo *exception)
379 assert(exception != (ExceptionInfo *) NULL);
380 assert(exception->signature == MagickSignature);
381 if (exception->semaphore == (SemaphoreInfo *) NULL)
382 AcquireSemaphoreInfo(&exception->semaphore);
383 LockSemaphoreInfo(exception->semaphore);
384 exception->severity=UndefinedException;
385 if (exception->exceptions != (void *) NULL)
386 exception->exceptions=(void *) DestroyLinkedList((LinkedListInfo *)
387 exception->exceptions,DestroyExceptionElement);
388 relinquish=exception->relinquish;
389 if (exception->relinquish != MagickFalse)
390 exception->signature=(~MagickSignature);
391 UnlockSemaphoreInfo(exception->semaphore);
392 DestroySemaphoreInfo(&exception->semaphore);
393 if (relinquish != MagickFalse)
394 exception=(ExceptionInfo *) RelinquishMagickMemory(exception);
399 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
403 % G e t E x c e p t i o n I n f o %
407 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
409 % GetExceptionInfo() initializes an exception to default values.
411 % The format of the GetExceptionInfo method is:
413 % GetExceptionInfo(ExceptionInfo *exception)
415 % A description of each parameter follows:
417 % o exception: the exception info.
420 MagickExport void GetExceptionInfo(ExceptionInfo *exception)
422 assert(exception != (ExceptionInfo *) NULL);
423 (void) ResetMagickMemory(exception,0,sizeof(*exception));
424 exception->severity=UndefinedException;
425 exception->exceptions=(void *) NewLinkedList(0);
426 exception->semaphore=AllocateSemaphoreInfo();
427 exception->signature=MagickSignature;
431 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
435 % G e t E x c e p t i o n M e s s a g e %
439 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
441 % GetExceptionMessage() returns the error message defined by the specified
444 % The format of the GetExceptionMessage method is:
446 % char *GetExceptionMessage(const int error)
448 % A description of each parameter follows:
450 % o error: the error code.
453 MagickExport char *GetExceptionMessage(const int error)
456 exception[MaxTextExtent];
459 #if defined(MAGICKCORE_HAVE_STRERROR_R)
460 (void) strerror_r(error,exception,sizeof(exception));
462 (void) CopyMagickString(exception,strerror(error),sizeof(exception));
464 return(ConstantString(exception));
468 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
472 % 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 %
476 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
478 % GetLocaleExceptionMessage() converts a enumerated exception severity and tag
479 % to a message in the current locale.
481 % The format of the GetLocaleExceptionMessage method is:
483 % const char *GetLocaleExceptionMessage(const ExceptionType severity,
486 % A description of each parameter follows:
488 % o severity: the severity of the exception.
490 % o tag: the message tag.
494 static const char *ExceptionSeverityToTag(const ExceptionType severity)
498 case ResourceLimitWarning: return("Resource/Limit/Warning/");
499 case TypeWarning: return("Type/Warning/");
500 case OptionWarning: return("Option/Warning/");
501 case DelegateWarning: return("Delegate/Warning/");
502 case MissingDelegateWarning: return("Missing/Delegate/Warning/");
503 case CorruptImageWarning: return("Corrupt/Image/Warning/");
504 case FileOpenWarning: return("File/Open/Warning/");
505 case BlobWarning: return("Blob/Warning/");
506 case StreamWarning: return("Stream/Warning/");
507 case CacheWarning: return("Cache/Warning/");
508 case CoderWarning: return("Coder/Warning/");
509 case FilterWarning: return("Filter/Warning/");
510 case ModuleWarning: return("Module/Warning/");
511 case DrawWarning: return("Draw/Warning/");
512 case ImageWarning: return("Image/Warning/");
513 case WandWarning: return("Wand/Warning/");
514 case XServerWarning: return("XServer/Warning/");
515 case MonitorWarning: return("Monitor/Warning/");
516 case RegistryWarning: return("Registry/Warning/");
517 case ConfigureWarning: return("Configure/Warning/");
518 case PolicyWarning: return("Policy/Warning/");
519 case ResourceLimitError: return("Resource/Limit/Error/");
520 case TypeError: return("Type/Error/");
521 case OptionError: return("Option/Error/");
522 case DelegateError: return("Delegate/Error/");
523 case MissingDelegateError: return("Missing/Delegate/Error/");
524 case CorruptImageError: return("Corrupt/Image/Error/");
525 case FileOpenError: return("File/Open/Error/");
526 case BlobError: return("Blob/Error/");
527 case StreamError: return("Stream/Error/");
528 case CacheError: return("Cache/Error/");
529 case CoderError: return("Coder/Error/");
530 case FilterError: return("Filter/Error/");
531 case ModuleError: return("Module/Error/");
532 case DrawError: return("Draw/Error/");
533 case ImageError: return("Image/Error/");
534 case WandError: return("Wand/Error/");
535 case XServerError: return("XServer/Error/");
536 case MonitorError: return("Monitor/Error/");
537 case RegistryError: return("Registry/Error/");
538 case ConfigureError: return("Configure/Error/");
539 case PolicyError: return("Policy/Error/");
540 case ResourceLimitFatalError: return("Resource/Limit/FatalError/");
541 case TypeFatalError: return("Type/FatalError/");
542 case OptionFatalError: return("Option/FatalError/");
543 case DelegateFatalError: return("Delegate/FatalError/");
544 case MissingDelegateFatalError: return("Missing/Delegate/FatalError/");
545 case CorruptImageFatalError: return("Corrupt/Image/FatalError/");
546 case FileOpenFatalError: return("File/Open/FatalError/");
547 case BlobFatalError: return("Blob/FatalError/");
548 case StreamFatalError: return("Stream/FatalError/");
549 case CacheFatalError: return("Cache/FatalError/");
550 case CoderFatalError: return("Coder/FatalError/");
551 case FilterFatalError: return("Filter/FatalError/");
552 case ModuleFatalError: return("Module/FatalError/");
553 case DrawFatalError: return("Draw/FatalError/");
554 case ImageFatalError: return("Image/FatalError/");
555 case WandFatalError: return("Wand/FatalError/");
556 case XServerFatalError: return("XServer/FatalError/");
557 case MonitorFatalError: return("Monitor/FatalError/");
558 case RegistryFatalError: return("Registry/FatalError/");
559 case ConfigureFatalError: return("Configure/FatalError/");
560 case PolicyFatalError: return("Policy/FatalError/");
566 MagickExport const char *GetLocaleExceptionMessage(const ExceptionType severity,
570 message[MaxTextExtent];
575 assert(tag != (const char *) NULL);
576 (void) FormatMagickString(message,MaxTextExtent,"Exception/%s%s",
577 ExceptionSeverityToTag(severity),tag);
578 locale_message=GetLocaleMessage(message);
579 if (locale_message == (const char *) NULL)
581 if (locale_message == message)
583 return(locale_message);
587 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
591 % I n h e r i t E x c e p t i o n %
595 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
597 % InheritException() inherits an exception from a related exception.
599 % The format of the InheritException method is:
601 % InheritException(ExceptionInfo *exception,const ExceptionInfo *relative)
603 % A description of each parameter follows:
605 % o exception: the exception info.
607 % o relative: the related exception info.
610 MagickExport void InheritException(ExceptionInfo *exception,
611 const ExceptionInfo *relative)
613 register const ExceptionInfo
616 assert(exception != (ExceptionInfo *) NULL);
617 assert(exception->signature == MagickSignature);
618 assert(relative != (ExceptionInfo *) NULL);
619 assert(relative->signature == MagickSignature);
620 if (relative->exceptions == (void *) NULL)
622 LockSemaphoreInfo(exception->semaphore);
623 ResetLinkedListIterator((LinkedListInfo *) relative->exceptions);
624 p=(const ExceptionInfo *) GetNextValueInLinkedList((LinkedListInfo *)
625 relative->exceptions);
626 while (p != (const ExceptionInfo *) NULL)
628 (void) ThrowException(exception,p->severity,p->reason,p->description);
629 p=(const ExceptionInfo *) GetNextValueInLinkedList((LinkedListInfo *)
630 relative->exceptions);
632 UnlockSemaphoreInfo(exception->semaphore);
636 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
640 % M a g i c k E r r o r %
644 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
646 % MagickError() calls the exception handler methods with an error reason.
648 % The format of the MagickError method is:
650 % void MagickError(const ExceptionType error,const char *reason,
651 % const char *description)
653 % A description of each parameter follows:
655 % o exception: Specifies the numeric error category.
657 % o reason: Specifies the reason to display before terminating the
660 % o description: Specifies any description to the reason.
663 MagickExport void MagickError(const ExceptionType error,const char *reason,
664 const char *description)
666 if (error_handler != (ErrorHandler) NULL)
667 (*error_handler)(error,reason,description);
671 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
675 % M a g i c k F a t al E r r o r %
679 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
681 % MagickFatalError() calls the fatal exception handler methods with an error
684 % The format of the MagickError method is:
686 % void MagickFatalError(const ExceptionType error,const char *reason,
687 % const char *description)
689 % A description of each parameter follows:
691 % o exception: Specifies the numeric error category.
693 % o reason: Specifies the reason to display before terminating the
696 % o description: Specifies any description to the reason.
699 MagickExport void MagickFatalError(const ExceptionType error,const char *reason,
700 const char *description)
702 if (fatal_error_handler != (ErrorHandler) NULL)
703 (*fatal_error_handler)(error,reason,description);
707 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
711 % M a g i c k W a r n i n g %
715 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
717 % MagickWarning() calls the warning handler methods with a warning reason.
719 % The format of the MagickWarning method is:
721 % void MagickWarning(const ExceptionType warning,const char *reason,
722 % const char *description)
724 % A description of each parameter follows:
726 % o warning: the warning severity.
728 % o reason: Define the reason for the warning.
730 % o description: Describe the warning.
733 MagickExport void MagickWarning(const ExceptionType warning,const char *reason,
734 const char *description)
736 if (warning_handler != (WarningHandler) NULL)
737 (*warning_handler)(warning,reason,description);
741 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
745 % S e t E r r o r H a n d l e r %
749 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
751 % SetErrorHandler() sets the exception handler to the specified method
752 % and returns the previous exception handler.
754 % The format of the SetErrorHandler method is:
756 % ErrorHandler SetErrorHandler(ErrorHandler handler)
758 % A description of each parameter follows:
760 % o handler: the method to handle errors.
763 MagickExport ErrorHandler SetErrorHandler(ErrorHandler handler)
768 previous_handler=error_handler;
769 error_handler=handler;
770 return(previous_handler);
774 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
778 % S e t F a t a l E r r o r H a n d l e r %
782 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
784 % SetFatalErrorHandler() sets the fatal exception handler to the specified
785 % method and returns the previous fatal exception handler.
787 % The format of the SetErrorHandler method is:
789 % ErrorHandler SetErrorHandler(ErrorHandler handler)
791 % A description of each parameter follows:
793 % o handler: the method to handle errors.
796 MagickExport FatalErrorHandler SetFatalErrorHandler(FatalErrorHandler handler)
801 previous_handler=fatal_error_handler;
802 fatal_error_handler=handler;
803 return(previous_handler);
807 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
811 % S e t W a r n i n g H a n d l e r %
815 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
817 % SetWarningHandler() sets the warning handler to the specified method
818 % and returns the previous warning handler.
820 % The format of the SetWarningHandler method is:
822 % ErrorHandler SetWarningHandler(ErrorHandler handler)
824 % A description of each parameter follows:
826 % o handler: the method to handle warnings.
829 MagickExport WarningHandler SetWarningHandler(WarningHandler handler)
834 previous_handler=warning_handler;
835 warning_handler=handler;
836 return(previous_handler);
840 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
844 % T h r o w E x c e p t i o n %
848 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
850 % ThrowException() throws an exception with the specified severity code,
851 % reason, and optional description.
853 % The format of the ThrowException method is:
855 % MagickBooleanType ThrowException(ExceptionInfo *exception,
856 % const ExceptionType severity,const char *reason,
857 % const char *description)
859 % A description of each parameter follows:
861 % o exception: the exception info.
863 % o severity: the severity of the exception.
865 % o reason: the reason for the exception.
867 % o description: the exception description.
870 MagickExport MagickBooleanType ThrowException(ExceptionInfo *exception,
871 const ExceptionType severity,const char *reason,const char *description)
873 register ExceptionInfo
876 assert(exception != (ExceptionInfo *) NULL);
877 assert(exception->signature == MagickSignature);
878 p=(ExceptionInfo *) GetLastValueInLinkedList((LinkedListInfo *)
879 exception->exceptions);
880 if ((p != (ExceptionInfo *) NULL) && (p->severity == severity) &&
881 (LocaleCompare(exception->reason,reason) == 0) &&
882 (LocaleCompare(exception->description,description) == 0))
884 p=(ExceptionInfo *) AcquireMagickMemory(sizeof(*p));
885 if (p == (ExceptionInfo *) NULL)
886 ThrowFatalException(ResourceLimitFatalError,"MemoryAllocationFailed");
887 (void) ResetMagickMemory(p,0,sizeof(*p));
888 p->severity=severity;
889 if (reason != (const char *) NULL)
890 p->reason=ConstantString(reason);
891 if (description != (const char *) NULL)
892 p->description=ConstantString(description);
893 p->signature=MagickSignature;
894 (void) AppendValueToLinkedList((LinkedListInfo *) exception->exceptions,p);
895 exception->severity=p->severity;
896 exception->reason=p->reason;
897 exception->description=p->description;
902 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
906 % T h r o w M a g i c k E x c e p t i o n %
910 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
912 % ThrowMagickException logs an exception as determined by the log configuration
913 % file. If an error occurs, MagickFalse is returned otherwise MagickTrue.
915 % The format of the ThrowMagickException method is:
917 % MagickBooleanType ThrowFileException(ExceptionInfo *exception,
918 % const char *module,const char *function,const size_t line,
919 % const ExceptionType severity,const char *tag,const char *format,...)
921 % A description of each parameter follows:
923 % o exception: the exception info.
925 % o filename: the source module filename.
927 % o function: the function name.
929 % o line: the line number of the source module.
931 % o severity: Specifies the numeric error category.
933 % o tag: the locale tag.
935 % o format: the output format.
939 MagickExport MagickBooleanType ThrowMagickExceptionList(
940 ExceptionInfo *exception,const char *module,const char *function,
941 const size_t line,const ExceptionType severity,const char *tag,
942 const char *format,va_list operands)
945 message[MaxTextExtent],
947 reason[MaxTextExtent];
962 assert(exception != (ExceptionInfo *) NULL);
963 assert(exception->signature == MagickSignature);
964 locale=GetLocaleExceptionMessage(severity,tag);
965 (void) CopyMagickString(reason,locale,MaxTextExtent);
966 (void) ConcatenateMagickString(reason," ",MaxTextExtent);
967 length=strlen(reason);
968 #if defined(MAGICKCORE_HAVE_VSNPRINTF)
969 n=vsnprintf(reason+length,MaxTextExtent-length,format,operands);
971 n=vsprintf(reason+length,format,operands);
974 reason[MaxTextExtent-1]='\0';
975 status=LogMagickEvent(ExceptionEvent,module,function,line,"%s",reason);
976 GetPathComponent(module,TailPath,path);
978 if ((severity >= WarningException) && (severity < ErrorException))
980 if ((severity >= ErrorException) && (severity < FatalErrorException))
982 if (severity >= FatalErrorException)
984 (void) FormatMagickString(message,MaxTextExtent,"%s @ %s/%s/%s/%.20g",reason,
985 type,path,function,(double) line);
986 (void) ThrowException(exception,severity,message,(char *) NULL);
990 MagickExport MagickBooleanType ThrowMagickException(ExceptionInfo *exception,
991 const char *module,const char *function,const size_t line,
992 const ExceptionType severity,const char *tag,const char *format,...)
1000 va_start(operands,format);
1001 status=ThrowMagickExceptionList(exception,module,function,line,severity,tag,