… | |
… | |
3617 | libev.m4 |
3617 | libev.m4 |
3618 | |
3618 | |
3619 | =head2 PREPROCESSOR SYMBOLS/MACROS |
3619 | =head2 PREPROCESSOR SYMBOLS/MACROS |
3620 | |
3620 | |
3621 | Libev can be configured via a variety of preprocessor symbols you have to |
3621 | Libev can be configured via a variety of preprocessor symbols you have to |
3622 | define before including any of its files. The default in the absence of |
3622 | define before including (or compiling) any of its files. The default in |
3623 | autoconf is documented for every option. |
3623 | the absence of autoconf is documented for every option. |
|
|
3624 | |
|
|
3625 | Symbols marked with "(h)" do not change the ABI, and can have different |
|
|
3626 | values when compiling libev vs. including F<ev.h>, so it is permissible |
|
|
3627 | to redefine them before including F<ev.h> without breakign compatibility |
|
|
3628 | to a compiled library. All other symbols change the ABI, which means all |
|
|
3629 | users of libev and the libev code itself must be compiled with compatible |
|
|
3630 | settings. |
3624 | |
3631 | |
3625 | =over 4 |
3632 | =over 4 |
3626 | |
3633 | |
3627 | =item EV_STANDALONE |
3634 | =item EV_STANDALONE (h) |
3628 | |
3635 | |
3629 | Must always be C<1> if you do not use autoconf configuration, which |
3636 | Must always be C<1> if you do not use autoconf configuration, which |
3630 | keeps libev from including F<config.h>, and it also defines dummy |
3637 | keeps libev from including F<config.h>, and it also defines dummy |
3631 | implementations for some libevent functions (such as logging, which is not |
3638 | implementations for some libevent functions (such as logging, which is not |
3632 | supported). It will also not define any of the structs usually found in |
3639 | supported). It will also not define any of the structs usually found in |
… | |
… | |
3782 | as well as for signal and thread safety in C<ev_async> watchers. |
3789 | as well as for signal and thread safety in C<ev_async> watchers. |
3783 | |
3790 | |
3784 | In the absence of this define, libev will use C<sig_atomic_t volatile> |
3791 | In the absence of this define, libev will use C<sig_atomic_t volatile> |
3785 | (from F<signal.h>), which is usually good enough on most platforms. |
3792 | (from F<signal.h>), which is usually good enough on most platforms. |
3786 | |
3793 | |
3787 | =item EV_H |
3794 | =item EV_H (h) |
3788 | |
3795 | |
3789 | The name of the F<ev.h> header file used to include it. The default if |
3796 | The name of the F<ev.h> header file used to include it. The default if |
3790 | undefined is C<"ev.h"> in F<event.h>, F<ev.c> and F<ev++.h>. This can be |
3797 | undefined is C<"ev.h"> in F<event.h>, F<ev.c> and F<ev++.h>. This can be |
3791 | used to virtually rename the F<ev.h> header file in case of conflicts. |
3798 | used to virtually rename the F<ev.h> header file in case of conflicts. |
3792 | |
3799 | |
3793 | =item EV_CONFIG_H |
3800 | =item EV_CONFIG_H (h) |
3794 | |
3801 | |
3795 | If C<EV_STANDALONE> isn't C<1>, this variable can be used to override |
3802 | If C<EV_STANDALONE> isn't C<1>, this variable can be used to override |
3796 | F<ev.c>'s idea of where to find the F<config.h> file, similarly to |
3803 | F<ev.c>'s idea of where to find the F<config.h> file, similarly to |
3797 | C<EV_H>, above. |
3804 | C<EV_H>, above. |
3798 | |
3805 | |
3799 | =item EV_EVENT_H |
3806 | =item EV_EVENT_H (h) |
3800 | |
3807 | |
3801 | Similarly to C<EV_H>, this macro can be used to override F<event.c>'s idea |
3808 | Similarly to C<EV_H>, this macro can be used to override F<event.c>'s idea |
3802 | of how the F<event.h> header can be found, the default is C<"event.h">. |
3809 | of how the F<event.h> header can be found, the default is C<"event.h">. |
3803 | |
3810 | |
3804 | =item EV_PROTOTYPES |
3811 | =item EV_PROTOTYPES (h) |
3805 | |
3812 | |
3806 | If defined to be C<0>, then F<ev.h> will not define any function |
3813 | If defined to be C<0>, then F<ev.h> will not define any function |
3807 | prototypes, but still define all the structs and other symbols. This is |
3814 | prototypes, but still define all the structs and other symbols. This is |
3808 | occasionally useful if you want to provide your own wrapper functions |
3815 | occasionally useful if you want to provide your own wrapper functions |
3809 | around libev functions. |
3816 | around libev functions. |
… | |
… | |
3880 | |
3887 | |
3881 | Defining C<EV_MINIMAL> to C<2> will additionally reduce the core API to |
3888 | Defining C<EV_MINIMAL> to C<2> will additionally reduce the core API to |
3882 | provide a bare-bones event library. See C<ev.h> for details on what parts |
3889 | provide a bare-bones event library. See C<ev.h> for details on what parts |
3883 | of the API are still available, and do not complain if this subset changes |
3890 | of the API are still available, and do not complain if this subset changes |
3884 | over time. |
3891 | over time. |
|
|
3892 | |
|
|
3893 | =item EV_AVOID_STDIO |
|
|
3894 | |
|
|
3895 | If this is set to C<1> at compiletime, then libev will avoid using stdio |
|
|
3896 | functions (printf, scanf, perror etc.). This will increase the codesize |
|
|
3897 | somewhat, but if your program doesn't otherwise depend on stdio and your |
|
|
3898 | libc allows it, this avoids linking in the stdio library which is quite |
|
|
3899 | big. |
|
|
3900 | |
|
|
3901 | Note that error messages might become less precise when this option is |
|
|
3902 | enabled. |
3885 | |
3903 | |
3886 | =item EV_NSIG |
3904 | =item EV_NSIG |
3887 | |
3905 | |
3888 | The highest supported signal number, +1 (or, the number of |
3906 | The highest supported signal number, +1 (or, the number of |
3889 | signals): Normally, libev tries to deduce the maximum number of signals |
3907 | signals): Normally, libev tries to deduce the maximum number of signals |