2009-07-29 12:07:54 +02:00
|
|
|
/*
|
2011-03-02 16:30:40 +01:00
|
|
|
Copyright (c) 2007-2011 iMatix Corporation
|
|
|
|
Copyright (c) 2007-2011 Other contributors as noted in the AUTHORS file
|
2009-07-29 12:07:54 +02:00
|
|
|
|
|
|
|
This file is part of 0MQ.
|
|
|
|
|
|
|
|
0MQ is free software; you can redistribute it and/or modify it under
|
2010-10-30 15:08:28 +02:00
|
|
|
the terms of the GNU Lesser General Public License as published by
|
2009-07-29 12:07:54 +02:00
|
|
|
the Free Software Foundation; either version 3 of the License, or
|
|
|
|
(at your option) any later version.
|
|
|
|
|
|
|
|
0MQ 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
|
2010-10-30 15:08:28 +02:00
|
|
|
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/>.
|
|
|
|
*/
|
|
|
|
|
2009-08-03 11:30:13 +02:00
|
|
|
#ifndef __ZMQ_H_INCLUDED__
|
|
|
|
#define __ZMQ_H_INCLUDED__
|
2009-07-29 12:07:54 +02:00
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
2009-09-22 12:08:18 +02:00
|
|
|
#include <errno.h>
|
2009-07-29 12:07:54 +02:00
|
|
|
#include <stddef.h>
|
2009-12-10 16:46:22 +01:00
|
|
|
#if defined _WIN32
|
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
|
|
|
|
# if defined DLL_EXPORT
|
|
|
|
# define ZMQ_EXPORT __declspec(dllexport)
|
|
|
|
# else
|
|
|
|
# define ZMQ_EXPORT __declspec(dllimport)
|
|
|
|
# endif
|
2009-07-29 12:07:54 +02:00
|
|
|
#else
|
2010-12-01 10:33:07 +01:00
|
|
|
# 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
|
2010-11-25 17:12:31 +01:00
|
|
|
# endif
|
2009-07-29 12:07:54 +02:00
|
|
|
#endif
|
|
|
|
|
2010-04-11 14:00:40 +02:00
|
|
|
/******************************************************************************/
|
2010-09-04 16:10:14 +02:00
|
|
|
/* 0MQ versioning support. */
|
2010-04-11 14:00:40 +02:00
|
|
|
/******************************************************************************/
|
2010-02-11 10:29:33 +01:00
|
|
|
|
2010-10-15 15:05:54 +02:00
|
|
|
/* Version macros for compile-time API version detection */
|
2011-07-15 08:11:42 +02:00
|
|
|
#define ZMQ_VERSION_MAJOR 4
|
2011-03-23 15:24:18 +01:00
|
|
|
#define ZMQ_VERSION_MINOR 0
|
2011-02-22 21:43:52 +01:00
|
|
|
#define ZMQ_VERSION_PATCH 0
|
2010-10-15 15:05:54 +02: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)
|
|
|
|
|
|
|
|
/* Run-time API version detection */
|
2010-02-11 10:29:33 +01:00
|
|
|
ZMQ_EXPORT void zmq_version (int *major, int *minor, int *patch);
|
|
|
|
|
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
|
2011-08-15 20:39:48 +02:00
|
|
|
#ifndef EAFNOSUPPORT
|
|
|
|
#define EAFNOSUPPORT (ZMQ_HAUSNUMERO + 10)
|
|
|
|
#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)
|
2011-07-21 18:54:27 +02:00
|
|
|
#define ECANTROUTE (ZMQ_HAUSNUMERO + 55)
|
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);
|
|
|
|
|
2010-04-11 14:00:40 +02:00
|
|
|
/******************************************************************************/
|
|
|
|
/* 0MQ message definition. */
|
|
|
|
/******************************************************************************/
|
2009-09-22 10:57:46 +02:00
|
|
|
|
2011-08-31 15:23:00 +02:00
|
|
|
typedef struct {unsigned char _ [32];} zmq_msg_t;
|
2009-07-29 12:07:54 +02:00
|
|
|
|
2009-12-16 15:08:37 +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);
|
|
|
|
ZMQ_EXPORT int zmq_msg_init_data (zmq_msg_t *msg, void *data,
|
2009-12-16 15:08:37 +01:00
|
|
|
size_t size, zmq_free_fn *ffn, void *hint);
|
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);
|
|
|
|
ZMQ_EXPORT size_t zmq_msg_size (zmq_msg_t *msg);
|
2009-07-29 12:07:54 +02:00
|
|
|
|
2010-04-11 14:00:40 +02:00
|
|
|
/******************************************************************************/
|
|
|
|
/* 0MQ infrastructure (a.k.a. context) initialisation & termination. */
|
|
|
|
/******************************************************************************/
|
2009-09-22 10:57:46 +02:00
|
|
|
|
2010-06-04 15:24:06 +02:00
|
|
|
ZMQ_EXPORT void *zmq_init (int io_threads);
|
2009-08-03 11:30:13 +02:00
|
|
|
ZMQ_EXPORT int zmq_term (void *context);
|
2009-07-29 12:07:54 +02:00
|
|
|
|
2010-04-11 14:00:40 +02:00
|
|
|
/******************************************************************************/
|
|
|
|
/* 0MQ socket definition. */
|
|
|
|
/******************************************************************************/
|
2009-09-22 10:57:46 +02:00
|
|
|
|
2010-04-26 16:51:05 +02:00
|
|
|
/* Socket types. */
|
2010-08-06 17:49:37 +02:00
|
|
|
#define ZMQ_PAIR 0
|
|
|
|
#define ZMQ_PUB 1
|
|
|
|
#define ZMQ_SUB 2
|
|
|
|
#define ZMQ_REQ 3
|
|
|
|
#define ZMQ_REP 4
|
|
|
|
#define ZMQ_XREQ 5
|
|
|
|
#define ZMQ_XREP 6
|
|
|
|
#define ZMQ_PULL 7
|
|
|
|
#define ZMQ_PUSH 8
|
2010-12-04 23:14:38 +01:00
|
|
|
#define ZMQ_XPUB 9
|
|
|
|
#define ZMQ_XSUB 10
|
2009-11-24 11:23:10 +01:00
|
|
|
|
2010-04-11 14:00:40 +02:00
|
|
|
/* Socket options. */
|
2010-08-06 17:49:37 +02:00
|
|
|
#define ZMQ_AFFINITY 4
|
|
|
|
#define ZMQ_SUBSCRIBE 6
|
|
|
|
#define ZMQ_UNSUBSCRIBE 7
|
|
|
|
#define ZMQ_RATE 8
|
2009-09-22 10:57:46 +02:00
|
|
|
#define ZMQ_RECOVERY_IVL 9
|
2010-08-06 17:49:37 +02:00
|
|
|
#define ZMQ_SNDBUF 11
|
|
|
|
#define ZMQ_RCVBUF 12
|
|
|
|
#define ZMQ_RCVMORE 13
|
|
|
|
#define ZMQ_FD 14
|
|
|
|
#define ZMQ_EVENTS 15
|
2010-09-28 15:27:45 +02:00
|
|
|
#define ZMQ_TYPE 16
|
2010-10-16 10:53:29 +02:00
|
|
|
#define ZMQ_LINGER 17
|
2010-10-17 09:54:12 +02:00
|
|
|
#define ZMQ_RECONNECT_IVL 18
|
2010-10-17 10:23:58 +02:00
|
|
|
#define ZMQ_BACKLOG 19
|
2011-01-26 07:01:06 +01:00
|
|
|
#define ZMQ_RECONNECT_IVL_MAX 21
|
2011-03-02 09:00:36 +01:00
|
|
|
#define ZMQ_MAXMSGSIZE 22
|
2011-03-24 16:47:33 +01:00
|
|
|
#define ZMQ_SNDHWM 23
|
|
|
|
#define ZMQ_RCVHWM 24
|
2011-05-15 18:25:43 +02:00
|
|
|
#define ZMQ_MULTICAST_HOPS 25
|
2011-06-17 12:22:02 +02:00
|
|
|
#define ZMQ_RCVTIMEO 27
|
|
|
|
#define ZMQ_SNDTIMEO 28
|
2011-06-20 11:33:54 +02:00
|
|
|
#define ZMQ_RCVLABEL 29
|
2011-07-17 23:31:29 +02:00
|
|
|
#define ZMQ_RCVCMD 30
|
2011-08-08 12:10:31 +02:00
|
|
|
#define ZMQ_IPV4ONLY 31
|
|
|
|
|
2010-04-11 14:00:40 +02:00
|
|
|
/* Send/recv options. */
|
2011-03-26 10:38:40 +01:00
|
|
|
#define ZMQ_DONTWAIT 1
|
2010-08-06 17:49:37 +02:00
|
|
|
#define ZMQ_SNDMORE 2
|
2011-06-20 11:33:54 +02:00
|
|
|
#define ZMQ_SNDLABEL 4
|
2011-07-17 23:31:29 +02:00
|
|
|
#define ZMQ_SNDCMD 8
|
2009-12-05 11:20:57 +01:00
|
|
|
|
|
|
|
ZMQ_EXPORT void *zmq_socket (void *context, int type);
|
|
|
|
ZMQ_EXPORT int zmq_close (void *s);
|
2009-09-22 10:57:46 +02:00
|
|
|
ZMQ_EXPORT int zmq_setsockopt (void *s, int option, const void *optval,
|
|
|
|
size_t optvallen);
|
2010-04-09 13:04:15 +02:00
|
|
|
ZMQ_EXPORT int zmq_getsockopt (void *s, int option, void *optval,
|
|
|
|
size_t *optvallen);
|
2009-08-09 09:24:48 +02:00
|
|
|
ZMQ_EXPORT int zmq_bind (void *s, const char *addr);
|
|
|
|
ZMQ_EXPORT int zmq_connect (void *s, const char *addr);
|
2011-03-24 11:53:55 +01:00
|
|
|
ZMQ_EXPORT int zmq_send (void *s, const void *buf, size_t len, int flags);
|
|
|
|
ZMQ_EXPORT int zmq_recv (void *s, void *buf, size_t len, int flags);
|
|
|
|
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);
|
2009-07-29 12:07:54 +02:00
|
|
|
|
2010-04-11 14:00:40 +02:00
|
|
|
/******************************************************************************/
|
|
|
|
/* I/O multiplexing. */
|
|
|
|
/******************************************************************************/
|
2009-10-01 10:56:17 +02:00
|
|
|
|
2010-08-06 17:49:37 +02:00
|
|
|
#define ZMQ_POLLIN 1
|
|
|
|
#define ZMQ_POLLOUT 2
|
|
|
|
#define ZMQ_POLLERR 4
|
2009-10-01 10:56:17 +02:00
|
|
|
|
|
|
|
typedef struct
|
|
|
|
{
|
|
|
|
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;
|
|
|
|
|
2010-01-04 15:46:20 +01:00
|
|
|
ZMQ_EXPORT int zmq_poll (zmq_pollitem_t *items, int nitems, long timeout);
|
2009-10-01 10:56:17 +02:00
|
|
|
|
2010-11-25 17:12:31 +01:00
|
|
|
#undef ZMQ_EXPORT
|
|
|
|
|
2009-07-29 12:07:54 +02:00
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#endif
|
2010-09-04 17:12:08 +02:00
|
|
|
|