1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
What is JZMQ?
-------------
This is the Java language binding for libzmq (aka ZeroMQ, 0MQ).
[](https://travis-ci.org/zeromq/jzmq)
The latest [javadocs](http://zeromq.github.com/jzmq/javadocs/).
Building and Installing JZMQ
----------------------------
To build you need to have the libzmq library already installed, then you run:
```bash
./autogen.sh
./configure
make
make install
```
Avoiding JNI
------------
JZMQ uses JNI to wrap libzmq for the best performance. If performance isn't your primary goal, look at the [JeroMQ](https://github.com/zeromq/jeromq) project, which is a pure Java implementation that provides an identical API to JZMQ, and uses the same protocol.
Building Packages
-----------------
To build a Debian package, run:
```bash
$ dpkg-buildpackage -rfakeroot
```
To build an RPM package, run:
```bash
$ rpmbuild -tb jzmq-X.Y.Z.tar.gz
```
Where X.Y.Z is replaced with the version that you've downloaded.
If configure can't find your libzmq installation, you can tell it where to look, using e.g. `--with-zeromq=/usr/local`.
You may want to take a look at http://www.zeromq.org/docs:tuning-zeromq for additional hints.
For more information, refer to the ØMQ website at http://www.zeromq.org/.
On Mac OS X you may need to compile and make install pkg-config if configure fails with "syntax error near unexpected token newline".
See http://stackoverflow.com/questions/3522248/how-do-i-compile-jzmq-for-zeromq-on-osx for details.
You may also need to symlink the header files of your standard Java installation (e.g. `/Developer/SDKs/MacOSX10.6.sdk/System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK/Headers/*.h`) into a suitable directory (e.g. `/usr/local/include`) and point the `JAVA_HOME` environment variable to the parent directory (e.g.`/usr/local`).
## Acknowledgements
YourKit is kindly supporting ZeroMQ project with its full-featured [Java Profiler](http://www.yourkit.com/java/profiler/index.jsp).
Copying
-------
Free use of this software is granted under the terms of the GNU Lesser General
Public License (LGPL). For details see the files `COPYING` and `COPYING.LESSER`
included with the Java binding for ØMQ.
|
