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.

In Texis version 8 and later under Linux, a systemd service (texis-vhttpd) may be installed to control vhttpd. In this environment, stopping vhttpd with vhttpd -k may cause systemd to simply restart it immediately. The proper way to control a version 8 vhttpd when this service is installed is thus via the systemctl command, e.g. (as root): systemctl stop texis-vhttpd. A similar service may exist for Texis Monitor.

--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.

-D Set debug level. May be given multiple times; number of times indicates level:

• 0 Normal operation, the default.

• 1 Do not daemonize on startup (stay in foreground).

• 2 Also: no watchdog, do not fork: service one request and exit.

• 3 Also: print some config paths at startup. Added in version 7.07.1617919359 20210408.

The -w (watchdog) option was removed in version 8.01.1654793000 20220609.