Linux Audio

Check our new training course

Loading...
v6.2
  1/* SPDX-License-Identifier: GPL-2.0 */
  2/*
  3 *   S/390 debug facility
  4 *
  5 *    Copyright IBM Corp. 1999, 2020
  6 */
  7#ifndef _ASM_S390_DEBUG_H
  8#define _ASM_S390_DEBUG_H
  9
 10#include <linux/string.h>
 11#include <linux/spinlock.h>
 12#include <linux/kernel.h>
 13#include <linux/time.h>
 14#include <linux/refcount.h>
 15#include <linux/fs.h>
 16#include <linux/init.h>
 17
 18#define DEBUG_MAX_LEVEL		   6  /* debug levels range from 0 to 6 */
 19#define DEBUG_OFF_LEVEL		   -1 /* level where debug is switched off */
 20#define DEBUG_FLUSH_ALL		   -1 /* parameter to flush all areas */
 21#define DEBUG_MAX_VIEWS		   10 /* max number of views in proc fs */
 22#define DEBUG_MAX_NAME_LEN	   64 /* max length for a debugfs file name */
 23#define DEBUG_DEFAULT_LEVEL	   3  /* initial debug level */
 24
 25#define DEBUG_DIR_ROOT "s390dbf" /* name of debug root directory in proc fs */
 26
 27#define DEBUG_DATA(entry) (char *)(entry + 1) /* data is stored behind */
 28					      /* the entry information */
 
 
 29
 30#define __DEBUG_FEATURE_VERSION	   3  /* version of debug feature */
 31
 32struct __debug_entry {
 33	unsigned long clock	: 60;
 34	unsigned long exception	:  1;
 35	unsigned long level	:  3;
 36	void *caller;
 37	unsigned short cpu;
 38} __packed;
 39
 40typedef struct __debug_entry debug_entry_t;
 41
 42struct debug_view;
 43
 44typedef struct debug_info {
 45	struct debug_info *next;
 46	struct debug_info *prev;
 47	refcount_t ref_count;
 48	spinlock_t lock;
 49	int level;
 50	int nr_areas;
 51	int pages_per_area;
 52	int buf_size;
 53	int entry_size;
 54	debug_entry_t ***areas;
 55	int active_area;
 56	int *active_pages;
 57	int *active_entries;
 58	struct dentry *debugfs_root_entry;
 59	struct dentry *debugfs_entries[DEBUG_MAX_VIEWS];
 60	struct debug_view *views[DEBUG_MAX_VIEWS];
 61	char name[DEBUG_MAX_NAME_LEN];
 62	umode_t mode;
 63} debug_info_t;
 64
 65typedef int (debug_header_proc_t) (debug_info_t *id,
 66				   struct debug_view *view,
 67				   int area,
 68				   debug_entry_t *entry,
 69				   char *out_buf);
 70
 71typedef int (debug_format_proc_t) (debug_info_t *id,
 72				   struct debug_view *view, char *out_buf,
 73				   const char *in_buf);
 74typedef int (debug_prolog_proc_t) (debug_info_t *id,
 75				   struct debug_view *view,
 76				   char *out_buf);
 77typedef int (debug_input_proc_t) (debug_info_t *id,
 78				  struct debug_view *view,
 79				  struct file *file,
 80				  const char __user *user_buf,
 81				  size_t in_buf_size, loff_t *offset);
 82
 83int debug_dflt_header_fn(debug_info_t *id, struct debug_view *view,
 84			 int area, debug_entry_t *entry, char *out_buf);
 85
 
 
 
 86struct debug_view {
 87	char name[DEBUG_MAX_NAME_LEN];
 88	debug_prolog_proc_t *prolog_proc;
 89	debug_header_proc_t *header_proc;
 90	debug_format_proc_t *format_proc;
 91	debug_input_proc_t  *input_proc;
 92	void		    *private_data;
 93};
 94
 95extern struct debug_view debug_hex_ascii_view;
 
 96extern struct debug_view debug_sprintf_view;
 97
 98/* do NOT use the _common functions */
 99
