在你能使用任何感兴趣的LibEvent函数之前,你需要分配一个或多个event_base结构体。每个event_base结构体拥有一系列的event,并且可以通过轮询判断哪个event是激活的。
如果一个event_base设置为使用锁定,在多个线程中访问它是安全的,然而只能在一个线程中去处理其事件循环。如果你想在多线程中轮询IO,那么你需要为每个线程分配一个event_base。
注意
未来版本将会支持event_base多线程运行
每个event_base都有一个方法或后台用来决定哪个event已经准备好了。已经验证的可行方法是:
- select;
- poll;
- epoll;
- kqueue;
- devpoll;
- evport;
- win32;
用户可以通过一些环境变量来禁用某些后台,如果想要kqueue后端,设置变量EVENT_NOKQUEUE,诸如此类。如果你想要从程序内部关闭后台,请查看下面的event_config_avoid_method()方法。
1 创建默认的event_base
event_base()函数分配和返回了一个默认参数的event_base,它检验环境变量然后分配了一个指向新的event_base的指针,如果错误则返回NULL。
选择各种方法时,函数会选择其中操作系统支持的最快方法。
接口
struct event_base *event_base_new(void);
就大多数程序而言,这个函数就已经足够了。
event_base_new()函数声明在<event2/event.h>中,首次出现在 libevent1.4.3 版。
2 创建复杂的event_base
如果你想要更多控制你获取到的那种event_base,就需要event_config。event_config是一个不透明结构体,它保存了你设置给event_base的配置信息。当想创建一个event_base时,需要将event_config传入event_base_new_with_config()。
接口
struct event_config *event_config_new(void);
struct event_base *event_base_new_with_config(const struct event_config *cfg);
void event_config_free(struct event_config *cfg);
要用这些函数来创建一个新的event_base,你需要调用event_config_new()函数来分配一个新的event_config,然后调用别的函数,用event_config 告诉它你的需求。最后,调用event_base_new_with_config()函数来获取一个新的event_base,当这些完成后就可以使用event_config_free()函数来释放event_config。
接口
int event_config_avoid_method(struct event_config *cfg, const char *method);
enum event_method_feature
{
EV_FEATURE_ET = 0x01,
EV_FEATURE_O1 = 0x02,
EV_FEATU