NAME¶
shelltool - run a shell (or other program) in an OpenWindows terminal
window
SYNOPSIS¶
shelltool [
-C ] [
-B boldstyle ] [
-I
command ] [
generic-tool-arguments ] [
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.
DESCRIPTION¶
shelltool is a standard
OpenWindows facility for shells or other
programs that use a standard tty-based interface.
When invoked,
shelltool runs a program, (usually a shell) in an
interactive 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
.Xdefaults
file that effect the behavior of
shelltool. The ones of interest 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 parameters 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 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;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 characteristics 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 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:
alias header 'echo -n "\E]l\!*\E\"'
alias iheader 'echo -n "\E]L\!*\E\"'
alias icon 'echo -n "\E]I\!*\E\"'
FILES¶
- ~/.ttyswrc
- /usr/lib/ttyswrc
- /usr/bin/xview/shelltool
- /usr/demo