NAME

ddc-query.perl - distributed DDC query tool in perl

SYNOPSIS

ddc-query.perl [OPTIONS] [QUERY...]

General Options:
 -help
 -version

Connection Options:
 -server  SERVER                   ##-- default=localhost
 -port    PORT                     ##-- default=50011
 -timeout DDC_TIMEOUT              ##-- default=60
 -mode    QMODE                    ##-- query mode: 'json', 'table', 'text', 'request' (default='json')
 -qenc    QENCODING                ##-- query encoding (default=raw bytes)
 -file			            ##-- arguments are query-list filenames, not queries
 -request			    ##-- alias for -mode=request -raw (for protocol debugging)
 -multi                            ##-- send multiple requests on same connection (default=no)

Benchmarking and Batch Options:
 -bench-iters ITERS                ##-- benchmark: time ITERS query iterations
 -bench-seconds SECONDS            ##-- benchmark: abort after SECONDS query-processing time (default=inf)
 -[no]bench-clear		    ##-- do/don't clear server cache between benchmark iterations (default=do)
 -query-file                       ##-- batch-execute queries from command-line argument file(s)
 -query-sleep SECONDS              ##-- sleep for SECONDS between multiple queries (default=0)
 -query-verbose                    ##-- trace query execution to stderr

Hit Selection Options:
 -corpora DDC_CORPORA              ##-- comma-separated list; default=none
 -opt-file OPTFILE                 ##-- load DDC .opt file
 -start FIRST_HIT                  ##-- default=0
 -limit MAX_HITS                   ##-- default=10
 -expand-chain PIPELINE            ##-- perform term expansion via PIPELINE rather than a retrieval query

Hit Parsing Options
 -parse-meta   , -no-meta          ##-- do/don't parse hit metadata (default=do)
 -parse-context, -no-context       ##-- do/don't parse hit context  (default=do)
 -keep-raw     , -nokeep-raw       ##-- do/don't keep raw hit context (default=don't)
 -field-names FIELDS               ##-- parse into named FIELDS (space-separated list; default=none)
 -word-separator REGEX             ##-- word separator regex for context parsing (default=' ')
 -field-separator REGEX            ##-- field separator regex for context parsing (default='\x{1f}' : ASCII unit separator)
 -token-separator REGEX            ##-- token separator regex for context parsing (default='\x{1e}' : ASCII record separator)
 -encoding ENCODING                ##-- server encoding (default='UTF-8')

Formatting Options:
 -columns COLS                     ##-- output columns for text formatter (default=80)
 -width   COLS                     ##-- number of context characters for KWIC formatter (default=32)
 -pretty , -ugly                   ##-- do/don't pretty-print (default=don't)
 -raw                              ##-- dump raw query response buffer
 -dumper                           ##-- use Data::Dumper formatter
 -kwic                             ##-- use KWIC formatter
 -text                             ##-- use old text formatter
 -json                             ##-- use JSON formatter
 -yaml                             ##-- use YAML formatter
 -template TTKFILE                 ##-- use Template-Toolkit formatter with TTKFILE

OPTIONS AND ARGUMENTS

not yet written

DESCRIPTION

not yet written

AUTHOR

Bryan Jurish <moocow@cpan.org>