NAME

dbiproxy - A proxy server for the DBD::Proxy driver

SYNOPSIS

    dbiproxy <options> --port <port>

DESCRIPTION

This tool is just a front end for the DBI::ProxyServer package. All it does is picking options from the command line and calling DBI::ProxyServer::main(). See DBI::ProxyServer(3) for details.

Available options include:

--configfile filename

The DBI::ProxyServer can use a configuration file for authorizing clients. The file is almost identical to that of RPC::pServer, with the exception of some additional attributes. See "CONFIGURATION FILE" in DBI::ProxyServer(3).

If you don't use a config file, then access control is completely disabled. Only use this for debugging purposes or something similar!

--debug

Turns on debugging mode. Debugging messages will usually be logged to syslog with facility daemon unless you use the options --facility or --stderr, see below.

--facility

Sets the syslog facility, by default daemon.

--help

Tells the proxy server to print a help message and exit immediately.

--ip ip-number

Tells the DBI::ProxyServer, on which ip number he should bind. The default is, to bind to INADDR_ANY or any ip number of the local host. You might use this option, for example, on a firewall with two network interfaces. If your LAN has non public IP numbers and you bind the proxy server to the inner network interface, then you will easily disable the access from the outer network or the Internet.

--port port

This option tells the DBI::ProxyServer, on which port number he should bind. Unlike other applications, DBI::ProxyServer has no builtin default, so using this option is required.

--pidfile filename

Tells the daemon, where to store its PID file. The default is /tmp/dbiproxy.pid. The PID file looks like this:

    567
    IP number 127.0.0.1, port 3334
    dbiproxy -ip 127.0.0.1 -p 3334

The first line is the process number. The second line are IP number and port number, so that they can be used by local clients and the third line is the command line. These can be used in administrative scripts, for example to first kill the DBI::ProxyServer and then restart it with the same options you do a

    kill `head -1 /tmp/dbiproxy.pid`
    `tail -1 /tmp/dbiproxy.pid`

--stderr

Forces printing of messages to stderr. The default is using the syslog.

--version

Forces the DBI::ProxyServer to print its version number and copyright message and exit immediately.

AUTHOR

    Copyright (c) 1997    Jochen Wiedmann
                          Am Eisteich 9
                          72555 Metzingen
                          Germany

                          Email: joe@ispsoft.de
                          Phone: +49 7123 14881

The DBI::ProxyServer module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. In particular permission is granted to Tim Bunce for distributing this as a part of the DBI.

SEE ALSO

DBI::ProxyServer(3), DBD::Proxy(3), DBI(3)