An F# binding for the ZeroMQ distributed computing library.
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
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.
On Linux, the recommended solution is install
libzmq from your distro's package manager. Alternatively, you may build from source.
Please note: in a pinch, the
lib folder in the root of this repo contains Windows, macOS, and Linux binaries of
libzmq. But they're not compiled with all available features for all platforms 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 Framework)
- 64-bit Windows Server 2008 R2 (running against .NET Framework)
- 32-bit and 64-bit Windows 7 (running against .NET Framework or Mono)
- 32-bit and 64-bit Windows 8 (running against .NET Framework or Mono)
- 32-bit and 64-bit Windows 10 (running against .NET Framework, .NET Core, and Mono)
- 32-bit and 64-bit OS X (running against Mono)
- 64-bit Linux (Ubuntu 18.04 running against .NET Core)
Other platform/architecture/runtime combinations should work (so long as .NET Framework, .NET Core, or Mono are supported and there is a native libzmq port).
IMPORTANT NOTE: starting with version 12.3,
fszmqwill only ship as a .NET Standard library (currently, .NET Standard 2). This may have consequences (or limitations) for existing applications wishing to upgrade.
A note about versions
In the past, several attempts were made (poorly) to keep the version of
fszmq synchronized to the version of
Starting with verion
12.0.0 (which is the twelth release... version 4.0.9 was the eleventh release), this is no longer done.
fszmq is versioned independently. The versions of
libzmq supported by each version of
fszmq are as follows
(where 'x' means any number >= 0):
|12.3.x||4.1.x (and a sub-set of 4.2.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.