laag-libczmq 4.1.0.0

data/vendor/github.com/zeromq/czmq/include/zbeacon.h

@@ -0,0 +1,86 @@
+/*  =========================================================================
+    zbeacon - LAN discovery and presence
+    
+    Copyright (c) the Contributors as noted in the AUTHORS file.
+    This file is part of CZMQ, the high-level C binding for 0MQ:
+    http://czmq.zeromq.org.
+
+    This Source Code Form is subject to the terms of the Mozilla Public
+    License, v. 2.0. If a copy of the MPL was not distributed with this
+    file, You can obtain one at http://mozilla.org/MPL/2.0/.
+    =========================================================================
+*/
+
+#ifndef __ZBEACON_H_INCLUDED__
+#define __ZBEACON_H_INCLUDED__
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+//  @interface
+//  Create new zbeacon actor instance:
+//
+//      zactor_t *beacon = zactor_new (zbeacon, NULL);
+//
+//  Destroy zbeacon instance:
+//
+//      zactor_destroy (&beacon);
+//
+//  Enable verbose logging of commands and activity:
+//
+//      zstr_send (beacon, "VERBOSE");
+//
+//  Configure beacon to run on specified UDP port, and return the name of
+//  the host, which can be used as endpoint for incoming connections. To
+//  force the beacon to operate on a given interface, set the environment
+//  variable ZSYS_INTERFACE, or call zsys_set_interface() before creating
+//  the beacon. If the system does not support UDP broadcasts (lacking a
+//  workable interface), returns an empty hostname:
+//
+//      //  Pictures: 's' = C string, 'i' = int
+//      zsock_send (beacon, "si", "CONFIGURE", port_number);
+//      char *hostname = zstr_recv (beacon);
+//
+//  Start broadcasting a beacon at a specified interval in msec. The beacon
+//  data can be at most UDP_FRAME_MAX bytes; this constant is defined in
+//  zsys.h to be 255:
+//
+//      //  Pictures: 'b' = byte * data + size_t size
+//      zsock_send (beacon, "sbi", "PUBLISH", data, size, interval);
+//
+//  Stop broadcasting the beacon:
+//
+//      zstr_sendx (beacon, "SILENCE", NULL);
+//
+//  Start listening to beacons from peers. The filter is used to do a prefix
+//  match on received beacons, to remove junk. Note that any received data
+//  that is identical to our broadcast beacon_data is discarded in any case.
+//  If the filter size is zero, we get all peer beacons:
+//  
+//      zsock_send (beacon, "sb", "SUBSCRIBE", filter_data, filter_size);
+//
+//  Stop listening to other peers
+//
+//      zstr_sendx (beacon, "UNSUBSCRIBE", NULL);
+//
+//  Receive next beacon from a peer. Received beacons are always a 2-frame
+//  message containing the ipaddress of the sender, and then the binary
+//  beacon data as published by the sender:
+//
+//      zmsg_t *msg = zmsg_recv (beacon);
+//
+//  This is the zbeacon constructor as a zactor_fn:
+CZMQ_EXPORT void
+    zbeacon (zsock_t *pipe, void *unused);
+
+//  Self test of this class
+CZMQ_EXPORT void
+    zbeacon_test (bool verbose);
+//  @end
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif

data/vendor/github.com/zeromq/czmq/include/zcert.h

