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::Proxy-
    Server::main(). See DBI::ProxyServer(3) for details.

    Available options include:

    --chroot=dir
   (UNIX only) After doing a bind(), change root directory to the
   given directory by doing a chroot(). This is usefull for security,
   but it restricts the environment a lot. For example, you need to
   load DBI drivers in the config file or you have to create hard
   links to Unix sockets, if your drivers are using them. For example,
   with MySQL, a config file might contain the following lines:

     my $rootdir = '/var/dbiproxy';
     my $unixsockdir = '/tmp';
     my $unixsockfile = 'mysql.sock';
     foreach $dir ($rootdir, "$rootdir$unixsockdir") {
    mkdir 0755, $dir;
     }
     link("$unixsockdir/$unixsockfile",
    "$rootdir$unixsockdir/$unixsockfile");
     require DBD::mysql;

     {
    'chroot' => $rootdir,
    ...
     }

   If you don't know chroot(), think of an FTP server where you can
   see a certain directory tree only after logging in. See also the
   --group and --user options.

    --configfile=file
   Config files are assumed to return a single hash ref that overrides
   the arguments of the new method. However, command line arguments in
   turn take precedence over the config file. See the "CONFIGURATION
   FILE" section below for details on the config file.

    --debug
   Turn debugging mode on. Mainly this asserts that logging messages
   of level "debug" are created.

    --facility=mode
   (UNIX only) Facility to use for "Sys::Syslog (3)". The default is
   daemon.

    --group=gid
   After doing a bind(), change the real and effective GID to the
   given. This is usefull, if you want your server to bind to a priv-
   ileged port (<1024), but don't want the server to execute as root.
   See also the --user option.

   GID's can be passed as group names or numeric values.

    --localaddr=ip
   By default a daemon is listening to any IP number that a machine
   has. This attribute allows to restrict the server to the given IP
   number.

    --localport=port
   This attribute sets the port on which the daemon is listening. It
   must be given somehow, as there's no default.

    --logfile=file
   Be default logging messages will be written to the syslog (Unix) or
   to the event log (Windows NT). On other operating systems you need
   to specify a log file. The special value "STDERR" forces logging to
   stderr. See Net::Daemon::Log(3) for details.

    --mode=modename
   The server can run in three different modes, depending on the envi-
   ronment.

   If you are running Perl 5.005 and did compile it for threads, then
   the server will create a new thread for each connection. The thread
   will execute the server's Run() method and then terminate. This
   mode is the default, you can force it with "--mode=threads".

   If threads are not available, but you have a working fork(), then
   the server will behave similar by creating a new process for each
   connection. This mode will be used automatically in the absence of
   threads or if you use the "--mode=fork" option.

   Finally there's a single-connection mode: If the server has
   accepted a connection, he will enter the Run() method. No other
   connections are accepted until the Run() method returns (if the
   client disconnects).  This operation mode is usefull if you have
   neither threads nor fork(), for example on the Macintosh. For
   debugging purposes you can force this mode with "--mode=single".

    --pidfile=file
   (UNIX only) If this option is present, a PID file will be created
   at the given location.

    --user=uid
   After doing a bind(), change the real and effective UID to the
   given. This is usefull, if you want your server to bind to a priv-
   ileged port (<1024), but don't want the server to execute as root.
   See also the --group and the --chroot options.

   UID's can be passed as group names or numeric values.

    --version
   Supresses startup of the server; instead the version string will be
   printed and the program exits 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)