Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ suntools(1) — SunOS 2.0

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

adjacentscreens(1)

clocktool(1)

coretool(1)

dbxtool(1)

fonttool(1)

gfxtool(1)

icontool(1)

lockscreen(1)

perfmeter(1)

perfmon(1)

shelltool(1)

tektool(1)

SUNTOOLS(1)  —  USER COMMANDS

NAME

suntools − Run the SunWindows environment

SYNOPSIS

suntools [ −n | −s startup file ] [ −d display device ] [ −m mouse device ]
[ −k keyboard device ] [ −b red green blue ] [ −f red green blue ] [ −i ] [ −p ] [− [ B | F | P ] ]

GETTING STARTED

suntools starts up the SunWindows environment and awaits your directions.  You will often give directions by selecting a menu item.  If your /dev directory has not been initialized for the window environment, suntools will fail; see Initialization below for details.  If there is a file called .suntools in your home directory, suntools starts the application programs (tools) specified in that file.  You can find the format of the .suntools file described in detail under Start-up Processing below. 

The SunWindows system is ready when:

1)the screen is painted with a standard pattern (usually light gray, see OPTIONS)

2)an arrow-shaped cursor appears on the screen, tracking motions of the mouse.  An optical mouse must be on its special pad before it can be tracked.  Sometimes the cursor will not move at start-up; moving the mouse in large circles for a few seconds brings the cursor to life. 

See Multiple/Color Displays for information about running suntools on more than one display at the same time or on color displays. 

OPTIONS

−n Bypasses startup processing by ignoring the .suntools file.  See Startup Processing for more on startup processing. 

−s startup file
Read startup commands from startup file (instead of ~/.suntools).

−d display device
Use display device as the output device on which to run.  If this option is not specified, SunWindows output goes to the default frame buffer device, /dev/fb. 

−m mouse device
Use mouse device as the system pointing device (locator).  If this option is not specified, SunWindows uses the default mouse device, /dev/mouse. 

−k keyboard device
Accept keyboard input from keyboard device.  If this option is not specified, SunWindows uses the default keyboard device, /dev/kbd. 

−b red green blue
Specifies the values of the red, green and blue components of the background color.  If this option is not specified, each component of the background color is 255 (white).  See the −f option for more details. 

−f red green blue
Specifies the values of the red, green and blue components of the foreground color.  For most color screens, values must be between 0 and 255 where 0 is the absence of color and 255 is the maximum intensity of that color.  If this option is not specified, each component of the foreground color is 0 (black). 

−i Invert the background and foreground colors used on the screen.  On a monochrome monitor, this option provides a video reversed image.  On a color monitor, colors that are not used as the background and foreground are not affected. 

−p Displays the name of the window device used for the suntools window. 

−B Uses the background color for the suntools window color. 

−F Uses the foreground color for the suntools window color. 

−P Uses a stipple pattern for the suntools window color.  If no -F, -B or -P option is given, -P is assumed. 

DESCRIPTION

Windows

The SunWindows environment always has one window open which covers the whole screen; this is called the Root Window. A solid color is the only content of the Root Window; it serves as a backdrop for the SunWindows environment.  Tools that run in the environment are given their own windows which lie on top of portions of the Root Window (and possibly other tools).  A window obscures any portions of another window which lies below it.  Only the topmost window is guaranteed to be fully visible, and the Root Window color shows through only in areas which have no tool windows on them. 

Input to Windows

When you type on the keyboard, move the mouse, or press mouse buttons, be sure your mouse cursor is inside the window you want to affect. Otherwise, your input gets lost or sent to a different window. 

Your input actions are queued for each window, with mouse motions and button pushes integrated with keystrokes.  This means that you can type some characters to one window, move the mouse to another window, then type or use the mouse in the second window before the first window has processed its input.  Each tool’s input handling is described with the rest of its behavior in its section within the Commands Reference Manual. 

The Mouse

Use the mouse buttons as follows:

Left button(the select button)  Click once to select or choose objects. 

Middle button(the adjust button)  Click once to shorten or lengthen your selection. 

Right button(the menu button)  Depress and hold down to invoke menus. 

The exact interpretation of your actions depends on the type of window receiving them.  Any window type or tool that interprets mouse input differently has the differences documented in its separate section. 

Menus

You can invoke many functions in suntools by using the mouse and a pop-up menu.   When you press down on the menu button and hold it down, the menu(s) appropriate to the window appear.  Remember that the mouse cursor must be in the window, or you may get unexpected results. 