@@ -0,0 +1,133 @@
+/*  =========================================================================
+    zcert - work with CURVE security certificates
+
+    Copyright (c) the Contributors as noted in the AUTHORS file.
+    This file is part of CZMQ, the high-level C binding for 0MQ:
+    http://czmq.zeromq.org.
+
+    This Source Code Form is subject to the terms of the Mozilla Public
+    License, v. 2.0. If a copy of the MPL was not distributed with this
+    file, You can obtain one at http://mozilla.org/MPL/2.0/.
+    =========================================================================
+*/
+
+#ifndef __ZCERT_H_INCLUDED__
+#define __ZCERT_H_INCLUDED__
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+//  @warning THE FOLLOWING @INTERFACE BLOCK IS AUTO-GENERATED BY ZPROJECT
+//  @warning Please edit the model at "api/zcert.api" to make changes.
+//  @interface
+//  This is a stable class, and may not change except for emergencies. It
+//  is provided in stable builds.
+//  This class has draft methods, which may change over time. They are not
+//  in stable releases, by default. Use --enable-drafts to enable.
+//  Create and initialize a new certificate in memory
+CZMQ_EXPORT zcert_t *
+    zcert_new (void);
+
+//  Accepts public/secret key pair from caller
+CZMQ_EXPORT zcert_t *
+    zcert_new_from (const byte *public_key, const byte *secret_key);
+
+//  Load certificate from file
+CZMQ_EXPORT zcert_t *
+    zcert_load (const char *filename);
+
+//  Destroy a certificate in memory
+CZMQ_EXPORT void
+    zcert_destroy (zcert_t **self_p);
+
+//  Return public part of key pair as 32-byte binary string
+CZMQ_EXPORT const byte *
+    zcert_public_key (zcert_t *self);
+
+//  Return secret part of key pair as 32-byte binary string
+CZMQ_EXPORT const byte *
+    zcert_secret_key (zcert_t *self);
+
+//  Return public part of key pair as Z85 armored string
+CZMQ_EXPORT const char *
+    zcert_public_txt (zcert_t *self);
+
+//  Return secret part of key pair as Z85 armored string
+CZMQ_EXPORT const char *
+    zcert_secret_txt (zcert_t *self);
+
+//  Set certificate metadata from formatted string.
+CZMQ_EXPORT void
+    zcert_set_meta (zcert_t *self, const char *name, const char *format, ...) CHECK_PRINTF (3);
+
+//  Get metadata value from certificate; if the metadata value doesn't
+//  exist, returns NULL.
+CZMQ_EXPORT const char *
+    zcert_meta (zcert_t *self, const char *name);
+
+//  Get list of metadata fields from certificate. Caller is responsible for
+//  destroying list. Caller should not modify the values of list items.
+CZMQ_EXPORT zlist_t *
+    zcert_meta_keys (zcert_t *self);
+
+//  Save full certificate (public + secret) to file for persistent storage
+//  This creates one public file and one secret file (filename + "_secret").
+CZMQ_EXPORT int
+    zcert_save (zcert_t *self, const char *filename);
+
+//  Save public certificate only to file for persistent storage
+CZMQ_EXPORT int
+    zcert_save_public (zcert_t *self, const char *filename);
+
+//  Save secret certificate only to file for persistent storage
+CZMQ_EXPORT int
+    zcert_save_secret (zcert_t *self, const char *filename);
+
+//  Apply certificate to socket, i.e. use for CURVE security on socket.
+//  If certificate was loaded from public file, the secret key will be
+//  undefined, and this certificate will not work successfully.
+CZMQ_EXPORT void
+    zcert_apply (zcert_t *self, void *socket);
+
+//  Return copy of certificate; if certificate is NULL or we exhausted
+//  heap memory, returns NULL.
+//  Caller owns return value and must destroy it when done.
+CZMQ_EXPORT zcert_t *
+    zcert_dup (zcert_t *self);
+
+//  Return true if two certificates have the same keys
+CZMQ_EXPORT bool
+    zcert_eq (zcert_t *self, zcert_t *compare);
+
+//  Print certificate contents to stdout
+CZMQ_EXPORT void
+    zcert_print (zcert_t *self);
+
+//  Self test of this class
+CZMQ_EXPORT void
+    zcert_test (bool verbose);
+
+#ifdef CZMQ_BUILD_DRAFT_API
+//  *** Draft method, for development use, may change without warning ***
+//  Accepts public/secret key text pair from caller
+CZMQ_EXPORT zcert_t *
+    zcert_new_from_txt (const char *public_txt, const char *secret_txt);
+
+//  *** Draft method, for development use, may change without warning ***
+//  Unset certificate metadata.
+CZMQ_EXPORT void
+    zcert_unset_meta (zcert_t *self, const char *name);
+
+#endif // CZMQ_BUILD_DRAFT_API
+//  @end
+
+
+#ifdef __cplusplus
+}
+#endif
+
+//  Deprecated method aliases
+#define zcert_dump(s) zcert_print(s)
+
+#endif

data/vendor/github.com/zeromq/czmq/include/zcertstore.h

