1 /*
2  * Copyright (c) 2001-2002 Michael David Adams.
3  * All rights reserved.
4  */
5 
6 /* __START_OF_JASPER_LICENSE__
7  *
8  * JasPer License Version 2.0
9  *
10  * Copyright (c) 2001-2006 Michael David Adams
11  * Copyright (c) 1999-2000 Image Power, Inc.
12  * Copyright (c) 1999-2000 The University of British Columbia
13  *
14  * All rights reserved.
15  *
16  * Permission is hereby granted, free of charge, to any person (the
17  * "User") obtaining a copy of this software and associated documentation
18  * files (the "Software"), to deal in the Software without restriction,
19  * including without limitation the rights to use, copy, modify, merge,
20  * publish, distribute, and/or sell copies of the Software, and to permit
21  * persons to whom the Software is furnished to do so, subject to the
22  * following conditions:
23  *
24  * 1.  The above copyright notices and this permission notice (which
25  * includes the disclaimer below) shall be included in all copies or
26  * substantial portions of the Software.
27  *
28  * 2.  The name of a copyright holder shall not be used to endorse or
29  * promote products derived from the Software without specific prior
30  * written permission.
31  *
32  * THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
33  * LICENSE.  NO USE OF THE SOFTWARE IS AUTHORIZED HEREUNDER EXCEPT UNDER
34  * THIS DISCLAIMER.  THE SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS
35  * "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
36  * BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
37  * PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.  IN NO
38  * EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL
39  * INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING
40  * FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
41  * NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
42  * WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.  NO ASSURANCES ARE
43  * PROVIDED BY THE COPYRIGHT HOLDERS THAT THE SOFTWARE DOES NOT INFRINGE
44  * THE PATENT OR OTHER INTELLECTUAL PROPERTY RIGHTS OF ANY OTHER ENTITY.
45  * EACH COPYRIGHT HOLDER DISCLAIMS ANY LIABILITY TO THE USER FOR CLAIMS
46  * BROUGHT BY ANY OTHER ENTITY BASED ON INFRINGEMENT OF INTELLECTUAL
47  * PROPERTY RIGHTS OR OTHERWISE.  AS A CONDITION TO EXERCISING THE RIGHTS
48  * GRANTED HEREUNDER, EACH USER HEREBY ASSUMES SOLE RESPONSIBILITY TO SECURE
49  * ANY OTHER INTELLECTUAL PROPERTY RIGHTS NEEDED, IF ANY.  THE SOFTWARE
50  * IS NOT FAULT-TOLERANT AND IS NOT INTENDED FOR USE IN MISSION-CRITICAL
51  * SYSTEMS, SUCH AS THOSE USED IN THE OPERATION OF NUCLEAR FACILITIES,
52  * AIRCRAFT NAVIGATION OR COMMUNICATION SYSTEMS, AIR TRAFFIC CONTROL
53  * SYSTEMS, DIRECT LIFE SUPPORT MACHINES, OR WEAPONS SYSTEMS, IN WHICH
54  * THE FAILURE OF THE SOFTWARE OR SYSTEM COULD LEAD DIRECTLY TO DEATH,
55  * PERSONAL INJURY, OR SEVERE PHYSICAL OR ENVIRONMENTAL DAMAGE ("HIGH
56  * RISK ACTIVITIES").  THE COPYRIGHT HOLDERS SPECIFICALLY DISCLAIM ANY
57  * EXPRESS OR IMPLIED WARRANTY OF FITNESS FOR HIGH RISK ACTIVITIES.
58  *
59  * __END_OF_JASPER_LICENSE__
60  */
61 
62 /******************************************************************************\
63 * Includes.
64 \******************************************************************************/
65 
66 #include "jasper/jas_debug.h"
67 #include "jasper/jas_types.h"
68 
69 #include <stdarg.h>
70 #include <stdio.h>
71 
72 /******************************************************************************\
73 * Local data.
74 \******************************************************************************/
75 
76 static int jas_dbglevel = 0;
77 /* The debug level. */
78 
79 /******************************************************************************\
80 * Code for getting/setting the debug level.
81 \******************************************************************************/
82 
83 /* Set the library debug level. */
jas_setdbglevel(int dbglevel)84 int jas_setdbglevel(int dbglevel)
85 {
86 	int olddbglevel;
87 
88 	/* Save the old debug level. */
89 	olddbglevel = jas_dbglevel;
90 
91 	/* Change the debug level. */
92 	jas_dbglevel = dbglevel;
93 
94 	/* Return the old debug level. */
95 	return olddbglevel;
96 }
97 
98 /* Get the library debug level. */
jas_getdbglevel()99 int jas_getdbglevel()
100 {
101 	return jas_dbglevel;
102 }
103 
104 /******************************************************************************\
105 * Code.
106 \******************************************************************************/
107 
108 /* Perform formatted output to standard error. */
jas_eprintf(const char * fmt,...)109 int jas_eprintf(const char *fmt, ...)
110 {
111 	int ret;
112 	va_list ap;
113 
114 	va_start(ap, fmt);
115 	ret = vfprintf(stderr, fmt, ap);
116 	va_end(ap);
117 	return ret;
118 }
119 
120 /* Dump memory to a stream. */
jas_memdump(FILE * out,const void * data,size_t len)121 int jas_memdump(FILE *out, const void *data, size_t len)
122 {
123 	size_t i;
124 	size_t j;
125 	const jas_uchar *dp = data;
126 	for (i = 0; i < len; i += 16) {
127 		fprintf(out, "%04zx:", i);
128 		for (j = 0; j < 16; ++j) {
129 			if (i + j < len) {
130 				fprintf(out, " %02x", dp[i + j]);
131 			}
132 		}
133 		fprintf(out, "\n");
134 	}
135 	return 0;
136 }
137 
138 /******************************************************************************\
139 * Code.
140 \******************************************************************************/
141 
jas_deprecated(const char * s)142 void jas_deprecated(const char *s)
143 {
144 	static const char message[] =
145 	"WARNING!!! WARNING!!! WARNING!!! WARNING!!! WARNING!!! WARNING!!!\n"
146 	"WARNING!!! WARNING!!! WARNING!!! WARNING!!! WARNING!!! WARNING!!!\n"
147 	"WARNING!!! WARNING!!! WARNING!!! WARNING!!! WARNING!!! WARNING!!!\n"
148 	"YOUR CODE IS RELYING ON DEPRECATED FUNCTIONALITY IN THE JASPER LIBRARY.\n"
149 	"THIS FUNCTIONALITY WILL BE REMOVED IN THE NEAR FUTURE.\n"
150 	"PLEASE FIX THIS PROBLEM BEFORE YOUR CODE STOPS WORKING!\n"
151 	;
152 	jas_eprintf("%s", message);
153 	jas_eprintf("The specific problem is as follows:\n%s\n", s);
154 	//abort();
155 }
156