Libevent 可以提供记录内部错误和警告,它也可以记录debugging信息。默认情况下这些信息被写到stderr,但你也可以通过自己的日志函数去重写这种行为。
接口:
```
#define EVENT_LOG_DEBUG 0
#define EVENT_LOG_MSG 1
#define EVENT_LOG_WARN 2
#define EVENT_LOG_ERR 3
#define _EVENT_LOG_DEBUG EVENT_LOG_DEBUG
#define _EVENT_LOG_MSG EVENT_LOG_MSG
#define _EVENT_LOG_WARN EVENT_LOG_WARN
#define _EVENT_LOG_ERR EVENT_LOG_ERR
typedef void (*event_log_cb)(int serverity, const char* msg);//这是日志的回调函数,可重写
void event_set_log_callback(event_log_cb cb);
```
要重写Libevent的日志行为,需要自己重写个event_log_cb,然后传给event_set_log_callback()调用。如果event_log_cb的参数是NULL，则调用默认日志行为
```
#include
#include
static void discard_cb(int severity,const char* msg)
{
printf("logging!");
}
static FILE* logfile = NULL;
static void write_to_file_cb(int severity,const char* msg)
{
const char* s;
if(!logfile)
return;
switch(severity)
{
case _EVENT_LOG_DEBUG: s = "debug";break;
case _EVENT_LOG_MSG: s = "msg"; break;
case _EVENT_LOG_WARN: s = "warn"; break;
case _EVENT_LOG_ERR: s = "error";break;
default: s = "?"; break;
}
fprintf(logfile,"[%s]%s\n",s,msg);
}
void suppress_logging(void)
{
event_set_log_callback(discard_cb);
}
void set_logfile(FILE* f)
{
logfile = f;
event_set_log_callback(write_to_file_cb);
}
```
一般情况下,Libevent不会开启debug日志,而且也不会被发向日志回调函数,但也可以手动打开debug日志
接口:
```
#define EVENT_DBG_NONE 0
#define EVENT_DBG_ALL 0xffffffffu
void event_enable_debug_logging(ev_uint32_t which);
```
通过调用event_enable_debug_logging()用EVENT_DBG_NONE参数得到默认行为,用EVENT_DBG_ALL打开所有支持的debug日志
处理致命错误
当Libevent检测到一个不可恢复的内部错误时,它的默认行为是调用exit()和abort()函数退出当前进程。这种情况通常表明有bug
你也可以通过重写行为去更好的解决致命错误,通过提供自己的函数
接口:
```
typedef void (*event_fatal_cb)(int err);
void event_set_fatal_callback(event_fatal_cb cb);
```
一旦调用了自己的函数，就应该不要再调用任何libevent的函数了,因为libevent可能会为了避免崩溃而退出
内存管理:
默认情况下,libevent用c的内存管理去从堆上分配空间。你也可以让libevent用你自己的内存管理。
接口：
```
void event_set_mem_functions(void* (*malloc_fn)(size_t sz),void* (*realloc_fn)(void* ptr,size_t sz),void(*free_fn)(void* ptr));
```
例子：
```
#include
#include
#include
union alignment
{
size_t sz;
void* ptr;
double dbl;
};
#define ALIGNMENT sizeof(union alignment)
#define OUTPTR(ptr) (((char*)ptr)+ALIGNMENT)
#define INPTR(ptr) (((char*)ptr)-ALIGNMENT)
static size_t total_allocated = 0;
static void* replacement_malloc(size_t sz)
{
void* chunk = malloc(sz+ALIGNMENT);
if(!chunk) return chunk;
total_allocated += sz;
*(size_t*)chunk = sz;
return OUTPTR(chunk);
}
static void* replacement_realloc(void* ptr,size_t sz)
{
size_t old_size = 0;
if(ptr)
{
ptr = INPTR(ptr);
old_size = *(size_t*)ptr;
}
ptr = realloc(ptr,sz+ALIGNMENT);
if(!ptr)
return NULL;
*(size_t*)ptr = sz;
total_allocated = total_allocated - old_size + sz;
return OUTPTR(ptr);
}
static void replacement_free(void* ptr)
{
ptr = INPTR(ptr);
total_allocated -= *(size_t*)ptr;
free(ptr);
}
void start_counting_bytes(void)
{
event_set_mem_functions(replacement_malloc,replacement_realloc,replacement_free);
}
```
锁和线程
Libevent的结构可以在多线程情况下以三种方式工作:
1，一些结构是固有的单线程的，同时在多线程下使用不安全
2，一些结构是可选锁的，可以告知Libevent在要使用时锁住
3, 一些结构是一直锁的, 在多线程情况下是一直安全的
在得到锁之前,你必须告诉Libevent用哪个函数
接口:
```
#ifdef WIN32
int evthread_use_windows_threads(void);
#define EVTHREAD_USE_WINDOWS_THREADS_IMPLEMENTED
#endif
#ifdef _EVENT_HAVE_PTHREADS
int evthread_use_pthreads(void);
#define EVTHREAD_USE_PTHREADS_IMPLEMENTED
#endif
```
如果你要使用不同的线程库,那你需要定义以下功能：
Locks
locking
unlocking
lock allocation
lock destruction
Conditions
condition variable creation
condition variable destruction
waiting on a condition variable
signaling/broadcasting to a condition variable
Threads
thread ID detection
然后通过evthread_set_lock_callbacks和evthread_set_id_callback接口来告诉Libevent
接口:
```
#define EVTHREAD_WRITE 0x04
#define EVTHREAD_READ 0x08
#define EVTHREAD_TRY 0x10
#define EVTHREAD_LOCKTYPE_RECURSIVE 1
#define EVTHREAD_LOCKTYPE_READWRITE 2
#define EVTHREAD_LOCK_API_VERSION 1
struct evthread_lock_callbacks {
int lock_api_version;
unsigned supported_locktypes;
void* (*alloc)(unsigned locktype);
void (*free)(void *lock,unsigned locktype);
int (*lock)(unsigned mode,void* lock);
int(*unlock(unsigned mode,void* lock);
};
int evthread_set_lock_callbacks(conststruct evthread_lock_callbacks *);
void evthread_set_id_callback(unsignedlong (*id_fn)(void));
struct evthread_condition_callbacks {
int condition_api_version;
void*(*alloc_condition)(unsignedcondtype);
void(*free_condition)(void*cond);
int(*signal_condition)(void*cond,intbroadcast);
int(*wait_condition)(void*cond,void*lock,conststructtimeval *timeout);};
intevthread_set_condition_callbacks(conststructevthread_condition_callbacks *);
```