How to run the Server

Up: Documentation content
Next: Using the Clients

Running the Server

Usually you won't call VTQLserver directly, but use the SYSV script VTQLserv_start. This uses a nice configuration file, quite simular to the one of xawtv. Anyway, we do first things first:

Command line options to VTQLserver

VTQLserver [options] socket_name

Examples

Options

-h,--helpshow help text and exit
-v,--versionshow some version info and exit
-u,--user namerun as user name
-g,--group namerun as group name
--force the next option to be interpreted as socket_name
socket_nameThe filename of the socket, that will be opened by the server on start.

You should not run the server as root, since this there may be exploits to VTQLserver. So if you start VTQLserver as root, you have to specify a user name or user ID for the server's process (the name may also be "root", by the way).

The socket will be in configruation mode and any fruther configuration of the server is done via this socket. The server will fork itself into background after the socket was sucessfully opend.

VTQLserv_start

You may either use this script as startup script or you may use it as SYSV startup script (i.e. let VTQLserver run as deamon in specific runlevels): Put it into "/etc/rc.d/init.d" and link it properly into the "/etc/rc.d/rc?.d" directories (read "man 8 init " if you do not know about the SYSV startup process).

You may have to edit the "--config--" section of the script to get it running.

Command line options to VTQLserv_start

VTQLserv_start option

Options

startTry to start a server
stopTry to kill the server

The script looks for a configuration file first at $HOME/.VTQL, second at /etc/VTQLrc and starts and configures the server. Any socket configured in query or event mode is made accessable for any user.

The configuration file VTQLrc

The configuration file is quite simular to the one of xawtv, in special, the station settings are almost the same, so it should not be too hard to write the configuration file. A full documentation is provided at the example file "scripts/VTQLrc" in your source directory. If you try to do advanced things in that configuration file or even stuff, that is beyond that configuration file, you may have to understand a bit of VTQL.