Linux中Libevent编程介绍

今天药忘吃喽~ 2022-12-17 15:58 214阅读 0赞

# Libevent开发 #

*  依赖库：基于Linux中libevent库进行的事件响应
 *  基本介绍：

Libevent是一个基于事件触发的网络库 ，跨平台的网络库，使用了select epoll kqueue编程结构，拥有高效的处理性能 ，数据处理模块

*  重点对象：

event_base 是event集合，存储监听的event 
    
    struct event { 
        TAILQ_ENTRY (event) ev_next;//用来链接IO时间
        TAILQ_ENTRY (event) ev_active_next;//用来链接就绪事件，实际插入对应的
        TAILQ_ENTRY (event) ev_signal_next;//用来链接信号事件
        unsigned int min_heap_idx;  /* for managing timeouts事件在堆中的下标 */
    
        struct event_base *ev_base;
    
        int ev_fd;//对于I/O事件,是绑定的文件描述符;对于signal事件,是绑定的信号
        short ev_events;//event关注的事件类型
        /* 包含三个事件：IO事件：EV_READ和EV_WRITE 信号事件：EV_SIGNAL 定时器事件：EV_TIMEOUT */
        short ev_ncalls;//事件就绪执行时，调用ev_callback的次数
        short *ev_pncalls;  /* Allows deletes in callback */
    
        struct timeval ev_timeout;//timout事件的超时值
    
        int ev_pri;     /* smaller numbers are higher priority 优先级*/
    
        void (*ev_callback)(int, short, void *arg);//回调函数
        void *ev_arg;//回调函数的参数
    
        int ev_res;     /* result passed to event callback 传递给回调函数 */
        int ev_flags;//表明事件当前处于何种状态
        /* 依据事件处于不同状态将其加入不同的链表中。 */
    }
    
    struct event_base { 
        const struct eventop *evsel;//底层具体I/O demultiplex操作函数集
        void *evbase;//存储IO复用返回的文件描述符相关 evbase
        int event_count;        /* counts number of total events总的事件数量 */
        int event_count_active; /* counts number of active events 就绪事件数量*/
    
        int event_gotterm;      /* Set to terminate loop */
        int event_break;        /* Set to terminate loop immediately */
    
        /* active event management */
        struct event_list **activequeues;//指针数组 ，就绪事件链表数组,每个元素防止一个链表头部
        int nactivequeues;//就绪事件队列个数，指针数组维度，也就是优先级个数
    
        /* signal handling info */
        struct evsignal_info sig;//用于管理信号
    
        struct event_list eventqueue;//注册事件队列
        struct timeval event_tv;
    
        struct min_heap timeheap;//管理定时器的小根堆
    
        struct timeval tv_cache;//记录时间缓存
    }

*  编程流程(面向对象的流程)

1. 创建对象 
    struct event_base *event_base_new(void)
    2. 销毁对象
    void event_base_free(struct event_base * base);
    3. 获取当前自动选择的IO模型 
    event_base_get_method 
    4. 使用对象
    基于事件循环的方法进行事件等待，event loop 
    event_base_dispatch(struct *event_base * base)
    在内部不断循环监听注册上来的事件 返回0成功 
    int event_base_loop(struct event_base*base ,flag);
    1. EVLOOP_ONCE 0x01
      
    引起循环退出的情况：
    	1.event_base中没有事件了 
    	2.调用event_base_loopbreak 事件循环会停止 (立即停止)
    	3.调用event_base_loopexit  (等待所有事件结束后停止)
    	4. 程序错误 
    
    特定头+len 
    固定长度包
    特殊接收符包

# 关于libevent库 #

Libevent 是一个轻量级的开源高性能网络库，有几个显著的亮点：

*  事件驱动（event-driven），高性能;
 *  轻量级，专注于网络，不如 ACE 那么臃肿庞大；
 *  源代码相当精炼、易读；
 *  跨平台，支持 Windows、 Linux、 \*BSD 和 Mac Os；
 *  支持多种 I/O 多路复用技术， epoll、 poll、 dev/poll、 select 和 kqueue 等；
 *  支持 I/O，定时器和信号等事件；
 *  注册事件优先级；

Libevent 已经被广泛的应用，作为底层的网络库；比如 memcached、Vomit、Nylon、Netchat等等。

# 关于libevent的安装 #

下载安装包

