2 /* pngerror.c - stub functions for i/o and memory allocation
4 * Last changed in libpng 1.2.51 [February 6, 2014]
5 * Copyright (c) 1998-2014 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
20 #define PNG_NO_PEDANTIC_WARNINGS
22 #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 /* Prior to 1.2.45 the error_fn received a NULL pointer, expressed
91 * erroneously as '\0', instead of the empty string "". This was
92 * apparently an error, introduced in libpng-1.2.20, and png_default_error
93 * will crash in this case.
95 if (png_ptr
!= NULL
&& png_ptr
->error_fn
!= NULL
)
96 (*(png_ptr
->error_fn
))(png_ptr
, "");
98 /* If the custom handler doesn't exist, or if it returns,
99 use the default handler, which will not return. */
100 png_default_error(png_ptr
, "");
102 #endif /* PNG_ERROR_TEXT_SUPPORTED */
104 #ifdef PNG_WARNINGS_SUPPORTED
105 /* This function is called whenever there is a non-fatal error. This function
106 * should not be changed. If there is a need to handle warnings differently,
107 * you should supply a replacement warning function and use
108 * png_set_error_fn() to replace the warning function at run-time.
111 png_warning(png_structp png_ptr
, png_const_charp warning_message
)
116 #ifdef PNG_ERROR_NUMBERS_SUPPORTED
118 (PNG_FLAG_STRIP_ERROR_NUMBERS
|PNG_FLAG_STRIP_ERROR_TEXT
))
121 if (*warning_message
== PNG_LITERAL_SHARP
)
123 for (offset
= 1; offset
< 15; offset
++)
124 if (warning_message
[offset
] == ' ')
129 if (png_ptr
!= NULL
&& png_ptr
->warning_fn
!= NULL
)
130 (*(png_ptr
->warning_fn
))(png_ptr
, warning_message
+ offset
);
132 png_default_warning(png_ptr
, warning_message
+ offset
);
134 #endif /* PNG_WARNINGS_SUPPORTED */
136 #ifdef PNG_BENIGN_ERRORS_SUPPORTED
138 png_benign_error(png_structp png_ptr
, png_const_charp error_message
)
140 if (png_ptr
->flags
& PNG_FLAG_BENIGN_ERRORS_WARN
)
141 png_warning(png_ptr
, error_message
);
143 png_error(png_ptr
, error_message
);
147 /* These utilities are used internally to build an error message that relates
148 * to the current chunk. The chunk name comes from png_ptr->chunk_name,
149 * this is used to prefix the message. The message is limited in length
150 * to 63 bytes, the name characters are output as hex digits wrapped in []
151 * if the character is invalid.
153 #define isnonalpha(c) ((c) < 65 || (c) > 122 || ((c) > 90 && (c) < 97))
154 static PNG_CONST
char png_digit
[16] = {
155 '0', '1', '2', '3', '4', '5', '6', '7', '8', '9',
156 'A', 'B', 'C', 'D', 'E', 'F'
159 #define PNG_MAX_ERROR_TEXT 64
160 #if defined(PNG_WARNINGS_SUPPORTED) || defined(PNG_ERROR_TEXT_SUPPORTED)
161 static void /* PRIVATE */
162 png_format_buffer(png_structp png_ptr
, png_charp buffer
, png_const_charp
165 int iout
= 0, iin
= 0;
169 int c
= png_ptr
->chunk_name
[iin
++];
172 buffer
[iout
++] = PNG_LITERAL_LEFT_SQUARE_BRACKET
;
173 buffer
[iout
++] = png_digit
[(c
& 0xf0) >> 4];
174 buffer
[iout
++] = png_digit
[c
& 0x0f];
175 buffer
[iout
++] = PNG_LITERAL_RIGHT_SQUARE_BRACKET
;
179 buffer
[iout
++] = (png_byte
)c
;
183 if (error_message
== NULL
)
187 buffer
[iout
++] = ':';
188 buffer
[iout
++] = ' ';
191 while (iin
< PNG_MAX_ERROR_TEXT
-1 && error_message
[iin
] != '\0')
192 buffer
[iout
++] = error_message
[iin
++];
194 /* iin < PNG_MAX_ERROR_TEXT, so the following is safe: */
199 #ifdef PNG_READ_SUPPORTED
201 png_chunk_error(png_structp png_ptr
, png_const_charp error_message
)
203 char msg
[18+PNG_MAX_ERROR_TEXT
];
205 png_error(png_ptr
, error_message
);
208 png_format_buffer(png_ptr
, msg
, error_message
);
209 png_error(png_ptr
, msg
);
212 #endif /* PNG_READ_SUPPORTED */
213 #endif /* PNG_WARNINGS_SUPPORTED || PNG_ERROR_TEXT_SUPPORTED */
215 #ifdef PNG_WARNINGS_SUPPORTED
217 png_chunk_warning(png_structp png_ptr
, png_const_charp warning_message
)
219 char msg
[18+PNG_MAX_ERROR_TEXT
];
221 png_warning(png_ptr
, warning_message
);
224 png_format_buffer(png_ptr
, msg
, warning_message
);
225 png_warning(png_ptr
, msg
);
228 #endif /* PNG_WARNINGS_SUPPORTED */
230 #ifdef PNG_READ_SUPPORTED
231 #ifdef PNG_BENIGN_ERRORS_SUPPORTED
233 png_chunk_benign_error(png_structp png_ptr
, png_const_charp error_message
)
235 if (png_ptr
->flags
& PNG_FLAG_BENIGN_ERRORS_WARN
)
236 png_chunk_warning(png_ptr
, error_message
);
238 png_chunk_error(png_ptr
, error_message
);
241 #endif /* PNG_READ_SUPPORTED */
243 /* This is the default error handling function. Note that replacements for
244 * this function MUST NOT RETURN, or the program will likely crash. This
245 * function is used by default, or if the program supplies NULL for the
246 * error function pointer in png_set_error_fn().
248 static void /* PRIVATE */
249 png_default_error(png_structp png_ptr
, png_const_charp error_message
)
251 #ifdef PNG_CONSOLE_IO_SUPPORTED
252 #ifdef PNG_ERROR_NUMBERS_SUPPORTED
253 if (*error_message
== PNG_LITERAL_SHARP
)
255 /* Strip "#nnnn " from beginning of error message. */
257 char error_number
[16];
258 for (offset
= 0; offset
<15; offset
++)
260 error_number
[offset
] = error_message
[offset
+ 1];
261 if (error_message
[offset
] == ' ')
264 if ((offset
> 1) && (offset
< 15))
266 error_number
[offset
- 1] = '\0';
267 fprintf(stderr
, "libpng error no. %s: %s",
268 error_number
, error_message
+ offset
+ 1);
269 fprintf(stderr
, PNG_STRING_NEWLINE
);
273 fprintf(stderr
, "libpng error: %s, offset=%d",
274 error_message
, offset
);
275 fprintf(stderr
, PNG_STRING_NEWLINE
);
281 fprintf(stderr
, "libpng error: %s", error_message
);
282 fprintf(stderr
, PNG_STRING_NEWLINE
);
286 #ifdef PNG_SETJMP_SUPPORTED
289 # ifdef USE_FAR_KEYWORD
292 png_memcpy(jmpbuf
, png_ptr
->jmpbuf
, png_sizeof(jmp_buf));
296 longjmp(png_ptr
->jmpbuf
, 1);
300 /* Here if not setjmp support or if png_ptr is null. */
302 #ifndef PNG_CONSOLE_IO_SUPPORTED
303 PNG_UNUSED(error_message
) /* Make compiler happy */
307 #ifdef PNG_WARNINGS_SUPPORTED
308 /* This function is called when there is a warning, but the library thinks
309 * it can continue anyway. Replacement functions don't have to do anything
310 * here if you don't want them to. In the default configuration, png_ptr is
311 * not used, but it is passed in case it may be useful.
313 static void /* PRIVATE */
314 png_default_warning(png_structp png_ptr
, png_const_charp warning_message
)
316 #ifdef PNG_CONSOLE_IO_SUPPORTED
317 # ifdef PNG_ERROR_NUMBERS_SUPPORTED
318 if (*warning_message
== PNG_LITERAL_SHARP
)
321 char warning_number
[16];
322 for (offset
= 0; offset
< 15; offset
++)
324 warning_number
[offset
] = warning_message
[offset
+ 1];
325 if (warning_message
[offset
] == ' ')
328 if ((offset
> 1) && (offset
< 15))
330 warning_number
[offset
+ 1] = '\0';
331 fprintf(stderr
, "libpng warning no. %s: %s",
332 warning_number
, warning_message
+ offset
);
333 fprintf(stderr
, PNG_STRING_NEWLINE
);
337 fprintf(stderr
, "libpng warning: %s",
339 fprintf(stderr
, PNG_STRING_NEWLINE
);
345 fprintf(stderr
, "libpng warning: %s", warning_message
);
346 fprintf(stderr
, PNG_STRING_NEWLINE
);
349 PNG_UNUSED(warning_message
) /* Make compiler happy */
351 PNG_UNUSED(png_ptr
) /* Make compiler happy */
353 #endif /* PNG_WARNINGS_SUPPORTED */
355 /* This function is called when the application wants to use another method
356 * of handling errors and warnings. Note that the error function MUST NOT
357 * return to the calling routine or serious problems will occur. The return
358 * method used in the default routine calls longjmp(png_ptr->jmpbuf, 1)
361 png_set_error_fn(png_structp png_ptr
, png_voidp error_ptr
,
362 png_error_ptr error_fn
, png_error_ptr warning_fn
)
366 png_ptr
->error_ptr
= error_ptr
;
367 png_ptr
->error_fn
= error_fn
;
368 png_ptr
->warning_fn
= warning_fn
;
372 /* This function returns a pointer to the error_ptr associated with the user
373 * functions. The application should free any memory associated with this
374 * pointer before png_write_destroy and png_read_destroy are called.
377 png_get_error_ptr(png_structp png_ptr
)
381 return ((png_voidp
)png_ptr
->error_ptr
);
385 #ifdef PNG_ERROR_NUMBERS_SUPPORTED
387 png_set_strip_error_numbers(png_structp png_ptr
, png_uint_32 strip_mode
)
392 ((~(PNG_FLAG_STRIP_ERROR_NUMBERS
|PNG_FLAG_STRIP_ERROR_TEXT
))&strip_mode
);
396 #endif /* PNG_READ_SUPPORTED || PNG_WRITE_SUPPORTED */