phditto

Access a Photon workspace on a remote node

Syntax:

phditto [-b baud] [-H time1[,time2][,time3]]
        [-h height] [-i igrp] [-k]
        [-M kbytes[,Mbytes]] [-m modem] [-n path[+]]
        [-o options] [-s service]
        [-t ipaddr[:port]]
        [-U userid[:password]] [-u] [-V[V]...]
        [-w width] [-X offset] [-x offset]
        [-Y offset] [-y offset] [host]

Options:

-b baud

Specify the effective baud rate of the communication link. The default is the current baud rate of the communication link.

-H time1 [,time2] [,time3]

Mouse holdoff times (in tenths of a second):

• time1 -- normal mouse motion.
• time2 -- motion with button press.
• time3 -- motion with a drag cursor.

Default times are scaled, based on baud rate, yielding 1.2, 0.6, and 0.3 seconds at 9600 baud. The default mouse holdoff is disabled at baud rates above 115,200.

-h height

The height of the window, in pixels. The default is 480 pixels.

-i igrp

Specify phditto's input group. Default is 1.

-k

Start in kiosk (full-screen) mode. Pressing Ctrl-Alt-K anytime toggles kiosk mode.

-M kbytes [,Mbytes]

Specify RAM cache (and optionally the disk cache) limits. The default is 4096,20, which corresponds to a 4M cache and a 20M disk cache.

-m modem

Specify the name of the QNX serial device to use for remote connect.

-n path[+]

View and interact with Photon in the specified path, e.g. -n /dev/photon. To create a new private Photon session, end path with +, e.g. -n /dev/ph+ (/dev/ph is the default path).

-o options

Options:

• 0 -- no compression.
• 1 -- BPE (Byte-Pair Encoding) compression.
• 2 -- RLL (Run Length Limited) compression.
• 8 -- Use CRC (Cyclic Redundancy Check) error checking.

Combine options by addition, e.g. to specify BPE and CRC, select 9. If the selected baud rate requires it, compression will be automatically selected unless you specify 0.

-s service

Request a specific phrelay service. For more information, see "Using predefined Photon services" in the documentation for phrelay.

-t ipaddr[:port]

Connect via TCP/IP to this IP address (with optional port). (Specifying host does the same thing.)

-U userid[:password]

Login as this user (with optional password) when using services. The default is $LOGNAME.

-u

Unlocked mode. Allow user to navigate independently at the remote Photon space.

-V[V...]

Be verbose; more V characters cause more verbosity. Output is sent to standard output.

-w width

The width of the window, in pixels. The default is 640 pixels.

-X offset

Specify the initial x offset in the local Photon event space.

-x offset

Specify the x offset of the remote phditto window.

-Y offset

Specify the initial y offset in the local Photon event space.

-y offset

Specify the y offset of the remote phditto window.

host

Connect to this TCP/IP host or IP address.

Description:

The phditto utility lets you view and interact with another Photon workspace in a network. When you "ditto" the remote node, both you and the remote user can share the same workspace.

You can end the phditto session by selecting Close from phditto's window menu (click the right mouse button on the phditto label in the Taskbar).

Remote connectivity via modem

When you specify a modem (using -m), phditto first acts as a simple text terminal emulator so you can interact with the modem, dial up a remote QNX machine, and log in. Once you're logged in, you can then start up a Photon session by entering the following command:

exec  /usr/bin/phrelay

The phditto program will then synchronize with the remote phrelay program and start to function as a Photon graphics terminal.

Remote connectivity via TCP/IP

When you specify a TCP/IP connection (using -t), the inetd program running on the remote QNX host will automatically launch phrelay for you, provided phrelay and inetd have been configured properly.

Examples:

Run an encapsulated Photon session (Photon within Photon) on the local machine:

phditto localhost

Start a private pfm service on host:

phditto -Spfm -t host

Connect through the modem on /dev/ser2 to a remote QNX box. Once logged into QNX, type exec /usr/bin/phrelay:

phditto -m/dev/ser2

Connect via the Internet to an IP port on a remote QNX machine where a remote Photon session will be automatically started:

phditto -t198.53.31.1:4869

Connect to a remote QNX machine and run an encapsulated PhAB session as user joe:

phditto -t198.53.31.1 -sphab -Ujoe:password

Caveats:

To access a remote node, you must specify one of -m, -t, or host because native QNX messaging is not currently implemented as a transport mechanism.

See also:

phrelay

Using the Photon microGUI in the Neutrino User's Guide