B.7. X Protocol Engine Tab

Use attributes on the X Protocol Engine tab to tune graphical emulator processes.

From the command line, use the Section D.16, “tarantella config list” command to list these settings, and the Section D.15, “tarantella config edit” command to edit these settings.

Changes to these attributes take effect for new Protocol Engines only. Existing Protocol Engines are not affected.

B.7.1. Monitor Resolution

Usage: Type a number in the field.

Description

The default monitor resolution, in dots per inch, to assume.

You can override this value using an application's Section C.2.82, “Monitor Resolution” attribute.

Command Line

Command option: --xpe-monitorresolution dpi

Usage: Replace dpi with the monitor resolution, in dots per inch.

The following example specifies a monitor resolution of 96 dots per inch.

--xpe-monitorresolution 96

B.7.2. Font Path

Usage: Type path names for the fonts directories in the field.

Description

Directories on the SGD host containing the fonts used by the X Protocol Engine.

Font paths are listed in search order.

Use %%INSTALLDIR%% to represent the SGD installation directory.

You can include font servers, for example, tcp/boston:7000.

Command Line

Command option: --xpe-fontpath fontpath

Usage: Replace fontpath with a list of font directories. Separate each directory in the font path with a comma (,).

The following example specifies a list of font directories used by the X Protocol Engine.

--xpe-fontpath %%INSTALLDIR%%/etc/fonts/misc,\ 
%%INSTALLDIR%%/etc/fonts/TTF,%%INSTALLDIR%%/etc/fonts/Type1

B.7.3. Client Window Size

Usage: Type numbers for horizontal and vertical display sizes, in pixels, in the fields.

Description

The maximum expected horizontal and vertical display resolution for client devices connecting to this server.

You use these attributes to configure the maximum display size for the following:

To avoid clipping problems, set these attributes to the highest display resolution that you expect to support.

Command Line

Command option: --xpe-cwm-maxwidth pixels

Command option: --xpe-cwm-maxheight pixels

Usage: Replace pixels with a value for maximum display width or maximum display height.

The following example specifies a maximum display size of 1280 x 960 pixels.

--xpe-cwm-maxwidth 1280
--xpe-cwm-maxheight 960

B.7.4. Session Start Timeout

Usage: Type a number in the field.

Description

How long the X Protocol Engine waits for X applications to connect, in seconds.

Command Line

Command option: --xpe-sessionstarttimeout seconds

Usage: Replace seconds with a timeout value, in seconds.

The following example specifies a timeout value of 60 seconds when starting an X session.

--xpe-sessionstarttimeout 60

B.7.5. Maximum Sessions

Usage: Type a number in the field.

Description

The maximum number of application sessions each X Protocol Engine handles.

More X Protocol Engines are started to meet demand.

Command Line

Command option: --xpe-maxsessions num

Usage: Replace num with the maximum number of application sessions.

The following example specifies a maximum sessions setting of 20 for each X Protocol Engine.

--xpe-maxsessions 20

B.7.6. Exit Timeout

Usage: Type a number in the field.

Description

The length of time, in seconds, an X Protocol Engine process continues to run without any active connections.

Command Line

Command option: --xpe-exitafter secs

Usage: Replace num with the time period, measured in seconds.

In the following example, the Protocol Engine exits after 60 seconds if there are no active connections.

--xpe-exitafter 60

B.7.7. Command-Line Arguments

Usage: Type command-line arguments in the field.

Description

Any arguments to the Protocol Engine. For example, the name of a log file.

Only change this setting if Technical Support ask you to.

Command Line

Command option: --xpe-args args

Usage: Replace args with the arguments to pass to the Protocol Engine.

The following example specifies an error log file for the Protocol Engine.

--xpe-args xpeerror.log