diff options
author | Niels Provos <provos@gmail.com> | 2002-04-10 02:20:26 +0000 |
---|---|---|
committer | Niels Provos <provos@gmail.com> | 2002-04-10 02:20:26 +0000 |
commit | 06630e311655f1fde0f9d7fb42a197340caaa133 (patch) | |
tree | fc5e7a2dc86c92f2568128a039c8fec7a8892e95 /event.3 | |
parent | d10f85dbce67c2835eb09c712da691a46d319aac (diff) | |
download | libevent-06630e311655f1fde0f9d7fb42a197340caaa133.tar.gz |
describe signal_*
svn:r19
Diffstat (limited to 'event.3')
-rw-r--r-- | event.3 | 43 |
1 files changed, 41 insertions, 2 deletions
@@ -43,6 +43,11 @@ .Nm timeout_del .Nm timeout_pending , .Nm timeout_initalized , +.Nm signal_set , +.Nm signal_add , +.Nm signal_del +.Nm signal_pending , +.Nm signal_initalized , .Nd execute a function when a specific event occurs .Sh SYNOPSIS .Fd #include <event.h> @@ -72,6 +77,16 @@ .Fn "timeout_pending" "struct event *ev" "struct timeval *tv" .Ft int .Fn "timeout_initialized" "struct event *ev" +.Ft void +.Fn "signal_set" "struct event *ev" "int signal" "void (*fn)(int, short, void *)" "void *arg" +.Ft void +.Fn "signal_add" "struct event *ev" "struct timeval *" +.Ft void +.Fn "signal_del" "struct event *ev" +.Ft int +.Fn "signal_pending" "struct event *ev" "struct timeval *tv" +.Ft int +.Fn "signal_initialized" "struct event *ev" .Ft int .Fa (*event_sigcb)(void) ; .Ft int @@ -165,13 +180,21 @@ The function will be called with the file descriptor that triggered the event and the type of event which will be either .Va EV_TIMEOUT , +.Va EV_SIGNAL , .Va EV_READ , or .Va EV_WRITE . +The additional flag +.Va EV_PERSIST +makes an +.Fn event_add +persistent until +.Fn event_del +has been called. .Pp Once initialized, the .Fa ev -structure can be used in repeatedly in +structure can be used repeatedly with .Fn event_add and .Fn event_del @@ -239,9 +262,25 @@ are abbreviations for common situations where only a timeout is required. The file descriptor passed will be 0, and the event type will be .Va EV_TIMEOUT . .Pp +.Pp +The functions +.Fn signal_set , +.Fn signal_add , +.Fn signal_del , +.Fn signal_initialized , +and +.Fn signal_pending +are abbreviations. +The event type will be a persistent +.Va EV_SIGNAL . +That means +.Fn signal_set +adds +.Va EV_PERSIST . +.Pp It is possible to disable support for .Va kqueue -but setting the environment variable +by setting the environment variable .Va EVENT_NOKQUEUE . .Pp .Sh RETURN VALUES |