NAME

  qdb-send - send a new event to the qdb-daemon ; talk with the qdb daemon


SYNOPSIS

  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]


DESCRIPTION

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.


OPTIONS

-q

be quiet ; only errors

-v

be verbose ; show all actions

-d

show debug info ; internals

-h

show help ; exit

-t $t

timeout after $t seconds ; default 1

-i

interactive ; talk to the daemon ; type '?' to get help. For more details see below.

-c

use config file ; default : qdb.conf, /etc/qdb/conf


CONFIG FILE

The default locations of the config file is /etc/qdb/conf.

For syntax see the qdb manual page.

config entries

port port

Specify a number ; the default is :

  port 22722
secret $secret

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.

server $server

New events are sent to a qdb-server. The default is

  server localhost
db_init $bool

Config options other then those listed above are silently ignored.


INTERACTIVE MODE

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-commands

Meta-command may be abbreviated to a unique prefix like .h etc.

The meta-commands are :

.auth

authorise yourself, using the configured $secret

.help

print a help message ; same as '?'

.pretty

toggle pretty-mode ; you can't use qdb's PRETTY commands.

.quit

quit


FILES

  /etc/qdb/conf : qdb-configuration


SEE ALSO

qdb, qdb-fsck


LICENSE

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.


AUTHOR

qdb-send © 2015-2017 Henk P. Penning - All rights reserved ; qdb-0.04-p12 - Thu Jan 5 12:58:15 2017