vhttpd Command Line Options

The following command line options may be given to the vhttpd server. Where applicable, these options override the corresponding settings given in the config file. For example, an identical server can be set up on port 1234 with a log directory of /tmp/logs without changing the config file, with the command line vhttpd -p 1234 -logdir /tmp/logs.

-d dir Set ServerRoot to directory dir.

-f file Use the given server config file.

-k Just kill (stop) the running vhttpd and exit.

--reinit Just reinitialize the running vhttpd and exit. Currently the only reinitialization that occurs is that the TransferLog, ErrorLog and VortexLog configured at startup (or via <vxcp>) are re-opened; this releases the disk space of the original files if they were deleted for log rotation. If a log file cannot be re-opened (e.g. permissions), the previous file handle remains open. For log rotation, re-initializing the server via --reinit instead of killing and re-starting it avoids a potential few seconds of down time (i.e. connection-refused errors in browsers). Added in version 5.01.1170023637 20070128.

-version Just print version information and exit.

-h Print brief help message and exit.

-H Print verbose help message and exit.

-doc dir Set DocumentRoot to directory dir.

--listen [address:]port Set a Listen address/port. May be given multiple times. Added in version 8.

-b address Set BindAddress, the local address to bind to.

Note: this option is deprecated and will become unsupported in a future release. Use --listen instead, which overrides -b and -p.

-p port Set the TCP Port to listen for HTTP requests.

Note: this option is deprecated and will become unsupported in a future release. Use --listen instead, which overrides -b and -p.

-V path Add path as a VortexPath URL. May be used multiple times.

-s Set Texis single-user mode. Use with caution; see the caveats on singleuser with the <sqlcp> function, here.

-logdir dir Set the LogDir to dir. (See LogDir above.)

-l file Set the TransferLog to file. Can be overridden per-transaction with <vxcp> in Vortex scripts; see here.

-ref Log the HTTP Referer field in the transfer log. The LogFormat setting overrides this.

-ua Log the HTTP User-Agent field in the transfer log. The LogFormat setting overrides this.

-e file Set the server ErrorLog to file. Can be overridden per-transaction with <vxcp> in Vortex scripts; see here.

-v file Set the VortexLog to file. Can be overridden per-transaction with <vxcp> in Vortex scripts; see here.

-P file Set the PidFile to write the server process id to on startup.

-scriptroot dir Sets the Vortex ScriptRoot dir.

-n num Set TxPreOpenNum, the number of pre-opened Texis handles.

-db path Set TxPreOpenDb, the database for pre-opened Texis handles.

-per num Set TxPreOpenGive, the number of pre-opened handles to give each process.

-i num Set TxPreOpenLife, the number of times to use a pre-opened handle.

-u user Set the User to run web transactions as.

-g group Set the Group to run web transactions as.

-objext .ext Debugging option. Set VortexObjExt, the filename extension for compiled Vortex object files.

-w Debugging option. Use watchdog process.

-D Set debug level. May be given multiple times.