blog.bundles.dev

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);

• event_base_new() 함수는 event_base를 기본 설정 상태로 생성하고 반환한다.
• 만약 여러 개의 메소드가 있다면, 동작 OS에서 가장 빨리 작동하는 메소드를 자동으로 선택한다.
• 반환값은 성공하면 새로 생성한 event_base 포인터를 반환하고 에러가 발생하면 NULL을 반환한다.

event_base 해제

void event_base_free(struct event_base *base);

• 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);

• 매개 변수 설명
  • *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_TIMEOUT	event_add 함수에 같이 설장한 시간 뒤에 active 된다.
EV_READ	등록한 file descriptor가 Read 가능한 상태일 때 active 된다.
EV_WRITE	등록한 file descriptor가 Write 가능한 상태일 때 active 된다.
EV_SIGNAL	등록한 시그널이 감지될 때 active 된다.
EV_PERSIST	해당 이벤트는 영구적임을 나타난다.
EV_ET	event_base 의 백엔드가 Edge-trigger 를 지원할 때, 해당 이벤트가 Edge-triggered 를 사용한다는 것을 나타낸다. EV_READ/EV_WRITE 의 Edge-trigger 버전이다.

event 해제

void event_free(struct event *event);

• 매개 변수 설명
  • *event : 메모리 해제할 event
• 반환값은 없다.
• 해당 함수는 event가 pending이나 active 상태에서 호출해도 되지만, non-pending이나 inactive 상태에서 메모리 해제된다.

event를 event_base loop에 추가

int event_add(struct event *ev, const struct timeval *tv);

• pending 상태로 만들기 위해서 사용한다.
• 매개 변수 설명
  • *ev : pending 상태를 만들기 위한 event
  • *tv : 설정한 값의 시간(seconds, microseconds) 후에 active 된다.
• 반환값은 성공하면 0, 에러가 발생하면 -1를 반환한다.

event를 event_bass loop에서 삭제

int event_del(struct event *ev);

• non-pending 상태로 만들기 위해서 사용한다.
• 매개 변수 설명
  • *ev : non-pending 상태를 만들기 위한 event
• 반환값은 성공하면 0, 에러가 발생하면 -1를 반환한다.

event loop 동작

loop의 기본 흐름(flags 미포함)

flag	설명
EVLOOP_ONCE	event_base 에 등록된 이벤트들중 하나 혹은 하나이상의 이벤트가 “active” 될 때까지 대기를 한다. 이후 active 된 이벤트를 실행한다. 실행할 active된 이벤트가 없으면 반환한다.
EVLOOP_NONBLOCK	event_base 에 등록된 이벤트가 “trigger” 될 때까지 대기하지 않고 즉시 “trigger”된 이벤트만 확인한 후 active된 이벤트를 실행하고 반환한다.
EVLOOP_NO_EXIT_ON_EMPTY	event_base_loopbreak(), event_base_loopexit() 를 호출하거나 에러가 발생하지 않는 이상, 계속해서 루프를 돌게 된다.

loop 흐름(flags 포함)