metamod-r/src/log_meta.h

#ifndef LOG_META_H
#define LOG_META_H

#include "comp_dep.h"
#include "osdep.h"	//unlikely, OPEN_ARGS

// Debug logging.  
//
// This is done as a macro, rather than a function.  This way, you can add
// DEBUG statements all over, without worrying about performance
// implications.  If the debugging level is set low, all those statements
// will only generate a simple float/int compare each; if we were to use a
// function instead of a macro, it would end up wasting a lot of cpu cycles
// calling/returning from the function every time.  With a fair number of
// DEBUG statements, or if they're placed in frequently excuted code, the
// overhead of the wasted function calls could significantly impact server
// performance.
//
// For this reason, we also compare directly to the float value of the
// cvar, rather than calling CVAR_GET_FLOAT() and thus generating a string
// compare for each DEBUG statement.
//
// Called as: 
//    META_DEBUG(3, ("return code: %d", ret)); 
//
// Note the double parens, and the missing parens around "args" in the
// macro itself.  Note also the "do..while(0)" loop wrapping the
// statements, so they become a single statement when expanded, necessary
// for times when it might be called as a single-statement result of an
// else (or other flow control).
//
// Yes, it's all a bit of a hack.
//
// Using meta_debug_value instead of meta_debug.value.
// meta_debug_value is preconverted int-value of meta_debug.value.
// Reason for this optimization: Integer compare is much faster than float compare.
// i686 has fast float compare, but since we want to have i386 binary, we use this.

#ifdef __BUILD_FAST_METAMOD__
	#define META_DEBUG(level, args) do { break; } while(0)
#else
	#define META_DEBUG(level, args) \
		do { \
			if(unlikely(meta_debug_value >= level)) { \
				META_DEBUG_SET_LEVEL(level); \
				META_DO_DEBUG args; \
			} \
		} while(0)
#endif

// max buffer size for printed messages
#define MAX_LOGMSG_LEN	1024

// max buffer size for client messages
#define MAX_CLIENTMSG_LEN 128

extern cvar_t meta_debug DLLHIDDEN;
extern int meta_debug_value DLLHIDDEN;

// META_DEV provides debug logging via the cvar "developer" (when set to 1)
// and uses a function call rather than a macro as it's really intended to
// be used only during startup, before meta_debug has been set from reading
// server.cfg.
// NOTE: META_DEV has now been mostly obsoleted in the code.

void DLLINTERNAL META_CONS(const char *fmt, ...);
void DLLINTERNAL META_DEV(const char *fmt, ...);
void DLLINTERNAL META_INFO(const char *fmt, ...);
void DLLINTERNAL META_WARNING(const char *fmt, ...);
void DLLINTERNAL META_ERROR(const char *fmt, ...);
void DLLINTERNAL META_LOG(const char *fmt, ...);
void DLLINTERNAL META_CLIENT(edict_t *pEntity, const char *fmt, ...);
#ifndef __BUILD_FAST_METAMOD__
	void DLLINTERNAL META_DEBUG_SET_LEVEL(int level);
	void DLLINTERNAL META_DO_DEBUG(const char *fmt, ...);
#endif

void DLLINTERNAL flush_ALERT_buffer(void);

#endif /* LOG_META_H */