100debug_entry_t *debug_event_common(debug_info_t *id, int level,
101				  const void *data, int length);
102
103debug_entry_t *debug_exception_common(debug_info_t *id, int level,
104				      const void *data, int length);
105
106/* Debug Feature API: */
107
108debug_info_t *debug_register(const char *name, int pages, int nr_areas,
109			     int buf_size);
110
111debug_info_t *debug_register_mode(const char *name, int pages, int nr_areas,
112				  int buf_size, umode_t mode, uid_t uid,
113				  gid_t gid);
114
115void debug_unregister(debug_info_t *id);
116
117void debug_set_level(debug_info_t *id, int new_level);
118
119void debug_set_critical(void);
120
121void debug_stop_all(void);
122
123/**
124 * debug_level_enabled() - Returns true if debug events for the specified
125 *			   level would be logged. Otherwise returns false.
126 *
127 * @id:		handle for debug log
128 * @level:	debug level
129 *
130 * Return:
131 * - %true if level is less or equal to the current debug level.
132 */
133static inline bool debug_level_enabled(debug_info_t *id, int level)
134{
135	return level <= id->level;
136}
137
138/**
139 * debug_event() - writes binary debug entry to active debug area
140 *		   (if level <= actual debug level)
141 *
142 * @id:		handle for debug log
143 * @level:	debug level
144 * @data:	pointer to data for debug entry
145 * @length:	length of data in bytes
146 *
147 * Return:
148 * - Address of written debug entry
149 * - %NULL if error
150 */
151static inline debug_entry_t *debug_event(debug_info_t *id, int level,
152					 void *data, int length)
153{
154	if ((!id) || (level > id->level) || (id->pages_per_area == 0))
155		return NULL;
156	return debug_event_common(id, level, data, length);
157}
158
159/**
160 * debug_int_event() - writes unsigned integer debug entry to active debug area
161 *		       (if level <= actual debug level)
162 *
163 * @id:		handle for debug log
164 * @level:	debug level
165 * @tag:	integer value for debug entry
166 *
167 * Return:
168 * - Address of written debug entry
169 * - %NULL if error
170 */
171static inline debug_entry_t *debug_int_event(debug_info_t *id, int level,
172					     unsigned int tag)
173{
174	unsigned int t = tag;
175
176	if ((!id) || (level > id->level) || (id->pages_per_area == 0))
177		return NULL;
178	return debug_event_common(id, level, &t, sizeof(unsigned int));
179}
180
181/**
182 * debug_long_event() - writes unsigned long debug entry to active debug area
183 *		       (if level <= actual debug level)
184 *
185 * @id:		handle for debug log
186 * @level:	debug level
187 * @tag:	long integer value for debug entry
188 *
189 * Return:
190 * - Address of written debug entry
191 * - %NULL if error
192 */
193static inline debug_entry_t *debug_long_event(debug_info_t *id, int level,
194					      unsigned long tag)
195{
196	unsigned long t = tag;
197
198	if ((!id) || (level > id->level) || (id->pages_per_area == 0))
199		return NULL;
200	return debug_event_common(id, level, &t, sizeof(unsigned long));
201}
202
203/**
204 * debug_text_event() - writes string debug entry in ascii format to active
205 *			debug area (if level <= actual debug level)
206 *
207 * @id:		handle for debug log
208 * @level:	debug level
209 * @txt:	string for debug entry
210 *
211 * Return:
212 * - Address of written debug entry
213 * - %NULL if error
214 */
215static inline debug_entry_t *debug_text_event(debug_info_t *id, int level,
216					      const char *txt)
217{
218	if ((!id) || (level > id->level) || (id->pages_per_area == 0))
219		return NULL;
220	return debug_event_common(id, level, txt, strlen(txt));
221}
222
223/*
224 * IMPORTANT: Use "%s" in sprintf format strings with care! Only pointers are
225 * stored in the s390dbf. See Documentation/s390/s390dbf.rst for more details!
226 */
227extern debug_entry_t *
228__debug_sprintf_event(debug_info_t *id, int level, char *string, ...)
229	__attribute__ ((format(printf, 3, 4)));
230
231/**
232 * debug_sprintf_event() - writes debug entry with format string
233 *			   and varargs (longs) to active debug area
234 *			   (if level $<=$ actual debug level).
235 *
236 * @_id:	handle for debug log
237 * @_level:	debug level
238 * @_fmt:	format string for debug entry
239 * @...:	varargs used as in sprintf()
240 *
241 * Return:
242 * - Address of written debug entry
243 * - %NULL if error
244 *
245 * floats and long long datatypes cannot be used as varargs.
246 */
247#define debug_sprintf_event(_id, _level, _fmt, ...)			\
248({									\
249	debug_entry_t *__ret;						\
250	debug_info_t *__id = _id;					\
251	int __level = _level;						\
252									\
253	if ((!__id) || (__level > __id->level))				\
254		__ret = NULL;						\
255	else								\
256		__ret = __debug_sprintf_event(__id, __level,		\
257					      _fmt, ## __VA_ARGS__);	\
258	__ret;								\
259})
260
261/**
262 * debug_exception() - writes binary debug entry to active debug area
263 *		       (if level <= actual debug level)
264 *		       and switches to next debug area
265 *
266 * @id:		handle for debug log
267 * @level:	debug level
268 * @data:	pointer to data for debug entry
269 * @length:	length of data in bytes
270 *
271 * Return:
272 * - Address of written debug entry
273 * - %NULL if error
274 */
275static inline debug_entry_t *debug_exception(debug_info_t *id, int level,
276					     void *data, int length)
277{
278	if ((!id) || (level > id->level) || (id->pages_per_area == 0))
279		return NULL;
280	return debug_exception_common(id, level, data, length);
281}
282
283/**
284 * debug_int_exception() - writes unsigned int debug entry to active debug area
285 *			   (if level <= actual debug level)
286 *			   and switches to next debug area
287 *
288 * @id:		handle for debug log
289 * @level:	debug level
290 * @tag:	integer value for debug entry
291 *
292 * Return:
293 * - Address of written debug entry
294 * - %NULL if error
295 */
296static inline debug_entry_t *debug_int_exception(debug_info_t *id, int level,
297						 unsigned int tag)
298{
299	unsigned int t = tag;
300
301	if ((!id) || (level > id->level) || (id->pages_per_area == 0))
302		return NULL;
303	return debug_exception_common(id, level, &t, sizeof(unsigned int));
304}
305
306/**
307 * debug_long_exception() - writes long debug entry to active debug area
308 *			   (if level <= actual debug level)
309 *			   and switches to next debug area
310 *
311 * @id:		handle for debug log
312 * @level:	debug level
313 * @tag:	long integer value for debug entry
314 *
315 * Return:
316 * - Address of written debug entry
317 * - %NULL if error
318 */
319static inline debug_entry_t *debug_long_exception (debug_info_t *id, int level,
320						   unsigned long tag)
321{
322	unsigned long t = tag;
323
324	if ((!id) || (level > id->level) || (id->pages_per_area == 0))
325		return NULL;
326	return debug_exception_common(id, level, &t, sizeof(unsigned long));
327}
328
329/**
330 * debug_text_exception() - writes string debug entry in ascii format to active
331 *			    debug area (if level <= actual debug level)
332 *			    and switches to next debug area
333 * area
334 *
335 * @id:	handle for debug log
336 * @level:	debug level
337 * @txt:	string for debug entry
338 *
339 * Return:
340 * - Address of written debug entry
341 * - %NULL if error
342 */
343static inline debug_entry_t *debug_text_exception(debug_info_t *id, int level,
344						  const char *txt)
345{
346	if ((!id) || (level > id->level) || (id->pages_per_area == 0))
347		return NULL;
348	return debug_exception_common(id, level, txt, strlen(txt));
349}
350
351/*
352 * IMPORTANT: Use "%s" in sprintf format strings with care! Only pointers are
353 * stored in the s390dbf. See Documentation/s390/s390dbf.rst for more details!
354 */
355extern debug_entry_t *
356__debug_sprintf_exception(debug_info_t *id, int level, char *string, ...)
357	__attribute__ ((format(printf, 3, 4)));
358
359
360/**
361 * debug_sprintf_exception() - writes debug entry with format string and
362 *			       varargs (longs) to active debug area
363 *			       (if level <= actual debug level)
364 *			       and switches to next debug area.
365 *
366 * @_id:	handle for debug log
367 * @_level:	debug level
368 * @_fmt:	format string for debug entry
369 * @...:	varargs used as in sprintf()
370 *
371 * Return:
372 * - Address of written debug entry
373 * - %NULL if error
374 *
375 * floats and long long datatypes cannot be used as varargs.
376 */
377#define debug_sprintf_exception(_id, _level, _fmt, ...)			\
378({									\
379	debug_entry_t *__ret;						\
380	debug_info_t *__id = _id;					\
381	int __level = _level;						\
382									\
383	if ((!__id) || (__level > __id->level))				\
384		__ret = NULL;						\
385	else								\
386		__ret = __debug_sprintf_exception(__id, __level,	\
387						  _fmt, ## __VA_ARGS__);\
388	__ret;								\
389})
390
391int debug_register_view(debug_info_t *id, struct debug_view *view);
392
393int debug_unregister_view(debug_info_t *id, struct debug_view *view);
394
395#ifndef MODULE
396
397/*
398 * Note: Initial page and area numbers must be fixed to allow static
399 * initialization. This enables very early tracing. Changes to these values
400 * must be reflected in __DEFINE_STATIC_AREA.
401 */
402#define EARLY_PAGES		8
403#define EARLY_AREAS		1
404
405#define VNAME(var, suffix)	__##var##_##suffix
406
407/*
408 * Define static areas for early trace data. During boot debug_register_static()
409 * will replace these with dynamically allocated areas to allow custom page and
410 * area sizes, and dynamic resizing.
411 */
412#define __DEFINE_STATIC_AREA(var)					\
413static char VNAME(var, data)[EARLY_PAGES][PAGE_SIZE] __initdata;	\
414static debug_entry_t *VNAME(var, pages)[EARLY_PAGES] __initdata = {	\
415	(debug_entry_t *)VNAME(var, data)[0],				\
416	(debug_entry_t *)VNAME(var, data)[1],				\
417	(debug_entry_t *)VNAME(var, data)[2],				\
418	(debug_entry_t *)VNAME(var, data)[3],				\
419	(debug_entry_t *)VNAME(var, data)[4],				\
420	(debug_entry_t *)VNAME(var, data)[5],				\
421	(debug_entry_t *)VNAME(var, data)[6],				\
422	(debug_entry_t *)VNAME(var, data)[7],				\
423};									\
424static debug_entry_t **VNAME(var, areas)[EARLY_AREAS] __initdata = {	\
425	(debug_entry_t **)VNAME(var, pages),				\
426};									\
427static int VNAME(var, active_pages)[EARLY_AREAS] __initdata;		\
428static int VNAME(var, active_entries)[EARLY_AREAS] __initdata
429
430#define __DEBUG_INFO_INIT(var, _name, _buf_size) {			\
431	.next = NULL,							\
432	.prev = NULL,							\
433	.ref_count = REFCOUNT_INIT(1),					\
434	.lock = __SPIN_LOCK_UNLOCKED(var.lock),				\
435	.level = DEBUG_DEFAULT_LEVEL,					\
436	.nr_areas = EARLY_AREAS,					\
437	.pages_per_area = EARLY_PAGES,					\
438	.buf_size = (_buf_size),					\
439	.entry_size = sizeof(debug_entry_t) + (_buf_size),		\
440	.areas = VNAME(var, areas),					\
441	.active_area = 0,						\
442	.active_pages = VNAME(var, active_pages),			\
443	.active_entries = VNAME(var, active_entries),			\
444	.debugfs_root_entry = NULL,					\
445	.debugfs_entries = { NULL },					\
446	.views = { NULL },						\
447	.name = (_name),						\
448	.mode = 0600,							\
449}
450
451#define __REGISTER_STATIC_DEBUG_INFO(var, name, pages, areas, view)	\
452static int __init VNAME(var, reg)(void)					\
453{									\
454	debug_register_static(&var, (pages), (areas));			\
455	debug_register_view(&var, (view));				\
456	return 0;							\
457}									\
458arch_initcall(VNAME(var, reg))
459
460/**
461 * DEFINE_STATIC_DEBUG_INFO - Define static debug_info_t
462 *
463 * @var: Name of debug_info_t variable
464 * @name: Name of debug log (e.g. used for debugfs entry)
465 * @pages: Number of pages per area
466 * @nr_areas: Number of debug areas
467 * @buf_size: Size of data area in each debug entry
468 * @view: Pointer to debug view struct
469 *
470 * Define a static debug_info_t for early tracing. The associated debugfs log
471 * is automatically registered with the specified debug view.
472 *
473 * Important: Users of this macro must not call any of the
474 * debug_register/_unregister() functions for this debug_info_t!
475 *
476 * Note: Tracing will start with a fixed number of initial pages and areas.
477 * The debug area will be changed to use the specified numbers during
478 * arch_initcall.
479 */
480#define DEFINE_STATIC_DEBUG_INFO(var, name, pages, nr_areas, buf_size, view) \
481__DEFINE_STATIC_AREA(var);						\
482static debug_info_t __refdata var =					\
483	__DEBUG_INFO_INIT(var, (name), (buf_size));			\
484__REGISTER_STATIC_DEBUG_INFO(var, name, pages, nr_areas, view)
485
486void debug_register_static(debug_info_t *id, int pages_per_area, int nr_areas);
487
488#endif /* MODULE */
489
490#endif /* _ASM_S390_DEBUG_H */
v4.10.11
 
  1/*
  2 *   S/390 debug facility
  3 *
  4 *    Copyright IBM Corp. 1999, 2000
  5 */
  6#ifndef DEBUG_H
  7#define DEBUG_H
  8
  9#include <linux/string.h>
 10#include <linux/spinlock.h>
 11#include <linux/kernel.h>
 12#include <linux/time.h>
 13#include <uapi/asm/debug.h>
 
 
 
 
 
 
 
 
 
 14
 15#define DEBUG_MAX_LEVEL            6  /* debug levels range from 0 to 6 */
 16#define DEBUG_OFF_LEVEL            -1 /* level where debug is switched off */
 17#define DEBUG_FLUSH_ALL            -1 /* parameter to flush all areas */
 18#define DEBUG_MAX_VIEWS            10 /* max number of views in proc fs */
 19#define DEBUG_MAX_NAME_LEN         64 /* max length for a debugfs file name */
 20#define DEBUG_DEFAULT_LEVEL        3  /* initial debug level */
 21
 22#define DEBUG_DIR_ROOT "s390dbf" /* name of debug root directory in proc fs */
 23
 24#define DEBUG_DATA(entry) (char*)(entry + 1) /* data is stored behind */
 25                                             /* the entry information */
 
 
 
 
 
 26
 27typedef struct __debug_entry debug_entry_t;
 28
 29struct debug_view;
 30
 31typedef struct debug_info {	
 32	struct debug_info* next;
 33	struct debug_info* prev;
 34	atomic_t ref_count;
 35	spinlock_t lock;			
 36	int level;
 37	int nr_areas;
 38	int pages_per_area;
 39	int buf_size;
 40	int entry_size;	
 41	debug_entry_t*** areas;
 42	int active_area;
 43	int *active_pages;
 44	int *active_entries;
 45	struct dentry* debugfs_root_entry;
 46	struct dentry* debugfs_entries[DEBUG_MAX_VIEWS];
 47	struct debug_view* views[DEBUG_MAX_VIEWS];	
 48	char name[DEBUG_MAX_NAME_LEN];
 49	umode_t mode;
 50} debug_info_t;
 51
 52typedef int (debug_header_proc_t) (debug_info_t* id,
 53				   struct debug_view* view,
 54				   int area,
 55				   debug_entry_t* entry,
 56				   char* out_buf);
 57
 58typedef int (debug_format_proc_t) (debug_info_t* id,
 59				   struct debug_view* view, char* out_buf,
 60				   const char* in_buf);
 61typedef int (debug_prolog_proc_t) (debug_info_t* id,
 62				   struct debug_view* view,
 63				   char* out_buf);
 64typedef int (debug_input_proc_t) (debug_info_t* id,
 65				  struct debug_view* view,
 66				  struct file* file,
 67				  const char __user *user_buf,
 68				  size_t in_buf_size, loff_t* offset);
 
 
 
 69
 70int debug_dflt_header_fn(debug_info_t* id, struct debug_view* view,
 71		         int area, debug_entry_t* entry, char* out_buf);						
 72				
 73struct debug_view {
 74	char name[DEBUG_MAX_NAME_LEN];
 75	debug_prolog_proc_t* prolog_proc;
 76	debug_header_proc_t* header_proc;
 77	debug_format_proc_t* format_proc;
 78	debug_input_proc_t*  input_proc;
 79	void*                private_data;
 80};
 81
 82extern struct debug_view debug_hex_ascii_view;
 83extern struct debug_view debug_raw_view;
 84extern struct debug_view debug_sprintf_view;
 85
 86/* do NOT use the _common functions */
 87
 88debug_entry_t* debug_event_common(debug_info_t* id, int level, 
 89                                  const void* data, int length);
 90
 91debug_entry_t* debug_exception_common(debug_info_t* id, int level, 
 92                                      const void* data, int length);
 93
 94/* Debug Feature API: */
 95
 96debug_info_t *debug_register(const char *name, int pages, int nr_areas,
 97                             int buf_size);
 98
 99debug_info_t *debug_register_mode(const char *name, int pages, int nr_areas,
100				  int buf_size, umode_t mode, uid_t uid,
101				  gid_t gid);
102
103void debug_unregister(debug_info_t* id);
104
105void debug_set_level(debug_info_t* id, int new_level);
106
107void debug_set_critical(void);
 
108void debug_stop_all(void);
109
110static inline bool debug_level_enabled(debug_info_t* id, int level)
 
 
 
 
 
 
 
 
 
 
111{
112	return level <= id->level;
113}
114
115static inline debug_entry_t*
116debug_event(debug_info_t* id, int level, void* data, int length)
 
 
 
 
 
 
 
 
 
 
 
 
 
117{
118	if ((!id) || (level > id->level) || (id->pages_per_area == 0))
119		return NULL;
120        return debug_event_common(id,level,data,length);
121}
122
123static inline debug_entry_t*
124debug_int_event(debug_info_t* id, int level, unsigned int tag)
 
 
 
 
 
 
 
 
 
 
 
 
125{
126        unsigned int t=tag;
 
127	if ((!id) || (level > id->level) || (id->pages_per_area == 0))
128		return NULL;
129        return debug_event_common(id,level,&t,sizeof(unsigned int));
130}
131
132static inline debug_entry_t *
133debug_long_event (debug_info_t* id, int level, unsigned long tag)
 
 
 
 
 
 
 
 
 
 
 
 
134{
135        unsigned long t=tag;
 
136	if ((!id) || (level > id->level) || (id->pages_per_area == 0))
137		return NULL;
138        return debug_event_common(id,level,&t,sizeof(unsigned long));
139}
140
141static inline debug_entry_t*
142debug_text_event(debug_info_t* id, int level, const char* txt)
 
 
 
 
 
 
 
 
 
 
 
 
143{
144	if ((!id) || (level > id->level) || (id->pages_per_area == 0))
145		return NULL;
146        return debug_event_common(id,level,txt,strlen(txt));
147}
148
149/*
150 * IMPORTANT: Use "%s" in sprintf format strings with care! Only pointers are
151 * stored in the s390dbf. See Documentation/s390/s390dbf.txt for more details!
152 */
153extern debug_entry_t *
154__debug_sprintf_event(debug_info_t *id, int level, char *string, ...)
155	__attribute__ ((format(printf, 3, 4)));
156
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
157#define debug_sprintf_event(_id, _level, _fmt, ...)			\
158({									\
159	debug_entry_t *__ret;						\
160	debug_info_t *__id = _id;					\
161	int __level = _level;						\
 
162	if ((!__id) || (__level > __id->level))				\
163		__ret = NULL;						\
164	else								\
165		__ret = __debug_sprintf_event(__id, __level,		\
166					      _fmt, ## __VA_ARGS__);	\
167	__ret;								\
168})
169
170static inline debug_entry_t*
171debug_exception(debug_info_t* id, int level, void* data, int length)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
172{
173	if ((!id) || (level > id->level) || (id->pages_per_area == 0))
174		return NULL;
175        return debug_exception_common(id,level,data,length);
176}
177
178static inline debug_entry_t*
179debug_int_exception(debug_info_t* id, int level, unsigned int tag)
 
 
 
 
 
 
 
 
 
 
 
 
 
180{
181        unsigned int t=tag;
 
182	if ((!id) || (level > id->level) || (id->pages_per_area == 0))
183		return NULL;
184        return debug_exception_common(id,level,&t,sizeof(unsigned int));
185}
186
187static inline debug_entry_t *
188debug_long_exception (debug_info_t* id, int level, unsigned long tag)
 
 
 
 
 
 
 
 
 
 
 
 
 
189{
190        unsigned long t=tag;
 
191	if ((!id) || (level > id->level) || (id->pages_per_area == 0))
192		return NULL;
193        return debug_exception_common(id,level,&t,sizeof(unsigned long));
194}
195
196static inline debug_entry_t*
197debug_text_exception(debug_info_t* id, int level, const char* txt)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
198{
199	if ((!id) || (level > id->level) || (id->pages_per_area == 0))
200		return NULL;
201        return debug_exception_common(id,level,txt,strlen(txt));
202}
203
204/*
205 * IMPORTANT: Use "%s" in sprintf format strings with care! Only pointers are
206 * stored in the s390dbf. See Documentation/s390/s390dbf.txt for more details!
207 */
208extern debug_entry_t *
209__debug_sprintf_exception(debug_info_t *id, int level, char *string, ...)
210	__attribute__ ((format(printf, 3, 4)));
211
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
212#define debug_sprintf_exception(_id, _level, _fmt, ...)			\
213({									\
214	debug_entry_t *__ret;						\
215	debug_info_t *__id = _id;					\
216	int __level = _level;						\
 
217	if ((!__id) || (__level > __id->level))				\
218		__ret = NULL;						\
219	else								\
220		__ret = __debug_sprintf_exception(__id, __level,	\
221						  _fmt, ## __VA_ARGS__);\
222	__ret;								\
223})
224
225int debug_register_view(debug_info_t* id, struct debug_view* view);
226int debug_unregister_view(debug_info_t* id, struct debug_view* view);
 
 
 
227
228/*
229   define the debug levels:
230   - 0 No debugging output to console or syslog
231   - 1 Log internal errors to syslog, ignore check conditions 
232   - 2 Log internal errors and check conditions to syslog
233   - 3 Log internal errors to console, log check conditions to syslog
234   - 4 Log internal errors and check conditions to console
235   - 5 panic on internal errors, log check conditions to console
236   - 6 panic on both, internal errors and check conditions
237 */
238
239#ifndef DEBUG_LEVEL
240#define DEBUG_LEVEL 4
241#endif
242
243#define INTERNAL_ERRMSG(x,y...) "E" __FILE__ "%d: " x, __LINE__, y
244#define INTERNAL_WRNMSG(x,y...) "W" __FILE__ "%d: " x, __LINE__, y
245#define INTERNAL_INFMSG(x,y...) "I" __FILE__ "%d: " x, __LINE__, y
246#define INTERNAL_DEBMSG(x,y...) "D" __FILE__ "%d: " x, __LINE__, y
247
248#if DEBUG_LEVEL > 0
249#define PRINT_DEBUG(x...) printk ( KERN_DEBUG PRINTK_HEADER x )
250#define PRINT_INFO(x...) printk ( KERN_INFO PRINTK_HEADER x )
251#define PRINT_WARN(x...) printk ( KERN_WARNING PRINTK_HEADER x )
252#define PRINT_ERR(x...) printk ( KERN_ERR PRINTK_HEADER x )
253#define PRINT_FATAL(x...) panic ( PRINTK_HEADER x )
254#else
255#define PRINT_DEBUG(x...) printk ( KERN_DEBUG PRINTK_HEADER x )
256#define PRINT_INFO(x...) printk ( KERN_DEBUG PRINTK_HEADER x )
257#define PRINT_WARN(x...) printk ( KERN_DEBUG PRINTK_HEADER x )
258#define PRINT_ERR(x...) printk ( KERN_DEBUG PRINTK_HEADER x )
259#define PRINT_FATAL(x...) printk ( KERN_DEBUG PRINTK_HEADER x )
260#endif				/* DASD_DEBUG */
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
261
262#endif				/* DEBUG_H */