| nn_env(7) |
| ========== |
| |
| |
| NAME |
| ---- |
| nn_env - nanomsg environment variables |
| |
| |
| SYNOPSIS |
| -------- |
| Environment variables that influence the way nanomsg works |
| |
| |
| DESCRIPTION |
| ----------- |
| |
| *This functionality is experimental and a subject to change at any time* |
| |
| Following environment variables are used to turn on some debugging for any |
| nanomsg application. Please, do not try to parse output and do not |
| build business logic based on it. |
| |
| NN_PRINT_ERRORS:: |
| If set to non-empty string nanomsg will print errors to stderr. Some errors |
| will be resolved by nanomsg itself (e.g. if nanomsg can't establish |
| connection it will retry again in a moment). Some depend on the |
| environment (e.g. port that is bound by another process need to be |
| released). In any case nanomsg will not repeat the error message until |
| error is clear and appear again (e.g. connection established then broken |
| again). |
| |
| NN_PRINT_STATISTICS:: |
| If set to non-empty string nanomsg will print some statistics to stderr. |
| That's statistics is intended for debugging purposes only. |
| |
| NN_STATISTICS_SOCKET:: |
| The nanomsg address to send statistics to. Nanomsg opens NN_PUB socket |
| and sends statistics there. The data is sent using ESTP protocol. |
| |
| |
| NOTES |
| ----- |
| |
| The output of both debugging facilities (NN_PRINT_ERRORS, NN_PRINT_STATISTICS) |
| is intended for reading by human and a subject for change at any time (even |
| after 1.0 release). |
| |
| The NN_STATISTICS_SOCKET facility is intended to use by system administrators |
| to debug network and application issues. The ESTP format is stable. But the |
| nanomsg support of it is experimental and is subject to change or removal |
| until 1.0 release. |
| |
| Anyway, there is *no excuse* for making application logic based on the data |
| described here. And by application logic we mean any of the following: |
| |
| * Load balancing |
| * Failover |
| * Routing requests |
| * Executing nn_connect/nn_bind |
| |
| There are other ways for load-balancing and failover in nanomsg. If you feel |
| you can't do something, consider ask on the mailing list first. |
| |
| |
| SEE ALSO |
| -------- |
| linknanomsg:nanomsg[7] |
| |
| http://github.com/estp |
| |
| http://github.com/estp/estp/blob/master/specification.rst |
| |
| |
| AUTHORS |
| ------- |
| Paul Colomiets <paul@colomiets.name> |
| |
