void warn(char *format, ...)
/* Issue a warning message. */
{
va_list args;
va_start(args, format);
vaWarn(format, args);
va_end(args);
}
void xpError(struct xp *xp, char *format, ...)
/* Output an error message with filename and line number included. */
{
va_list args;
va_start(args, format);
vaWarn(format, args);
errAbort("line %d of %s", xpLineIx(xp), xpFileName(xp));
va_end(args);
}
void recordWarn(struct raRecord *rec, char *format, ...)
/* Issue a warning message. */
{
va_list args;
va_start(args, format);
vaWarn(format, args);
va_end(args);
recordLocationReport(rec, stderr);
}
void reportError(char *fileName, int startLine, char *format, ...)
/* Report error and abort if there are too many errors. */
{
va_list args;
va_start(args, format);
if (++gErrCount > clMaxErr)
noWarnAbort();
vaWarn(format, args);
warn(" in stanza starting line %d of %s", startLine, fileName);
}
void errnoWarn(char *format, ...)
/* Prints error message from UNIX errno first, then does rest of warning. */
{
char fbuf[512];
va_list args;
va_start(args, format);
sprintf(fbuf, "%s\n%s", strerror(errno), format);
vaWarn(fbuf, args);
va_end(args);
}
void tokenizerErrAbort(struct tokenizer *tkz, char *format, ...)
/* Print error message followed by file and line number and
* abort. */
{
va_list args;
va_start(args, format);
vaWarn(format, args);
errAbort("line %d of %s:\n%s",
tokenizerLineCount(tkz), tokenizerFileName(tkz), tkz->curLine);
}
static void tagVaWarn(struct htmlPage *page, struct htmlTag *tag, char *format,
va_list args)
/* Print warning message and some context of tag. */
{
char context[80];
strncpy(context, tag->start, sizeof(context));
context[sizeof(context)-1] = 0;
warn("Error near line %d of %s:\n %s", findLineNumber(page->htmlText, tag->start),
page->url, context);
vaWarn(format, args);
}
void vaErrAbort(char *format, va_list args)
/* Abort function, with optional (vprintf formatted) error message. */
{
/* flag is needed because both errAbort and warn generate message
* using the warn handler, however sometimes one needed to know
* (like when logging), if it's an error or a warning. This is far from
* perfect, as this isn't cleared if the error handler continues,
* as with an exception mechanism. */
struct perThreadAbortVars *ptav = getThreadVars();
ptav->errAbortInProgress = TRUE;
vaWarn(format, args);
noWarnAbort();
}
static void vcfFileErr(struct vcfFile *vcff, char *format, ...)
/* Send error message to errabort stack's warn handler and abort */
{
va_list args;
va_start(args, format);
char formatPlus[1024];
if (vcff->lf != NULL)
sprintf(formatPlus, "%s:%d: %s", vcff->lf->fileName, vcff->lf->lineIx, format);
else
strcpy(formatPlus, format);
vaWarn(formatPlus, args);
va_end(args);
vcff->errCnt++;
if (vcfFileStopDueToErrors(vcff))
errAbort("VCF: %d parser errors, quitting", vcff->errCnt);
}
void warnWithBackTrace(char *format, ...)
/* Issue a warning message and append backtrace. */
{
va_list args;
va_start(args, format);
struct dyString *dy = newDyString(255);
dyStringAppend(dy, format);
#define STACK_LIMIT 20
char **strings = NULL;
int count = 0;
// developer: this is an occasionally useful means of getting stack info without crashing
// however, it is not supported on cygwin. Conditionally compile this in when desired.
// The define is at top to include execinfo.h
#ifdef BACKTRACE_EXISTS
void *buffer[STACK_LIMIT];
count = backtrace(buffer, STACK_LIMIT);
strings = backtrace_symbols(buffer, count);
#endif///def BACKTRACE_EXISTS
if (strings == NULL)
dyStringAppend(dy,"\nno backtrace_symbols available in errabort::warnWithBackTrace().");
else
{
int ix = 1;
dyStringAppend(dy,"\nBACKTRACE (use on cmdLine):");
if (strings[1] != NULL)
{
strSwapChar(strings[1],' ','\0');
dyStringPrintf(dy,"\naddr2line -Cfise %s",strings[1]);
strings[1] += strlen(strings[1]) + 1;
}
for (; ix < count && strings[ix] != NULL; ix++)
{
strings[ix] = skipBeyondDelimit(strings[ix],'[');
strSwapChar(strings[ix],']','\0');
dyStringPrintf(dy," %s",strings[ix]);
}
free(strings);
}
vaWarn(dyStringCannibalize(&dy), args);
va_end(args);
}
void qaStatusSoftError(struct qaStatus *qs, char *format, ...)
/* Add error message for something less than a crash. */
{
struct dyString *dy = dyStringNew(0);
va_list args;
va_start(args, format);
vaWarn(format, args);
if (qs->errMessage)
{
dyStringAppend(dy, qs->errMessage);
dyStringAppendC(dy, '\n');
}
dyStringVaPrintf(dy, format, args);
va_end(args);
freez(&qs->errMessage);
qs->errMessage = cloneString(dy->string);
dyStringFree(&dy);
}