fszmq is an MPLv2-licensed F# binding for the ZeroMQ distributed computing library. It provides a complete binding to versions 2.1.x, 3.2.x, 4.0.x, 4.1.x of ZeroMQ (Note: prior to 4.0.0, each binding is a separate branch in git, as there are some non-compatible differences). This library is primarily designed to be consumed from F#. However, where possible, the library has been designed to appear "friendly" when consumed by other CLR languages (C#, et aliam).
The fszmq library can be installed from NuGet:
PM> Install-Package fszmq
Please note: the fszmq NuGet package ONLY provides the managed fszmq.dll
file.
You need to provide the native libzmq
file(s) appropriate to your platform.
On Windows, the recommended solution is to download a release from the official GitHub repo and then compile it in a recent version of Visual Studio (several versions are supported... check the release docs for more information).
On macOS, the recommended solution is to install zmq
from Homebrew -- the missing package manager.
Please note: in a pinch, the lib
folder in the root of this repo contains Windows and macOS binaries of libzmq
. But they're not compiled with all available features and may not behave as expected.
At this point in time, fszmq has been tested on the following platform/architecture/runtime combinations:
- 32-bit Windows XP (running against .NET)
- 64-bit Windows Server 2008 R2 (running against .NET)
- 32-bit and 64-bit Windows 7 (running against .NET or Mono)
- 32-bit and 64-bit Windows 8 (running against .NET or Mono)
- 32-bit and 64-bit OS X (running against Mono)
Other platform/architecture/runtime combinations should work (so long as .NET or Mono are supported and there is a native libzmq port) and will be tested in due course..
In the past, several attempts were made (poorly) to keep the version of fszmq
synchronized to the version of libzmq
.
Starting with verion 12.0.0
(which is the twelth release... version 4.0.9 was the eleventh release), this is no longer done.
Instead, fszmq
is versioned independently. The versions of libzmq
supported by each version of fszmq
are as follows
(where 'x' means any number >= 0):
fszmq version |
libzmq versions supported |
---|---|
12.2.x | 4.1.x |
12.1.1 | 4.1.x |
12.1.0 | 4.1.x |
12.0.1 | 4.0.x |
4.0.9 | 4.0.5 |
4.0.8 | 4.0.5 |
4.0.6 | 4.0.5 |
4.0.5 | 4.0.5 |
4.0.4 | 4.0.4 |
3.2.7 | 3.2.5 |
3.2.5 | 3.2.5 |
2.2.1 | 2.2.1 |
2.2.0 | 2.2.0 |
2.1.11 | 2.1.x |
2.1.10 | 2.1.x |
2.1.6 | 2.1.x |
More information about ZeroMQ is available at http://zero.mq.
Issues, questions, and concerns may be directed the the Issue Tracker.
If you'd like to help develop and maintain fszmq, please read about CONTRIBUTING.