@@ -0,0 +1,101 @@
+/*  =========================================================================
+    zcertstore - work with CURVE security certificate stores
+
+    Copyright (c) the Contributors as noted in the AUTHORS file.
+    This file is part of CZMQ, the high-level C binding for 0MQ:
+    http://czmq.zeromq.org.
+
+    This Source Code Form is subject to the terms of the Mozilla Public
+    License, v. 2.0. If a copy of the MPL was not distributed with this
+    file, You can obtain one at http://mozilla.org/MPL/2.0/.
+    =========================================================================
+*/
+
+#ifndef __ZCERTSTORE_H_INCLUDED__
+#define __ZCERTSTORE_H_INCLUDED__
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+//  @warning THE FOLLOWING @INTERFACE BLOCK IS AUTO-GENERATED BY ZPROJECT
+//  @warning Please edit the model at "api/zcertstore.api" to make changes.
+//  @interface
+//  This is a stable class, and may not change except for emergencies. It
+//  is provided in stable builds.
+//  This class has draft methods, which may change over time. They are not
+//  in stable releases, by default. Use --enable-drafts to enable.
+//  Create a new certificate store from a disk directory, loading and
+//  indexing all certificates in that location. The directory itself may be
+//  absent, and created later, or modified at any time. The certificate store
+//  is automatically refreshed on any zcertstore_lookup() call. If the
+//  location is specified as NULL, creates a pure-memory store, which you
+//  can work with by inserting certificates at runtime.
+CZMQ_EXPORT zcertstore_t *
+    zcertstore_new (const char *location);
+
+//  Destroy a certificate store object in memory. Does not affect anything
+//  stored on disk.
+CZMQ_EXPORT void
+    zcertstore_destroy (zcertstore_t **self_p);
+
+//  Look up certificate by public key, returns zcert_t object if found,
+//  else returns NULL. The public key is provided in Z85 text format.
+CZMQ_EXPORT zcert_t *
+    zcertstore_lookup (zcertstore_t *self, const char *public_key);
+
+//  Insert certificate into certificate store in memory. Note that this
+//  does not save the certificate to disk. To do that, use zcert_save()
+//  directly on the certificate. Takes ownership of zcert_t object.
+CZMQ_EXPORT void
+    zcertstore_insert (zcertstore_t *self, zcert_t **cert_p);
+
+//  Print list of certificates in store to logging facility
+CZMQ_EXPORT void
+    zcertstore_print (zcertstore_t *self);
+
+//  Self test of this class
+CZMQ_EXPORT void
+    zcertstore_test (bool verbose);
+
+#ifdef CZMQ_BUILD_DRAFT_API
+// Loaders retrieve certificates from an arbitrary source.
+typedef void (zcertstore_loader) (
+    zcertstore_t *self);
+
+// Destructor for loader state.
+typedef void (zcertstore_destructor) (
+    void **self_p);
+
+//  *** Draft method, for development use, may change without warning ***
+//  Override the default disk loader with a custom loader fn.
+CZMQ_EXPORT void
+    zcertstore_set_loader (zcertstore_t *self, zcertstore_loader loader, zcertstore_destructor destructor, void *state);
+
+//  *** Draft method, for development use, may change without warning ***
+//  Empty certificate hashtable. This wrapper exists to be friendly to bindings,
+//  which don't usually have access to struct internals.
+CZMQ_EXPORT void
+    zcertstore_empty (zcertstore_t *self);
+
+//  *** Draft method, for development use, may change without warning ***
+//  Return a list of all the certificates in the store.
+//  The caller takes ownership of the zlistx_t object and is responsible
+//  for destroying it.  The caller does not take ownership of the zcert_t
+//  objects.
+//  Caller owns return value and must destroy it when done.
+CZMQ_EXPORT zlistx_t *
+    zcertstore_certs (zcertstore_t *self);
+
+#endif // CZMQ_BUILD_DRAFT_API
+//  @end
+
+
+#ifdef __cplusplus
+}
+#endif
+
+//  Deprecated method aliases
+#define zcertstore_dump(s) zcertstore_print(s)
+
+#endif

data/vendor/github.com/zeromq/czmq/include/zchunk.h

