Logging API

logging information on stdout/stderr with a common format. More...

Defines
#define	MqDLogC(msgque, proc, level, str)   MqDLogV(msgque,proc,level,"%s",str)
	log a string using formatting
#define	MqDLog(msgque, level, fmt, args...)   if (likely(msgque != NULL) && unlikely(msgque->debug >= level)) MqDLogV(msgque,__func__,level,fmt,args)
	log a vararg string using formatting and checking for logging level
#define	MqSLog(msgque, level, fmt, args...)   if (likely(msgque != NULL) && unlikely(msgque->stat >= level)) MqDLogV(msgque,__func__,level,fmt,args)
	log a vararg string using formatting and checking for statistics level
Functions
MQ_EXTERN const char *	MqLogTime (void)
	get date-time string in logging format
MQ_EXTERN void	MqLog (FILE *channel, const char *fmt,...)
	log vararg string without formatting to stdout/stderr
MQ_EXTERN void	MqDLogV (const MqSP msgque, const char *proc, MQ_INT2 level, const char *fmt,...)
	log vararg string using formatting
MQ_EXTERN void	MqDLogEVL (const MqSP msgque, const char *proc, const char *fmt, va_list ap)
	log a vararg error list using formatting
MQ_EXTERN void	MqDLogEV (const MqSP msgque, const char *proc, const char *fmt,...)
	log a vararg error string using formatting
MQ_EXTERN MQ_STR	MqLogStatus (MqErrorE status)
	convert a MqErrorE into a human readable string
MQ_EXTERN MQ_STR	MqLogType (MqSP const msgque)
	convert a MqS type member into a human readable string
MQ_EXTERN MQ_STR	MqLogContext (MqSP const msgque)
	convert a MqS parent member into a human readable string
MQ_EXTERN MQ_STR	MqLogC (MQ_STR str, MQ_SIZE size)
	convert a MQ_STR into a human readable string.

---

Detailed Description

logging information on stdout/stderr with a common format.

---

Define Documentation

#define MqDLog (  msgque, level, fmt, args...   )     if (likely(msgque != NULL) && unlikely(msgque->debug >= level)) MqDLogV(msgque,__func__,level,fmt,args)

log a vararg string using formatting and checking for logging level Parameters: msgque  link to the MqS object level  debug level 0 <= level <= 9 fmt  vararg format string args  vararg string argument Attention: the prefix string is the calling procedure name Definition at line 59 of file log.h.

#define MqDLogC (  msgque, proc, level, str   )     MqDLogV(msgque,proc,level,"%s",str)

log a string using formatting Parameters: msgque  link to the MqS object proc  prefix string, usually the procedure name level  debug level 0 <= level <= 9 str  string to log Definition at line 51 of file log.h.

#define MqSLog (  msgque, level, fmt, args...   )     if (likely(msgque != NULL) && unlikely(msgque->stat >= level)) MqDLogV(msgque,__func__,level,fmt,args)

log a vararg string using formatting and checking for statistics level Parameters: msgque  link to the MqS object level  statistics level 0 <= level <= 9 fmt  vararg format string args  vararg string argument Attention: the prefix string is the calling procedure name Definition at line 68 of file log.h.

---

Function Documentation

MQ_EXTERN void MqDLogEV (  const MqSP  msgque, const char *  proc, const char *  fmt,   ... )

log a vararg error string using formatting Parameters: msgque  link to the MqS object proc  prefix string, usually the procedure name fmt  vararg format string ...  vararg string argument

MQ_EXTERN void MqDLogEVL (  const MqSP  msgque, const char *  proc, const char *  fmt, va_list  ap )

log a vararg error list using formatting Parameters: msgque  link to the MqS object proc  prefix string, usually the procedure name fmt  vararg format string ap  vararg argument list

MQ_EXTERN void MqDLogV (  const MqSP  msgque, const char *  proc, MQ_INT2  level, const char *  fmt,   ... )

log vararg string using formatting Parameters: msgque  link to the MqS object proc  prefix string, usually the procedure name level  debug level 0 <= level <= 9 fmt  vararg format string

MQ_EXTERN MQ_STR MqLogC (  MQ_STR  str, MQ_SIZE  size )

convert a MQ_STR into a human readable string. replace non ASCII characters with '?' or 'o' (NULL)

---