As you press the menu button, the menu appears on the screen near the current location of the mouse.  The cursor changes to a right-pointing arrow called the pointer.  The menu remains on the screen as long as you hold the menu button down.  Move the pointer with the mouse.  To invoke a menu item, point at it (it will be highlighted), then release the menu button. 

You may see more than one menu presented simultaneously; generally this occurs when several different classes of actions are possible in the current context.  The menus are presented in a stack, with the label of each menu visible, and with the current menu on top so its items are also visible.  To bring another menu to the top, thus making its items available, invoke its label as you would a menu item.  That is, position the cursor in the label of the desired menu and release the menu button.  Then push the menu button again.  The stack of menus is repainted with the selected menu on top, and menu operations may continue.  Another way to bring a rear menu forward is to press and release the select mouse button while the pointer is over the label of the desired menu, holding the menu button down the whole time.  This rearranges the menus without removing them from the screen. 

The Suntools Menu

The Root Window’s default menu (the Suntools Menu) contains four job-control functions.  To invoke it, move the pointer anywhere in the Root Window, then depress and hold down the menu button. 

The items in the Suntools Menu are:

New ShellCreates a new Shell Tool. 
A tool running a new copy of the shell appears on the screen.  The window is placed on the screen on top of everything it overlaps.  Its initial size can display 80 columns and 34 rows of characters.

New GraphicsCreates a new Graphics Tool. 
Creates a new tool window appropriate for running graphics programs. It is placed on the screen on top of everything it overlaps.

ExitExits the suntools program. 
Closes all tool windows and kills their associated processes. You return to the shell which invoked suntools. This command requires confirmation: When it prompts you, press the left mouse button to complete the Exit command; press the right button to cancel.

ReDisplay AllRedraws all the contents of the screen. 
Use this to repair damage done by processes that wrote to the screen without consulting the SunWindows system. See shelltool(1) for details on how to avoid this.

The Root Window ignores most keyboard input; if you type while the cursor is over an exposed portion of the Root Window, the keystrokes are simply discarded (without any audible or visible feedback). 

The Tool Manager

Tools interpret most of your input in their own fashion; for instance, many tools incorporate a terminal emulator running a shell.  Tools also provide you with a small set of universal functions through the Tool Manager menu. 

You can invoke the Tool Manager menu when the cursor is over a portion of the tool which does not impose some other interpretation on your input.  For any tool, the tool namestripe (black stripe holding the tool’s name), the border stripes of the window, and the whole of the tool’s icon are such areas. 

The items in this menu are:

Close (or Open)Only one of “Close” or “Open” appears in the menu, as appropriate to the current state of the window.  Close shrinks the tool to a small image on the screen.  Open reopens a closed window and places it in the spot it occupied when it was last open. 
when the window is closed, the tool’s process(es) continue to run. Closed windows are placed by default in the lower left of the screen, filling in rows to the right, and then bottom-to-top, in the order they are created.  You can move a closed window just like an open window.   If you reopen it and close it again, it returns to its last position on the screen, without affecting its size or contents.

MoveMove the tool window to another spot on the screen. 
When invoked, Move instructs you to grasp the window by depressing and holding down either the left or middle mouse buttons, or to cancel the operation by pressing the right button.  Depressing any mouse button removes these instructions from the screen.

When you depress either the left or middle button, a box called a bounding box outlines the window.  The bounding box tracks the mouse as long as you hold that button down.  When you press the button, the cursor location determines how the window is moved.  If the mouse cursor is near a corner when you press the button, that corner of the box attaches to the mouse cursor.  If it is in the middle third of a side, then the midpoint of the box’s side attaches to the mouse cursor. 

Position the bounding box where you want the window to go and release the mouse button.  If the window is on top of or underneath other windows before you move it, it will be on top of or underneath the same windows after you move it. 

StretchShrinks or stretches the size of a window on the screen. 
Stretch works almost like Move. Depress and hold down either the left or middle mouse buttons to grasp the window. Cancel the operation by pressing the right button.

When you depress either the left or middle button, a bounding box outlines the window.  The bounding box tracks the mouse as long as you hold that button down.  When you press the button, your action determines how the window is stretched.  If the mouse cursor is near a corner when you press the button, both of the sides that form that corner are adjusted; the opposite corner remains fixed.  If it is in the middle third of a side, then only that side is adjusted. 

Adjust the bounding box to the shape you want the window to take, and release the mouse button.  If the window is on top of or underneath other windows before you move it, it will be on top of or underneath the same windows after you stretch it. 

