Server

The script startXvxPose

verifies the command line arguments,

translates the arguments in corresponding configurations for the virtual X Window server xvx and the XposeXrecord proxy xmetax,

and starts the XposeXrecord proxy,

which in turn starts the virtual X Window server.

Configuration startXvxPose

The command

/opt/XSOXposeXrecord/bin/startXvxPose \
[-help] \
[-info] \
[-dryRun] \
[-auth file_name] \
[:display_number_of_the_proxy [:display_number_of the_server]] \
[screen_spezification...] \
[configuration_statement...] \
[-auth file_name]

starts the XposeXrecord proxy and the virtual X Window server with matching configurations or prints helpful informations. All arguments are optional — order is significant, though —, so that the command

/opt/XSOXposeXrecord/bin/startXvxPose

equals the following command, which shows all default values:

/opt/XSOXposeXrecord/bin/startXvxPose \
-auth none \
:10 :990 \
1280x1024x8

In this case the startXvxPose script generates the following configuration for the XposeXrecord proxy (Configuration of the XposeXrecord proxy) and — indirectly by the serverCommand statement (X Window server) — for the virtual X Window server:

/opt/XSOXposeXrecord/bin/xposexrecord
connection :10
xdmcpMode query xdmcpHost localhost
bell off
extensions
"X-SOFTWARE POSE" MIT-SHM SHAPE
XInputExtension XTEST
serverAuthorization own accessControl on
pixmapFormats +1 +8
metascreen metaScreen0
screen screen0
display :990.0
visuals PseudoColor:8:8
serverCommand /opt/XSOXposeXrecord/bin/xvx :990 -screen 0 1280x1024x8

The X Window client connection (X Window client connection) as well as the X Window server connection (Screen) may be changed by additional arguments.

By default, the XposeXrecord proxy uses XDMCP to contact a local display manager (X Display Manager Control Protocol). Therefore, the login prompt gets displayed on the virtual X11 session usually.

The XposeXrecord proxy is authorized by the virtual X Window server using an automatically generated key (Authorization of the XposeXrecord proxy by the X Window server).

Furthermore, a screen with the dimensions 1280×1024 and a color depth of 8 bits is defined by default.

The configuration may be arbitrarily modified or enhanced by adding configuration statements at the end of the command line (Additional configuration of the XmetaX proxy). For instance, the following command disables XDMCP:

/opt/XSOXposeXrecord/bin/startXvxPose xdmcpMode off

The configuration options are described in the following sections.

Printing informations

The argument

-help

lets the startXvxPose script print a short explanation of the command line arguments as well as the default configuration of the XposeXrecord proxy. Neither the Proxy nor the virtual X Window server are started.

The argument

-dryRun

avoids execution, too: although the command line arguments are translated to configurations, only these configurations are printed.

Authorization

The arguments

-auth file_name|none

specify an authorization file, which is used by the XposeXrecord proxy for authorization of the X Window clients.

The default value none disables the authorization by keys. Though, the usual authorization by host access control remains active. Therefore, for a remote connection the corresponding hostname has to be written into the access file, usually /etc/Xdisplay_number_of_the_proxy.hosts.

For the case that the startXvxPose script is called by a display manager (Display Manager) which automagically appends the authorization arguments to the command line, these arguments are correctly interpreted at the end of the command, too. The last -auth argument overrides all previous arguments.

X Window client connection

The communication between the XposeXrecord proxy and the X Window clients uses TCP/IP, UNIX domain sockets or other local transport mechanisms. Clients connect to a certain communication port of the machine which executes the xposexrecord program. The port number is specified indirectly through the display number with the argument

:display_number_of_the_proxy

The default value :10 corresponds to the port number 6010.

Since two servers cannot share a common communication port, each virtual session needs its own display number.

X Window server connection

The second argument

:display_number_of_the_server

indirectly specifies the port number for the communication between the XposeXrecord proxy and the virtual X Window server xvx. The default value is the result of the expression (1000 - display_number_of_the_proxy), hence 990, corresponding to the port number 6990, unless the display number of the proxy is specified.

Since two servers cannot share a common communication port, each virtual session needs its own display number, either specified explicitly or determined by the default subtraction expression.

Screens

The arguments

screen_specification...

specify dimensions and color depth of one or more virtual screens following the syntax

width_in_pixelsxheight_in_pixelsxcolor_depth_in_bits

The color depth 8 is supported by a PseudoColor visual, the color depths 16 and 24 are supported by a TrueColor visual. One screen, 1280x1024x8, is defined by default.

Additional configuration of the XmetaX proxy

The arguments

configuration_statement...

are appended to the XposeXrecord proxy configuration initially composed by the startXvxPose script (Configuration of the XposeXrecord proxy). This allows to modify the general proxy configuration as well as the configuration of individual meta screens or screens.

Integration

inittab

One or more virtual X11 sessions may be automatically started when the computer boots, for instance by the init process. Therefore for each session add to the configuration file /etc/inittab a line of the form

token:levels:respawn:/opt/XSOXposeXrecord/bin/startXvxPose >> /tmp/token.log 2>&1

Each line is identified by the field token, a word with usually only four characters at most (under some operating systems only two characters are significant). The field levels denotes the system runlevel(s) you want to execute the virtual X11 session.

The command

init q

lets the init process re-read its configuration file and start the virtual X11 sessions.

Display Manager

If you would like to integrate the virtual X11 session in an X Window environment like CDE, KDE, or Gnome, please contact <support@x-software.com> for individual instructions.

Copyright © 2018 X-Software GmbH
info@x-software.com
2009-12-10 19:06:44 +0100