|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% EEEEE X X CCCC EEEEE PPPP TTTTT IIIII OOO N N %
|
|
|
% E X X C E P P T I O O NN N %
|
|
|
% EEE X C EEE PPPP T I O O N N N %
|
|
|
% E X X C E P T I O O N NN %
|
|
|
% EEEEE X X CCCC EEEEE P T IIIII OOO N N %
|
|
|
% %
|
|
|
% %
|
|
|
% MagickCore Exception Methods %
|
|
|
% %
|
|
|
% Software Design %
|
|
|
% Cristy %
|
|
|
% July 1993 %
|
|
|
% %
|
|
|
% %
|
|
|
% Copyright 1999-2021 ImageMagick Studio LLC, a non-profit organization %
|
|
|
% dedicated to making software imaging solutions freely available. %
|
|
|
% %
|
|
|
% You may not use this file except in compliance with the License. You may %
|
|
|
% obtain a copy of the License at %
|
|
|
% %
|
|
|
% https://imagemagick.org/script/license.php %
|
|
|
% %
|
|
|
% Unless required by applicable law or agreed to in writing, software %
|
|
|
% distributed under the License is distributed on an "AS IS" BASIS, %
|
|
|
% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. %
|
|
|
% See the License for the specific language governing permissions and %
|
|
|
% limitations under the License. %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
%
|
|
|
%
|
|
|
*/
|
|
|
|
|
|
/*
|
|
|
Include declarations.
|
|
|
*/
|
|
|
#include "MagickCore/studio.h"
|
|
|
#include "MagickCore/client.h"
|
|
|
#include "MagickCore/exception.h"
|
|
|
#include "MagickCore/exception-private.h"
|
|
|
#include "MagickCore/linked-list.h"
|
|
|
#include "MagickCore/locale_.h"
|
|
|
#include "MagickCore/log.h"
|
|
|
#include "MagickCore/magick.h"
|
|
|
#include "MagickCore/memory_.h"
|
|
|
#include "MagickCore/memory-private.h"
|
|
|
#include "MagickCore/semaphore.h"
|
|
|
#include "MagickCore/string_.h"
|
|
|
#include "MagickCore/utility.h"
|
|
|
#include "MagickCore/utility-private.h"
|
|
|
|
|
|
/*
|
|
|
Define declarations.
|
|
|
*/
|
|
|
#define MaxExceptionList 64
|
|
|
|
|
|
/*
|
|
|
Forward declarations.
|
|
|
*/
|
|
|
#if defined(__cplusplus) || defined(c_plusplus)
|
|
|
extern "C" {
|
|
|
#endif
|
|
|
|
|
|
static void
|
|
|
DefaultErrorHandler(const ExceptionType,const char *,const char *),
|
|
|
DefaultFatalErrorHandler(const ExceptionType,const char *,const char *),
|
|
|
DefaultWarningHandler(const ExceptionType,const char *,const char *);
|
|
|
|
|
|
#if defined(__cplusplus) || defined(c_plusplus)
|
|
|
}
|
|
|
#endif
|
|
|
|
|
|
/*
|
|
|
Global declarations.
|
|
|
*/
|
|
|
static ErrorHandler
|
|
|
error_handler = DefaultErrorHandler;
|
|
|
|
|
|
static FatalErrorHandler
|
|
|
fatal_error_handler = DefaultFatalErrorHandler;
|
|
|
|
|
|
static WarningHandler
|
|
|
warning_handler = DefaultWarningHandler;
|
|
|
|
|
|
/*
|
|
|
Static declarations.
|
|
|
*/
|
|
|
static SemaphoreInfo
|
|
|
*exception_semaphore = (SemaphoreInfo *) NULL;
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% A c q u i r e E x c e p t i o n I n f o %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% AcquireExceptionInfo() allocates the ExceptionInfo structure.
|
|
|
%
|
|
|
% The format of the AcquireExceptionInfo method is:
|
|
|
%
|
|
|
% ExceptionInfo *AcquireExceptionInfo(void)
|
|
|
%
|
|
|
*/
|
|
|
MagickExport ExceptionInfo *AcquireExceptionInfo(void)
|
|
|
{
|
|
|
ExceptionInfo
|
|
|
*exception;
|
|
|
|
|
|
exception=(ExceptionInfo *) AcquireCriticalMemory(sizeof(*exception));
|
|
|
InitializeExceptionInfo(exception);
|
|
|
exception->relinquish=MagickTrue;
|
|
|
return(exception);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% C l e a r M a g i c k E x c e p t i o n %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% ClearMagickException() clears any exception that may not have been caught
|
|
|
% yet.
|
|
|
%
|
|
|
% The format of the ClearMagickException method is:
|
|
|
%
|
|
|
% ClearMagickException(ExceptionInfo *exception)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o exception: the exception info.
|
|
|
%
|
|
|
*/
|
|
|
|
|
|
static void *DestroyExceptionElement(void *exception)
|
|
|
{
|
|
|
ExceptionInfo
|
|
|
*p;
|
|
|
|
|
|
p=(ExceptionInfo *) exception;
|
|
|
if (p->reason != (char *) NULL)
|
|
|
p->reason=DestroyString(p->reason);
|
|
|
if (p->description != (char *) NULL)
|
|
|
p->description=DestroyString(p->description);
|
|
|
p=(ExceptionInfo *) RelinquishMagickMemory(p);
|
|
|
return((void *) NULL);
|
|
|
}
|
|
|
|
|
|
MagickExport void ClearMagickException(ExceptionInfo *exception)
|
|
|
{
|
|
|
assert(exception != (ExceptionInfo *) NULL);
|
|
|
assert(exception->signature == MagickCoreSignature);
|
|
|
if (exception->exceptions == (void *) NULL)
|
|
|
return;
|
|
|
LockSemaphoreInfo(exception->semaphore);
|
|
|
ClearLinkedList((LinkedListInfo *) exception->exceptions,
|
|
|
DestroyExceptionElement);
|
|
|
exception->severity=UndefinedException;
|
|
|
exception->reason=(char *) NULL;
|
|
|
exception->description=(char *) NULL;
|
|
|
UnlockSemaphoreInfo(exception->semaphore);
|
|
|
errno=0;
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% C a t c h E x c e p t i o n %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% CatchException() returns if no exceptions is found otherwise it reports
|
|
|
% the exception as a warning, error, or fatal depending on the severity.
|
|
|
%
|
|
|
% The format of the CatchException method is:
|
|
|
%
|
|
|
% CatchException(ExceptionInfo *exception)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o exception: the exception info.
|
|
|
%
|
|
|
*/
|
|
|
MagickExport void CatchException(ExceptionInfo *exception)
|
|
|
{
|
|
|
LinkedListInfo
|
|
|
*exceptions;
|
|
|
|
|
|
const ExceptionInfo
|
|
|
*p;
|
|
|
|
|
|
ssize_t
|
|
|
i;
|
|
|
|
|
|
assert(exception != (ExceptionInfo *) NULL);
|
|
|
assert(exception->signature == MagickCoreSignature);
|
|
|
if (exception->exceptions == (void *) NULL)
|
|
|
return;
|
|
|
LockSemaphoreInfo(exception->semaphore);
|
|
|
exceptions=(LinkedListInfo *) exception->exceptions;
|
|
|
ResetLinkedListIterator(exceptions);
|
|
|
p=(const ExceptionInfo *) GetNextValueInLinkedList(exceptions);
|
|
|
for (i=0; p != (const ExceptionInfo *) NULL; i++)
|
|
|
{
|
|
|
if ((p->severity >= WarningException) && (p->severity < ErrorException))
|
|
|
MagickWarning(p->severity,p->reason,p->description);
|
|
|
if ((p->severity >= ErrorException) && (p->severity < FatalErrorException))
|
|
|
MagickError(p->severity,p->reason,p->description);
|
|
|
if (p->severity >= FatalErrorException)
|
|
|
MagickFatalError(p->severity,p->reason,p->description);
|
|
|
p=(const ExceptionInfo *) GetNextValueInLinkedList(exceptions);
|
|
|
}
|
|
|
UnlockSemaphoreInfo(exception->semaphore);
|
|
|
ClearMagickException(exception);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% C l o n e E x c e p t i o n I n f o %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% CloneExceptionInfo() clones the ExceptionInfo structure.
|
|
|
%
|
|
|
% The format of the CloneExceptionInfo method is:
|
|
|
%
|
|
|
% ExceptionInfo *CloneException(ExceptionInfo *exception)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o exception: the exception info.
|
|
|
%
|
|
|
*/
|
|
|
MagickExport ExceptionInfo *CloneExceptionInfo(ExceptionInfo *exception)
|
|
|
{
|
|
|
ExceptionInfo
|
|
|
*clone_exception;
|
|
|
|
|
|
clone_exception=(ExceptionInfo *) AcquireCriticalMemory(sizeof(*exception));
|
|
|
InitializeExceptionInfo(clone_exception);
|
|
|
InheritException(clone_exception,exception);
|
|
|
clone_exception->relinquish=MagickTrue;
|
|
|
return(clone_exception);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
+ D e f a u l t E r r o r H a n d l e r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% DefaultErrorHandler() displays an error reason.
|
|
|
%
|
|
|
% The format of the DefaultErrorHandler method is:
|
|
|
%
|
|
|
% void MagickError(const ExceptionType severity,const char *reason,
|
|
|
% const char *description)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o severity: Specifies the numeric error category.
|
|
|
%
|
|
|
% o reason: Specifies the reason to display before terminating the
|
|
|
% program.
|
|
|
%
|
|
|
% o description: Specifies any description to the reason.
|
|
|
%
|
|
|
*/
|
|
|
static void DefaultErrorHandler(const ExceptionType magick_unused(severity),
|
|
|
const char *reason,const char *description)
|
|
|
{
|
|
|
magick_unreferenced(severity);
|
|
|
|
|
|
if (reason == (char *) NULL)
|
|
|
return;
|
|
|
(void) FormatLocaleFile(stderr,"%s: %s",GetClientName(),reason);
|
|
|
if (description != (char *) NULL)
|
|
|
(void) FormatLocaleFile(stderr," (%s)",description);
|
|
|
(void) FormatLocaleFile(stderr,".\n");
|
|
|
(void) fflush(stderr);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
+ D e f a u l t F a t a l E r r o r H a n d l e r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% DefaultFatalErrorHandler() displays an error reason and then terminates the
|
|
|
% program.
|
|
|
%
|
|
|
% The format of the DefaultFatalErrorHandler method is:
|
|
|
%
|
|
|
% void MagickFatalError(const ExceptionType severity,const char *reason,
|
|
|
% const char *description)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o severity: Specifies the numeric error category.
|
|
|
%
|
|
|
% o reason: Specifies the reason to display before terminating the program.
|
|
|
%
|
|
|
% o description: Specifies any description to the reason.
|
|
|
%
|
|
|
*/
|
|
|
static void DefaultFatalErrorHandler(const ExceptionType severity,
|
|
|
const char *reason,const char *description)
|
|
|
{
|
|
|
if (reason == (char *) NULL)
|
|
|
return;
|
|
|
(void) FormatLocaleFile(stderr,"%s: %s",GetClientName(),reason);
|
|
|
if (description != (char *) NULL)
|
|
|
(void) FormatLocaleFile(stderr," (%s)",description);
|
|
|
(void) FormatLocaleFile(stderr,".\n");
|
|
|
(void) fflush(stderr);
|
|
|
MagickCoreTerminus();
|
|
|
exit((int) (severity-FatalErrorException)+1);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
+ D e f a u l t W a r n i n g H a n d l e r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% DefaultWarningHandler() displays a warning reason.
|
|
|
%
|
|
|
% The format of the DefaultWarningHandler method is:
|
|
|
%
|
|
|
% void DefaultWarningHandler(const ExceptionType severity,
|
|
|
% const char *reason,const char *description)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o severity: Specifies the numeric warning category.
|
|
|
%
|
|
|
% o reason: Specifies the reason to display before terminating the
|
|
|
% program.
|
|
|
%
|
|
|
% o description: Specifies any description to the reason.
|
|
|
%
|
|
|
*/
|
|
|
static void DefaultWarningHandler(const ExceptionType magick_unused(severity),
|
|
|
const char *reason,const char *description)
|
|
|
{
|
|
|
magick_unreferenced(severity);
|
|
|
|
|
|
if (reason == (char *) NULL)
|
|
|
return;
|
|
|
(void) FormatLocaleFile(stderr,"%s: %s",GetClientName(),reason);
|
|
|
if (description != (char *) NULL)
|
|
|
(void) FormatLocaleFile(stderr," (%s)",description);
|
|
|
(void) FormatLocaleFile(stderr,".\n");
|
|
|
(void) fflush(stderr);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% D e s t r o y E x c e p t i o n I n f o %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% DestroyExceptionInfo() deallocates memory associated with an exception.
|
|
|
%
|
|
|
% The format of the DestroyExceptionInfo method is:
|
|
|
%
|
|
|
% ExceptionInfo *DestroyExceptionInfo(ExceptionInfo *exception)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o exception: the exception info.
|
|
|
%
|
|
|
*/
|
|
|
MagickExport ExceptionInfo *DestroyExceptionInfo(ExceptionInfo *exception)
|
|
|
{
|
|
|
MagickBooleanType
|
|
|
relinquish;
|
|
|
|
|
|
assert(exception != (ExceptionInfo *) NULL);
|
|
|
assert(exception->signature == MagickCoreSignature);
|
|
|
if (exception->semaphore == (SemaphoreInfo *) NULL)
|
|
|
ActivateSemaphoreInfo(&exception->semaphore);
|
|
|
LockSemaphoreInfo(exception->semaphore);
|
|
|
exception->severity=UndefinedException;
|
|
|
if (exception->relinquish != MagickFalse)
|
|
|
{
|
|
|
exception->signature=(~MagickCoreSignature);
|
|
|
if (exception->exceptions != (void *) NULL)
|
|
|
exception->exceptions=(void *) DestroyLinkedList((LinkedListInfo *)
|
|
|
exception->exceptions,DestroyExceptionElement);
|
|
|
}
|
|
|
else
|
|
|
if (exception->exceptions != (void *) NULL)
|
|
|
ClearLinkedList((LinkedListInfo *) exception->exceptions,
|
|
|
DestroyExceptionElement);
|
|
|
relinquish=exception->relinquish;
|
|
|
UnlockSemaphoreInfo(exception->semaphore);
|
|
|
if (relinquish != MagickFalse)
|
|
|
{
|
|
|
RelinquishSemaphoreInfo(&exception->semaphore);
|
|
|
exception=(ExceptionInfo *) RelinquishMagickMemory(exception);
|
|
|
}
|
|
|
return(exception);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
+ E x e c e p t i o n C o m p o n e n t G e n e s i s %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% ExceptionComponentGenesis() instantiates the exception component.
|
|
|
%
|
|
|
% The format of the ExceptionComponentGenesis method is:
|
|
|
%
|
|
|
% MagickBooleanType ExceptionComponentGenesis(void)
|
|
|
%
|
|
|
*/
|
|
|
MagickPrivate MagickBooleanType ExceptionComponentGenesis(void)
|
|
|
{
|
|
|
if (exception_semaphore == (SemaphoreInfo *) NULL)
|
|
|
exception_semaphore=AcquireSemaphoreInfo();
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
+ E x c e p t i o n C o m p o n e n t T e r m i n u s %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% ExceptionComponentTerminus() destroys the exception component.
|
|
|
%
|
|
|
% The format of the ExceptionComponentTerminus method is:
|
|
|
%
|
|
|
% void ExceptionComponentTerminus(void)
|
|
|
%
|
|
|
*/
|
|
|
MagickPrivate void ExceptionComponentTerminus(void)
|
|
|
{
|
|
|
if (exception_semaphore == (SemaphoreInfo *) NULL)
|
|
|
ActivateSemaphoreInfo(&exception_semaphore);
|
|
|
LockSemaphoreInfo(exception_semaphore);
|
|
|
UnlockSemaphoreInfo(exception_semaphore);
|
|
|
RelinquishSemaphoreInfo(&exception_semaphore);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% G e t E x c e p t i o n M e s s a g e %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% GetExceptionMessage() returns the error message defined by the specified
|
|
|
% error code.
|
|
|
%
|
|
|
% The format of the GetExceptionMessage method is:
|
|
|
%
|
|
|
% char *GetExceptionMessage(const int error)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o error: the error code.
|
|
|
%
|
|
|
*/
|
|
|
MagickExport char *GetExceptionMessage(const int error)
|
|
|
{
|
|
|
char
|
|
|
exception[MagickPathExtent];
|
|
|
|
|
|
*exception='\0';
|
|
|
#if defined(MAGICKCORE_HAVE_STRERROR_R)
|
|
|
#if !defined(MAGICKCORE_STRERROR_R_CHAR_P)
|
|
|
(void) strerror_r(error,exception,sizeof(exception));
|
|
|
#else
|
|
|
(void) CopyMagickString(exception,strerror_r(error,exception,
|
|
|
sizeof(exception)),sizeof(exception));
|
|
|
#endif
|
|
|
#else
|
|
|
(void) CopyMagickString(exception,strerror(error),sizeof(exception));
|
|
|
#endif
|
|
|
return(ConstantString(exception));
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% 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 %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% GetLocaleExceptionMessage() converts a enumerated exception severity and tag
|
|
|
% to a message in the current locale.
|
|
|
%
|
|
|
% The format of the GetLocaleExceptionMessage method is:
|
|
|
%
|
|
|
% const char *GetLocaleExceptionMessage(const ExceptionType severity,
|
|
|
% const char *tag)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o severity: the severity of the exception.
|
|
|
%
|
|
|
% o tag: the message tag.
|
|
|
%
|
|
|
*/
|
|
|
|
|
|
static const char *ExceptionSeverityToTag(const ExceptionType severity)
|
|
|
{
|
|
|
switch (severity)
|
|
|
{
|
|
|
case ResourceLimitWarning: return("Resource/Limit/Warning/");
|
|
|
case TypeWarning: return("Type/Warning/");
|
|
|
case OptionWarning: return("Option/Warning/");
|
|
|
case DelegateWarning: return("Delegate/Warning/");
|
|
|
case MissingDelegateWarning: return("Missing/Delegate/Warning/");
|
|
|
case CorruptImageWarning: return("Corrupt/Image/Warning/");
|
|
|
case FileOpenWarning: return("File/Open/Warning/");
|
|
|
case BlobWarning: return("Blob/Warning/");
|
|
|
case StreamWarning: return("Stream/Warning/");
|
|
|
case CacheWarning: return("Cache/Warning/");
|
|
|
case CoderWarning: return("Coder/Warning/");
|
|
|
case FilterWarning: return("Filter/Warning/");
|
|
|
case ModuleWarning: return("Module/Warning/");
|
|
|
case DrawWarning: return("Draw/Warning/");
|
|
|
case ImageWarning: return("Image/Warning/");
|
|
|
case WandWarning: return("Wand/Warning/");
|
|
|
case XServerWarning: return("XServer/Warning/");
|
|
|
case MonitorWarning: return("Monitor/Warning/");
|
|
|
case RegistryWarning: return("Registry/Warning/");
|
|
|
case ConfigureWarning: return("Configure/Warning/");
|
|
|
case PolicyWarning: return("Policy/Warning/");
|
|
|
case ResourceLimitError: return("Resource/Limit/Error/");
|
|
|
case TypeError: return("Type/Error/");
|
|
|
case OptionError: return("Option/Error/");
|
|
|
case DelegateError: return("Delegate/Error/");
|
|
|
case MissingDelegateError: return("Missing/Delegate/Error/");
|
|
|
case CorruptImageError: return("Corrupt/Image/Error/");
|
|
|
case FileOpenError: return("File/Open/Error/");
|
|
|
case BlobError: return("Blob/Error/");
|
|
|
case StreamError: return("Stream/Error/");
|
|
|
case CacheError: return("Cache/Error/");
|
|
|
case CoderError: return("Coder/Error/");
|
|
|
case FilterError: return("Filter/Error/");
|
|
|
case ModuleError: return("Module/Error/");
|
|
|
case DrawError: return("Draw/Error/");
|
|
|
case ImageError: return("Image/Error/");
|
|
|
case WandError: return("Wand/Error/");
|
|
|
case XServerError: return("XServer/Error/");
|
|
|
case MonitorError: return("Monitor/Error/");
|
|
|
case RegistryError: return("Registry/Error/");
|
|
|
case ConfigureError: return("Configure/Error/");
|
|
|
case PolicyError: return("Policy/Error/");
|
|
|
case ResourceLimitFatalError: return("Resource/Limit/FatalError/");
|
|
|
case TypeFatalError: return("Type/FatalError/");
|
|
|
case OptionFatalError: return("Option/FatalError/");
|
|
|
case DelegateFatalError: return("Delegate/FatalError/");
|
|
|
case MissingDelegateFatalError: return("Missing/Delegate/FatalError/");
|
|
|
case CorruptImageFatalError: return("Corrupt/Image/FatalError/");
|
|
|
case FileOpenFatalError: return("File/Open/FatalError/");
|
|
|
case BlobFatalError: return("Blob/FatalError/");
|
|
|
case StreamFatalError: return("Stream/FatalError/");
|
|
|
case CacheFatalError: return("Cache/FatalError/");
|
|
|
case CoderFatalError: return("Coder/FatalError/");
|
|
|
case FilterFatalError: return("Filter/FatalError/");
|
|
|
case ModuleFatalError: return("Module/FatalError/");
|
|
|
case DrawFatalError: return("Draw/FatalError/");
|
|
|
case ImageFatalError: return("Image/FatalError/");
|
|
|
case WandFatalError: return("Wand/FatalError/");
|
|
|
case XServerFatalError: return("XServer/FatalError/");
|
|
|
case MonitorFatalError: return("Monitor/FatalError/");
|
|
|
case RegistryFatalError: return("Registry/FatalError/");
|
|
|
case ConfigureFatalError: return("Configure/FatalError/");
|
|
|
case PolicyFatalError: return("Policy/FatalError/");
|
|
|
default: break;
|
|
|
}
|
|
|
return("");
|
|
|
}
|
|
|
|
|
|
MagickExport const char *GetLocaleExceptionMessage(const ExceptionType severity,
|
|
|
const char *tag)
|
|
|
{
|
|
|
char
|
|
|
message[MagickPathExtent];
|
|
|
|
|
|
const char
|
|
|
*locale_message;
|
|
|
|
|
|
assert(tag != (const char *) NULL);
|
|
|
(void) FormatLocaleString(message,MagickPathExtent,"Exception/%s%s",
|
|
|
ExceptionSeverityToTag(severity),tag);
|
|
|
locale_message=GetLocaleMessage(message);
|
|
|
if (locale_message == (const char *) NULL)
|
|
|
return(tag);
|
|
|
if (locale_message == message)
|
|
|
return(tag);
|
|
|
return(locale_message);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% I n h e r i t E x c e p t i o n %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% InheritException() inherits an exception from a related exception.
|
|
|
%
|
|
|
% The format of the InheritException method is:
|
|
|
%
|
|
|
% InheritException(ExceptionInfo *exception,const ExceptionInfo *relative)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o exception: the exception info.
|
|
|
%
|
|
|
% o relative: the related exception info.
|
|
|
%
|
|
|
*/
|
|
|
MagickExport void InheritException(ExceptionInfo *exception,
|
|
|
const ExceptionInfo *relative)
|
|
|
{
|
|
|
const ExceptionInfo
|
|
|
*p;
|
|
|
|
|
|
assert(exception != (ExceptionInfo *) NULL);
|
|
|
assert(exception->signature == MagickCoreSignature);
|
|
|
assert(relative != (ExceptionInfo *) NULL);
|
|
|
assert(relative->signature == MagickCoreSignature);
|
|
|
assert(exception != relative);
|
|
|
if (relative->exceptions == (void *) NULL)
|
|
|
return;
|
|
|
LockSemaphoreInfo(relative->semaphore);
|
|
|
ResetLinkedListIterator((LinkedListInfo *) relative->exceptions);
|
|
|
p=(const ExceptionInfo *) GetNextValueInLinkedList((LinkedListInfo *)
|
|
|
relative->exceptions);
|
|
|
while (p != (const ExceptionInfo *) NULL)
|
|
|
{
|
|
|
(void) ThrowException(exception,p->severity,p->reason,p->description);
|
|
|
p=(const ExceptionInfo *) GetNextValueInLinkedList((LinkedListInfo *)
|
|
|
relative->exceptions);
|
|
|
}
|
|
|
UnlockSemaphoreInfo(relative->semaphore);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% I n i t i a l i z e t E x c e p t i o n I n f o %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% InitializeExceptionInfo() initializes an exception to default values.
|
|
|
%
|
|
|
% The format of the InitializeExceptionInfo method is:
|
|
|
%
|
|
|
% InitializeExceptionInfo(ExceptionInfo *exception)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o exception: the exception info.
|
|
|
%
|
|
|
*/
|
|
|
MagickPrivate void InitializeExceptionInfo(ExceptionInfo *exception)
|
|
|
{
|
|
|
assert(exception != (ExceptionInfo *) NULL);
|
|
|
(void) memset(exception,0,sizeof(*exception));
|
|
|
exception->severity=UndefinedException;
|
|
|
exception->exceptions=(void *) NewLinkedList(0);
|
|
|
exception->semaphore=AcquireSemaphoreInfo();
|
|
|
exception->signature=MagickCoreSignature;
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k E r r o r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickError() calls the exception handler methods with an error reason.
|
|
|
%
|
|
|
% The format of the MagickError method is:
|
|
|
%
|
|
|
% void MagickError(const ExceptionType error,const char *reason,
|
|
|
% const char *description)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o exception: Specifies the numeric error category.
|
|
|
%
|
|
|
% o reason: Specifies the reason to display before terminating the
|
|
|
% program.
|
|
|
%
|
|
|
% o description: Specifies any description to the reason.
|
|
|
%
|
|
|
*/
|
|
|
MagickExport void MagickError(const ExceptionType error,const char *reason,
|
|
|
const char *description)
|
|
|
{
|
|
|
if (error_handler != (ErrorHandler) NULL)
|
|
|
(*error_handler)(error,reason,description);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k F a t al E r r o r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickFatalError() calls the fatal exception handler methods with an error
|
|
|
% reason.
|
|
|
%
|
|
|
% The format of the MagickError method is:
|
|
|
%
|
|
|
% void MagickFatalError(const ExceptionType error,const char *reason,
|
|
|
% const char *description)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o exception: Specifies the numeric error category.
|
|
|
%
|
|
|
% o reason: Specifies the reason to display before terminating the
|
|
|
% program.
|
|
|
%
|
|
|
% o description: Specifies any description to the reason.
|
|
|
%
|
|
|
*/
|
|
|
MagickExport void MagickFatalError(const ExceptionType error,const char *reason,
|
|
|
const char *description)
|
|
|
{
|
|
|
if (fatal_error_handler != (ErrorHandler) NULL)
|
|
|
(*fatal_error_handler)(error,reason,description);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% M a g i c k W a r n i n g %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% MagickWarning() calls the warning handler methods with a warning reason.
|
|
|
%
|
|
|
% The format of the MagickWarning method is:
|
|
|
%
|
|
|
% void MagickWarning(const ExceptionType warning,const char *reason,
|
|
|
% const char *description)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o warning: the warning severity.
|
|
|
%
|
|
|
% o reason: Define the reason for the warning.
|
|
|
%
|
|
|
% o description: Describe the warning.
|
|
|
%
|
|
|
*/
|
|
|
MagickExport void MagickWarning(const ExceptionType warning,const char *reason,
|
|
|
const char *description)
|
|
|
{
|
|
|
if (warning_handler != (WarningHandler) NULL)
|
|
|
(*warning_handler)(warning,reason,description);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% S e t E r r o r H a n d l e r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% SetErrorHandler() sets the exception handler to the specified method
|
|
|
% and returns the previous exception handler.
|
|
|
%
|
|
|
% The format of the SetErrorHandler method is:
|
|
|
%
|
|
|
% ErrorHandler SetErrorHandler(ErrorHandler handler)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o handler: the method to handle errors.
|
|
|
%
|
|
|
*/
|
|
|
MagickExport ErrorHandler SetErrorHandler(ErrorHandler handler)
|
|
|
{
|
|
|
ErrorHandler
|
|
|
previous_handler;
|
|
|
|
|
|
if (exception_semaphore == (SemaphoreInfo *) NULL)
|
|
|
ActivateSemaphoreInfo(&exception_semaphore);
|
|
|
LockSemaphoreInfo(exception_semaphore);
|
|
|
previous_handler=error_handler;
|
|
|
error_handler=handler;
|
|
|
UnlockSemaphoreInfo(exception_semaphore);
|
|
|
return(previous_handler);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% S e t F a t a l E r r o r H a n d l e r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% SetFatalErrorHandler() sets the fatal exception handler to the specified
|
|
|
% method and returns the previous fatal exception handler.
|
|
|
%
|
|
|
% The format of the SetErrorHandler method is:
|
|
|
%
|
|
|
% ErrorHandler SetErrorHandler(ErrorHandler handler)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o handler: the method to handle errors.
|
|
|
%
|
|
|
*/
|
|
|
MagickExport FatalErrorHandler SetFatalErrorHandler(FatalErrorHandler handler)
|
|
|
{
|
|
|
FatalErrorHandler
|
|
|
previous_handler;
|
|
|
|
|
|
if (exception_semaphore == (SemaphoreInfo *) NULL)
|
|
|
ActivateSemaphoreInfo(&exception_semaphore);
|
|
|
LockSemaphoreInfo(exception_semaphore);
|
|
|
previous_handler=fatal_error_handler;
|
|
|
fatal_error_handler=handler;
|
|
|
UnlockSemaphoreInfo(exception_semaphore);
|
|
|
return(previous_handler);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% S e t W a r n i n g H a n d l e r %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% SetWarningHandler() sets the warning handler to the specified method
|
|
|
% and returns the previous warning handler.
|
|
|
%
|
|
|
% The format of the SetWarningHandler method is:
|
|
|
%
|
|
|
% ErrorHandler SetWarningHandler(ErrorHandler handler)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o handler: the method to handle warnings.
|
|
|
%
|
|
|
*/
|
|
|
MagickExport WarningHandler SetWarningHandler(WarningHandler handler)
|
|
|
{
|
|
|
WarningHandler
|
|
|
previous_handler;
|
|
|
|
|
|
if (exception_semaphore == (SemaphoreInfo *) NULL)
|
|
|
ActivateSemaphoreInfo(&exception_semaphore);
|
|
|
LockSemaphoreInfo(exception_semaphore);
|
|
|
previous_handler=warning_handler;
|
|
|
warning_handler=handler;
|
|
|
UnlockSemaphoreInfo(exception_semaphore);
|
|
|
return(previous_handler);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% T h r o w E x c e p t i o n %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% ThrowException() throws an exception with the specified severity code,
|
|
|
% reason, and optional description.
|
|
|
%
|
|
|
% The format of the ThrowException method is:
|
|
|
%
|
|
|
% MagickBooleanType ThrowException(ExceptionInfo *exception,
|
|
|
% const ExceptionType severity,const char *reason,
|
|
|
% const char *description)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o exception: the exception info.
|
|
|
%
|
|
|
% o severity: the severity of the exception.
|
|
|
%
|
|
|
% o reason: the reason for the exception.
|
|
|
%
|
|
|
% o description: the exception description.
|
|
|
%
|
|
|
*/
|
|
|
MagickExport MagickBooleanType ThrowException(ExceptionInfo *exception,
|
|
|
const ExceptionType severity,const char *reason,const char *description)
|
|
|
{
|
|
|
LinkedListInfo
|
|
|
*exceptions;
|
|
|
|
|
|
ExceptionInfo
|
|
|
*p;
|
|
|
|
|
|
assert(exception != (ExceptionInfo *) NULL);
|
|
|
assert(exception->signature == MagickCoreSignature);
|
|
|
LockSemaphoreInfo(exception->semaphore);
|
|
|
exceptions=(LinkedListInfo *) exception->exceptions;
|
|
|
if (GetNumberOfElementsInLinkedList(exceptions) > MaxExceptionList)
|
|
|
{
|
|
|
if (severity < ErrorException)
|
|
|
{
|
|
|
UnlockSemaphoreInfo(exception->semaphore);
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
p=(ExceptionInfo *) GetLastValueInLinkedList(exceptions);
|
|
|
if (p->severity >= ErrorException)
|
|
|
{
|
|
|
UnlockSemaphoreInfo(exception->semaphore);
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
}
|
|
|
p=(ExceptionInfo *) GetLastValueInLinkedList(exceptions);
|
|
|
if ((p != (ExceptionInfo *) NULL) && (p->severity == severity) &&
|
|
|
(LocaleCompare(exception->reason,reason) == 0) &&
|
|
|
(LocaleCompare(exception->description,description) == 0))
|
|
|
{
|
|
|
UnlockSemaphoreInfo(exception->semaphore);
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
p=(ExceptionInfo *) AcquireMagickMemory(sizeof(*p));
|
|
|
if (p == (ExceptionInfo *) NULL)
|
|
|
{
|
|
|
UnlockSemaphoreInfo(exception->semaphore);
|
|
|
ThrowFatalException(ResourceLimitFatalError,"MemoryAllocationFailed");
|
|
|
}
|
|
|
(void) memset(p,0,sizeof(*p));
|
|
|
p->severity=severity;
|
|
|
if (reason != (const char *) NULL)
|
|
|
p->reason=ConstantString(reason);
|
|
|
if (description != (const char *) NULL)
|
|
|
p->description=ConstantString(description);
|
|
|
p->signature=MagickCoreSignature;
|
|
|
(void) AppendValueToLinkedList(exceptions,p);
|
|
|
if (p->severity > exception->severity)
|
|
|
{
|
|
|
exception->severity=p->severity;
|
|
|
exception->reason=p->reason;
|
|
|
exception->description=p->description;
|
|
|
}
|
|
|
UnlockSemaphoreInfo(exception->semaphore);
|
|
|
if (GetNumberOfElementsInLinkedList(exceptions) == MaxExceptionList)
|
|
|
(void) ThrowMagickException(exception,GetMagickModule(),
|
|
|
ResourceLimitWarning,"TooManyExceptions",
|
|
|
"(exception processing is suspended)");
|
|
|
return(MagickTrue);
|
|
|
}
|
|
|
|
|
|
/*
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
% T h r o w M a g i c k E x c e p t i o n %
|
|
|
% %
|
|
|
% %
|
|
|
% %
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
%
|
|
|
% ThrowMagickException logs an exception as determined by the log
|
|
|
% configuration file. If an error occurs, MagickFalse is returned
|
|
|
% otherwise MagickTrue.
|
|
|
%
|
|
|
% The format of the ThrowMagickException method is:
|
|
|
%
|
|
|
% MagickBooleanType ThrowFileException(ExceptionInfo *exception,
|
|
|
% const char *module,const char *function,const size_t line,
|
|
|
% const ExceptionType severity,const char *tag,const char *format,...)
|
|
|
%
|
|
|
% A description of each parameter follows:
|
|
|
%
|
|
|
% o exception: the exception info.
|
|
|
%
|
|
|
% o filename: the source module filename.
|
|
|
%
|
|
|
% o function: the function name.
|
|
|
%
|
|
|
% o line: the line number of the source module.
|
|
|
%
|
|
|
% o severity: Specifies the numeric error category.
|
|
|
%
|
|
|
% o tag: the locale tag.
|
|
|
%
|
|
|
% o format: the output format.
|
|
|
%
|
|
|
*/
|
|
|
|
|
|
MagickExport MagickBooleanType ThrowMagickExceptionList(
|
|
|
ExceptionInfo *exception,const char *module,const char *function,
|
|
|
const size_t line,const ExceptionType severity,const char *tag,
|
|
|
const char *format,va_list operands)
|
|
|
{
|
|
|
char
|
|
|
message[MagickPathExtent],
|
|
|
path[MagickPathExtent],
|
|
|
reason[MagickPathExtent];
|
|
|
|
|
|
const char
|
|
|
*locale,
|
|
|
*type;
|
|
|
|
|
|
int
|
|
|
n;
|
|
|
|
|
|
MagickBooleanType
|
|
|
status;
|
|
|
|
|
|
size_t
|
|
|
length;
|
|
|
|
|
|
assert(exception != (ExceptionInfo *) NULL);
|
|
|
assert(exception->signature == MagickCoreSignature);
|
|
|
locale=GetLocaleExceptionMessage(severity,tag);
|
|
|
(void) CopyMagickString(reason,locale,MagickPathExtent);
|
|
|
(void) ConcatenateMagickString(reason," ",MagickPathExtent);
|
|
|
length=strlen(reason);
|
|
|
#if defined(MAGICKCORE_HAVE_VSNPRINTF)
|
|
|
n=vsnprintf(reason+length,MagickPathExtent-length,format,operands);
|
|
|
#else
|
|
|
n=vsprintf(reason+length,format,operands);
|
|
|
#endif
|
|
|
if (n < 0)
|
|
|
reason[MagickPathExtent-1]='\0';
|
|
|
status=LogMagickEvent(ExceptionEvent,module,function,line,"%s",reason);
|
|
|
GetPathComponent(module,TailPath,path);
|
|
|
type="undefined";
|
|
|
if ((severity >= WarningException) && (severity < ErrorException))
|
|
|
type="warning";
|
|
|
if ((severity >= ErrorException) && (severity < FatalErrorException))
|
|
|
type="error";
|
|
|
if (severity >= FatalErrorException)
|
|
|
type="fatal";
|
|
|
(void) FormatLocaleString(message,MagickPathExtent,"%s @ %s/%s/%s/%.20g",
|
|
|
reason,type,path,function,(double) line);
|
|
|
(void) ThrowException(exception,severity,message,(char *) NULL);
|
|
|
return(status);
|
|
|
}
|
|
|
|
|
|
MagickExport MagickBooleanType ThrowMagickException(ExceptionInfo *exception,
|
|
|
const char *module,const char *function,const size_t line,
|
|
|
const ExceptionType severity,const char *tag,const char *format,...)
|
|
|
{
|
|
|
MagickBooleanType
|
|
|
status;
|
|
|
|
|
|
va_list
|
|
|
operands;
|
|
|
|
|
|
va_start(operands,format);
|
|
|
status=ThrowMagickExceptionList(exception,module,function,line,severity,tag,
|
|
|
format,operands);
|
|
|
va_end(operands);
|
|
|
return(status);
|
|
|
}
|
