phditto

Access 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 node] [-o options] [-P palette_file]
        [-s service] [-T [p|n|l]...] [-t ipaddr]
        [-U userid[:password]] [-u] [-V...] [-w width]
        [-X offset] [-x offset] [-Y offset] [-y offset]

Options:

-b baud

Specify the effective baud rate of the communication link. Default is the current baud rate of the communication link.

-H time1 [,time2] [,time3]

Mouse holdoff times (in 1/10 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. Default mouse holdoff is disabled at baud rates above 115,200.

-h height

Specify the height of the phditto window. Default is 480.

-i igrp

Specify phditto's input group. Default is 1.

-k

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

-M kbytes [,Mbytes]

Specify RAM cache (and optional disk cache) limits. Default is 1024,20 which corresponds to a 1M cache and a 20M disk cache.

-m modem

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

-n node

View and interact with Photon on the specified node. If node is a simple number, then //node/dev/photon is used. If node ends with +, then a private Photon session is created.

-o options

Options:

0-

no compression

1-

BPE (Byte-Pair Encoding) compression

2-

RLL (Run Length Limited) compression

-P palette_file

Restrict color choice to the RGB colors defined in this Photon palette file (default: default.pal). If a fullpath isn't specified, palette files are searched for in /usr/photon/palette.

---

The -P palette_file option applies to Photon 1.13 only.

---

-s service

Request a specific phrelay service. For more information, see "Using predefined Photon services" under phrelay.

-T [p|n|l]

Toolbar options:

p-

enables panning controls

n-

enables node identifier

l ("el")-

turns on Rx/Tx lights

-t ipaddr

Connect via TCP/IP to this IP address.

-U userid[:password]

Login as this user (with optional password) when using services.

-u

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

-V

Be verbose. Add more V's for greater verbosity. Output is sent to standard output.

-w width

Specify the width of the phditto window. Default is 640.

-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.

Description:

The phditto utility is one of the programs behind Photon's Jump Gate connectivity technology. The 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. By default, phditto displays the remote node's active console.

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/photon/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:

"Ditto" the Photon session on node 7:

phditto -n7

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

phditto

Run an encapsulated Photon session on remote node 2:

phditto -n//2/dev/ph+

Dial in to a remote QNX machine where a remote Photon session will be started:

phditto -m/dev/ser2

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

phditto -t198.53.31.1

Connect via the Internet to remote QNX node 2:

phditto -t198.53.31.1 -n2

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

phditto -t198.53.31.1 -sphab -Ujoe:password

See also:

phrelay