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
.-b address
Set BindAddress
, the local address to bind to.-p port
Set the TCP Port
to listen for HTTP requests.-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.