Change licensing conditions to LGPL.

[mLib] / trace.h

/* -*-c-*-
 *
 * $Id: trace.h,v 1.2 1999/05/05 18:50:31 mdw Exp $
 *
 * Tracing functions for debugging
 *
 * (c) 1998 Straylight/Edgeware
 */

/*----- Licensing notice --------------------------------------------------* 
 *
 * This file is part of the mLib utilities library.
 *
 * mLib is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Library General Public License as
 * published by the Free Software Foundation; either version 2 of the
 * License, or (at your option) any later version.
 * 
 * mLib is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Library General Public License for more details.
 * 
 * You should have received a copy of the GNU Library General Public
 * License along with mLib; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 */

/*----- Revision history --------------------------------------------------*
 *
 * $Log: trace.h,v $
 * Revision 1.2  1999/05/05 18:50:31  mdw
 * Change licensing conditions to LGPL.
 *
 * Revision 1.1.1.1  1998/06/17 23:44:42  mdw
 * Initial version of mLib
 *
 */

#ifndef TRACE_H
#define TRACE_H

#ifdef __cplusplus
  extern "C" {
#endif

#include <stdio.h>

/*----- Functions provided ------------------------------------------------*/

/* --- @trace@ --- *
 *
 * Arguments:	@unsigned int l@ = trace level for output
 *		@const char *f@ = a @printf@-style format string
 *		@...@ = other arguments
 *
 * Returns:	---
 *
 * Use:		Reports a message to the trace output.
 */

extern void trace(unsigned int /*l*/, const char */*f*/, ...);

/* --- @trace_block@ --- *
 *
 * Arguments:	@unsigned int l@ = trace level for output
 *		@const char *s@ = some header string to write
 *		@const void *b@ = pointer to a block of memory to dump
 *		@size_t sz@ = size of the block of memory
 *
 * Returns:	---
 *
 * Use:		Dumps the contents of a block to the trace output.
 */

extern void trace_block(unsigned int /*l*/, const char */*s*/,
			const void */*b*/, size_t /*sz*/);

/* --- @trace_on@ --- *
 *
 * Arguments:	@FILE *fp@ = a file to trace on
 *		@unsigned int l@ = trace level to set
 *
 * Returns:	---
 *
 * Use:		Enables tracing to a file.
 */

extern void trace_on(FILE */*fp*/, unsigned int /*l*/);

/* --- @trace_setLevel@ --- *
 *
 * Arguments:	@unsigned int l@ = trace level to set
 *
 * Returns:	---
 *
 * Use:		Sets the tracing level.
 */

extern void trace_setLevel(unsigned int /*l*/);

/* --- @tracing@ --- *
 *
 * Arguments:	---
 *
 * Returns:	Zero if not tracing, tracing level if tracing.
 *
 * Use:		Informs the caller whether tracing is enabled.
 */

extern unsigned int tracing(void);

/*----- Tracing macros ----------------------------------------------------*/

#ifndef NTRACE
#  define T(x) x
#  define IF_TRACING(l, x) if ((l) & tracing()) x
#else
#  define T(x)
#  define IF_TRACING(l, x)
#endif

/*----- That's all, folks -------------------------------------------------*/

#ifdef __cplusplus
  }
#endif

#endif