Libevent 기초

Status
Publishing
Created By
Empty
Last Edited Time
7/13/2020, 3:35:00 PM
Description
libevent의 event, event_base를 주로 다룬다
Tags
C/C++
libevent
개요
각각의 요청을 실제로 처리하기 위해, libevent 라이브러리는 기본 네트워크 백엔드 주위에서 랩퍼 역할을 하는 이벤트 메커니즘을 제공한다
이벤트 시스템을 사용하면 기본 I/O 복잡성을 간소화하는 한편, 연결을 위한 핸들러를 매우 쉽고 간단하게 추가할 수 있다.
libevent 라이브러리가 실제로는 select()poll() 또는 다른 메커니즘의 기초를 대체하지는 못한다.
주요 구성요소
event : 특정 조건에서 발생되는 사건
event_base : event들을 관리하기 위한 구조체
event_base
libevent를 사용하기 전, 하나 혹은 그 이상의 event_base_structure를 생성해야 한다. 각각의 event_base_structure는 설정된 이벤트를 감시하며, Poll 한다.
만약 event_base가 Locking 을 사용한다면 멀티 스레드 환경에서도 안전하게 사용이 가능하지만, 만약 사용하지 않는다면 반드시 싱글 스레드 환경에서만 사용해야 한다.
각각의 event_base는 어떤 이벤트들이 준비됐는지 확인하기 위해 "메소드" 혹은 "백엔드"를 사용한다.
메소드(백엔드)의 종류
select
poll
epoll
kqueue
devpoll
evport
win32
event_base 생성
struct event_base *event_base_new(void);
C
event_base_new() 함수는 event_base를 기본 설정 상태로 생성하고 반환한다.
만약 여러 개의 메소드가 있다면, 동작 OS에서 가장 빨리 작동하는 메소드를 자동으로 선택한다.
반환값은 성공하면 새로 생성한 event_base 포인터를 반환하고 에러가 발생하면 NULL을 반환한다.
event_base 해제
void event_base_free(struct event_base *base);
C
event_base의 사용이 끝났다면, event_base_free() 함수를 통해 메모리를 해제해주어야 한다.
매개 변수 설명
*base : 메모리 해제할 event_base
반환값은 없다.
이 함수를 사용한다고 해서 event_base와 연동된 다른 오브젝트들 까지 메모리 해제가 되는 것이 아니며, 소켓을 종료하는 것이 아니다.
event
libevent의 기본 실행 단위.
이벤트의 상태 종류
file descriptor의 read/write 준비 완료
file descriptor의 read/write 준비 중(Egde-triggered1) IO Only)
timeout 만료
signal 발생
사용자 정의 trigger
event 생명주기
event 생성
struct event *event_new(struct event_base *base, evutil_socket_t fd, short what, event_callback_fn cb, void *arg);
C
매개 변수 설명
*base : event가 포함될 event_base
fd : read/write 하고자 하는 file descriptor 값
what : flag set
cb : 함수 이벤트가 active 되면, 호출할 함수
*arg : cb 호출 시 cb로 넘겨줄 매개 변수
반환값은 성공하면 새로 생성된 event 포인터, 에러가 발생하면 NULL을 반환한다.
모든 이벤트는 생성 직후 초기화(initialized) 상태 혹은 non-pending 상태가 된다.
flag set
flag
설명
EV_READ
Open
등록한 file descriptor가 Read 가능한 상태일 때 active 된다.
EV_WRITE
Open
등록한 file descriptor가 Write 가능한 상태일 때 active 된다.
EV_SIGNAL
Open
등록한 시그널이 감지될 때 active 된다.
EV_PERSIST
Open
해당 이벤트는 영구적임을 나타난다.
EV_ET
Open
event_base 의 백엔드가 Edge-trigger 를 지원할 때, 해당 이벤트가 Edge-triggered 를 사용한다는 것을 나타낸다. EV_READ/EV_WRITE 의 Edge-trigger 버전이다.
Count6
event 해제
void event_free(struct event *event);
C
매개 변수 설명
*event : 메모리 해제할 event
반환값은 없다.
해당 함수는 event가 pending이나 active 상태에서 호출해도 되지만, non-pending이나 inactive 상태에서 메모리 해제된다.
eventevent_base loop에 추가
int event_add(struct event *ev, const struct timeval *tv);
C
pending 상태로 만들기 위해서 사용한다.
매개 변수 설명
*ev : pending 상태를 만들기 위한 event
*tv : 설정한 값의 시간(seconds, microseconds) 후에 active 된다.
반환값은 성공하면 0, 에러가 발생하면 -1를 반환한다.
eventevent_bass loop에서 삭제
int event_del(struct event *ev);
C
non-pending 상태로 만들기 위해서 사용한다.
매개 변수 설명
*ev : non-pending 상태를 만들기 위한 event
반환값은 성공하면 0, 에러가 발생하면 -1를 반환한다.
event loop 동작
loop의 기본 흐름(flags 미포함)
loop flag
flag
설명
event_base 에 등록된 이벤트들중 하나 혹은 하나이상의 이벤트가 "active" 될 때까지 대기를 한다. 이후 active 된 이벤트를 실행한다. 실행할 active된 이벤트가 없으면 반환한다.
EVLOOP_NONBLOCK
Open
event_base 에 등록된 이벤트가 "trigger" 될 때까지 대기하지 않고 즉시 “trigger”된 이벤트만 확인한 후 active된 이벤트를 실행하고 반환한다.
EVLOOP_NO_EXIT_ON_EMPTY
Open
event_base_loopbreak(), event_base_loopexit() 를 호출하거나 에러가 발생하지 않는 이상, 계속해서 루프를 돌게 된다.
Count3
loop 흐름(flags 포함)