2
/* pngerror.c - stub functions for i/o and memory allocation
4
* Last changed in libpng 1.4.0 [January 3, 2010]
5
* Copyright (c) 1998-2010 Glenn Randers-Pehrson
6
* (Version 0.96 Copyright (c) 1996, 1997 Andreas Dilger)
7
* (Version 0.88 Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.)
9
* This code is released under the libpng license.
10
* For conditions of distribution and use, see the disclaimer
11
* and license in png.h
13
* This file provides a location for all error handling. Users who
14
* need special error handling are expected to write replacement functions
15
* and use png_set_error_fn() to use those functions. See the instructions
19
#define PNG_NO_PEDANTIC_WARNINGS
21
#if defined(PNG_READ_SUPPORTED) || defined(PNG_WRITE_SUPPORTED)
24
static void /* PRIVATE */
25
png_default_error PNGARG((png_structp png_ptr,
26
png_const_charp error_message)) PNG_NORETURN;
27
#ifdef PNG_WARNINGS_SUPPORTED
28
static void /* PRIVATE */
29
png_default_warning PNGARG((png_structp png_ptr,
30
png_const_charp warning_message));
31
#endif /* PNG_WARNINGS_SUPPORTED */
33
/* This function is called whenever there is a fatal error. This function
34
* should not be changed. If there is a need to handle errors differently,
35
* you should supply a replacement error function and use png_set_error_fn()
36
* to replace the error function at run-time.
38
#ifdef PNG_ERROR_TEXT_SUPPORTED
40
png_error(png_structp png_ptr, png_const_charp error_message)
42
#ifdef PNG_ERROR_NUMBERS_SUPPORTED
47
(PNG_FLAG_STRIP_ERROR_NUMBERS|PNG_FLAG_STRIP_ERROR_TEXT))
49
if (*error_message == PNG_LITERAL_SHARP)
51
/* Strip "#nnnn " from beginning of error message. */
53
for (offset = 1; offset<15; offset++)
54
if (error_message[offset] == ' ')
56
if (png_ptr->flags&PNG_FLAG_STRIP_ERROR_TEXT)
59
for (i = 0; i < offset - 1; i++)
60
msg[i] = error_message[i + 1];
65
error_message += offset;
69
if (png_ptr->flags&PNG_FLAG_STRIP_ERROR_TEXT)
79
if (png_ptr != NULL && png_ptr->error_fn != NULL)
80
(*(png_ptr->error_fn))(png_ptr, error_message);
82
/* If the custom handler doesn't exist, or if it returns,
83
use the default handler, which will not return. */
84
png_default_error(png_ptr, error_message);
88
png_err(png_structp png_ptr)
90
if (png_ptr != NULL && png_ptr->error_fn != NULL)
91
(*(png_ptr->error_fn))(png_ptr, '\0');
93
/* If the custom handler doesn't exist, or if it returns,
94
use the default handler, which will not return. */
95
png_default_error(png_ptr, '\0');
97
#endif /* PNG_ERROR_TEXT_SUPPORTED */
99
#ifdef PNG_WARNINGS_SUPPORTED
100
/* This function is called whenever there is a non-fatal error. This function
101
* should not be changed. If there is a need to handle warnings differently,
102
* you should supply a replacement warning function and use
103
* png_set_error_fn() to replace the warning function at run-time.
106
png_warning(png_structp png_ptr, png_const_charp warning_message)
111
#ifdef PNG_ERROR_NUMBERS_SUPPORTED
113
(PNG_FLAG_STRIP_ERROR_NUMBERS|PNG_FLAG_STRIP_ERROR_TEXT))
116
if (*warning_message == PNG_LITERAL_SHARP)
118
for (offset = 1; offset < 15; offset++)
119
if (warning_message[offset] == ' ')
124
if (png_ptr != NULL && png_ptr->warning_fn != NULL)
125
(*(png_ptr->warning_fn))(png_ptr, warning_message + offset);
127
png_default_warning(png_ptr, warning_message + offset);
129
#endif /* PNG_WARNINGS_SUPPORTED */
131
#ifdef PNG_BENIGN_ERRORS_SUPPORTED
133
png_benign_error(png_structp png_ptr, png_const_charp error_message)
135
if (png_ptr->flags & PNG_FLAG_BENIGN_ERRORS_WARN)
136
png_warning(png_ptr, error_message);
138
png_error(png_ptr, error_message);
142
/* These utilities are used internally to build an error message that relates
143
* to the current chunk. The chunk name comes from png_ptr->chunk_name,
144
* this is used to prefix the message. The message is limited in length
145
* to 63 bytes, the name characters are output as hex digits wrapped in []
146
* if the character is invalid.
148
#define isnonalpha(c) ((c) < 65 || (c) > 122 || ((c) > 90 && (c) < 97))
149
static PNG_CONST char png_digit[16] = {
150
'0', '1', '2', '3', '4', '5', '6', '7', '8', '9',
151
'A', 'B', 'C', 'D', 'E', 'F'
154
#define PNG_MAX_ERROR_TEXT 64
155
#if defined(PNG_WARNINGS_SUPPORTED) || defined(PNG_ERROR_TEXT_SUPPORTED)
156
static void /* PRIVATE */
157
png_format_buffer(png_structp png_ptr, png_charp buffer, png_const_charp
160
int iout = 0, iin = 0;
164
int c = png_ptr->chunk_name[iin++];
167
buffer[iout++] = PNG_LITERAL_LEFT_SQUARE_BRACKET;
168
buffer[iout++] = png_digit[(c & 0xf0) >> 4];
169
buffer[iout++] = png_digit[c & 0x0f];
170
buffer[iout++] = PNG_LITERAL_RIGHT_SQUARE_BRACKET;
174
buffer[iout++] = (png_byte)c;
178
if (error_message == NULL)
182
buffer[iout++] = ':';
183
buffer[iout++] = ' ';
184
png_memcpy(buffer + iout, error_message, PNG_MAX_ERROR_TEXT);
185
buffer[iout + PNG_MAX_ERROR_TEXT - 1] = '\0';
189
#ifdef PNG_READ_SUPPORTED
191
png_chunk_error(png_structp png_ptr, png_const_charp error_message)
193
char msg[18+PNG_MAX_ERROR_TEXT];
195
png_error(png_ptr, error_message);
198
png_format_buffer(png_ptr, msg, error_message);
199
png_error(png_ptr, msg);
202
#endif /* PNG_READ_SUPPORTED */
203
#endif /* PNG_WARNINGS_SUPPORTED || PNG_ERROR_TEXT_SUPPORTED */
205
#ifdef PNG_WARNINGS_SUPPORTED
207
png_chunk_warning(png_structp png_ptr, png_const_charp warning_message)
209
char msg[18+PNG_MAX_ERROR_TEXT];
211
png_warning(png_ptr, warning_message);
214
png_format_buffer(png_ptr, msg, warning_message);
215
png_warning(png_ptr, msg);
218
#endif /* PNG_WARNINGS_SUPPORTED */
220
#ifdef PNG_READ_SUPPORTED
221
#ifdef PNG_BENIGN_ERRORS_SUPPORTED
223
png_chunk_benign_error(png_structp png_ptr, png_const_charp error_message)
225
if (png_ptr->flags & PNG_FLAG_BENIGN_ERRORS_WARN)
226
png_chunk_warning(png_ptr, error_message);
228
png_chunk_error(png_ptr, error_message);
231
#endif /* PNG_READ_SUPPORTED */
233
#ifdef PNG_SETJMP_SUPPORTED
234
/* This API only exists if ANSI-C style error handling is used,
235
* otherwise it is necessary for png_default_error to be overridden.
238
png_set_longjmp_fn(png_structp png_ptr, png_longjmp_ptr longjmp_fn,
241
if (png_ptr == NULL || jmp_buf_size != png_sizeof(jmp_buf))
244
png_ptr->longjmp_fn = longjmp_fn;
245
return &png_ptr->jmpbuf;
249
/* This is the default error handling function. Note that replacements for
250
* this function MUST NOT RETURN, or the program will likely crash. This
251
* function is used by default, or if the program supplies NULL for the
252
* error function pointer in png_set_error_fn().
254
static void /* PRIVATE */
255
png_default_error(png_structp png_ptr, png_const_charp error_message)
257
#ifdef PNG_CONSOLE_IO_SUPPORTED
258
#ifdef PNG_ERROR_NUMBERS_SUPPORTED
259
if (*error_message == PNG_LITERAL_SHARP)
261
/* Strip "#nnnn " from beginning of error message. */
263
char error_number[16];
264
for (offset = 0; offset<15; offset++)
266
error_number[offset] = error_message[offset + 1];
267
if (error_message[offset] == ' ')
270
if ((offset > 1) && (offset < 15))
272
error_number[offset - 1] = '\0';
273
fprintf(stderr, "libpng error no. %s: %s",
274
error_number, error_message + offset + 1);
275
fprintf(stderr, PNG_STRING_NEWLINE);
279
fprintf(stderr, "libpng error: %s, offset=%d",
280
error_message, offset);
281
fprintf(stderr, PNG_STRING_NEWLINE);
287
fprintf(stderr, "libpng error: %s", error_message);
288
fprintf(stderr, PNG_STRING_NEWLINE);
292
#ifdef PNG_SETJMP_SUPPORTED
293
if (png_ptr && png_ptr->longjmp_fn)
295
# ifdef USE_FAR_KEYWORD
298
png_memcpy(jmpbuf, png_ptr->jmpbuf, png_sizeof(jmp_buf));
299
png_ptr->longjmp_fn(jmpbuf, 1);
302
png_ptr->longjmp_fn(png_ptr->jmpbuf, 1);
306
/* Here if not setjmp support or if png_ptr is null. */
308
#ifndef PNG_CONSOLE_IO_SUPPORTED
309
error_message = error_message; /* Make compiler happy */
313
#ifdef PNG_WARNINGS_SUPPORTED
314
/* This function is called when there is a warning, but the library thinks
315
* it can continue anyway. Replacement functions don't have to do anything
316
* here if you don't want them to. In the default configuration, png_ptr is
317
* not used, but it is passed in case it may be useful.
319
static void /* PRIVATE */
320
png_default_warning(png_structp png_ptr, png_const_charp warning_message)
322
#ifdef PNG_CONSOLE_IO_SUPPORTED
323
# ifdef PNG_ERROR_NUMBERS_SUPPORTED
324
if (*warning_message == PNG_LITERAL_SHARP)
327
char warning_number[16];
328
for (offset = 0; offset < 15; offset++)
330
warning_number[offset] = warning_message[offset + 1];
331
if (warning_message[offset] == ' ')
334
if ((offset > 1) && (offset < 15))
336
warning_number[offset + 1] = '\0';
337
fprintf(stderr, "libpng warning no. %s: %s",
338
warning_number, warning_message + offset);
339
fprintf(stderr, PNG_STRING_NEWLINE);
343
fprintf(stderr, "libpng warning: %s",
345
fprintf(stderr, PNG_STRING_NEWLINE);
351
fprintf(stderr, "libpng warning: %s", warning_message);
352
fprintf(stderr, PNG_STRING_NEWLINE);
355
warning_message = warning_message; /* Make compiler happy */
357
png_ptr = png_ptr; /* Make compiler happy */
359
#endif /* PNG_WARNINGS_SUPPORTED */
361
/* This function is called when the application wants to use another method
362
* of handling errors and warnings. Note that the error function MUST NOT
363
* return to the calling routine or serious problems will occur. The return
364
* method used in the default routine calls longjmp(png_ptr->jmpbuf, 1)
367
png_set_error_fn(png_structp png_ptr, png_voidp error_ptr,
368
png_error_ptr error_fn, png_error_ptr warning_fn)
372
png_ptr->error_ptr = error_ptr;
373
png_ptr->error_fn = error_fn;
374
png_ptr->warning_fn = warning_fn;
378
/* This function returns a pointer to the error_ptr associated with the user
379
* functions. The application should free any memory associated with this
380
* pointer before png_write_destroy and png_read_destroy are called.
383
png_get_error_ptr(png_structp png_ptr)
387
return ((png_voidp)png_ptr->error_ptr);
391
#ifdef PNG_ERROR_NUMBERS_SUPPORTED
393
png_set_strip_error_numbers(png_structp png_ptr, png_uint_32 strip_mode)
398
((~(PNG_FLAG_STRIP_ERROR_NUMBERS|PNG_FLAG_STRIP_ERROR_TEXT))&strip_mode);
402
#endif /* PNG_READ_SUPPORTED || PNG_WRITE_SUPPORTED */