1 | .\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14) |
1 | .\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) |
2 | .\" |
2 | .\" |
3 | .\" Standard preamble: |
3 | .\" Standard preamble: |
4 | .\" ======================================================================== |
4 | .\" ======================================================================== |
5 | .de Sp \" Vertical space (when we can't use .PP) |
5 | .de Sp \" Vertical space (when we can't use .PP) |
6 | .if t .sp .5v |
6 | .if t .sp .5v |
… | |
… | |
122 | .\} |
122 | .\} |
123 | .rm #[ #] #H #V #F C |
123 | .rm #[ #] #H #V #F C |
124 | .\" ======================================================================== |
124 | .\" ======================================================================== |
125 | .\" |
125 | .\" |
126 | .IX Title "LIBEV 3" |
126 | .IX Title "LIBEV 3" |
127 | .TH LIBEV 3 "2012-05-06" "libev-4.11" "libev - high performance full featured event loop" |
127 | .TH LIBEV 3 "2012-05-26" "libev-4.11" "libev - high performance full featured event loop" |
128 | .\" For nroff, turn off justification. Always turn off hyphenation; it makes |
128 | .\" For nroff, turn off justification. Always turn off hyphenation; it makes |
129 | .\" way too many mistakes in technical documents. |
129 | .\" way too many mistakes in technical documents. |
130 | .if n .ad l |
130 | .if n .ad l |
131 | .nh |
131 | .nh |
132 | .SH "NAME" |
132 | .SH "NAME" |
… | |
… | |
4088 | libev sources can be compiled as \*(C+. Therefore, code that uses the C \s-1API\s0 |
4088 | libev sources can be compiled as \*(C+. Therefore, code that uses the C \s-1API\s0 |
4089 | will work fine. |
4089 | will work fine. |
4090 | .PP |
4090 | .PP |
4091 | Proper exception specifications might have to be added to callbacks passed |
4091 | Proper exception specifications might have to be added to callbacks passed |
4092 | to libev: exceptions may be thrown only from watcher callbacks, all |
4092 | to libev: exceptions may be thrown only from watcher callbacks, all |
4093 | other callbacks (allocator, syserr, loop acquire/release and periodioc |
4093 | other callbacks (allocator, syserr, loop acquire/release and periodic |
4094 | reschedule callbacks) must not throw exceptions, and might need a \f(CW\*(C`throw |
4094 | reschedule callbacks) must not throw exceptions, and might need a \f(CW\*(C`throw |
4095 | ()\*(C'\fR specification. If you have code that needs to be compiled as both C |
4095 | ()\*(C'\fR specification. If you have code that needs to be compiled as both C |
4096 | and \*(C+ you can use the \f(CW\*(C`EV_THROW\*(C'\fR macro for this: |
4096 | and \*(C+ you can use the \f(CW\*(C`EV_THROW\*(C'\fR macro for this: |
4097 | .PP |
4097 | .PP |
4098 | .Vb 6 |
4098 | .Vb 6 |
… | |
… | |
4364 | .IP "Lua" 4 |
4364 | .IP "Lua" 4 |
4365 | .IX Item "Lua" |
4365 | .IX Item "Lua" |
4366 | Brian Maher has written a partial interface to libev for lua (at the |
4366 | Brian Maher has written a partial interface to libev for lua (at the |
4367 | time of this writing, only \f(CW\*(C`ev_io\*(C'\fR and \f(CW\*(C`ev_timer\*(C'\fR), to be found at |
4367 | time of this writing, only \f(CW\*(C`ev_io\*(C'\fR and \f(CW\*(C`ev_timer\*(C'\fR), to be found at |
4368 | http://github.com/brimworks/lua\-ev <http://github.com/brimworks/lua-ev>. |
4368 | http://github.com/brimworks/lua\-ev <http://github.com/brimworks/lua-ev>. |
|
|
4369 | .IP "Javascript" 4 |
|
|
4370 | .IX Item "Javascript" |
|
|
4371 | Node.js (<http://nodejs.org>) uses libev as the underlying event library. |
|
|
4372 | .IP "Others" 4 |
|
|
4373 | .IX Item "Others" |
|
|
4374 | There are others, and I stopped counting. |
4369 | .SH "MACRO MAGIC" |
4375 | .SH "MACRO MAGIC" |
4370 | .IX Header "MACRO MAGIC" |
4376 | .IX Header "MACRO MAGIC" |
4371 | Libev can be compiled with a variety of options, the most fundamental |
4377 | Libev can be compiled with a variety of options, the most fundamental |
4372 | of which is \f(CW\*(C`EV_MULTIPLICITY\*(C'\fR. This option determines whether (most) |
4378 | of which is \f(CW\*(C`EV_MULTIPLICITY\*(C'\fR. This option determines whether (most) |
4373 | functions and callbacks have an initial \f(CW\*(C`struct ev_loop *\*(C'\fR argument. |
4379 | functions and callbacks have an initial \f(CW\*(C`struct ev_loop *\*(C'\fR argument. |
… | |
… | |
4668 | .IX Item "EV_WIN32_CLOSE_FD(fd)" |
4674 | .IX Item "EV_WIN32_CLOSE_FD(fd)" |
4669 | If programs implement their own fd to handle mapping on win32, then this |
4675 | If programs implement their own fd to handle mapping on win32, then this |
4670 | macro can be used to override the \f(CW\*(C`close\*(C'\fR function, useful to unregister |
4676 | macro can be used to override the \f(CW\*(C`close\*(C'\fR function, useful to unregister |
4671 | file descriptors again. Note that the replacement function has to close |
4677 | file descriptors again. Note that the replacement function has to close |
4672 | the underlying \s-1OS\s0 handle. |
4678 | the underlying \s-1OS\s0 handle. |
|
|
4679 | .IP "\s-1EV_USE_WSASOCKET\s0" 4 |
|
|
4680 | .IX Item "EV_USE_WSASOCKET" |
|
|
4681 | If defined to be \f(CW1\fR, libev will use \f(CW\*(C`WSASocket\*(C'\fR to create its internal |
|
|
4682 | communication socket, which works better in some environments. Otherwise, |
|
|
4683 | the normal \f(CW\*(C`socket\*(C'\fR function will be used, which works better in other |
|
|
4684 | environments. |
4673 | .IP "\s-1EV_USE_POLL\s0" 4 |
4685 | .IP "\s-1EV_USE_POLL\s0" 4 |
4674 | .IX Item "EV_USE_POLL" |
4686 | .IX Item "EV_USE_POLL" |
4675 | If defined to be \f(CW1\fR, libev will compile in support for the \f(CW\*(C`poll\*(C'\fR(2) |
4687 | If defined to be \f(CW1\fR, libev will compile in support for the \f(CW\*(C`poll\*(C'\fR(2) |
4676 | backend. Otherwise it will be enabled on non\-win32 platforms. It |
4688 | backend. Otherwise it will be enabled on non\-win32 platforms. It |
4677 | takes precedence over select. |
4689 | takes precedence over select. |