pcsc-lite 2.3.3
Macros | Enumerations | Functions
debuglog.h File Reference

This handles debugging. More...

Go to the source code of this file.

Macros

#define PCSC_API
 
#define DEBUG_CATEGORY_NOTHING   0
 
#define DEBUG_CATEGORY_APDU   1
 
#define DEBUG_CATEGORY_SW   2
 
#define __FUNCTION__   ""
 
#define __attribute__(x)   /*nothing*/
 
#define Log0(priority)   log_msg(priority, "%s:%d:%s()", __FILE__, __LINE__, __FUNCTION__)
 
#define Log1(priority, fmt)   log_msg(priority, "%s:%d:%s() " fmt, __FILE__, __LINE__, __FUNCTION__)
 
#define Log2(priority, fmt, data)   log_msg(priority, "%s:%d:%s() " fmt, __FILE__, __LINE__, __FUNCTION__, data)
 
#define Log3(priority, fmt, data1, data2)   log_msg(priority, "%s:%d:%s() " fmt, __FILE__, __LINE__, __FUNCTION__, data1, data2)
 
#define Log4(priority, fmt, data1, data2, data3)   log_msg(priority, "%s:%d:%s() " fmt, __FILE__, __LINE__, __FUNCTION__, data1, data2, data3)
 
#define LogRv4(priority, rv, fmt, data1, data2)   log_msg_rv(priority, rv, "%s:%d:%s() " fmt, __FILE__, __LINE__, __FUNCTION__, data1, data2)
 
#define Log5(priority, fmt, data1, data2, data3, data4)   log_msg(priority, "%s:%d:%s() " fmt, __FILE__, __LINE__, __FUNCTION__, data1, data2, data3, data4)
 
#define Log9(priority, fmt, data1, data2, data3, data4, data5, data6, data7, data8)   log_msg(priority, "%s:%d:%s() " fmt, __FILE__, __LINE__, __FUNCTION__, data1, data2, data3, data4, data5, data6, data7, data8)
 
#define LogXxd(priority, msg, buffer, size)   log_xxd(priority, msg, buffer, size)
 
#define DebugLogA(a)   Log1(PCSC_LOG_INFO, a)
 
#define DebugLogB(a, b)   Log2(PCSC_LOG_INFO, a, b)
 
#define DebugLogC(a, b, c)   Log3(PCSC_LOG_INFO, a, b, c)
 

Enumerations

enum  {
  DEBUGLOG_NO_DEBUG = 0 ,
  DEBUGLOG_SYSLOG_DEBUG ,
  DEBUGLOG_STDOUT_DEBUG ,
  DEBUGLOG_STDOUT_COLOR_DEBUG
}
 
enum  {
  PCSC_LOG_DEBUG = 0 ,
  PCSC_LOG_INFO ,
  PCSC_LOG_ERROR ,
  PCSC_LOG_CRITICAL
}
 

Functions

const char * rv2text (unsigned int rv)
 
