qdb-send - send a new event to the qdb-daemon ; talk with the qdb daemon
Usage: qdb-send [-vqdh] -i [-c config] [server [port] ]
qdb-send [-vqdh] [-t t ] [-c config] new|delete path
option v : be verbose
option q : be quiet
option d : show debug info
option h : show help message ; exit
option t : timeout after $t seconds ; default [1]
: no timer is set if $t == 0
option i : [interactive] ; talk with a qdb-server ; implies -t 0
default server : localhost
default port : 22722
option c : use config-file $config ; default [/etc/qdb/conf]
Program qdb-send is a simple, stand-alone script that
sends one specified new event to a qdb-daemon.
Alternative (with -i) it lets you talk directly to the daemon.
The main purpose of qdb-send is to provide a simple, low-impact
interface to qdb for rrr-server and rrr-clients.
Note that if qdb-send fails to deliver the new event to the server, the event is lost. To prevent this loss, qdb-send can be augmented to save undeliverd events to a file, to be retried later.
be quiet ; only errors
be verbose ; show all actions
show debug info ; internals
show help ; exit
timeout after $t seconds ; default 1
interactive ; talk to the daemon ; type '?' to get help.
For more details see below.
use config file ; default : qdb.conf, /etc/qdb/conf
The default locations of the config file is /etc/qdb/conf.
For syntax see the qdb manual page.
Specify a number ; the default is :
port 22722
Specify the server's secret. There is no default.
The secret is shared between the server and trusted clients. Program qdb-send uses $secret for authentication.
New events are sent to a qdb-server. The default is
server localhost
Config options other then those listed above are silently ignored.
In interactive mode (with -i), qdb-send connects with the
configured server. You are prompted for commands.
Remember that the server's response to a command is a json :
{ cmd ⇒ ..., err ⇒ ..., res ⇒ ... }
The interaction is in pretty or raw mode (default pretty). in pretty mode, qdb-send shows the results of commands, or error-messages if an error is returned. in raw mode, qdb-send shows the returned json.
Your commands are sent to the server, except for some meta-commands.
For the list of commands, see qdb section Server commands & results.
Meta-command may be abbreviated to a unique prefix like .h etc.
The meta-commands are :
authorise yourself, using the configured $secret
print a help message ; same as '?'
toggle pretty-mode ; you can't use qdb's PRETTY commands.
quit
/etc/qdb/conf : qdb-configuration
You may distribute under the terms of either the GNU General Public License or the Artistic License, as specified in the Perl 5.10.0 README file.