> 官网：[http://www.monkey.org/~provos…][http_www.monkey.org_provos]  
> 下载：[http://www.monkey.org/~provos…][http_www.monkey.org_provos 1]

解压

# tar zxvf libevent-2.0.10-stable.tar.gz

进入目录

# cd libevent-2.0.10-stable

切换到root

# su

安装gcc

# yum install gcc

设置安装路径  
不加这句的话，**默认安装目录在/usr/local/lib**

# ./configure --prefix=/usr

编译

# make

安装

# make install

测试libevent是否安装成功：

**\# ls -al /usr/lib | grep libevent**

lrwxrwxrwx 1 root root 21 11?? 12 17:38 libevent-1.2.so.1 -> libevent-1.2.so.1.0.3  
\-rwxr-xr-x 1 root root 263546 11?? 12 17:38 libevent-1.2.so.1.0.3  
\-rw-r–r– 1 root root 454156 11?? 12 17:38 libevent.a  
\-rwxr-xr-x 1 root root 811 11?? 12 17:38 libevent.la  
lrwxrwxrwx 1 root root 21 11?? 12 17:38 libevent.so -> libevent-1.2.so.1.0.3

$ wget http://monkey.org/~provos/libevent-1.4.14b-stable.tar.gz
    $ tar xzf libevent-1.4.14b-stable.tar.gz
    $ cd libevent-1.4.14b-stable
    $ ./configure --prefix=/opt/libevent
    # hopefully, you haven't encountered any errors so far
    $ make
    # make install
    apt-get install libevent-dev 
    
    gcc -g -o event_base event_base.c -levent

# 安装问题 #

1.  频繁报了openssl问题
    
     *  首先先排查你究竟装了libevent没有，我在给朋友重新配置环境时候，怎么都会报错，该试的都试了，最后结果在/usr/local/lib/下面看到了一堆的libevent.so，这个真的是，太无语了。  
        言归正传，如果你不是设置过./configure的话，**默认安装目录在/usr/local/lib**下面，装前你先看一看嘛，又不吃亏，不行的话可以 find 一下嘛
     *  如果真的不行，那么可能openssl的目录不在系统的默认路径置中，那么可以加入一个软连接
        
            # ln -sf /usr/local/ssl/include/openssl /usr/include/openssl
     *  如果还是有问题，那么可能是你的openssl的版本太低，可以试试升级
        
            # yum update openssl -y

# libevent的使用 #

第一个例子：

int main()
    {
        int sockfd = create_socket();
    
        struct event_base * base = event_init();
        assert( base != NULL );
    
        struct event* ev_sock = event_new(base,sockfd,EV_READ|EV_PERSIST,accept_cb,(void*)base);
        assert( ev_sock != NULL );
        event_add(ev_sock,NULL);
    
        event_base_dispatch(base);
        event_free(ev_sock);
        event_base_free(base);
    }

第二个例子：

int main()
    {
        struct event_base *base = event_init();
        struct event *signal_event = evsignal_new(base,SIGINT,signal_cb,base);
        event_add(signal_event,NULL);
    
        struct timeval tv = {3,0};
        struct event *timeout_event = evtimer_new(base,timeout_cb,NULL);
        event_add(timeout_event,&tv);
    
        event_base_dispatch(base);
    
        event_free(timeout_event);
        event_free(signal_event);
        event_base_free(base);
    }

这两个简单例子反映了event库使用时的代码逻辑：

1.  首先用event\_init()来构建一个event\_base对象
2.  创建具体的事件event \*用来表示具体事件，用evsignal\_new，或者evtimer\_new来注册事件，两个函数本质上来说都是对函数event\_new()的封装
    
        struct event* event_new(struct event_base *base, evutil_socket_t fd,
                                short event, void (*cb)(evutil_socket_t fd, 
                                short event, void *arg),void *arg);
        
        //short event所使用的宏名
        #define EV_TIMEOUT 0x01 //定时时间
        #define EV_READ    0x01 //可读时间
        #define EV_WRITE   0x01 //可写时间
        #define EV_SIGNAL  0x01 //信号时间
        #define EV_PERSIST 0x01 //永久时间
        #define EV_ET      0x20 //边缘触发，epoll下的ET模式
3.  调用event\_add()函数，将事件注册到事件表中去
4.  调用event\_base\_dispatch()执行事件循环
5.  事件结束后，利用event\_free()来释放事件资源，利用event\_base\_free()来释放event\_free对象
    
    > 如果事件表中都是一次性事件，一次事件触发后会结束事件从此不再监听  
    > evtimer\_new()默认的超时事件是一个一次性的事件，如果需要多次监听，可以从event\_new中进行详细的设置  
    > event\_new()中，信号事件直接在fd处写入信号名称，如果是超时事件，则用-1来表明

[http_www.monkey.org_provos]: http://www.monkey.org/~provos/libevent/
[http_www.monkey.org_provos 1]: http://www.monkey.org/~provos/libevent-2.0.10-stable.tar.gz