shelltool(1)shelltool(1)NAMEshelltool - run a shell (or other program) in an OpenWindows terminal
window
SYNOPSISshelltool [ -C ] [ -B boldstyle ] [ -I command ] [ generic-tool-argu‐
ments ] [ program [ arguments ] ]
AVAILABILITY
This command is available with the OpenWindows user environment, For
information about installing OpenWindows, refer to the OpenWindows
Installation and Start-Up Guide.
DESCRIPTIONshelltool is a standard OpenWindows facility for shells or other pro‐
grams that use a standard tty-based interface.
When invoked, shelltool runs a program, (usually a shell) in an inter‐
active terminal emulator based on a tty subwindow. Keyboard input is
passed to that program. In the OpenWindows version of shelltool, a
restricted pop-up menu is available from the main display area that
allows you to enable scrolling. Selecting the Enable Scrolling option
from the restricted menu gives shelltool the full functionality of the
cmdtool window, included a larger pop-up menu from which to select
options. Selecting Disable Scrolling from the pop-up submenu will
return Shelltool to its original state.
OPTIONS-C Redirect system console output to this shelltool.
-B boldstyle Set the style for displaying bold text to boldstyle.
boldstyle can be a string specifying one of the choices
for the term.boldstyle default, see Defaults Options,
below, or it may be a numerical value for one of those
choices, from 0 to 8, corresponding to the placement of
the choice in the list.
-I command Pass command to the shell. SPACE characters within the
command must be escaped.
generic-tool-arguments
shelltool accepts the generic tool arguments listed in
xview(1).
USAGE
.Xdefaults File Options
You can specify a number of defaults using the options in the .Xde‐
faults file that effect the behavior of shelltool. The ones of inter‐
est are those that begin with text,term, or keyboard. See .xview(1)
for more detailed information.
The Terminal Emulator
The tty subwindow is a terminal emulator. Whenever a tty subwindow is
created, the startup file ~/.ttyswrc is read for initialization parame‐
ters that are specific to the tty subwindow.
The .ttyswrc File
The command format for this file is:
# Comment.
set variable Turn on the specified variable.
mapi key text When key is typed pretend text was input.
mapo key text When 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. (ESC, RETURN , and CTRL-X ,
respectively). See termcap(5) for the format of the string escapes
that are recognized. Note: mapi and mapo may be replaced by another
keymapping mechanism in the future.
When using the default kernel keyboard tables, the keys L1, LEFT ,
RIGHT , BREAK , R8, R10, R12, and R14 cannot be mapped in this way;
they send special values to the tty subwindow. Also, when using the
default kernel keyboard tables, L1-L10 are now used by XView. See
input_from_defaults(1) and kbd(4S) for more information on how to
change the behavior of the keyboard.
It is possible to have terminal-based p special escape sequences.
These escape sequences may also be sent by typing a key appropriately
mapped using the mapo function described above. The following func‐
tions 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;HT;WIDTHt - stretch, to HT WIDTH size (in pixels)
\E[5t - front
\E[6t - back
\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;HT;WIDTHt
\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]ltext\E\ - set tool header to text
\E]Ifile\E\ - set icon to the icon contained in file;
file must be in iconedit output format
\E]Llabel\E\ - set icon label to label
\E[>OPT;...h - turn SB OPT on (OPT = 1 => pagemode), for
example, \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), for .B
\E[>1;3;
See EXAMPLES for an example of using this facility.
shelltool Windows
The window created by shelltool is based on the text facility that is
described in the textedit man page. The user is given a prompt at
which to type commands and pop-up menus from which to select command
options.
shelltool windows support cursor motions, using an /etc/termcap entry
called sun-cmd. Command windows automatically set the TERM environment
variable to sun-cmd. So, if you rlogin(1C) to a machine that does not
have an entry for sun-cmd in its /etc/termcap file, the error message
`Type sun-cmd unknown' results. To rectify this, type the command `set
TERM=sun'. Programs written using the curses(3X) or curses(3V) library
packages will work in a command window, but programs hard-coded for
sun-type terminals may not. When supporting a program that performs
cursor motions, the command window automatically takes on the charac‐
teristics of a tty window (as with shelltool(1)). When that program
terminates or sleeps, the full command window functionality is
restored.
cmdtool supports programs that use CBREAK and NO ECHO terminal modes.
This support is normally invisible to the user. However, programs that
use RAW mode, such as rlogin(1C) and script(1), inhibit command-line
editing with the mouse. In this case, however, tty-style ERASE, word-
kill and line-kill characters can still be used to edit the current
command line.
The shelltool Menu
The shelltool window menu is called the Term Pane menu and contains the
following options and their submenus:
Enable Page Mode
Enables page mode within shelltool .
Copy Places the highlighted text on the clipboard.
PastePuts the contents of
pointed to by the cusor.
Scrolling Enables scrolling within shelltool .
EXAMPLES
The following aliases can be put into your ~/.cshrc file:
# dynamically set the name stripe of the tool:
alias header 'echo -n "\E]l\!*\E\"'
# dynamically set the label on the icon:
alias iheader 'echo -n "\E]L\!*\E\"'
# dynamically set the image on the icon:
alias icon 'echo -n "\E]I\!*\E\"'
FILES
~/.ttyswrc
/usr/lib/ttyswrc
/usr/bin/xview/shelltool
/usr/demo/*
SEE ALSOcmdtool(1), more(1), xview(1), rlogin(1C), kbd(4S), termcap(5)
OpenWindows User's Guide
BUGS
If more than 256 characters are input to a terminal emulator subwindow
without an intervening NEWLINE , the terminal emulator may hang. If
this occurs, an alert will come up with a message saying `Too many key‐
strokes in input buffer'. Choosing the Flush Input Buffer menu item
may correct the problem. This is a bug for a terminal emulator subwin‐
dow running on top of or rlogin(1C) to a machine with pre-4.0 release
kernel.
11 June 1990 shelltool(1)
