2 # ABSTRACT: detect and/or install zeromq
9 Upon installation, the target system is probed for the presence of libzmq. If
10 it is not found, zeromq 3.2.2 is installed in a shared directory. In short,
11 modules that need libzmq can depend on this module to make sure that it is
18 my $version = Alien::ZMQ::lib_version;
22 These options to F<Build.PL> affect the installation of this module.
26 =item --zmq-skip-probe
28 By default, zeromq is not compiled and installed if it is detected to already
29 be on the system. Use this to skip those checks and always install zeromq.
31 =item --zmq-config=...
33 Pass extra flags to zeromq's F<configure> script. You may want to consider
34 passing either C<--with-pgm> or C<--with-system-pgm> if you need support for
35 PGM; this is not enabled by default because it is not supported by every
40 Pass extra flags to the linker when probing for an existing installation of
41 zeromq. In particular, if your F<libzmq.so> file is installed to a special
42 location, you may pass flags such as C<-L/opt/libzmq2/lib -lzmq>.
44 =item --zmq-cflags=...
46 Pass extra flags to the compiler when probing for an existing installation of
47 zeromq. These flags will not be used when actually compiling zeromq from
48 source. For that, just use the C<CFLAGS> environment variable.
54 Probing is only done upon installation, so if you are using a system-installed
55 version of libzmq and you uninstall or upgrade it, you will also need to
56 reinstall this module.
60 Windows is not yet supported. Patches are welcome.
66 =item * L<GitHub project|https://github.com/chazmcgarvey/p5-Alien-ZMQ>
68 =item * L<ZMQ> - good perl bindings for zeromq
70 =item * L<ZeroMQ|http://www.zeromq.org/> - official libzmq website
74 =head1 ACKNOWLEDGEMENTS
76 The design and implementation of this module were influenced by other L<Alien>
77 modules, including L<Alien::GMP> and L<Alien::Tidyp>.
81 Get the version number of libzmq as a dotted version string according to the
90 Get the version number of libzmq as a dotted version string according to the
99 Get the directory containing the F
<zmq
.h
> header file
.
107 Get the directory containing the F
<libzmq
.so
> file
.
115 Get the C compiler flags required to compile a program that uses libzmq
. This
116 is a shortcut
for constructing a C
<-I
> flag using C
<inc_dir
>.
121 "-I'" . inc_dir
. "'";
126 Get the linker flags required to
link a program against libzmq
. This
is
127 a shortcut
for constructing a C
<-L
> flag using C
<lib_dir
>, plus C
<-lzmq
>.
132 "-L'" . lib_dir
. "' -lzmq";