WSH(1G) WSH(1G)
NAME
wsh - creates and specifies a window shell
SYNOPSIS
wsh [ -c cmd[args] ] [ -C textcolor, pagecolor, hilitecolor,
cursorcolor ]
[ -f fontfile ] [ -F] [ -H] [ -m cols,lines ] [ -n name ]
[ -p x,y ]
[ -s cols,lines ] [ -t title ]
DESCRIPTION
wsh is a terminal emulation program that runs a shell (or
other UNIX command) within its own mex window on the screen.
Each wsh provides menus that allow you to interactively
attach and select windows, change fonts and window sizes,
and create new wshs.
Command line options are available to specify the font,
window size, title, and position when wsh starts up. The
command line options include:
-c cmd[args]
to execute a child program within the wsh window,
using the specified command line arguments, rather
than the default shell. The -c option will pass all
trailing arguments to wsh , to be executed as a
command line. Thus, if -c is given, it must appear
as the final wsh option.
-C textcolor,pagecolor,hilitecolor,cursorcolor
to set the color indices used by wsh to display text
characters, the background page, highlighted text
characters, and the block cursor.
-f fontfile
to set the specified font for displaying text.
-F to start wsh in fixed terminal size mode. The
terminal size is fixed initially at the maximum
window size specified by the -m command line option,
or the default maximum size (80,40). While in fixed
terminal size mode, making the window smaller will
hide some of the fixed sized terminal's data. A
visual truncation indicator is displayed when data
is hidden in this way. The ``set size'' menu may be
used to set up a new fixed terminal size. By
default, wsh starts up in variable terminal size
mode. While in variable terminal size mode,
reshaping the window causes the terminal itself to
be resized accordingly. In this case, the
terminal's data is never hidden because it is
wrapped within the confines of the window itself.
Page 1 (last mod. 8/20/87)
WSH(1G) WSH(1G)
-H to hold wsh after its child program has exited, to
permit viewing its output.
-m cols,lines
to set the maximum window size, as the number of
columns wide by the number of lines high. The
window manager will not allow the window to be
reshaped larger than the maximum window size. If
the -m option is not given, the maximum window size
is set to the initial window size, as specified by
the -s command line option, or the default size. If
the -F option is given, the maximum window size is
also used as the initial fixed terminal size at
startup.
-n name to provide a unique window name for a wsh. The
window manager will look up name in .deskconfig to
find initial positioning information. If -n is
given with no argument, the system uses the name of
the command running within wsh. If no -n is given,
the system does not ask .deskconfig for positioning
information.
-p x,y to set the position of the lower-left corner of the
window to the screen pixel location x,y. If the -p
option (or .deskconfig, see -n above) does not
provide a window location, the window manager
prompts for it.
-s cols,lines
to set the initial size of the window by specifying
the number of columns wide by the number of lines
high. The default size is 80,40. If the -s size
given is larger than the default maximum window size
(80,40), the effective maximum size expands to
accomodate it.
-t title
to set the title of the window to the title. If a
null string is provided, (-t ""), wsh will appear
without a title bar.
You can use environment variables to set a font directory
and a font filename for displaying text within wsh. FONTDIR
overrides the default font directory /usr/lib/gl/fonts by
specifying another directory (using the full pathname).
FONT overrides the default font /etc/gl/defaultfont by
specifying the name of another font file found in the
prevailing font directory. You can further override this
preference by using the -f font selection option of wsh.
You can restore the size of a wsh window using the ``prev
Page 2 (last mod. 8/20/87)
WSH(1G) WSH(1G)
size'' item on the window menu. This allows you to toggle
back and forth between a ``stowed'' and ``open'' size and
position for a given wsh. Note that font changes which
affect window size reset the previous size.
When you log on to a remote system, use vt100 if no iris-
ansi entry exists in the terminfo or termcap file. You must
set wsh terminal size to 80,24 for this to work properly.
When you use vi, emacs, or other visual-mode programs
remotely, you must size the terminal window to match the
terminal size referenced by the current $TERM environmental
variable, or visual chaos will reign.
The following command line options are for special startup
only:
-L master_dev,slave_dev
use the given psuedo-tty master and slave devices
instead of taking the next available pair. wsh does
not fork a shell; it listens on master_dev for
output that is expected from another process which
is writing to and reading from slave_dev. wsh keeps
slave_dev open so another process can reopen it
without closing and reopening master_dev. This
option is usually only used for the console window.
It implies -Z 1.
-Z n to provide special instructions. The legal values
for n are: 1, which indicates the wsh was started
as a result of an entry in /etc/inittab; 2, which
indicates the wsh is for the system console
/dev/console and implies -Z 1; filename, which
passes cloned parameters to a new windowed shell.
Only one -Z option can be specified.
wsh recognizes escape sequences as listed in Using mex,
Chapter 7, IRIS-4D Terminal Escape Sequences.
FILES
/etc/gl/deskconfig
/etc/gl/defaultfont
/usr/lib/gl/fonts
SEE ALSO
Using mex, Chapter 6, wsh, and Chapter 7, IRIS-4D Terminal
Escape Sequences.
Getting Started with the IRIS 4-D Workstation
ORIGIN
Silicon Graphics, Inc.
Page 3 (last mod. 8/20/87)
WSH(1G) WSH(1G)
Page 4 (last mod. 8/20/87)