ExposeBrings the window to ‘the top of the heap’. 
The whole window becomes visible, and occludes any window it happens to overlap on the screen.  Its position on the screen does not change.

HidePuts the window on the ‘bottom of the heap’. 
The window is occluded by any window which overlaps it.  Its position on the screen does not change.

ReDisplayRedraws the contents of the window. 

QuitNotifies the tool to terminate gracefully. 
This command requires the same type of confirmation as the Exit command in the Suntools Menu.

In many multi-subwindow tools, you can adjust the boundary between two subwindows up or down without changing the overall size of the tool.  Depress the middle mouse button over the boundary.  A bounding box is drawn for the subwindow above or to the left of the selected boundary.  Now adjust the size of that subwindow, exactly as with the Stretch operation.  When the button is released, that subwindow is adjusted to the size indicated, and the remaining area of the tool is allotted to the other subwindows. 

Tool Management Accelerators

Accelerators are provided for some of the Tool Manager functions.  You can invoke these functions quickly with a simple button push in the tool window, rather than displaying a menu. 

The accelerators for the various functions are:

OpenTo open an iconic tool,  click the select mouse button when the cursor is over the icon. 

MoveTo invoke Move, depress the middle mouse button while the cursor is in the tool window’s name stripe or outer boundary.  A bounding box displays and tracks the mouse as long as you hold the middle button down.  Release the button when the box indicates the spot where you want to place the window. 

ExposeTo expose a window, click the left mouse button at an open tool window while the cursor is on the tool’s name stripe or outer boundary. 

HelpTo get help, type a question mark to a tool window.  A help message explaining the material covered here appears. 

Generic Tool Arguments

Most tools now take the following arguments in their command lines:

FLAG(LONG FLAG)ARGSNOTES
-Ww (-width)   columns
-Wh (-height)  lines
-Ws (-size)    x yx and y are in pixels
-Wp (-position) x yx and y are in pixels
-WP (-icon_position)x yx and y are in pixels
-Wl (-label)   "string"
-Wi (-iconic)  makes the tool start iconic
-Wt (-font)filename
-Wf (-foreground_color)red green blue0-255 (no color-full color)
-Wb (-background_color) red green blue0-255 (no color-full color)
-Wg (-set_default_color)(apply color to subwindows too)
-WI (-icon_image)filename(for tools with non-default icons)
-WL (-icon_label)"string"(for tools with non-default icons)
-WT (-icon_font)filename(for tools with non-default icons)
-WH(-help)print this table

Each flag option may be specified in either its short form or its long form; the two are completely synonymous. 

Terminal Emulators

Several tools provide a terminal emulator running a shell in some part of their window.   When you  type to this subwindow, the keystrokes pass through to the shell program running in it, rather than being handled by the tool.  These tools provide Tool Manager functions only when the cursor is in their name stripe or borders.   Similarly, output from the shell program displays in the subwindow. 

Whenever a tty subwindow is created, the startup file ~/.ttyswrc is parsed for tty subwindow-specific parameters.  A sample .ttyswrc file may be found at the end of this section.  The command format of this file is:

#Comment.
set variableTurn on the specified variable.
mapi key textWhen key is typed pretend text was typed.
mapo key textWhen key is typed pretend text was output.

The only currently defined "variable" is "pagemode".  "Key" is one of L1-L15, F1-F15, T1-T15, R1-R15, LEFT, or RIGHT (see note below).  "Text" may contain escapes such as \E, \n, ^X, etc.  (escape, newline, control-X, respectively).  See termcap(5) for the format of the string escapes that are recognized. Note that "mapi" and "mapo" may be replaced by another keymapping mechanism in the future.

NOTE: When using the default kernel keyboard tables, the keys L1, LEFT, RIGHT, BREAK, R8, R10, R12, and R14 cannot be mapped in this way because they send special values to the terminal emulator subwindow.  See kbd(5) for more information.

It is possible to have terminal-based programs drive the tool in which its tty subwindow resides by sending it special escape sequences.  These escape sequences may also be sent using the "mapo" function described above.  The following functions pertain to the tool in which the tty subwindow resides, not the tty subwindow itself. 

