| … | |
… | |
| 567 | ev_default_loop (ev_recommended_backends () | EVBACKEND_KQUEUE); |
567 | ev_default_loop (ev_recommended_backends () | EVBACKEND_KQUEUE); |
| 568 | |
568 | |
| 569 | =item struct ev_loop *ev_loop_new (unsigned int flags) |
569 | =item struct ev_loop *ev_loop_new (unsigned int flags) |
| 570 | |
570 | |
| 571 | Similar to C<ev_default_loop>, but always creates a new event loop that is |
571 | Similar to C<ev_default_loop>, but always creates a new event loop that is |
| 572 | always distinct from the default loop. Unlike the default loop, it cannot |
572 | always distinct from the default loop. |
| 573 | handle signal and child watchers, and attempts to do so will be greeted by |
|
|
| 574 | undefined behaviour (or a failed assertion if assertions are enabled). |
|
|
| 575 | |
573 | |
| 576 | Note that this function I<is> thread-safe, and the recommended way to use |
574 | Note that this function I<is> thread-safe, and one common way to use |
| 577 | libev with threads is indeed to create one loop per thread, and using the |
575 | libev with threads is indeed to create one loop per thread, and using the |
| 578 | default loop in the "main" or "initial" thread. |
576 | default loop in the "main" or "initial" thread. |
| 579 | |
577 | |
| 580 | Example: Try to create a event loop that uses epoll and nothing else. |
578 | Example: Try to create a event loop that uses epoll and nothing else. |
| 581 | |
579 | |
| … | |
… | |
| 583 | if (!epoller) |
581 | if (!epoller) |
| 584 | fatal ("no epoll found here, maybe it hides under your chair"); |
582 | fatal ("no epoll found here, maybe it hides under your chair"); |
| 585 | |
583 | |
| 586 | =item ev_default_destroy () |
584 | =item ev_default_destroy () |
| 587 | |
585 | |
| 588 | Destroys the default loop again (frees all memory and kernel state |
586 | Destroys the default loop (frees all memory and kernel state etc.). None |
| 589 | etc.). None of the active event watchers will be stopped in the normal |
587 | of the active event watchers will be stopped in the normal sense, so |
| 590 | sense, so e.g. C<ev_is_active> might still return true. It is your |
588 | e.g. C<ev_is_active> might still return true. It is your responsibility to |
| 591 | responsibility to either stop all watchers cleanly yourself I<before> |
589 | either stop all watchers cleanly yourself I<before> calling this function, |
| 592 | calling this function, or cope with the fact afterwards (which is usually |
590 | or cope with the fact afterwards (which is usually the easiest thing, you |
| 593 | the easiest thing, you can just ignore the watchers and/or C<free ()> them |
591 | can just ignore the watchers and/or C<free ()> them for example). |
| 594 | for example). |
|
|
| 595 | |
592 | |
| 596 | Note that certain global state, such as signal state (and installed signal |
593 | Note that certain global state, such as signal state (and installed signal |
| 597 | handlers), will not be freed by this function, and related watchers (such |
594 | handlers), will not be freed by this function, and related watchers (such |
| 598 | as signal and child watchers) would need to be stopped manually. |
595 | as signal and child watchers) would need to be stopped manually. |
| 599 | |
596 | |