@@ -0,0 +1,163 @@
+/*  =========================================================================
+    zchunk - work with memory chunks
+
+    Copyright (c) the Contributors as noted in the AUTHORS file.
+    This file is part of CZMQ, the high-level C binding for 0MQ:
+    http://czmq.zeromq.org.
+
+    This Source Code Form is subject to the terms of the Mozilla Public
+    License, v. 2.0. If a copy of the MPL was not distributed with this
+    file, You can obtain one at http://mozilla.org/MPL/2.0/.
+    =========================================================================
+*/
+
+#ifndef __ZCHUNK_H_INCLUDED__
+#define __ZCHUNK_H_INCLUDED__
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+//  @warning THE FOLLOWING @INTERFACE BLOCK IS AUTO-GENERATED BY ZPROJECT
+//  @warning Please edit the model at "api/zchunk.api" to make changes.
+//  @interface
+//  This is a stable class, and may not change except for emergencies. It
+//  is provided in stable builds.
+//  Create a new chunk of the specified size. If you specify the data, it
+//  is copied into the chunk. If you do not specify the data, the chunk is
+//  allocated and left empty, and you can then add data using zchunk_append.
+CZMQ_EXPORT zchunk_t *
+    zchunk_new (const void *data, size_t size);
+
+//  Destroy a chunk
+CZMQ_EXPORT void
+    zchunk_destroy (zchunk_t **self_p);
+
+//  Resizes chunk max_size as requested; chunk_cur size is set to zero
+CZMQ_EXPORT void
+    zchunk_resize (zchunk_t *self, size_t size);
+
+//  Return chunk cur size
+CZMQ_EXPORT size_t
+    zchunk_size (zchunk_t *self);
+
+//  Return chunk max size
+CZMQ_EXPORT size_t
+    zchunk_max_size (zchunk_t *self);
+
+//  Return chunk data
+CZMQ_EXPORT byte *
+    zchunk_data (zchunk_t *self);
+
+//  Set chunk data from user-supplied data; truncate if too large. Data may
+//  be null. Returns actual size of chunk
+CZMQ_EXPORT size_t
+    zchunk_set (zchunk_t *self, const void *data, size_t size);
+
+//  Fill chunk data from user-supplied octet
+CZMQ_EXPORT size_t
+    zchunk_fill (zchunk_t *self, byte filler, size_t size);
+
+//  Append user-supplied data to chunk, return resulting chunk size. If the
+//  data would exceeded the available space, it is truncated. If you want to
+//  grow the chunk to accommodate new data, use the zchunk_extend method.
+CZMQ_EXPORT size_t
+    zchunk_append (zchunk_t *self, const void *data, size_t size);
+
+//  Append user-supplied data to chunk, return resulting chunk size. If the
+//  data would exceeded the available space, the chunk grows in size.
+CZMQ_EXPORT size_t
+    zchunk_extend (zchunk_t *self, const void *data, size_t size);
+
+//  Copy as much data from 'source' into the chunk as possible; returns the
+//  new size of chunk. If all data from 'source' is used, returns exhausted
+//  on the source chunk. Source can be consumed as many times as needed until
+//  it is exhausted. If source was already exhausted, does not change chunk.
+CZMQ_EXPORT size_t
+    zchunk_consume (zchunk_t *self, zchunk_t *source);
+
+//  Returns true if the chunk was exhausted by consume methods, or if the
+//  chunk has a size of zero.
+CZMQ_EXPORT bool
+    zchunk_exhausted (zchunk_t *self);
+
+//  Read chunk from an open file descriptor
+//  Caller owns return value and must destroy it when done.
+CZMQ_EXPORT zchunk_t *
+    zchunk_read (FILE *handle, size_t bytes);
+
+//  Write chunk to an open file descriptor
+CZMQ_EXPORT int
+    zchunk_write (zchunk_t *self, FILE *handle);
+
+//  Try to slurp an entire file into a chunk. Will read up to maxsize of
+//  the file. If maxsize is 0, will attempt to read the entire file and
+//  fail with an assertion if that cannot fit into memory. Returns a new
+//  chunk containing the file data, or NULL if the file could not be read.
+//  Caller owns return value and must destroy it when done.
+CZMQ_EXPORT zchunk_t *
+    zchunk_slurp (const char *filename, size_t maxsize);
+
+//  Create copy of chunk, as new chunk object. Returns a fresh zchunk_t
+//  object, or null if there was not enough heap memory. If chunk is null,
+//  returns null.
+//  Caller owns return value and must destroy it when done.
+CZMQ_EXPORT zchunk_t *
+    zchunk_dup (zchunk_t *self);
+
+//  Return chunk data encoded as printable hex string. Caller must free
+//  string when finished with it.
+//  Caller owns return value and must destroy it when done.
+CZMQ_EXPORT char *
+    zchunk_strhex (zchunk_t *self);
+
+//  Return chunk data copied into freshly allocated string
+//  Caller must free string when finished with it.
+//  Caller owns return value and must destroy it when done.
+CZMQ_EXPORT char *
+    zchunk_strdup (zchunk_t *self);
+
+//  Return TRUE if chunk body is equal to string, excluding terminator
+CZMQ_EXPORT bool
+    zchunk_streq (zchunk_t *self, const char *string);
+
+//  Transform zchunk into a zframe that can be sent in a message.
+//  Caller owns return value and must destroy it when done.
+CZMQ_EXPORT zframe_t *
+    zchunk_pack (zchunk_t *self);
+
+//  Transform a zframe into a zchunk.
+//  Caller owns return value and must destroy it when done.
+CZMQ_EXPORT zchunk_t *
+    zchunk_unpack (zframe_t *frame);
+
+//  Calculate SHA1 digest for chunk, using zdigest class.
+CZMQ_EXPORT const char *
+    zchunk_digest (zchunk_t *self);
+
+//  Dump chunk to FILE stream, for debugging and tracing.
+CZMQ_EXPORT void
+    zchunk_fprint (zchunk_t *self, FILE *file);
+
+//  Dump message to stderr, for debugging and tracing.
+//  See zchunk_fprint for details
+CZMQ_EXPORT void
+    zchunk_print (zchunk_t *self);
+
+//  Probe the supplied object, and report if it looks like a zchunk_t.
+CZMQ_EXPORT bool
+    zchunk_is (void *self);
+
+//  Self test of this class.
+CZMQ_EXPORT void
+    zchunk_test (bool verbose);
+
+//  @end
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif
+