PCSC_API void log_msg_rv (const int priority, unsigned int rv, const char *fmt,...) __attribute__((format(printf
 
PCSC_API void PCSC_API void log_msg (const int priority, const char *fmt,...) __attribute__((format(printf
 
PCSC_API void PCSC_API void PCSC_API void log_xxd (const int priority, const char *msg, const unsigned char *buffer, const int size)
 
void DebugLogSuppress (const int)
 
void DebugLogSetLogType (const int)
 
void DebugLogSetCategory (const int)
 
void DebugLogCategory (const int, const unsigned char *, const int)
 
PCSC_API void DebugLogSetLevel (const int level)
 

Detailed Description

This handles debugging.

Note
log message is sent to syslog or stderr depending on –foreground command line argument
Log1(priority, "text");
log "text" with priority level priority
Log2(priority, "text: %d", 1234);
log "text: 1234"
the format string can be anything printf() can understand
Log3(priority, "text: %d %d", 1234, 5678);
log "text: 1234 5678"
the format string can be anything printf() can understand
LogXxd(priority, msg, buffer, size);
log "msg" + a hex dump of size bytes of buffer[]

Definition in file debuglog.h.

Macro Definition Documentation

◆ __attribute__

#define __attribute__ (   x)    /*nothing*/

Definition at line 85 of file debuglog.h.

◆ __FUNCTION__

#define __FUNCTION__   ""

Definition at line 81 of file debuglog.h.

◆ DEBUG_CATEGORY_APDU

#define DEBUG_CATEGORY_APDU   1

Definition at line 69 of file debuglog.h.

◆ DEBUG_CATEGORY_NOTHING

#define DEBUG_CATEGORY_NOTHING   0

Definition at line 68 of file debuglog.h.

◆ DEBUG_CATEGORY_SW

#define DEBUG_CATEGORY_SW   2

Definition at line 70 of file debuglog.h.

◆ DebugLogA

#define DebugLogA (   a)    Log1(PCSC_LOG_INFO, a)

Definition at line 118 of file debuglog.h.

◆ DebugLogB

#define DebugLogB (   a,
  b 
)    Log2(PCSC_LOG_INFO, a, b)

Definition at line 119 of file debuglog.h.

◆ DebugLogC

#define DebugLogC (   a,
  b,
  c 
)    Log3(PCSC_LOG_INFO, a, b, c)

Definition at line 120 of file debuglog.h.

◆ Log0

#define Log0 (   priority)    log_msg(priority, "%s:%d:%s()", __FILE__, __LINE__, __FUNCTION__)

Definition at line 107 of file debuglog.h.

◆ Log1

#define Log1 (   priority,
  fmt 
)    log_msg(priority, "%s:%d:%s() " fmt, __FILE__, __LINE__, __FUNCTION__)

Definition at line 108 of file debuglog.h.

◆ Log2

#define Log2 (   priority,
  fmt,
  data 
)    log_msg(priority, "%s:%d:%s() " fmt, __FILE__, __LINE__, __FUNCTION__, data)

Definition at line 109 of file debuglog.h.

◆ Log3

#define Log3 (   priority,
  fmt,
  data1,
  data2 
)    log_msg(priority, "%s:%d:%s() " fmt, __FILE__, __LINE__, __FUNCTION__, data1, data2)

Definition at line 110 of file debuglog.h.

◆ Log4

#define Log4 (   priority,
  fmt,
  data1,
  data2,
  data3 
)    log_msg(priority, "%s:%d:%s() " fmt, __FILE__, __LINE__, __FUNCTION__, data1, data2, data3)

Definition at line 111 of file debuglog.h.

◆ Log5

#define Log5 (   priority,
  fmt,
  data1,
  data2,
  data3,
  data4 
)    log_msg(priority, "%s:%d:%s() " fmt, __FILE__, __LINE__, __FUNCTION__, data1, data2, data3, data4)

Definition at line 113 of file debuglog.h.

◆ Log9

#define Log9 (   priority,
  fmt,
  data1,
  data2,
  data3,
  data4,
  data5,
  data6,
  data7,
  data8 
)    log_msg(priority, "%s:%d:%s() " fmt, __FILE__, __LINE__, __FUNCTION__, data1, data2, data3, data4, data5, data6, data7, data8)

Definition at line 114 of file debuglog.h.

◆ LogRv4

#define LogRv4 (   priority,
  rv,
  fmt,
  data1,
  data2 
)    log_msg_rv(priority, rv, "%s:%d:%s() " fmt, __FILE__, __LINE__, __FUNCTION__, data1, data2)

Definition at line 112 of file debuglog.h.

◆ LogXxd

#define LogXxd (   priority,
  msg,
  buffer,
  size 
)    log_xxd(priority, msg, buffer, size)

Definition at line 115 of file debuglog.h.

◆ PCSC_API

#define PCSC_API

Definition at line 58 of file debuglog.h.

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

Definition at line 61 of file debuglog.h.

◆ anonymous enum

anonymous enum

Definition at line 72 of file debuglog.h.

Function Documentation

◆ DebugLogCategory()

void DebugLogCategory ( const int  category,
const unsigned char *  buffer,
const int  len 
)

Definition at line 419 of file debuglog.c.

◆ DebugLogSetCategory()

void DebugLogSetCategory ( const int  dbginfo)

Definition at line 405 of file debuglog.c.

◆ DebugLogSetLevel()

PCSC_API void DebugLogSetLevel ( const int  level)

Definition at line 380 of file debuglog.c.

◆ DebugLogSetLogType()

void DebugLogSetLogType ( const int  dbgtype)

Definition at line 336 of file debuglog.c.

◆ log_xxd()

PCSC_API void PCSC_API void PCSC_API void log_xxd ( const int  priority,
const char *  msg,
const unsigned char *  buffer,
const int  size 
)

Definition at line 322 of file debuglog.c.

◆ rv2text()

const char * rv2text ( unsigned int  rv)

Definition at line 155 of file debuglog.c.