blob: c194e76cc57c93305e0167998335feb380d7e2a9 [file] [log] [blame]
nanocat(1)
==========
NAME
----
nanocat - a command-line interface to nanomsg
SYNOPSIS
--------
nanocat --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 ALSO
--------
linknanomsg:nanomsg[7]
AUTHORS
-------
Paul Colomiets <paul@colomiets.name>