+◆ natsOptions_TLSHandshakeFirst()
+
+
+
+
If the server is not configured to require the client to perform the TLS handshake first, the server sends an INFO protocol first. When receiving it, the client and server are then initiate the TLS handshake.
+
If the server is configured to require the client to perform the TLS handshake first, the client will fail to connect if not setting this option. Conversely, if the client is configured with this option but the server is not, the connection will fail.
+
- Parameters
-
+
+
+
+
| NATS_EXTERN natsStatus | natsOptions_SetSecure (natsOptions *opts, bool secure) |
| | Sets the secure mode. More...
|
| |
+| NATS_EXTERN natsStatus | natsOptions_TLSHandshakeFirst (natsOptions *opts) |
+| | Performs TLS handshake first. More...
|
+| |
| NATS_EXTERN natsStatus | natsOptions_LoadCATrustedCertificates (natsOptions *opts, const char *fileName) |
| | Loads the trusted CA certificates from a file. More...
|
| |
diff --git a/doc/html/nats_8h.js b/doc/html/nats_8h.js
index 8b6d193d0..72f26996b 100644
--- a/doc/html/nats_8h.js
+++ b/doc/html/nats_8h.js
@@ -190,6 +190,7 @@ var nats_8h =
[ "natsOptions_SetTimeout", "group__opts_group.html#ga17cd7fe41176cd98aca1184fa9352ad9", null ],
[ "natsOptions_SetName", "group__opts_group.html#ga1c529d347be0fe2eec17c7f4698e283e", null ],
[ "natsOptions_SetSecure", "group__opts_group.html#gaa1f09416d443fa7a6af6b695da563eba", null ],
+ [ "natsOptions_TLSHandshakeFirst", "group__opts_group.html#gac530a5d4cc93158047fc17c79dac6812", null ],
[ "natsOptions_LoadCATrustedCertificates", "group__opts_group.html#ga2cd6563694a439b3949a31fd81103099", null ],
[ "natsOptions_SetCATrustedCertificates", "group__opts_group.html#gafb30794fc2ae74b9e0bd8fb609b901c8", null ],
[ "natsOptions_LoadCertificatesChain", "group__opts_group.html#ga36943e2ba53d05407cdabc4e7e96484b", null ],
diff --git a/doc/html/nats_8h_source.html b/doc/html/nats_8h_source.html
index b5fbaee02..9119607a3 100644
--- a/doc/html/nats_8h_source.html
+++ b/doc/html/nats_8h_source.html
@@ -569,7 +569,7 @@
-
+
@@ -997,1286 +997,1289 @@
-
-
-
-
-
-
+
+
+
+
+
+
-
- 2390 const char *certsFileName,
- 2391 const char *keyFileName);
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+ 2407 const char *certsFileName,
+ 2408 const char *keyFileName);
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 3088 const char *userOrChainedFile,
- 3089 const char *seedFile);
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
- 3105 const char *jwtAndSeedContent);
-
-
-
-
-
-
-
-
-
-
- 3163 const char *seedFile);
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 3264 #if defined(NATS_HAS_STREAMING)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+ 3105 const char *userOrChainedFile,
+ 3106 const char *seedFile);
+
+
+
+ 3122 const char *jwtAndSeedContent);
+
+
+
+
+
+
+
+
+
+
+ 3180 const char *seedFile);
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 3281 #if defined(NATS_HAS_STREAMING)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 3696 const char *data,
int dataLen);
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 3928 #if defined(NATS_HAS_STREAMING)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 4360 const unsigned char *message,
int messageLen,
- 4361 unsigned char sig[64]);
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 3713 const char *data,
int dataLen);
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 3945 #if defined(NATS_HAS_STREAMING)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 4471 const void *data,
int dataLen);
-
-
-
-
-
-
-
-
-
-
- 4518 const char *reply,
const void *data,
int dataLen);
-
-
-
- 4538 const char *reply,
const char *str);
-
-
-
- 4559 const void *data,
int dataLen, int64_t timeout);
-
-
-
- 4584 const char *subj,
const char *str,
-
-
-
-
- 4603 natsMsg *requestMsg, int64_t timeout);
-
-
-
-
-
-
-
-
-
- 4664 const char *subject, int64_t timeout,
-
-
-
-
- 4679 const char *subject);
-
-
-
- 4700 const char *subject,
const char *queueGroup,
-
-
-
-
- 4737 const char *subject,
const char *queueGroup,
-
-
-
-
- 4753 const char *subject,
const char *queueGroup);
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+ 4377 const unsigned char *message,
int messageLen,
+ 4378 unsigned char sig[64]);
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 4488 const void *data,
int dataLen);
+
+
+
+
+
+
+
+
+
+
+ 4535 const char *reply,
const void *data,
int dataLen);
+
+
+
+ 4555 const char *reply,
const char *str);
+
+
+
+ 4576 const void *data,
int dataLen, int64_t timeout);
+
+
+
+ 4601 const char *subj,
const char *str,
+
+
+
+
+ 4620 natsMsg *requestMsg, int64_t timeout);
+
+
+
+
+
+
+
+
+
+ 4681 const char *subject, int64_t timeout,
+
+
+
+
+ 4696 const char *subject);
+
+
+
+ 4717 const char *subject,
const char *queueGroup,
+
+
+
+
+ 4754 const char *subject,
const char *queueGroup,
+
+
+
+
+ 4770 const char *subject,
const char *queueGroup);
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 5012 int *maxPendingMsgs,
- 5013 int *maxPendingBytes,
- 5014 int64_t *deliveredMsgs,
- 5015 int64_t *droppedMsgs);
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 5197 #if defined(NATS_HAS_STREAMING)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 5337 const void *data,
int dataLen);
-
-
-
- 5364 const void *data,
int dataLen,
-
-
-
-
-
-
-
-
-
-
- 5417 const char *channel,
const char *queueGroup,
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 5029 int *maxPendingMsgs,
+ 5030 int *maxPendingBytes,
+ 5031 int64_t *deliveredMsgs,
+ 5032 int64_t *droppedMsgs);
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 5214 #if defined(NATS_HAS_STREAMING)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 5354 const void *data,
int dataLen);
+
+
+
+ 5381 const void *data,
int dataLen,
+
+
+
+
+
+
+
+
+
+
+ 5434 const char *channel,
const char *queueGroup,
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
-
-
-
-
-
+
+
+
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 5972 const char *stream,
const char *consumer,
-
-
-
-
-
-
-
-
- 6006 const char *stream,
const char *consumer,
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 5989 const char *stream,
const char *consumer,
+
+
+
+
+
+
+
+
+ 6023 const char *stream,
const char *consumer,
+
+
+
+
+
+
+
-
-
-
-
-
+
+
+
+
+
-
-
-
-
-
+
+
+
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
-
+
+
+
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 7852 #define MICRO_API_PREFIX "$SRV"
-
- 7857 #define MICRO_INFO_RESPONSE_TYPE "io.nats.micro.v1.info_response"
-
- 7862 #define MICRO_INFO_VERB "INFO"
-
- 7867 #define MICRO_PING_RESPONSE_TYPE "io.nats.micro.v1.ping_response"
-
- 7872 #define MICRO_PING_VERB "PING"
-
- 7877 #define MICRO_STATS_RESPONSE_TYPE "io.nats.micro.v1.stats_response"
-
- 7882 #define MICRO_STATS_VERB "STATS"
-
- 7888 #define MICRO_STATUS_HDR "Nats-Status"
-
- 7894 #define MICRO_ERROR_HDR "Nats-Service-Error"
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 7869 #define MICRO_API_PREFIX "$SRV"
+
+ 7874 #define MICRO_INFO_RESPONSE_TYPE "io.nats.micro.v1.info_response"
+
+ 7879 #define MICRO_INFO_VERB "INFO"
+
+ 7884 #define MICRO_PING_RESPONSE_TYPE "io.nats.micro.v1.ping_response"
+
+ 7889 #define MICRO_PING_VERB "PING"
+
+ 7894 #define MICRO_STATS_RESPONSE_TYPE "io.nats.micro.v1.stats_response"
- 7900 #define MICRO_ERROR_CODE_HDR "Nats-Service-Error-Code"
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+ 7899 #define MICRO_STATS_VERB "STATS"
+
+ 7905 #define MICRO_STATUS_HDR "Nats-Status"
+
+ 7911 #define MICRO_ERROR_HDR "Nats-Service-Error"
+
+ 7917 #define MICRO_ERROR_CODE_HDR "Nats-Service-Error-Code"
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 8460 #define microError_Ignore(__err) microError_Destroy(__err)
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 8477 #define microError_Ignore(__err) microError_Destroy(__err)
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
+
+
+
+
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
void(* natsOnCompleteCB)(void *closure)
Callback used to notify that an object lifecycle is complete.
Definition: nats.h:1622
natsStatus(* natsEvLoop_Attach)(void **userData, void *loop, natsConnection *nc, natsSock socket)
Attach this connection to the external event loop.
Definition: nats.h:1503
natsStatus(* natsUserJWTHandler)(char **userJWT, char **customErrTxt, void *closure)
Callback used to fetch and return account signed user JWT.
Definition: nats.h:1566
NATS_EXTERN natsStatus nats_Sign(const char *encodedSeed, const char *input, unsigned char **signature, int *signatureLength)
Signs a given text using the provided private key.
NATS_EXTERN const char * nats_GetVersion(void)
Returns the Library's version.
NATS_EXTERN void nats_ReleaseThreadMemory(void)
Release thread-local memory possibly allocated by the library.
void(* microErrorHandler)(microService *m, microEndpoint *ep, natsStatus s)
Callback type for async error notifications.
Definition: nats.h:7546
microError *(* microRequestHandler)(microRequest *req)
Callback type for request processing.
Definition: nats.h:7522
void(* microDoneHandler)(microService *m)
Callback type for Done (service stopped) notifications.
Definition: nats.h:7559
void(* microErrorHandler)(microService *m, microEndpoint *ep, natsStatus s)
Callback type for async error notifications.
Definition: nats.h:7563
microError *(* microRequestHandler)(microRequest *req)
Callback type for request processing.
Definition: nats.h:7539
void(* microDoneHandler)(microService *m)
Callback type for Done (service stopped) notifications.
Definition: nats.h:7576
NATS_EXTERN void microServiceInfo_Destroy(microServiceInfo *info)
Destroys a microServiceInfo object.
NATS_EXTERN void microServiceStats_Destroy(microServiceStats *stats)
Destroys a microServiceStats object.
NATS_EXTERN microError * micro_NewClient(microClient **new_client, natsConnection *nc, microClientConfig *cfg)
Creates a new microservice client.
NATS_EXTERN bool microService_IsStopped(microService *m)
Checks if the service is stopped.
NATS_EXTERN microError * microService_Destroy(microService *m)
Destroys a microservice, stopping it first if needed.
NATS_EXTERN microError * microService_GetStats(microServiceStats **new_stats, microService *m)
Returns run-time statistics for a microservice.
struct micro_client_s microClient
The Microservice client.
Definition: nats.h:7377
struct micro_group_s microGroup
a collection of endpoints and other groups, with a common prefix to their subjects and names.
Definition: nats.h:7446
struct micro_request_s microRequest
a request received by a microservice endpoint.
Definition: nats.h:7453
struct micro_error_s microError
the Microservice error object.
Definition: nats.h:7437
struct __for_forward_compatibility_only microClientConfig
The Microservice configuration object. For forward compatibility only.
Definition: nats.h:7382
struct micro_client_s microClient
The Microservice client.
Definition: nats.h:7394
struct micro_group_s microGroup
a collection of endpoints and other groups, with a common prefix to their subjects and names.
Definition: nats.h:7463
struct micro_request_s microRequest
a request received by a microservice endpoint.
Definition: nats.h:7470
struct micro_error_s microError
the Microservice error object.
Definition: nats.h:7454
struct __for_forward_compatibility_only microClientConfig
The Microservice configuration object. For forward compatibility only.
Definition: nats.h:7399
NATS_EXTERN microError * micro_ErrorInvalidArg
NATS_EXTERN microError * micro_ErrorOutOfMemory
struct micro_endpoint_s microEndpoint
microEndpoint represents a microservice endpoint.
Definition: nats.h:7393
struct micro_service_s microService
the main object for a configured microservice.
Definition: nats.h:7466
struct micro_endpoint_s microEndpoint
microEndpoint represents a microservice endpoint.
Definition: nats.h:7410
struct micro_service_s microService
the main object for a configured microservice.
Definition: nats.h:7483
NATS_EXTERN natsStatus natsMsg_Create(natsMsg **newMsg, const char *subj, const char *reply, const char *data, int dataLen)
Creates a natsMsg object.
NATS_EXTERN void natsMsgList_Destroy(natsMsgList *list)
Destroys this list of messages.
NATS_EXTERN int natsMsg_GetDataLength(const natsMsg *msg)
Returns the message length.
NATS_EXTERN natsStatus natsOptions_SetDiscoveredServersCB(natsOptions *opts, natsConnectionHandler discoveredServersCb, void *closure)
Sets the callback to be invoked when new servers are discovered.
NATS_EXTERN natsStatus natsOptions_UseGlobalMessageDelivery(natsOptions *opts, bool global)
Switch on/off the use of a central message delivery thread pool.
NATS_EXTERN natsStatus natsOptions_SetCustomInboxPrefix(natsOptions *opts, const char *inboxPrefix)
Sets a custom inbox prefix.
NATS_EXTERN natsStatus natsOptions_TLSHandshakeFirst(natsOptions *opts)
Performs TLS handshake first.
NATS_EXTERN natsStatus natsOptions_SetServers(natsOptions *opts, const char **servers, int serversCount)
Set the list of servers to try to (re)connect to.
NATS_EXTERN natsStatus natsOptions_SetToken(natsOptions *opts, const char *token)
Sets the token to use when not specified in the URL.
NATS_EXTERN natsStatus natsOptions_SetDisconnectedCB(natsOptions *opts, natsConnectionHandler disconnectedCb, void *closure)
Sets the callback to be invoked when the connection to a server is lost.
bool IncludeHistory
Definition: nats.h:1325
int64_t Timeout
How long to wait (in milliseconds) for some operations to complete.
Definition: nats.h:1327
bool MetaOnly
Definition: nats.h:1326
const char * Name
The name of the endpoint.
Definition: nats.h:7580
microRequestHandler Handler
The request handler for the endpoint.
Definition: nats.h:7602
const char * Subject
The NATS subject the endpoint will listen on.
Definition: nats.h:7591
natsMetadata Metadata
Definition: nats.h:7597
void * State
A user-provided pointer to store with the endpoint (state/closure).
Definition: nats.h:7608
const char * Subject
The semantic version of the service.
Definition: nats.h:7624
const char * Name
The name of the service.
Definition: nats.h:7619
natsMetadata Metadata
Definition: nats.h:7630
const char * Subject
Definition: nats.h:7639
int64_t NumRequests
The number of requests received by the endpoint.
Definition: nats.h:7644
char LastErrorString[2048]
a copy of the last error message.
Definition: nats.h:7670
int64_t ProcessingTimeSeconds
total request processing time (the seconds part).
Definition: nats.h:7655
int64_t ProcessingTimeNanoseconds
total request processing time (the nanoseconds part).
Definition: nats.h:7660
int64_t NumErrors
The number of errors, service-level and internal, associated with the endpoint.
Definition: nats.h:7650
int64_t AverageProcessingTimeNanoseconds
average request processing time, in ns.
Definition: nats.h:7665
const char * Name
Definition: nats.h:7638
The Microservice top-level configuration object.
Definition: nats.h:7680
const char * Description
The description of the service.
Definition: nats.h:7696
void * State
A user-provided pointer to state data.
Definition: nats.h:7747
const char * Version
The (semantic) version of the service.
Definition: nats.h:7691
microErrorHandler ErrHandler
An error notification handler.
Definition: nats.h:7728
natsMetadata Metadata
Metadata for the service, a JSON-encoded user-provided object, e.g. {"key":"value"}
Definition: nats.h:7701
microRequestHandler StatsHandler
A custom stats handler.
Definition: nats.h:7719
microDoneHandler DoneHandler
A callback handler for handling the final cleanup Done event, right before the service is destroyed.
Definition: nats.h:7738
const char * Name
The name of the service.
Definition: nats.h:7686
microEndpointConfig * Endpoint
The "main" (aka default) endpoint configuration.
Definition: nats.h:7710
natsMetadata Metadata
Metadata for the service, a JSON-encoded user-provided object, e.g. {"key":"value"}
Definition: nats.h:7785
const char * Name
The name of the service.
Definition: nats.h:7765
const char * Version
The semantic version of the service.
Definition: nats.h:7770
const char * Type
Response type. Always "io.nats.micro.v1.info_response".
Definition: nats.h:7760
const char * Id
The ID of the service instance responding to the request.
Definition: nats.h:7780
microEndpointInfo * Endpoints
Endpoints.
Definition: nats.h:7790
const char * Description
The description of the service.
Definition: nats.h:7775
int EndpointsLen
The number of endpoints in the Endpoints array.
Definition: nats.h:7795
int64_t Started
The timestamp of when the service was started.
Definition: nats.h:7826
int EndpointsLen
The number of endpoints in the endpoints array.
Definition: nats.h:7836
microEndpointStats * Endpoints
The stats for each endpoint of the service.
Definition: nats.h:7831
const char * Version
The semantic version of the service.
Definition: nats.h:7816
const char * Name
The name of the service.
Definition: nats.h:7811
const char * Type
Response type. Always "io.nats.micro.v1.stats_response".
Definition: nats.h:7806
const char * Id
The ID of the service instance responding to the request.
Definition: nats.h:7821
const char * Name
The name of the endpoint.
Definition: nats.h:7597
microRequestHandler Handler
The request handler for the endpoint.
Definition: nats.h:7619
const char * Subject
The NATS subject the endpoint will listen on.
Definition: nats.h:7608
natsMetadata Metadata
Definition: nats.h:7614
void * State
A user-provided pointer to store with the endpoint (state/closure).
Definition: nats.h:7625
const char * Subject
The semantic version of the service.
Definition: nats.h:7641
const char * Name
The name of the service.
Definition: nats.h:7636
natsMetadata Metadata
Definition: nats.h:7647
const char * Subject
Definition: nats.h:7656
int64_t NumRequests
The number of requests received by the endpoint.
Definition: nats.h:7661
char LastErrorString[2048]
a copy of the last error message.
Definition: nats.h:7687
int64_t ProcessingTimeSeconds
total request processing time (the seconds part).
Definition: nats.h:7672
int64_t ProcessingTimeNanoseconds
total request processing time (the nanoseconds part).
Definition: nats.h:7677
int64_t NumErrors
The number of errors, service-level and internal, associated with the endpoint.
Definition: nats.h:7667
int64_t AverageProcessingTimeNanoseconds
average request processing time, in ns.
Definition: nats.h:7682
const char * Name
Definition: nats.h:7655
The Microservice top-level configuration object.
Definition: nats.h:7697
const char * Description
The description of the service.
Definition: nats.h:7713
void * State
A user-provided pointer to state data.
Definition: nats.h:7764
const char * Version
The (semantic) version of the service.
Definition: nats.h:7708
microErrorHandler ErrHandler
An error notification handler.
Definition: nats.h:7745
natsMetadata Metadata
Metadata for the service, a JSON-encoded user-provided object, e.g. {"key":"value"}
Definition: nats.h:7718
microRequestHandler StatsHandler
A custom stats handler.
Definition: nats.h:7736
microDoneHandler DoneHandler
A callback handler for handling the final cleanup Done event, right before the service is destroyed.
Definition: nats.h:7755
const char * Name
The name of the service.
Definition: nats.h:7703
microEndpointConfig * Endpoint
The "main" (aka default) endpoint configuration.
Definition: nats.h:7727
natsMetadata Metadata
Metadata for the service, a JSON-encoded user-provided object, e.g. {"key":"value"}
Definition: nats.h:7802
const char * Name
The name of the service.
Definition: nats.h:7782
const char * Version
The semantic version of the service.
Definition: nats.h:7787
const char * Type
Response type. Always "io.nats.micro.v1.info_response".
Definition: nats.h:7777
const char * Id
The ID of the service instance responding to the request.
Definition: nats.h:7797
microEndpointInfo * Endpoints
Endpoints.
Definition: nats.h:7807
const char * Description
The description of the service.
Definition: nats.h:7792
int EndpointsLen
The number of endpoints in the Endpoints array.
Definition: nats.h:7812
int64_t Started
The timestamp of when the service was started.
Definition: nats.h:7843
int EndpointsLen
The number of endpoints in the endpoints array.
Definition: nats.h:7853
microEndpointStats * Endpoints
The stats for each endpoint of the service.
Definition: nats.h:7848
const char * Version
The semantic version of the service.
Definition: nats.h:7833
const char * Name
The name of the service.
Definition: nats.h:7828
const char * Type
Response type. Always "io.nats.micro.v1.stats_response".
Definition: nats.h:7823
const char * Id
The ID of the service instance responding to the request.
Definition: nats.h:7838