NANOCAT(1) nanomsg manual NANOCAT(1)NAMEnanocat - a command-line interface to nanomsg
SYNOPSISnanocat--req {--connect ADDR|--bind ADDR} {--data DATA|--file PATH} [-i SEC] [-AQ]
nanocat--rep {--connect ADDR|--bind ADDR} {--data DATA|--file PATH} [-AQ]
nanocat--push {--connect ADDR|--bind ADDR} {--data DATA|--file PATH} [-i SEC]
nanocat--pull {--connect ADDR|--bind ADDR} [-AQ]
nanocat--pub {--connect ADDR|--bind ADDR} {--data DATA|--file PATH} [-i SEC]
nanocat--sub {--connect ADDR|--bind ADDR} [--subscribe PREFIX ...] [-AQ]
nanocat--surveyor {--connect ADDR|--bind ADDR} {--data DATA|--file PATH} [-i SEC] [-AQ]
nanocat--respondent {--connect ADDR|--bind ADDR} {--data DATA|--file PATH} [-AQ]
nanocat--bus {--connect ADDR|--bind ADDR} {--data DATA|--file PATH} [-i SEC] [-AQ]
nanocat--pair {--connect ADDR|--bind ADDR} {--data DATA|--file PATH} [-i SEC] [-AQ]
In the case symlinks are installed:
nn_req {--connect ADDR|--bind ADDR} {--data DATA|--file PATH} [-i SEC] [-AQ]
nn_rep {--connect ADDR|--bind ADDR} {--data DATA|--file PATH} [-AQ]
nn_push {--connect ADDR|--bind ADDR} {--data DATA|--file PATH} [-i SEC]
nn_pull {--connect ADDR|--bind ADDR} [-AQ]
nn_pub {--connect ADDR|--bind ADDR} {--data DATA|--file PATH} [-i SEC]
nn_sub {--connect ADDR|--bind ADDR} [--subscribe PREFIX ...] [-AQ]
nn_surveyor {--connect ADDR|--bind ADDR} {--data DATA|--file PATH} [-i SEC] [-AQ]
nn_respondent {--connect ADDR|--bind ADDR} {--data DATA|--file PATH} [-AQ]
nn_bus {--connect ADDR|--bind ADDR} {--data DATA|--file PATH} [-i SEC] [-AQ]
nn_pair {--connect ADDR|--bind ADDR} {--data DATA|--file PATH} [-i SEC] [-AQ]
DESCRIPTION
The nanocat is a command-line tool to send and receive data via nanomsg
sockets. It can be used for debugging purposes, sending files through
the network, health checking the system or whatever else you can think
of.
OPTIONS
Generic:
--verbose,-v
Increase verbosity of the nanocat--silent,-q
Decrease verbosity of the nanocat--help,-h
This help text
Socket Types:
--push
Use NN_PUSH socket type
--pull
Use NN_PULL socket type
--pub
Use NN_PUB socket type
--sub
Use NN_SUB socket type
--req
Use NN_REQ socket type
--rep
Use NN_REP socket type
--surveyor
Use NN_SURVEYOR socket type
--respondent
Use NN_RESPONDENT socket type
--bus
Use NN_BUS socket type
--pair
Use NN_PAIR socket type
Socket Options:
--bind ADDR
Bind socket to the address ADDR
--connect ADDR
Connect socket to the address ADDR
--bind-ipc,-X PATH
Bind socket to the ipc address "ipc://PATH".
--connect-ipc,-x PATH
Connect socket to the ipc address "ipc://PATH".
--bind-local,-L PORT
Bind socket to the tcp address "tcp://127.0.0.1:PORT".
--connect-local,-l PORT
Connect socket to the tcp address "tcp://127.0.0.1:PORT".
--recv-timeout SEC
Set timeout for receiving a message
--send-timeout SEC
Set timeout for sending a message
SUB Socket Options:
--subscribe PREFIX
Subscribe to the prefix PREFIX. Note: socket will be subscribed to
everything (empty prefix) if no prefixes are specified on the
command-line.
Input Options:
--format FORMAT
Use echo format FORMAT (same as the options below)
--raw
Dump message as is (Note: no delimiters are printed)
--ascii,-A
Print ASCII part of message delimited by newline. All non-ascii
characters replaced by dot.
--quoted,-Q
Print each message on separate line in double quotes with C-like
character escaping
--msgpack
Print each message as msgpacked string (raw type). This is useful
for programmatic parsing.
Output Options:
--interval,-i SEC
Send message (or request) every SEC seconds
--delay,-d SEC
Wait for SEC seconds before sending message (useful for one-shot
PUB sockets)
--data,-D DATA
Send DATA to the socket and quit for PUB, PUSH, PAIR, BUS socket.
Use DATA to reply for REP or RESPONDENT socket. Send DATA as
request for REQ or SURVEYOR socket.
--file,-F PATH
Same as --data but get data from file PATH
EXAMPLES
The ping-pong with nn_req/nn_rep sockets (must be run simultaneously):
nanocat--rep --bind tcp://127.0.0.1:1234 --data pong --format ascii
nanocat--req --connect tcp://127.0.0.1:1234 --data ping --format ascii
Or in shorter to write form:
nn_rep -L1234 -Dpong -A
nn_req -l1234 -Dping -A
Do periodic requests once a second:
nn_req -l1234 -Dping -A -i 1
The rep socket that never reply (no -D option), may be used to check if
resending the requests is actually work:
nanocat--rep --connect ipc:///var/run/app/req.socket
Send an output of the ls to whatever would connect to 127.0.0.1:1234
then exit:
ls | nanocat--push -L1234 -F-
Send heartbeats to imaginary monitoring service:
nanocat--pub --connect tpc://monitoring.example.org -D"I am alive!" --interval 10
SEE ALSOnanomsg(7)AUTHORS
Paul Colomiets <paul@colomiets.name[1]>
NOTES
1. paul@colomiets.name
mailto:paul@colomiets.name
nanomsg Unknown 12/23/2015 NANOCAT(1)
