NAME

dta-cab-xmlrpc-server.perl - XML-RPC server for DTA::CAB queries

SYNOPSIS

dta-cab-xmlrpc-server.perl [OPTIONS...]

General Options:
 -help                           ##-- show short usage summary
 -man                            ##-- show longer help message
 -version                        ##-- show version & exit
 -verbose LEVEL                  ##-- really just an alias for -log-level=LEVEL

Server Configuration Options:
 -config PLFILE                  ##-- load server config from PLFILE
 -bind   HOST                    ##-- override host to bind (default=all)
 -port   PORT                    ##-- override port to bind (default=8088)
 -encoding ENCODING              ##-- override server encoding (default=UTF-8)

Daemon Mode Options:
 -daemon , -nodaemon             ##-- do/don't fork() a server subprocess
 -pidfile FILE                   ##-- save server PID to FILE

Logging Options:                 ##-- see Log::Log4perl(3pm)
 -log-level LEVEL                ##-- set minimum log level (internal config only)
 -log-file LOGFILE               ##-- log to file LOGFILE (default: none)
 -log-stserr , -nolog-stderr     ##-- do/don't log to stderr (default: do)
 -log-rotate , -no-rotate        ##-- do/don't auto-rotate logs (default: if available)
 -log-syslog , -no-syslog        ##-- do/don't log to syslog (default: don't)
 -log-config L4PFILE             ##-- override log4perl config file
 -log-watch SECONDS_OR_SIGNAL    ##-- watch log4perl config file (delay SECONDS or on SIGNAL)
 -nolog-nowatch                  ##-- override: don't watch L4PFILE

DESCRIPTION

dta-cab-xmlrpc-server.perl is a command-line utility for starting an XML-RPC server to perform DTA::CAB token-, sentence-, and/or document-analysis using the DTA::CAB::Server::XmlRpc module.

See dta-cab-xmlrpc-client.perl(1) for a command-line client using the DTA::CAB::Client::XmlRpc module.

OPTIONS AND ARGUMENTS

General Options

-help

Display a short help message and exit.

-man

Display a longer help message and exit.

-version

Display program and module version information and exit.

-verbose LEVEL

Alias for "-log-level LEVEL".

Server Configuration Options

-config PLFILE

Load server configuration from PLFILE, which should be a perl source file parseable by DTA::CAB::Persistent::loadFile() as a DTA::CAB::Server::XmlRpc object.

-bind HOST

Override host on which to bind server socket. Default is to bind on all interfaces of the current host.

-port PORT

Override port number to which to bind the server socket. Default is whatever DTA::CAB::Server::XmlRpc defaults to (usually 8088).

-encoding ENCODING

Override server encoding. Default=UTF-8.

Daemon Mode Options

-daemon , -nodaemon

Do/don't fork() a server subprocess (default: don't). If running in daemon mode, the program should simply spawn a single server subprocess and exit, reporting the PID of the child process.

Useful for starting persistent servers from system-wide init scripts. See also "-pidfile FILE".

-pidfile FILE

Writes PID of the server process to FILE before running the server. Useful for system init scripts.

Logging Options

The DTA::CAB family of modules uses the Log::Log4perl logging mechanism. See Log::Log4perl(3pm) for details on the general logging mechanism.

-log-level LEVEL

Set minimum log level. Has no effect if you also specify "-log-config". Known levels: (trace|debug|info|warn|error|fatal).

-log-config L4PFILE

User log4perl config file L4PFILE. Default behavior uses the log configuration string returned by DTA::CAB::Logger->defaultLogConf().

-log-watch SECONDS

-log-watch SIGNAL

-nolog-watch

Do/don't watch log4perl config file (default=don't). Only sensible if you also specify "-log-config".

ACKNOWLEDGEMENTS

Perl by Larry Wall.

RPC::XML by Randy J. Ray.

AUTHOR

Bryan Jurish <moocow@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2009-2019 by Bryan Jurish. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.24.1 or, at your option, any later version of Perl 5 you may have available.

SEE ALSO

dta-cab-analyze.perl(1), dta-cab-convert.perl(1), dta-cab-cachegen.perl(1), dta-cab-xmlrpc-server.perl(1), dta-cab-xmlrpc-client.perl(1), DTA::CAB(3pm), RPC::XML(3pm), perl(1), ...