\E[1t− open
\E[2t− close (become iconic)
\E[3t− move, with interactive feedback
\E[3;TOP;LEFTt− move, to TOP LEFT (pixel coordinates)
\E[4t− stretch, with interactive feedback
\E[4;WIDTH;HTt− stretch, to WIDTH HT size (in pixels)
\E[5t− top (expose)
\E[6t− bottom (hide)
\E[7t− refresh
\E[8;ROWS;COLSt− stretch, to ROWS COLS size (in characters)
\E[11t− report if open or iconic by sending \E[1t or \E[2t
\E[13t− report position by sending \E[3;TOP;LEFTt
\E[14t− report size in pixels by sending \E[4;WIDTH;HTt
\E[18t− report size in characters by sending \E[8;ROWS;COLSt
\E[20t− report icon label by sending \E]Llabel\E\
\E[21t− report tool header by sending \E]llabel\E\
\E]l<text>\E\− set tool header to <text>
\E]I<file>\E\− set icon to the icon contained in <file>;
<file> must be in icontool output format
\E]L<label>\E\− set icon label to <label>
\E[>OPT;...h− turn OPT on (OPT = 1 => pagemode), e.g., \E[>1;3;4h
\E[>OPT;...k− report OPT; sends \E[>OPTl or \E[>OPTh for each OPT
\E[>OPT;...l− turn OPT off (OPT = 1 => pagemode), e.g., \E[>1;3;4l

As an example of using this facility, the following aliases can be put into your ~/.cshrc file:

# dynamically set the name stripe of the tool:
alias header ’echo -n "^[]l\!∗^[\"’
# dynamically set the label on the icon:
alias iheader ’echo -n "^[]L\!∗^[\"’
# dynamically set the image on the icon:
alias icon ’echo -n "^[]I\!∗^[\"’

A sample .ttyswrc file follows:

#
#     ttysubwindow startup file
#
set     pagemode
# Top:
mapo     T1     \E[5t
# Close:
mapo     T2     \E[2t
# Move:
mapo     T3     \E[3t
# Stretch:
mapo     T4     \E[4t
# Bottom:
mapo     T5     \E[6t
# Refresh:
mapo     T6     \E[7t
# Move (non-interactive) to top left:
mapo     T7     \E[3;1;1t
# Stretch in chars (non-interactive) to half high:
mapo     T8     \E[8;10;80t
# Stretch in chars (non-interactive) to normal size:
mapo     T9     \E[8;34;80t
# Commands (very left keys, not setup):
mapi     L3     jobs0
mapi     L5     mail0
mapi     L7     ls -F0
mapi     L9     more errs0
# Editing:
# Bracket word in italic escapes while in vi:
mapi     R4     i\fIEea\fPE
# Bracket word in bold escapes while in vi:
mapi     R5     i\fBEea\fPE
# Mail:
mapi     R1     dt0
mapi     R2     s +planning\ndt\n
mapi     R3     s +bugs\ndt\n.sp

Selections

Terminal subwindows support a facility called selection, which provides for limited inter-tool communication and mouse-oriented text manipulation. A selection is a span of characters which you can manipulate.   To make a selection:

•Press the select (left) mouse button while the tip of the cursor is over the desired character. Your selection becomes highlighted. This feedback helps you see what you’re doing. Any previous selections are de-selected;  the highlighting around the old selection disappears. Move the mouse with the select button down, and the selection changes.  Release the select button to complete the selection.

•Press the adjust (middle) mouse button down and move the mouse to change the span of characters that you select. Release the button.  All characters, from the one you originally selected through the one indicated when you released adjust, are selected.  The highlighting indicating the selection adjusts to reflect its new contents. 

You can also adjust your selection by multi-clicking.  For example, if you select a character and then click the left or middle mouse button over it within .5 seconds, the highlighting adjusts to select a word.  Click again within .5 seconds, and the highlighting adjusts to select a line.  Click yet again, and the highlighting now shows you selected a paragraph.  Click one more time, and the selection shrinks back to the original character you selected. 

You can only select characters which are displayed in a terminal subwindow.  You can select characters obscured by another window if they lie between the characters you chose as the endpoints to the selection. 

The highlighting indicating the selection vanishes if:

•you move the cursor out of the subwindow which holds the selection,

•you type any key, or

•any new output is written to the window which holds the selection. 

However, even if the selection highlighting disappears, the selection still exists.  You can use it until you explicitly make another selection.  The fact that the selection highlighting disappears in these circumstances reflects an incomplete selection implementation. 

To manipulate your selection, press the menu button over the terminal subwindow.  A ttysw menu appears with the menu items discussed below:

StuffSelect Stuff, and the characters in the selection are copied to the window as though they had been typed at the keyboard.  The window in which you invoke Stuff does not have to be the same as the one in which you made the selection.  You can copy text between windows with this facility. 

If you are an expert user, you may want to accelerate the Stuff process.  If you hold down the shift key while you press the right mouse button, you can stuff a selection without selecting Stuff from the menu. 

Page Mode On
Select Page Mode On to prevent voluminous tty subwindow output from scrolling off the screen.  Page Mode can save you from redoing a command with a pipe to more in such cases. 

When Page Mode is on, a tiny stop sign appears on the screen when a command generates a screenful of output.  To restart output, type any key, or select the Continue menu item discussed below. 

Page Mode Off
After you turn Page Mode on, you can select Page Mode Off to turn it off.

Continue
Select Continue to restart output halted by Page Mode.

You can use the selection mechanism for building up complex command sequences and to avoid repetitive keyboard input.  Selection facilities will be expanded in future releases. 

Other Aspects of Terminal Emulators

Currently, only shelltool and gfxtool contain terminal emulator subwindows.  When you call one of these tools with command line arguments, any arguments not specific to the tool pass to the terminal emulator.  The terminal emulator runs the program named by the first of these arguments.  If you don’t give any arguments, then the terminal emulator runs the program described by your SHELL environment value.  If this environment value is not available, then /bin/sh is run.  Note:  To run a C shell using its -c option in either of these tools, you must explicitly specify csh -c on the command line when you start up the tool. 

Start-up Processing:  The ‘.suntools’ File

suntools can set up a predefined arrangement of windows for you when it starts up.  It does this by reading the file .suntools in your home directory and following the instructions there.  The −s flag on the command line indicates that suntools should read an alternative file.  The −n switch suppresses this start-up processing altogether. 

Each line in the file is a command line corresponding to a tool to be started up.  These command lines are similar to those given to a shell, but no special character interpretation is performed.  Use the generic tool arguments to place the tool on the screen (see Generic Tool Arguments).  Comment lines are preceded by a #. 

For example:

shelltool -C -Wi
shelltool
clocktool -Wi

starts up a shelltool as the console in its iconic form, a shelltool to be used for interactive command input and a clocktool, also in its iconic form.  Note that the system assigns the positions of windows and icons in this case, since no positioning arguments were given. 

As an alternative, a command line may be a string followed by 9 decimal numbers, as follows:

path  nl  nt  nw  nh  il  it  iw  ih  I  args

where path is the file name of the tool to be run, nl, nt, nw, and nh are decimal numbers which define the window for the normal (open) tool, as left edge, top edge, width, and height; il, it, iw, and ih are the same for the iconic form of the tool; and I is a boolean flag which should be non-zero if the tool is to be started in its iconic form.  The remainder of the line is passed to the the program running in the window as command-line arguments.  The origin (0,0) is the upper left-hand corner of the screen. If a size parameter is equal to −1 then the Root Manager assigns an appropriate value.

•You can include comments lines in a .suntools file by preceding them with a #. 

•You can place command lines in a .suntools file, but no interpretation ala shell is done.  You can combine this facility with the generic command line tool arguments to place tools. 

Consider a .suntools file containing:

shelltool0    72  -1   7284    4   64  64  0  vi $HOME/sked
shelltool372  0   -1   792-1   -1  64  64  0  -C
clocktool4    4   180  40 232  4   64  64  1

This starts suntools with three tools active:

•A shelltool in a window 38 by 80 characters (in the default font).  It comes up in the lower left corner of the screen,  which leaves enough space above it to fit some icons.  The shelltool is running the editor vi on a file named ‘sked’ in your home directory.  The string ‘vi $HOME/sked’ passes as a command to be executed by the shell running in the tool.  When this shell becomes iconic, it moves to the upper left corner of the screen. 

•Another shelltool extends nearly the full height of the screen (48 lines), and butts against the right edge.  The system places its icon when this shell becomes iconic.   The shell is ready for your input as soon as it appears on the screen.  Note, however, that all your messages are directed to this console shell.  If you hate being interrupted by biff, you should either add another shell to your .suntools file, or plan to start another shell in which to work as soon as Suntools comes up on the screen. 

•A clocktool starts out iconic, about a quarter of the way across the top of the screen. 

The program toolplaces in the directory /usr/bin can help you construct the .suntools file; it writes a description of the windows that exist at its run time on the standard output. 

Customizing the Root Manager Menu

A file in /usr/lib called "rootmenu" contains a description of the menu displayed over the gray root window.  Setting the ROOTMENU parameter in your environment to another file changes the place from which the menu description is gleaned.  You can customize the menu by modifying the file.  Lines in the file start with the string to display in the menu followed by a command (strings with embedded blanks are delimited with double quotes).  Here are the commands that you can supply.  Comment lines start with a #:

EXITExit the suntools program, after user confirmation.  To add this command, place the line

Exit EXIT

in the file. 

REFRESH
Redraw the entire screen.  To add this command, place the line

ReDisplay REFRESH

in the file. 

MENU
Stack a menu on the pile with the Suntools menu.  Get the menu contents from the filename that follows.  Name the menu with the string preceding. To add this command, place the line

"More Tools"MENU /usr/tmp/rootmenutool

in the file. 

Lines without recognized commands are treated as command lines and executed:

Shell  /usr/bin/shelltool
Lock  /usr/bin/lockscreen -r

No interpretation ala shell is done. 

Changing the System Font

The system has a default font built into it.  To use another font, set the environment variable DEFAULT_FONT to the name of the file containing the desired font.  You have to set DEFAULT_FONT in the shell from which you invoke the program.  You can find a small number of valid alternative fonts in the directory /usr/bin/fonts/fixedwidthfonts. 

Multiple/Color Displays

The suntools program runs on either a monochrome or color screen.  Each screen on a machine may have its own invocation of suntools running on it.  The keyboard and mouse input devices are shared among multiple screens.  The mouse cursor slides from one screen to another when you move the cursor off the edge of a screen. 

A common multiple display configuration is one monochrome and one color screen.   You could set up an instance of suntools on each screen in the following way:

1)Invoke suntools on the monochrome display by running “suntools”.  This starts suntools on the default frame buffer named /dev/fb. 

2)In a Shelltool, run “suntools -d /dev/cgone0”.  This starts suntools on a Sun−1 color screen named /dev/cgone0. 

3)In a Shelltool on the monochrome screen, run “adjacentscreens /dev/fb -r /dev/cgone0”.  This sets up cursor tracking so that the cursor slides from the monochrome screen to the color screen when you move the cursor off the right hand side of the monochrome screen.  Similarly, the cursor slides from the color screen to the monochrome screen when you move the cursor off the left hand side of the color screen. 

Getting Out

To exit any tool, invoke the Quit command in the Tool Manager Menu as described above.  Typing ^D to the shell in a terminal subwindow also makes the tool go away.   To exit the entire window system, invoke Exit in the Suntools menu as described above.  Make sure that all windows are in a safe condition (for example, editors have written out all changes) first. 

You can exit suntools via the keyboard by typing ^D followed by ^Q. There is no confirmation.  This facility provides an escape hatch if you inadvertently start suntools when no mouse is attached to the system. 

Initialization

Before you can run suntools, you have to create the appropriate devices for it in the /dev directory.  You only need to do this once on each machine.  To create the devices,

•set your user id to root,

•change directory to /dev, and

•execute the shell script ‘MAKEDEV win0’. 

If you tend to use more than 32 windows, run the script ‘MAKEDEV win1’ as well. 

Suntools also needs the file /etc/utmp to have read and write permission for all users.  It should have been installed with these permissions, but if not, you need to use chmod to change the permissions. 

SEE ALSO

Utility programs that run in the SunWindows environment: adjacentscreens(1)
clocktool(1)
coretool(1)
dbxtool(1)
fonttool(1)
gfxtool(1)
icontool(1)
lockscreen(1)
perfmeter(1)
perfmon(1)
shelltool(1)
tektool(1)

FILES

~/.suntools
~/.ttyswrc
/usr/bin/suntools
/usr/bin/toolplaces
/usr/lib/fonts/fixedwidthfonts/∗
/usr/lib/rootmenu
/usr/src/sun/suntool/∗
/dev/winx
/dev/ptypx
/dev/ttypx
/dev/fb
/dev/kbd
/dev/mouse
/dev/MAKEDEV
/etc/utmp

BUGS

This release has the following notable bugs:

(1)Messages from the kernel ignore window boundaries unless console messages have been redirected, thus trashing the display.  Recover from this by invoking the ‘ReDisplay All’ item on the Root Manager menu.  Then start a shelltool with the -C option to redirect the console output. 

(2)Acceptable performance on realistic tasks (such as editing with vi while make performs a C compilation) requires about 600K of available user memory.  In some cases, the kernel may have to be reconfigured to make that space available.  See the System Manager’s Guide.

Sun Release 2.0  —  Last change: 29 March 1985

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026