Commands Reference, Volume 6

xrx Command

Purpose

RX helper program.

Syntax

xrx [ -ToolKitOption ...] filename

Description

The helper program may be used with any Web browser to interpret documents in the RX MIME type format and start remote applications.

xrx reads in the RX document specified by its filename, from which it gets the list of services the application wants to use. Based on this information, xrx sets the various requested services, including creating authorization keys if your X server supports the SECURITY extension. It then passes the relevant data, such as the X display name, to the application through an HTTP GET request of the associated CGI script. The Web server then executes the CGI script to start the application. The client runs on the web server host connected to your X server.

Installation

You need to configure your web browser to use xrx for RX documents. Generally the following line in your $HOME/.mailcap is enough:

application/x-rx; xrx %s

However, you may need to refer to your web browser's documentation for exact instructions on configuring helper applications.

Once correctly configured, your browser will activate the helper program whenever you retrieve any document of the MIME type application/x-rx.

Flags

Resources

The application class name of the xrx program is Xrx and it understands the following application resource names and classes:

xrxHasFirewallProxy (class XrxHasFirewallProxy)

Specifies whether an X server firewall proxy is running and should be used. Default is "False."

xrxInternalWebServers (class XrxInternalWebServers)

The web servers for which the X server firewall proxy should not be used (only relevant when xrxHasFirewallProxy is "True"). Its value is a comma separated list of mask/value pairs to be used to filter internal web servers, based on their address. The mask part specifies which segments of the address are to be considered and the value part specifies what the result should match. For instance the following list:

255.255.255.0/198.112.45.0,

255.255.255.0/198.112.46.0

matches the address sets: 198.112.45.* and 198.112.46.*. More precisely, the test is (address & mask) == value.

xrxFastWebServers (class XrxFastWebServers)

The web servers for which LBX should not be used. The resource value is a list of address mask/value pairs, as previously described.

xrxTrustedWebServers (class XrxTrustedWebServers)

The web servers from which remote applications should be run as trusted clients. The default is to run remote applications as untrusted clients. The resource value is a list of address mask/value pairs, as previously described.

Environment

The xrx helper program uses the standard X environment variables such as DISPLAY to get the default X server host and display number. If the RX document requests X-UI-LBX service and the default X server does not advertise the LBX extension, xrx will look for the environment variable XREALDISPLAY to get a second address for your X server and look for the LBX extension there. When running your browser through lbxproxy you will need to set XREALDISPLAY to the actual address of your server if you wish remote applications to be able to use LBX across the Internet.

If the RX document requests XPRINT service, xrx will look for the variables XPRINTER, PDPRINTER, LPDEST, PRINTER, and XPSERVERLIST to get the printer name and X Print server address to use. Note that although this set of variables allows to specify more than one server and printer, only the first pair will be used. Finally, if you are using a firewall proxy, xrx will look for PROXY_MANAGER to get the address of your proxy manager (see proxymngr). When not specified it will use :6500 as the default.

Related Information

The libxrx command, lbxproxy command, and the proxymngr command.