GRSUNPROG(1)

NAME
grSunProg - internal process for Magic's Sun 120 display driver

SYNOPSIS
grSunProg colorWindowName textWindowName notifyPID requestFD pointFD buttonFD

DESCRIPTION

GrSunProg is an internal program used by Magic when using the Sun 120 workstation's display. This manual page is intended only for Magic maintainers.

GrSunProg collects button pushes from the color window and sends them over a pipe to Magic. The program also responds to requests from Magic for the mouse position. In addition, this program tells Suntools to forward characters typed in the color window directly to Magic's text window.

ARGUMENTS

All six arguments are required:

    colorWindowName
        This is the name of the color window that magic is running under (such as /dev/win3). Magic normally opens up the color monitor with a single, large, window on it.

    textWindowName
        This is the name of the text window that contains Magic's command log. Keyboard events are forwarded to this window.

    notifyPID
        If this processID is not 0, then SIGIO signals are sent to this process when there is data for it.

    requestFD pointFD buttonFD
        These are the file descriptors that grSunProg should use in its interface (see below). They are small integers printed as strings.

INTERFACE

Button pushes are sent out over file descriptor buttonFD. A button push is encoded as two characters followed by two integers giving the location of the button push. The first character is either 'L', 'M', or 'R' depending on the button pushed: Left, Middle, or Right. The next character is either 'D' or 'U' depending on the action: Up or Down. The two numbers are the X and Y coordinates of the button push. This string is followed by a newline. Example: LD 123 342 means that the left button was pushed down at location (123, 342).

GrSunProg sometimes receives a character from Magic over file descriptor requestFD. If this character is an EOF, then the program terminates. If this character is an 'A', then grSunProg responds with a 'P' and the current mouse coordinates over file descriptor pointFD. This string is followed by a newline. Example: P 101 23 means that the mouse is currently at location (101, 23).

SEE ALSO
magic(1) grsunprog2(1)

AUTHOR
Robert N. Mayo