2009-07-29 12:07:54 +02:00
|
|
|
/*
|
2016-01-28 15:07:31 +01:00
|
|
|
Copyright (c) 2007-2016 Contributors as noted in the AUTHORS file
|
2009-07-29 12:07:54 +02:00
|
|
|
|
2015-06-02 22:33:55 +02:00
|
|
|
This file is part of libzmq, the ZeroMQ core engine in C++.
|
2009-07-29 12:07:54 +02:00
|
|
|
|
2015-06-02 22:33:55 +02:00
|
|
|
libzmq is free software; you can redistribute it and/or modify it under
|
|
|
|
the terms of the GNU Lesser General Public License (LGPL) as published
|
|
|
|
by the Free Software Foundation; either version 3 of the License, or
|
2009-07-29 12:07:54 +02:00
|
|
|
(at your option) any later version.
|
|
|
|
|
2015-06-02 22:33:55 +02:00
|
|
|
As a special exception, the Contributors give you permission to link
|
|
|
|
this library with independent modules to produce an executable,
|
|
|
|
regardless of the license terms of these independent modules, and to
|
|
|
|
copy and distribute the resulting executable under terms of your choice,
|
|
|
|
provided that you also meet, for each linked independent module, the
|
|
|
|
terms and conditions of the license of that module. An independent
|
|
|
|
module is a module which is not derived from or based on this library.
|
|
|
|
If you modify this library, you must extend this exception to your
|
|
|
|
version of the library.
|
|
|
|
|
|
|
|
libzmq is distributed in the hope that it will be useful, but WITHOUT
|
|
|
|
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
|
|
FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
|
|
|
|
License for more details.
|
2009-07-29 12:07:54 +02:00
|
|
|
|
2010-10-30 15:08:28 +02:00
|
|
|
You should have received a copy of the GNU Lesser General Public License
|
2009-07-29 12:07:54 +02:00
|
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
2013-10-02 12:05:14 +02:00
|
|
|
|
|
|
|
*************************************************************************
|
|
|
|
NOTE to contributors. This file comprises the principal public contract
|
2016-02-01 11:34:36 +01:00
|
|
|
for ZeroMQ API users. Any change to this file supplied in a stable
|
|
|
|
release SHOULD not break existing applications.
|
2013-10-02 12:05:14 +02:00
|
|
|
In practice this means that the value of constants must not change, and
|
|
|
|
that old values may not be reused for new constants.
|
|
|
|
*************************************************************************
|
2009-07-29 12:07:54 +02:00
|
|
|
*/
|
|
|
|
|
2009-08-03 11:30:13 +02:00
|
|
|
#ifndef __ZMQ_H_INCLUDED__
|
|
|
|
#define __ZMQ_H_INCLUDED__
|
2009-07-29 12:07:54 +02:00
|
|
|
|
2013-11-24 12:47:24 +01:00
|
|
|
/* Version macros for compile-time API version detection */
|
|
|
|
#define ZMQ_VERSION_MAJOR 4
|
2018-03-23 20:28:26 +01:00
|
|
|
#define ZMQ_VERSION_MINOR 3
|
|
|
|
#define ZMQ_VERSION_PATCH 1
|
2013-11-24 12:47:24 +01:00
|
|
|
|
2018-02-01 11:46:09 +01:00
|
|
|
#define ZMQ_MAKE_VERSION(major, minor, patch) \
|
|
|
|
((major) *10000 + (minor) *100 + (patch))
|
|
|
|
#define ZMQ_VERSION \
|
|
|
|
ZMQ_MAKE_VERSION (ZMQ_VERSION_MAJOR, ZMQ_VERSION_MINOR, ZMQ_VERSION_PATCH)
|
2013-11-24 12:47:24 +01:00
|
|
|
|
2009-07-29 12:07:54 +02:00
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
2013-02-19 16:49:23 +01:00
|
|
|
#if !defined _WIN32_WCE
|
2009-09-22 12:08:18 +02:00
|
|
|
#include <errno.h>
|
2012-03-14 16:12:28 +01:00
|
|
|
#endif
|
2009-07-29 12:07:54 +02:00
|
|
|
#include <stddef.h>
|
2012-02-16 19:04:25 +01:00
|
|
|
#include <stdio.h>
|
2009-12-10 16:46:22 +01:00
|
|
|
#if defined _WIN32
|
2016-06-01 15:07:16 +02:00
|
|
|
// Set target version to Windows Server 2008, Windows Vista or higher.
|
|
|
|
// Windows XP (0x0501) is supported but without client & server socket types.
|
|
|
|
#ifndef _WIN32_WINNT
|
|
|
|
#define _WIN32_WINNT 0x0600
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifdef __MINGW32__
|
|
|
|
// Require Windows XP or higher with MinGW for getaddrinfo().
|
2018-02-01 11:46:09 +01:00
|
|
|
#if (_WIN32_WINNT >= 0x0501)
|
2016-06-01 15:07:16 +02:00
|
|
|
#else
|
2017-06-29 01:12:15 +02:00
|
|
|
#error You need at least Windows XP target
|
2016-06-01 15:07:16 +02:00
|
|
|
#endif
|
|
|
|
#endif
|
2011-06-18 20:44:03 +02:00
|
|
|
#include <winsock2.h>
|
2009-12-10 16:46:22 +01:00
|
|
|
#endif
|
2009-07-29 12:07:54 +02:00
|
|
|
|
2010-12-01 10:33:07 +01:00
|
|
|
/* Handle DSO symbol visibility */
|
2010-04-12 16:49:13 +02:00
|
|
|
#if defined _WIN32
|
2018-02-01 11:46:09 +01:00
|
|
|
#if defined ZMQ_STATIC
|
|
|
|
#define ZMQ_EXPORT
|
|
|
|
#elif defined DLL_EXPORT
|
|
|
|
#define ZMQ_EXPORT __declspec(dllexport)
|
2009-07-29 12:07:54 +02:00
|
|
|
#else
|
2018-02-01 11:46:09 +01:00
|
|
|
#define ZMQ_EXPORT __declspec(dllimport)
|
|
|
|
#endif
|
|
|
|
#else
|
|
|
|
#if defined __SUNPRO_C || defined __SUNPRO_CC
|
|
|
|
#define ZMQ_EXPORT __global
|
|
|
|
#elif (defined __GNUC__ && __GNUC__ >= 4) || defined __INTEL_COMPILER
|
|
|
|
#define ZMQ_EXPORT __attribute__ ((visibility ("default")))
|
|
|
|
#else
|
|
|
|
#define ZMQ_EXPORT
|
|
|
|
#endif
|
2009-07-29 12:07:54 +02:00
|
|
|
#endif
|
|
|
|
|
2013-05-19 11:01:33 +02:00
|
|
|
/* Define integer types needed for event interface */
|
2014-12-31 13:26:48 +01:00
|
|
|
#define ZMQ_DEFINED_STDINT 1
|
2013-05-19 11:01:33 +02:00
|
|
|
#if defined ZMQ_HAVE_SOLARIS || defined ZMQ_HAVE_OPENVMS
|
2018-02-01 11:46:09 +01:00
|
|
|
#include <inttypes.h>
|
2016-01-18 12:33:51 +01:00
|
|
|
#elif defined _MSC_VER && _MSC_VER < 1600
|
2018-02-01 11:46:09 +01:00
|
|
|
#ifndef int32_t
|
|
|
|
typedef __int32 int32_t;
|
|
|
|
#endif
|
|
|
|
#ifndef uint32_t
|
|
|
|
typedef unsigned __int32 uint32_t;
|
|
|
|
#endif
|
|
|
|
#ifndef uint16_t
|
|
|
|
typedef unsigned __int16 uint16_t;
|
|
|
|
#endif
|
|
|
|
#ifndef uint8_t
|
|
|
|
typedef unsigned __int8 uint8_t;
|
|
|
|
#endif
|
2013-05-19 11:01:33 +02:00
|
|
|
#else
|
2018-02-01 11:46:09 +01:00
|
|
|
#include <stdint.h>
|
2013-05-19 11:01:33 +02:00
|
|
|
#endif
|
|
|
|
|
2016-12-02 00:38:16 +01:00
|
|
|
// 32-bit AIX's pollfd struct members are called reqevents and rtnevents so it
|
|
|
|
// defines compatibility macros for them. Need to include that header first to
|
|
|
|
// stop build failures since zmq_pollset_t defines them as events and revents.
|
|
|
|
#ifdef ZMQ_HAVE_AIX
|
2018-02-01 11:46:09 +01:00
|
|
|
#include <poll.h>
|
2016-12-02 00:38:16 +01:00
|
|
|
#endif
|
|
|
|
|
2013-05-19 11:01:33 +02:00
|
|
|
|
2010-04-11 14:00:40 +02:00
|
|
|
/******************************************************************************/
|
2010-09-04 16:10:14 +02:00
|
|
|
/* 0MQ errors. */
|
2010-04-11 14:00:40 +02:00
|
|
|
/******************************************************************************/
|
2009-09-22 11:52:35 +02:00
|
|
|
|
2010-12-04 23:14:38 +01:00
|
|
|
/* A number random enough not to collide with different errno ranges on */
|
2010-04-11 14:00:40 +02:00
|
|
|
/* different OSes. The assumption is that error_t is at least 32-bit type. */
|
2009-09-22 11:52:35 +02:00
|
|
|
#define ZMQ_HAUSNUMERO 156384712
|
|
|
|
|
2010-04-11 14:00:40 +02:00
|
|
|
/* On Windows platform some of the standard POSIX errnos are not defined. */
|
2009-09-22 12:08:18 +02:00
|
|
|
#ifndef ENOTSUP
|
|
|
|
#define ENOTSUP (ZMQ_HAUSNUMERO + 1)
|
|
|
|
#endif
|
|
|
|
#ifndef EPROTONOSUPPORT
|
|
|
|
#define EPROTONOSUPPORT (ZMQ_HAUSNUMERO + 2)
|
|
|
|
#endif
|
2009-10-01 13:48:04 +02:00
|
|
|
#ifndef ENOBUFS
|
|
|
|
#define ENOBUFS (ZMQ_HAUSNUMERO + 3)
|
|
|
|
#endif
|
|
|
|
#ifndef ENETDOWN
|
|
|
|
#define ENETDOWN (ZMQ_HAUSNUMERO + 4)
|
|
|
|
#endif
|
|
|
|
#ifndef EADDRINUSE
|
|
|
|
#define EADDRINUSE (ZMQ_HAUSNUMERO + 5)
|
|
|
|
#endif
|
|
|
|
#ifndef EADDRNOTAVAIL
|
|
|
|
#define EADDRNOTAVAIL (ZMQ_HAUSNUMERO + 6)
|
|
|
|
#endif
|
2009-11-27 14:30:48 +01:00
|
|
|
#ifndef ECONNREFUSED
|
|
|
|
#define ECONNREFUSED (ZMQ_HAUSNUMERO + 7)
|
|
|
|
#endif
|
2009-12-29 16:42:56 +01:00
|
|
|
#ifndef EINPROGRESS
|
|
|
|
#define EINPROGRESS (ZMQ_HAUSNUMERO + 8)
|
|
|
|
#endif
|
2011-04-09 09:46:59 +02:00
|
|
|
#ifndef ENOTSOCK
|
|
|
|
#define ENOTSOCK (ZMQ_HAUSNUMERO + 9)
|
|
|
|
#endif
|
2012-06-18 23:13:17 +02:00
|
|
|
#ifndef EMSGSIZE
|
|
|
|
#define EMSGSIZE (ZMQ_HAUSNUMERO + 10)
|
|
|
|
#endif
|
2011-08-15 20:39:48 +02:00
|
|
|
#ifndef EAFNOSUPPORT
|
2012-06-18 23:13:17 +02:00
|
|
|
#define EAFNOSUPPORT (ZMQ_HAUSNUMERO + 11)
|
|
|
|
#endif
|
|
|
|
#ifndef ENETUNREACH
|
|
|
|
#define ENETUNREACH (ZMQ_HAUSNUMERO + 12)
|
|
|
|
#endif
|
|
|
|
#ifndef ECONNABORTED
|
|
|
|
#define ECONNABORTED (ZMQ_HAUSNUMERO + 13)
|
|
|
|
#endif
|
|
|
|
#ifndef ECONNRESET
|
|
|
|
#define ECONNRESET (ZMQ_HAUSNUMERO + 14)
|
|
|
|
#endif
|
|
|
|
#ifndef ENOTCONN
|
|
|
|
#define ENOTCONN (ZMQ_HAUSNUMERO + 15)
|
|
|
|
#endif
|
|
|
|
#ifndef ETIMEDOUT
|
|
|
|
#define ETIMEDOUT (ZMQ_HAUSNUMERO + 16)
|
2011-08-15 20:39:48 +02:00
|
|
|
#endif
|
2012-04-04 15:39:11 +02:00
|
|
|
#ifndef EHOSTUNREACH
|
2012-06-18 23:13:17 +02:00
|
|
|
#define EHOSTUNREACH (ZMQ_HAUSNUMERO + 17)
|
2012-04-04 15:39:11 +02:00
|
|
|
#endif
|
2012-06-19 20:15:48 +02:00
|
|
|
#ifndef ENETRESET
|
|
|
|
#define ENETRESET (ZMQ_HAUSNUMERO + 18)
|
|
|
|
#endif
|
2009-09-22 12:08:18 +02:00
|
|
|
|
2010-04-11 14:00:40 +02:00
|
|
|
/* Native 0MQ error codes. */
|
2009-09-22 12:08:18 +02:00
|
|
|
#define EFSM (ZMQ_HAUSNUMERO + 51)
|
|
|
|
#define ENOCOMPATPROTO (ZMQ_HAUSNUMERO + 52)
|
2010-04-11 16:36:27 +02:00
|
|
|
#define ETERM (ZMQ_HAUSNUMERO + 53)
|
2010-09-09 08:25:00 +02:00
|
|
|
#define EMTHREAD (ZMQ_HAUSNUMERO + 54)
|
2009-09-22 11:52:35 +02:00
|
|
|
|
2010-04-11 14:00:40 +02:00
|
|
|
/* This function retrieves the errno as it is known to 0MQ library. The goal */
|
|
|
|
/* of this function is to make the code 100% portable, including where 0MQ */
|
|
|
|
/* compiled with certain CRT library (on Windows) is linked to an */
|
|
|
|
/* application that uses different CRT library. */
|
2011-01-06 08:42:57 +01:00
|
|
|
ZMQ_EXPORT int zmq_errno (void);
|
2010-04-11 14:00:40 +02:00
|
|
|
|
|
|
|
/* Resolves system errors and 0MQ errors to human-readable string. */
|
2009-09-22 11:52:35 +02:00
|
|
|
ZMQ_EXPORT const char *zmq_strerror (int errnum);
|
|
|
|
|
2013-11-24 12:47:24 +01:00
|
|
|
/* Run-time API version detection */
|
|
|
|
ZMQ_EXPORT void zmq_version (int *major, int *minor, int *patch);
|
|
|
|
|
2012-03-20 01:41:20 +01:00
|
|
|
/******************************************************************************/
|
|
|
|
/* 0MQ infrastructure (a.k.a. context) initialisation & termination. */
|
|
|
|
/******************************************************************************/
|
|
|
|
|
2013-10-08 14:51:19 +02:00
|
|
|
/* Context options */
|
2018-02-01 11:46:09 +01:00
|
|
|
#define ZMQ_IO_THREADS 1
|
2013-10-08 14:51:19 +02:00
|
|
|
#define ZMQ_MAX_SOCKETS 2
|
2014-02-14 10:09:19 +01:00
|
|
|
#define ZMQ_SOCKET_LIMIT 3
|
2014-07-02 12:07:35 +02:00
|
|
|
#define ZMQ_THREAD_PRIORITY 3
|
|
|
|
#define ZMQ_THREAD_SCHED_POLICY 4
|
2016-02-09 10:51:51 +01:00
|
|
|
#define ZMQ_MAX_MSGSZ 5
|
2018-03-23 20:28:26 +01:00
|
|
|
#define ZMQ_MSG_T_SIZE 6
|
2012-03-20 01:41:20 +01:00
|
|
|
|
2013-10-08 14:51:19 +02:00
|
|
|
/* Default for new contexts */
|
2018-02-01 11:46:09 +01:00
|
|
|
#define ZMQ_IO_THREADS_DFLT 1
|
2013-11-11 14:41:42 +01:00
|
|
|
#define ZMQ_MAX_SOCKETS_DFLT 1023
|
2014-07-02 12:07:35 +02:00
|
|
|
#define ZMQ_THREAD_PRIORITY_DFLT -1
|
|
|
|
#define ZMQ_THREAD_SCHED_POLICY_DFLT -1
|
2012-03-20 01:41:20 +01:00
|
|
|
|
|
|
|
ZMQ_EXPORT void *zmq_ctx_new (void);
|
2013-01-17 23:36:38 +01:00
|
|
|
ZMQ_EXPORT int zmq_ctx_term (void *context);
|
2016-03-11 10:15:58 +01:00
|
|
|
ZMQ_EXPORT int zmq_ctx_shutdown (void *context);
|
2012-03-20 01:41:20 +01:00
|
|
|
ZMQ_EXPORT int zmq_ctx_set (void *context, int option, int optval);
|
|
|
|
ZMQ_EXPORT int zmq_ctx_get (void *context, int option);
|
|
|
|
|
|
|
|
/* Old (legacy) API */
|
|
|
|
ZMQ_EXPORT void *zmq_init (int io_threads);
|
|
|
|
ZMQ_EXPORT int zmq_term (void *context);
|
2013-01-17 23:36:38 +01:00
|
|
|
ZMQ_EXPORT int zmq_ctx_destroy (void *context);
|
2012-03-20 01:41:20 +01:00
|
|
|
|
|
|
|
|
2010-04-11 14:00:40 +02:00
|
|
|
/******************************************************************************/
|
|
|
|
/* 0MQ message definition. */
|
|
|
|
/******************************************************************************/
|
2009-09-22 10:57:46 +02:00
|
|
|
|
2016-08-26 00:33:00 +02:00
|
|
|
/* Some architectures, like sparc64 and some variants of aarch64, enforce pointer
|
|
|
|
* alignment and raise sigbus on violations. Make sure applications allocate
|
|
|
|
* zmq_msg_t on addresses aligned on a pointer-size boundary to avoid this issue.
|
2015-01-27 16:20:39 +01:00
|
|
|
*/
|
2018-02-01 11:46:09 +01:00
|
|
|
typedef struct zmq_msg_t
|
|
|
|
{
|
2018-02-03 14:55:45 +01:00
|
|
|
#if defined(_MSC_VER) && (defined(_M_X64) || defined(_M_ARM64))
|
2018-02-01 11:46:09 +01:00
|
|
|
__declspec(align (8)) unsigned char _[64];
|
|
|
|
#elif defined(_MSC_VER) && (defined(_M_IX86) || defined(_M_ARM_ARMV7VE))
|
|
|
|
__declspec(align (4)) unsigned char _[64];
|
2018-02-03 14:55:45 +01:00
|
|
|
#elif defined(__GNUC__) || defined(__INTEL_COMPILER) \
|
|
|
|
|| (defined(__SUNPRO_C) && __SUNPRO_C >= 0x590) \
|
|
|
|
|| (defined(__SUNPRO_CC) && __SUNPRO_CC >= 0x590)
|
|
|
|
unsigned char _[64] __attribute__ ((aligned (sizeof (void *))));
|
2016-08-26 00:33:00 +02:00
|
|
|
#else
|
2018-02-01 11:46:09 +01:00
|
|
|
unsigned char _[64];
|
2016-08-26 00:33:00 +02:00
|
|
|
#endif
|
|
|
|
} zmq_msg_t;
|
2009-07-29 12:07:54 +02:00
|
|
|
|
2018-02-01 11:46:09 +01:00
|
|
|
typedef void(zmq_free_fn) (void *data, void *hint);
|
2009-07-29 12:07:54 +02:00
|
|
|
|
2009-12-05 11:20:57 +01:00
|
|
|
ZMQ_EXPORT int zmq_msg_init (zmq_msg_t *msg);
|
2009-09-23 10:22:54 +02:00
|
|
|
ZMQ_EXPORT int zmq_msg_init_size (zmq_msg_t *msg, size_t size);
|
2018-02-01 11:46:09 +01:00
|
|
|
ZMQ_EXPORT int zmq_msg_init_data (
|
|
|
|
zmq_msg_t *msg, void *data, size_t size, zmq_free_fn *ffn, void *hint);
|
2014-10-20 23:18:18 +02:00
|
|
|
ZMQ_EXPORT int zmq_msg_send (zmq_msg_t *msg, void *s, int flags);
|
|
|
|
ZMQ_EXPORT int zmq_msg_recv (zmq_msg_t *msg, void *s, int flags);
|
2009-09-23 10:22:54 +02:00
|
|
|
ZMQ_EXPORT int zmq_msg_close (zmq_msg_t *msg);
|
|
|
|
ZMQ_EXPORT int zmq_msg_move (zmq_msg_t *dest, zmq_msg_t *src);
|
|
|
|
ZMQ_EXPORT int zmq_msg_copy (zmq_msg_t *dest, zmq_msg_t *src);
|
|
|
|
ZMQ_EXPORT void *zmq_msg_data (zmq_msg_t *msg);
|
2017-03-26 08:49:23 +02:00
|
|
|
ZMQ_EXPORT size_t zmq_msg_size (const zmq_msg_t *msg);
|
|
|
|
ZMQ_EXPORT int zmq_msg_more (const zmq_msg_t *msg);
|
|
|
|
ZMQ_EXPORT int zmq_msg_get (const zmq_msg_t *msg, int property);
|
2014-03-03 13:19:40 +01:00
|
|
|
ZMQ_EXPORT int zmq_msg_set (zmq_msg_t *msg, int property, int optval);
|
2018-02-01 11:46:09 +01:00
|
|
|
ZMQ_EXPORT const char *zmq_msg_gets (const zmq_msg_t *msg,
|
|
|
|
const char *property);
|
2012-02-16 01:41:09 +01:00
|
|
|
|
2010-04-11 14:00:40 +02:00
|
|
|
/******************************************************************************/
|
|
|
|
/* 0MQ socket definition. */
|
|
|
|
/******************************************************************************/
|
2009-09-22 10:57:46 +02:00
|
|
|
|
2013-09-09 20:40:34 +02:00
|
|
|
/* Socket types. */
|
2013-10-08 14:51:19 +02:00
|
|
|
#define ZMQ_PAIR 0
|
|
|
|
#define ZMQ_PUB 1
|
|
|
|
#define ZMQ_SUB 2
|
|
|
|
#define ZMQ_REQ 3
|
|
|
|
#define ZMQ_REP 4
|
|
|
|
#define ZMQ_DEALER 5
|
|
|
|
#define ZMQ_ROUTER 6
|
|
|
|
#define ZMQ_PULL 7
|
|
|
|
#define ZMQ_PUSH 8
|
|
|
|
#define ZMQ_XPUB 9
|
|
|
|
#define ZMQ_XSUB 10
|
|
|
|
#define ZMQ_STREAM 11
|
|
|
|
|
|
|
|
/* Deprecated aliases */
|
|
|
|
#define ZMQ_XREQ ZMQ_DEALER
|
|
|
|
#define ZMQ_XREP ZMQ_ROUTER
|
2011-10-31 15:51:11 +01:00
|
|
|
|
2010-04-11 14:00:40 +02:00
|
|
|
/* Socket options. */
|
2013-10-08 14:51:19 +02:00
|
|
|
#define ZMQ_AFFINITY 4
|
2017-09-06 17:45:56 +02:00
|
|
|
#define ZMQ_ROUTING_ID 5
|
2013-10-08 14:51:19 +02:00
|
|
|
#define ZMQ_SUBSCRIBE 6
|
|
|
|
#define ZMQ_UNSUBSCRIBE 7
|
|
|
|
#define ZMQ_RATE 8
|
|
|
|
#define ZMQ_RECOVERY_IVL 9
|
|
|
|
#define ZMQ_SNDBUF 11
|
|
|
|
#define ZMQ_RCVBUF 12
|
|
|
|
#define ZMQ_RCVMORE 13
|
|
|
|
#define ZMQ_FD 14
|
|
|
|
#define ZMQ_EVENTS 15
|
|
|
|
#define ZMQ_TYPE 16
|
|
|
|
#define ZMQ_LINGER 17
|
|
|
|
#define ZMQ_RECONNECT_IVL 18
|
|
|
|
#define ZMQ_BACKLOG 19
|
|
|
|
#define ZMQ_RECONNECT_IVL_MAX 21
|
|
|
|
#define ZMQ_MAXMSGSIZE 22
|
|
|
|
#define ZMQ_SNDHWM 23
|
|
|
|
#define ZMQ_RCVHWM 24
|
|
|
|
#define ZMQ_MULTICAST_HOPS 25
|
|
|
|
#define ZMQ_RCVTIMEO 27
|
|
|
|
#define ZMQ_SNDTIMEO 28
|
|
|
|
#define ZMQ_LAST_ENDPOINT 32
|
|
|
|
#define ZMQ_ROUTER_MANDATORY 33
|
|
|
|
#define ZMQ_TCP_KEEPALIVE 34
|
|
|
|
#define ZMQ_TCP_KEEPALIVE_CNT 35
|
|
|
|
#define ZMQ_TCP_KEEPALIVE_IDLE 36
|
|
|
|
#define ZMQ_TCP_KEEPALIVE_INTVL 37
|
|
|
|
#define ZMQ_IMMEDIATE 39
|
|
|
|
#define ZMQ_XPUB_VERBOSE 40
|
|
|
|
#define ZMQ_ROUTER_RAW 41
|
|
|
|
#define ZMQ_IPV6 42
|
|
|
|
#define ZMQ_MECHANISM 43
|
|
|
|
#define ZMQ_PLAIN_SERVER 44
|
|
|
|
#define ZMQ_PLAIN_USERNAME 45
|
|
|
|
#define ZMQ_PLAIN_PASSWORD 46
|
|
|
|
#define ZMQ_CURVE_SERVER 47
|
|
|
|
#define ZMQ_CURVE_PUBLICKEY 48
|
|
|
|
#define ZMQ_CURVE_SECRETKEY 49
|
|
|
|
#define ZMQ_CURVE_SERVERKEY 50
|
|
|
|
#define ZMQ_PROBE_ROUTER 51
|
|
|
|
#define ZMQ_REQ_CORRELATE 52
|
|
|
|
#define ZMQ_REQ_RELAXED 53
|
|
|
|
#define ZMQ_CONFLATE 54
|
|
|
|
#define ZMQ_ZAP_DOMAIN 55
|
2013-11-01 04:42:48 +01:00
|
|
|
#define ZMQ_ROUTER_HANDOVER 56
|
2013-11-25 04:01:21 +01:00
|
|
|
#define ZMQ_TOS 57
|
2017-09-07 09:29:46 +02:00
|
|
|
#define ZMQ_CONNECT_ROUTING_ID 61
|
2013-09-25 05:20:01 +02:00
|
|
|
#define ZMQ_GSSAPI_SERVER 62
|
2014-04-23 19:20:22 +02:00
|
|
|
#define ZMQ_GSSAPI_PRINCIPAL 63
|
|
|
|
#define ZMQ_GSSAPI_SERVICE_PRINCIPAL 64
|
2014-04-23 20:01:54 +02:00
|
|
|
#define ZMQ_GSSAPI_PLAINTEXT 65
|
2014-05-09 15:54:24 +02:00
|
|
|
#define ZMQ_HANDSHAKE_IVL 66
|
2014-06-22 10:32:22 +02:00
|
|
|
#define ZMQ_SOCKS_PROXY 68
|
2014-08-08 19:45:41 +02:00
|
|
|
#define ZMQ_XPUB_NODROP 69
|
2014-11-17 11:56:59 +01:00
|
|
|
#define ZMQ_BLOCKY 70
|
2014-11-26 09:38:54 +01:00
|
|
|
#define ZMQ_XPUB_MANUAL 71
|
2014-11-26 12:37:36 +01:00
|
|
|
#define ZMQ_XPUB_WELCOME_MSG 72
|
2015-01-23 15:25:40 +01:00
|
|
|
#define ZMQ_STREAM_NOTIFY 73
|
2015-01-26 15:59:19 +01:00
|
|
|
#define ZMQ_INVERT_MATCHING 74
|
2015-03-17 02:39:16 +01:00
|
|
|
#define ZMQ_HEARTBEAT_IVL 75
|
|
|
|
#define ZMQ_HEARTBEAT_TTL 76
|
|
|
|
#define ZMQ_HEARTBEAT_TIMEOUT 77
|
2016-02-09 09:53:41 +01:00
|
|
|
#define ZMQ_XPUB_VERBOSER 78
|
2015-08-04 14:47:07 +02:00
|
|
|
#define ZMQ_CONNECT_TIMEOUT 79
|
2016-02-09 09:33:29 +01:00
|
|
|
#define ZMQ_TCP_MAXRT 80
|
2015-08-16 09:42:11 +02:00
|
|
|
#define ZMQ_THREAD_SAFE 81
|
2015-11-23 20:35:02 +01:00
|
|
|
#define ZMQ_MULTICAST_MAXTPDU 84
|
2015-12-07 13:19:45 +01:00
|
|
|
#define ZMQ_VMCI_BUFFER_SIZE 85
|
|
|
|
#define ZMQ_VMCI_BUFFER_MIN_SIZE 86
|
|
|
|
#define ZMQ_VMCI_BUFFER_MAX_SIZE 87
|
|
|
|
#define ZMQ_VMCI_CONNECT_TIMEOUT 88
|
2016-02-09 10:36:14 +01:00
|
|
|
#define ZMQ_USE_FD 89
|
2018-03-23 20:28:26 +01:00
|
|
|
#define ZMQ_GSSAPI_PRINCIPAL_NAMETYPE 90
|
|
|
|
#define ZMQ_GSSAPI_SERVICE_PRINCIPAL_NAMETYPE 91
|
|
|
|
#define ZMQ_BINDTODEVICE 92
|
2014-01-19 09:27:57 +01:00
|
|
|
|
2011-11-06 14:03:51 +01:00
|
|
|
/* Message options */
|
2013-10-08 14:51:19 +02:00
|
|
|
#define ZMQ_MORE 1
|
2014-07-12 16:01:27 +02:00
|
|
|
#define ZMQ_SHARED 3
|
2011-11-06 14:03:51 +01:00
|
|
|
|
2010-04-11 14:00:40 +02:00
|
|
|
/* Send/recv options. */
|
2013-10-08 14:51:19 +02:00
|
|
|
#define ZMQ_DONTWAIT 1
|
|
|
|
#define ZMQ_SNDMORE 2
|
2012-10-08 09:36:35 +02:00
|
|
|
|
2013-05-15 17:54:03 +02:00
|
|
|
/* Security mechanisms */
|
2013-10-08 14:51:19 +02:00
|
|
|
#define ZMQ_NULL 0
|
|
|
|
#define ZMQ_PLAIN 1
|
|
|
|
#define ZMQ_CURVE 2
|
2013-09-25 05:20:01 +02:00
|
|
|
#define ZMQ_GSSAPI 3
|
2013-10-08 14:51:19 +02:00
|
|
|
|
2016-01-27 17:19:14 +01:00
|
|
|
/* RADIO-DISH protocol */
|
2018-02-01 11:46:09 +01:00
|
|
|
#define ZMQ_GROUP_MAX_LENGTH 15
|
2016-01-27 17:19:14 +01:00
|
|
|
|
2013-10-08 14:51:19 +02:00
|
|
|
/* Deprecated options and aliases */
|
2018-02-01 11:46:09 +01:00
|
|
|
#define ZMQ_IDENTITY ZMQ_ROUTING_ID
|
|
|
|
#define ZMQ_CONNECT_RID ZMQ_CONNECT_ROUTING_ID
|
|
|
|
#define ZMQ_TCP_ACCEPT_FILTER 38
|
|
|
|
#define ZMQ_IPC_FILTER_PID 58
|
|
|
|
#define ZMQ_IPC_FILTER_UID 59
|
|
|
|
#define ZMQ_IPC_FILTER_GID 60
|
|
|
|
#define ZMQ_IPV4ONLY 31
|
2013-10-08 14:51:19 +02:00
|
|
|
#define ZMQ_DELAY_ATTACH_ON_CONNECT ZMQ_IMMEDIATE
|
2018-02-01 11:46:09 +01:00
|
|
|
#define ZMQ_NOBLOCK ZMQ_DONTWAIT
|
|
|
|
#define ZMQ_FAIL_UNROUTABLE ZMQ_ROUTER_MANDATORY
|
|
|
|
#define ZMQ_ROUTER_BEHAVIOR ZMQ_ROUTER_MANDATORY
|
2009-12-05 11:20:57 +01:00
|
|
|
|
2016-05-04 14:04:00 +02:00
|
|
|
/* Deprecated Message options */
|
|
|
|
#define ZMQ_SRCFD 2
|
|
|
|
|
2018-03-23 20:28:26 +01:00
|
|
|
/******************************************************************************/
|
|
|
|
/* GSSAPI definitions */
|
|
|
|
/******************************************************************************/
|
|
|
|
|
|
|
|
/* GSSAPI principal name types */
|
|
|
|
#define ZMQ_GSSAPI_NT_HOSTBASED 0
|
|
|
|
#define ZMQ_GSSAPI_NT_USER_NAME 1
|
|
|
|
#define ZMQ_GSSAPI_NT_KRB5_PRINCIPAL 2
|
|
|
|
|
2012-05-04 03:32:46 +02:00
|
|
|
/******************************************************************************/
|
|
|
|
/* 0MQ socket events and monitoring */
|
|
|
|
/******************************************************************************/
|
|
|
|
|
2016-05-01 23:00:20 +02:00
|
|
|
/* Socket transport events (TCP, IPC and TIPC only) */
|
2014-04-28 11:30:04 +02:00
|
|
|
|
2018-02-01 11:46:09 +01:00
|
|
|
#define ZMQ_EVENT_CONNECTED 0x0001
|
|
|
|
#define ZMQ_EVENT_CONNECT_DELAYED 0x0002
|
|
|
|
#define ZMQ_EVENT_CONNECT_RETRIED 0x0004
|
|
|
|
#define ZMQ_EVENT_LISTENING 0x0008
|
|
|
|
#define ZMQ_EVENT_BIND_FAILED 0x0010
|
|
|
|
#define ZMQ_EVENT_ACCEPTED 0x0020
|
|
|
|
#define ZMQ_EVENT_ACCEPT_FAILED 0x0040
|
|
|
|
#define ZMQ_EVENT_CLOSED 0x0080
|
|
|
|
#define ZMQ_EVENT_CLOSE_FAILED 0x0100
|
|
|
|
#define ZMQ_EVENT_DISCONNECTED 0x0200
|
|
|
|
#define ZMQ_EVENT_MONITOR_STOPPED 0x0400
|
|
|
|
#define ZMQ_EVENT_ALL 0xFFFF
|
2012-05-04 03:32:46 +02:00
|
|
|
|
2012-03-20 01:41:20 +01:00
|
|
|
ZMQ_EXPORT void *zmq_socket (void *, int type);
|
|
|
|
ZMQ_EXPORT int zmq_close (void *s);
|
2018-02-01 11:46:09 +01:00
|
|
|
ZMQ_EXPORT int
|
|
|
|
zmq_setsockopt (void *s, int option, const void *optval, size_t optvallen);
|
|
|
|
ZMQ_EXPORT int
|
|
|
|
zmq_getsockopt (void *s, int option, void *optval, size_t *optvallen);
|
2012-03-20 01:41:20 +01:00
|
|
|
ZMQ_EXPORT int zmq_bind (void *s, const char *addr);
|
|
|
|
ZMQ_EXPORT int zmq_connect (void *s, const char *addr);
|
2012-04-20 16:59:08 +02:00
|
|
|
ZMQ_EXPORT int zmq_unbind (void *s, const char *addr);
|
|
|
|
ZMQ_EXPORT int zmq_disconnect (void *s, const char *addr);
|
2014-10-20 23:18:18 +02:00
|
|
|
ZMQ_EXPORT int zmq_send (void *s, const void *buf, size_t len, int flags);
|
|
|
|
ZMQ_EXPORT int zmq_send_const (void *s, const void *buf, size_t len, int flags);
|
|
|
|
ZMQ_EXPORT int zmq_recv (void *s, void *buf, size_t len, int flags);
|
2012-09-21 13:53:31 +02:00
|
|
|
ZMQ_EXPORT int zmq_socket_monitor (void *s, const char *addr, int events);
|
2016-01-27 17:19:14 +01:00
|
|
|
|
2012-02-08 02:58:35 +01:00
|
|
|
|
2010-04-11 14:00:40 +02:00
|
|
|
/******************************************************************************/
|
2017-03-11 10:16:09 +01:00
|
|
|
/* Deprecated I/O multiplexing. Prefer using zmq_poller API */
|
2010-04-11 14:00:40 +02:00
|
|
|
/******************************************************************************/
|
2009-10-01 10:56:17 +02:00
|
|
|
|
2013-10-08 14:51:19 +02:00
|
|
|
#define ZMQ_POLLIN 1
|
|
|
|
#define ZMQ_POLLOUT 2
|
|
|
|
#define ZMQ_POLLERR 4
|
2014-10-17 17:21:41 +02:00
|
|
|
#define ZMQ_POLLPRI 8
|
2009-10-01 10:56:17 +02:00
|
|
|
|
2014-03-12 15:11:12 +01:00
|
|
|
typedef struct zmq_pollitem_t
|
2009-10-01 10:56:17 +02:00
|
|
|
{
|
2015-08-20 16:46:34 +02:00
|
|
|
void *socket;
|
2009-12-10 16:46:22 +01:00
|
|
|
#if defined _WIN32
|
|
|
|
SOCKET fd;
|
|
|
|
#else
|
2009-10-01 10:56:17 +02:00
|
|
|
int fd;
|
2009-12-10 16:46:22 +01:00
|
|
|
#endif
|
2009-10-01 10:56:17 +02:00
|
|
|
short events;
|
|
|
|
short revents;
|
|
|
|
} zmq_pollitem_t;
|
|
|
|
|
2013-10-08 14:51:19 +02:00
|
|
|
#define ZMQ_POLLITEMS_DFLT 16
|
|
|
|
|
2018-02-01 11:46:09 +01:00
|
|
|
ZMQ_EXPORT int zmq_poll (zmq_pollitem_t *items, int nitems, long timeout);
|
2015-08-17 16:57:30 +02:00
|
|
|
|
2014-06-27 15:56:29 +02:00
|
|
|
/******************************************************************************/
|
|
|
|
/* Message proxying */
|
|
|
|
/******************************************************************************/
|
2012-03-16 22:39:11 +01:00
|
|
|
|
2013-10-18 15:01:05 +02:00
|
|
|
ZMQ_EXPORT int zmq_proxy (void *frontend, void *backend, void *capture);
|
2018-02-01 11:46:09 +01:00
|
|
|
ZMQ_EXPORT int zmq_proxy_steerable (void *frontend,
|
|
|
|
void *backend,
|
|
|
|
void *capture,
|
|
|
|
void *control);
|
2012-09-06 12:20:21 +02:00
|
|
|
|
2014-06-27 15:56:29 +02:00
|
|
|
/******************************************************************************/
|
|
|
|
/* Probe library capabilities */
|
|
|
|
/******************************************************************************/
|
2014-06-18 15:10:18 +02:00
|
|
|
|
|
|
|
#define ZMQ_HAS_CAPABILITIES 1
|
|
|
|
ZMQ_EXPORT int zmq_has (const char *capability);
|
|
|
|
|
2013-10-08 14:51:19 +02:00
|
|
|
/* Deprecated aliases */
|
|
|
|
#define ZMQ_STREAMER 1
|
|
|
|
#define ZMQ_FORWARDER 2
|
|
|
|
#define ZMQ_QUEUE 3
|
2014-06-18 15:10:18 +02:00
|
|
|
|
|
|
|
/* Deprecated methods */
|
2012-09-06 12:20:21 +02:00
|
|
|
ZMQ_EXPORT int zmq_device (int type, void *frontend, void *backend);
|
2014-06-18 15:10:18 +02:00
|
|
|
ZMQ_EXPORT int zmq_sendmsg (void *s, zmq_msg_t *msg, int flags);
|
|
|
|
ZMQ_EXPORT int zmq_recvmsg (void *s, zmq_msg_t *msg, int flags);
|
2016-05-04 17:30:38 +02:00
|
|
|
struct iovec;
|
2018-02-01 11:46:09 +01:00
|
|
|
ZMQ_EXPORT int
|
|
|
|
zmq_sendiov (void *s, struct iovec *iov, size_t count, int flags);
|
|
|
|
ZMQ_EXPORT int
|
|
|
|
zmq_recviov (void *s, struct iovec *iov, size_t *count, int flags);
|
2012-03-16 22:39:11 +01:00
|
|
|
|
2014-06-27 15:56:29 +02:00
|
|
|
/******************************************************************************/
|
|
|
|
/* Encryption functions */
|
|
|
|
/******************************************************************************/
|
|
|
|
|
|
|
|
/* Encode data with Z85 encoding. Returns encoded data */
|
2014-08-14 00:00:00 +02:00
|
|
|
ZMQ_EXPORT char *zmq_z85_encode (char *dest, const uint8_t *data, size_t size);
|
2014-06-27 15:56:29 +02:00
|
|
|
|
|
|
|
/* Decode data with Z85 encoding. Returns decoded data */
|
2014-08-14 00:00:00 +02:00
|
|
|
ZMQ_EXPORT uint8_t *zmq_z85_decode (uint8_t *dest, const char *string);
|
2014-06-27 15:56:29 +02:00
|
|
|
|
2016-05-19 08:51:18 +02:00
|
|
|
/* Generate z85-encoded public and private keypair with tweetnacl/libsodium. */
|
2014-06-27 15:56:29 +02:00
|
|
|
/* Returns 0 on success. */
|
|
|
|
ZMQ_EXPORT int zmq_curve_keypair (char *z85_public_key, char *z85_secret_key);
|
|
|
|
|
2016-05-19 08:51:18 +02:00
|
|
|
/* Derive the z85-encoded public key from the z85-encoded secret key. */
|
|
|
|
/* Returns 0 on success. */
|
2018-02-01 11:46:09 +01:00
|
|
|
ZMQ_EXPORT int zmq_curve_public (char *z85_public_key,
|
|
|
|
const char *z85_secret_key);
|
2016-05-19 08:51:18 +02:00
|
|
|
|
2014-12-23 01:14:38 +01:00
|
|
|
/******************************************************************************/
|
|
|
|
/* Atomic utility methods */
|
|
|
|
/******************************************************************************/
|
|
|
|
|
|
|
|
ZMQ_EXPORT void *zmq_atomic_counter_new (void);
|
|
|
|
ZMQ_EXPORT void zmq_atomic_counter_set (void *counter, int value);
|
|
|
|
ZMQ_EXPORT int zmq_atomic_counter_inc (void *counter);
|
2014-12-23 15:20:10 +01:00
|
|
|
ZMQ_EXPORT int zmq_atomic_counter_dec (void *counter);
|
2014-12-23 01:14:38 +01:00
|
|
|
ZMQ_EXPORT int zmq_atomic_counter_value (void *counter);
|
|
|
|
ZMQ_EXPORT void zmq_atomic_counter_destroy (void **counter_p);
|
|
|
|
|
2014-06-27 15:56:29 +02:00
|
|
|
|
|
|
|
/******************************************************************************/
|
|
|
|
/* These functions are not documented by man pages -- use at your own risk. */
|
|
|
|
/* If you need these to be part of the formal ZMQ API, then (a) write a man */
|
|
|
|
/* page, and (b) write a test case in tests. */
|
|
|
|
/******************************************************************************/
|
|
|
|
|
|
|
|
/* Helper functions are used by perf tests so that they don't have to care */
|
|
|
|
/* about minutiae of time-related functions on different OS platforms. */
|
|
|
|
|
|
|
|
/* Starts the stopwatch. Returns the handle to the watch. */
|
|
|
|
ZMQ_EXPORT void *zmq_stopwatch_start (void);
|
|
|
|
|
2018-02-03 12:31:39 +01:00
|
|
|
#ifdef ZMQ_BUILD_DRAFT_API
|
|
|
|
/* Returns the number of microseconds elapsed since the stopwatch was */
|
|
|
|
/* started, but does not stop or deallocate the stopwatch. */
|
|
|
|
ZMQ_EXPORT unsigned long zmq_stopwatch_intermediate (void *watch_);
|
|
|
|
#endif
|
|
|
|
|
2014-06-27 15:56:29 +02:00
|
|
|
/* Stops the stopwatch. Returns the number of microseconds elapsed since */
|
2018-02-03 12:31:39 +01:00
|
|
|
/* the stopwatch was started, and deallocates that watch. */
|
2014-06-27 15:56:29 +02:00
|
|
|
ZMQ_EXPORT unsigned long zmq_stopwatch_stop (void *watch_);
|
|
|
|
|
|
|
|
/* Sleeps for specified number of seconds. */
|
|
|
|
ZMQ_EXPORT void zmq_sleep (int seconds_);
|
|
|
|
|
2018-02-01 11:46:09 +01:00
|
|
|
typedef void(zmq_thread_fn) (void *);
|
2014-06-27 15:56:29 +02:00
|
|
|
|
|
|
|
/* Start a thread. Returns a handle to the thread. */
|
2018-02-01 11:46:09 +01:00
|
|
|
ZMQ_EXPORT void *zmq_threadstart (zmq_thread_fn *func, void *arg);
|
2014-06-27 15:56:29 +02:00
|
|
|
|
|
|
|
/* Wait for thread to complete then free up resources. */
|
2018-02-01 11:46:09 +01:00
|
|
|
ZMQ_EXPORT void zmq_threadclose (void *thread);
|
2014-06-27 15:56:29 +02:00
|
|
|
|
|
|
|
|
2016-05-02 20:44:35 +02:00
|
|
|
/******************************************************************************/
|
|
|
|
/* These functions are DRAFT and disabled in stable releases, and subject to */
|
|
|
|
/* change at ANY time until declared stable. */
|
|
|
|
/******************************************************************************/
|
|
|
|
|
|
|
|
#ifdef ZMQ_BUILD_DRAFT_API
|
|
|
|
|
2016-05-02 20:50:33 +02:00
|
|
|
/* DRAFT Socket types. */
|
|
|
|
#define ZMQ_SERVER 12
|
|
|
|
#define ZMQ_CLIENT 13
|
2016-05-02 20:59:34 +02:00
|
|
|
#define ZMQ_RADIO 14
|
|
|
|
#define ZMQ_DISH 15
|
2016-05-02 21:00:00 +02:00
|
|
|
#define ZMQ_GATHER 16
|
|
|
|
#define ZMQ_SCATTER 17
|
2016-05-13 03:20:31 +02:00
|
|
|
#define ZMQ_DGRAM 18
|
2016-05-02 20:59:34 +02:00
|
|
|
|
2017-07-31 17:01:13 +02:00
|
|
|
/* DRAFT Socket options. */
|
2017-10-07 19:34:18 +02:00
|
|
|
#define ZMQ_ZAP_ENFORCE_DOMAIN 93
|
2018-02-05 17:09:39 +01:00
|
|
|
#define ZMQ_LOOPBACK_FASTPATH 94
|
2018-03-12 01:41:33 +01:00
|
|
|
#define ZMQ_METADATA 95
|
2017-07-31 17:01:13 +02:00
|
|
|
|
2016-12-30 18:26:56 +01:00
|
|
|
/* DRAFT 0MQ socket events and monitoring */
|
2017-08-17 17:54:07 +02:00
|
|
|
/* Unspecified system errors during handshake. Event value is an errno. */
|
2018-02-01 11:46:09 +01:00
|
|
|
#define ZMQ_EVENT_HANDSHAKE_FAILED_NO_DETAIL 0x0800
|
2017-08-17 17:54:07 +02:00
|
|
|
/* Handshake complete successfully with successful authentication (if *
|
|
|
|
* enabled). Event value is unused. */
|
2018-02-01 11:46:09 +01:00
|
|
|
#define ZMQ_EVENT_HANDSHAKE_SUCCEEDED 0x1000
|
2017-08-17 17:54:07 +02:00
|
|
|
/* Protocol errors between ZMTP peers or between server and ZAP handler. *
|
|
|
|
* Event value is one of ZMQ_PROTOCOL_ERROR_* */
|
2018-02-01 11:46:09 +01:00
|
|
|
#define ZMQ_EVENT_HANDSHAKE_FAILED_PROTOCOL 0x2000
|
2017-08-17 17:54:07 +02:00
|
|
|
/* Failed authentication requests. Event value is the numeric ZAP status *
|
|
|
|
* code, i.e. 300, 400 or 500. */
|
2018-02-01 11:46:09 +01:00
|
|
|
#define ZMQ_EVENT_HANDSHAKE_FAILED_AUTH 0x4000
|
2017-08-17 17:54:07 +02:00
|
|
|
|
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZMTP_UNSPECIFIED 0x10000000
|
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZMTP_UNEXPECTED_COMMAND 0x10000001
|
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZMTP_INVALID_SEQUENCE 0x10000002
|
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZMTP_KEY_EXCHANGE 0x10000003
|
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZMTP_MALFORMED_COMMAND_UNSPECIFIED 0x10000011
|
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZMTP_MALFORMED_COMMAND_MESSAGE 0x10000012
|
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZMTP_MALFORMED_COMMAND_HELLO 0x10000013
|
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZMTP_MALFORMED_COMMAND_INITIATE 0x10000014
|
2017-08-17 18:20:45 +02:00
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZMTP_MALFORMED_COMMAND_ERROR 0x10000015
|
2017-08-17 18:32:44 +02:00
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZMTP_MALFORMED_COMMAND_READY 0x10000016
|
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZMTP_MALFORMED_COMMAND_WELCOME 0x10000017
|
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZMTP_INVALID_METADATA 0x10000018
|
2017-08-17 17:54:07 +02:00
|
|
|
|
|
|
|
// the following two may be due to erroneous configuration of a peer
|
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZMTP_CRYPTOGRAPHIC 0x11000001
|
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZMTP_MECHANISM_MISMATCH 0x11000002
|
|
|
|
|
2018-02-01 11:46:09 +01:00
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZAP_UNSPECIFIED 0x20000000
|
2017-08-17 17:54:07 +02:00
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZAP_MALFORMED_REPLY 0x20000001
|
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZAP_BAD_REQUEST_ID 0x20000002
|
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZAP_BAD_VERSION 0x20000003
|
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZAP_INVALID_STATUS_CODE 0x20000004
|
|
|
|
#define ZMQ_PROTOCOL_ERROR_ZAP_INVALID_METADATA 0x20000005
|
2016-12-30 18:26:56 +01:00
|
|
|
|
|
|
|
/* DRAFT Context options */
|
2017-10-25 09:55:47 +02:00
|
|
|
#define ZMQ_THREAD_AFFINITY_CPU_ADD 7
|
|
|
|
#define ZMQ_THREAD_AFFINITY_CPU_REMOVE 8
|
|
|
|
#define ZMQ_THREAD_NAME_PREFIX 9
|
2018-03-05 13:19:20 +01:00
|
|
|
#define ZMQ_ZERO_COPY_RECV 10
|
2016-12-29 20:40:57 +01:00
|
|
|
|
2016-05-03 09:24:27 +02:00
|
|
|
/* DRAFT Socket methods. */
|
2016-05-02 20:59:34 +02:00
|
|
|
ZMQ_EXPORT int zmq_join (void *s, const char *group);
|
|
|
|
ZMQ_EXPORT int zmq_leave (void *s, const char *group);
|
2016-05-02 20:50:33 +02:00
|
|
|
|
2016-05-03 09:24:27 +02:00
|
|
|
/* DRAFT Msg methods. */
|
2018-02-01 11:46:09 +01:00
|
|
|
ZMQ_EXPORT int zmq_msg_set_routing_id (zmq_msg_t *msg, uint32_t routing_id);
|
|
|
|
ZMQ_EXPORT uint32_t zmq_msg_routing_id (zmq_msg_t *msg);
|
|
|
|
ZMQ_EXPORT int zmq_msg_set_group (zmq_msg_t *msg, const char *group);
|
|
|
|
ZMQ_EXPORT const char *zmq_msg_group (zmq_msg_t *msg);
|
2016-05-03 09:24:27 +02:00
|
|
|
|
2017-08-04 10:33:51 +02:00
|
|
|
/* DRAFT Msg property names. */
|
2018-02-01 11:46:09 +01:00
|
|
|
#define ZMQ_MSG_PROPERTY_ROUTING_ID "Routing-Id"
|
|
|
|
#define ZMQ_MSG_PROPERTY_SOCKET_TYPE "Socket-Type"
|
|
|
|
#define ZMQ_MSG_PROPERTY_USER_ID "User-Id"
|
|
|
|
#define ZMQ_MSG_PROPERTY_PEER_ADDRESS "Peer-Address"
|
2017-08-04 10:33:51 +02:00
|
|
|
|
2016-05-02 20:54:31 +02:00
|
|
|
/******************************************************************************/
|
|
|
|
/* Poller polling on sockets,fd and thread-safe sockets */
|
|
|
|
/******************************************************************************/
|
|
|
|
|
|
|
|
#define ZMQ_HAVE_POLLER
|
|
|
|
|
|
|
|
typedef struct zmq_poller_event_t
|
|
|
|
{
|
|
|
|
void *socket;
|
|
|
|
#if defined _WIN32
|
|
|
|
SOCKET fd;
|
|
|
|
#else
|
|
|
|
int fd;
|
|
|
|
#endif
|
|
|
|
void *user_data;
|
|
|
|
short events;
|
|
|
|
} zmq_poller_event_t;
|
|
|
|
|
|
|
|
ZMQ_EXPORT void *zmq_poller_new (void);
|
2018-02-01 11:46:09 +01:00
|
|
|
ZMQ_EXPORT int zmq_poller_destroy (void **poller_p);
|
|
|
|
ZMQ_EXPORT int
|
|
|
|
zmq_poller_add (void *poller, void *socket, void *user_data, short events);
|
|
|
|
ZMQ_EXPORT int zmq_poller_modify (void *poller, void *socket, short events);
|
|
|
|
ZMQ_EXPORT int zmq_poller_remove (void *poller, void *socket);
|
|
|
|
ZMQ_EXPORT int
|
|
|
|
zmq_poller_wait (void *poller, zmq_poller_event_t *event, long timeout);
|
|
|
|
ZMQ_EXPORT int zmq_poller_wait_all (void *poller,
|
|
|
|
zmq_poller_event_t *events,
|
|
|
|
int n_events,
|
|
|
|
long timeout);
|
2016-05-02 20:54:31 +02:00
|
|
|
|
|
|
|
#if defined _WIN32
|
2018-02-01 11:46:09 +01:00
|
|
|
ZMQ_EXPORT int
|
|
|
|
zmq_poller_add_fd (void *poller, SOCKET fd, void *user_data, short events);
|
2016-05-02 20:54:31 +02:00
|
|
|
ZMQ_EXPORT int zmq_poller_modify_fd (void *poller, SOCKET fd, short events);
|
|
|
|
ZMQ_EXPORT int zmq_poller_remove_fd (void *poller, SOCKET fd);
|
|
|
|
#else
|
2018-02-01 11:46:09 +01:00
|
|
|
ZMQ_EXPORT int
|
|
|
|
zmq_poller_add_fd (void *poller, int fd, void *user_data, short events);
|
2016-05-02 20:54:31 +02:00
|
|
|
ZMQ_EXPORT int zmq_poller_modify_fd (void *poller, int fd, short events);
|
|
|
|
ZMQ_EXPORT int zmq_poller_remove_fd (void *poller, int fd);
|
|
|
|
#endif
|
|
|
|
|
2017-08-29 10:04:06 +02:00
|
|
|
ZMQ_EXPORT int zmq_socket_get_peer_state (void *socket,
|
2017-09-06 17:45:56 +02:00
|
|
|
const void *routing_id,
|
|
|
|
size_t routing_id_size);
|
2017-08-29 10:04:06 +02:00
|
|
|
|
2016-05-02 20:56:30 +02:00
|
|
|
/******************************************************************************/
|
|
|
|
/* Scheduling timers */
|
|
|
|
/******************************************************************************/
|
|
|
|
|
|
|
|
#define ZMQ_HAVE_TIMERS
|
|
|
|
|
2018-02-01 11:46:09 +01:00
|
|
|
typedef void(zmq_timer_fn) (int timer_id, void *arg);
|
2016-05-02 20:56:30 +02:00
|
|
|
|
|
|
|
ZMQ_EXPORT void *zmq_timers_new (void);
|
2018-02-01 11:46:09 +01:00
|
|
|
ZMQ_EXPORT int zmq_timers_destroy (void **timers_p);
|
|
|
|
ZMQ_EXPORT int
|
|
|
|
zmq_timers_add (void *timers, size_t interval, zmq_timer_fn handler, void *arg);
|
|
|
|
ZMQ_EXPORT int zmq_timers_cancel (void *timers, int timer_id);
|
|
|
|
ZMQ_EXPORT int
|
|
|
|
zmq_timers_set_interval (void *timers, int timer_id, size_t interval);
|
|
|
|
ZMQ_EXPORT int zmq_timers_reset (void *timers, int timer_id);
|
|
|
|
ZMQ_EXPORT long zmq_timers_timeout (void *timers);
|
|
|
|
ZMQ_EXPORT int zmq_timers_execute (void *timers);
|
2016-05-02 20:56:30 +02:00
|
|
|
|
2016-05-02 20:44:35 +02:00
|
|
|
#endif // ZMQ_BUILD_DRAFT_API
|
|
|
|
|
|
|
|
|
2010-11-25 17:12:31 +01:00
|
|
|
#undef ZMQ_EXPORT
|
|
|
|
|
2009-07-29 12:07:54 +02:00
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#endif
|