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

Although this command is available with both the SunView software installation option and the OpenWindows user environment, its appearance is not the same for both environments.  The man page you are currently viewing refers to the shelltool that is available with OpenWindows. The primary difference between this and the SunView shelltool is the user interface.  All OpenWindows standard tools use the OPEN LOOK Graphical User Interface. For more information about OPEN LOOK, refer to the OpenWindows User’s Guide.  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 functionaltiy 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 /Tty/Bold_style 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 sunview(1). 

USAGE

Defaults Options

These options are available through defaultsedit(1). 

Term.BoldStyle:
Select a style for emphasized text:

None Disable emphasis. 

Offset_X Thicken characters horizontally. 

Offset_Y Thicken characters vertically. 

Offset_X_and_Y Thicken characters both horizontally and vertically. 

Offset_XY Thicken characters diagonally. 

Offset_X_and_XY Thicken character both horizontally and diagonally. 

Offset_Y_and_XY Thicken characters both vertically and diagonally. 

Offset_X_and_Y_and_XY
Thicken characters horizontally, vertically and diagonally.

Invert Display emphasis as inverse video (the standard default). 

Term.InverseStyle:
Select a style for inverse video display:

Enable Enable inverse mode for inverted text. 

Disable Disable inverse mode for inverted text. 

Same_as_bold Display inverted text as bold text. 

Term.UnderlineStyle:
Select a style for underlined text:

Enable Enable underline mode for underlined text. 

Disable Disable underline mode for underlined text. 

Same_as_bold Display underlined text as bold text. 

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

A sample .ttyswrc file can be found in /usr/lib/ttyswrc.  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 SunView.  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 programs drive the tool in which its tty subwindow resides by sending 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 example, \E[>1;3;4l

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 shelltooll Menu

The shelltool window menu is called the Term Pane menu and contains the following options and their submenus:

History

Creates a a list of commands used during the shelltool session

Edit >

Provides a set of editing functions as described below:
 
Again

Repeats the last action. 

Undo >

Undo Last Edit

Undoes the last edit made in shelltool. 

Undo All Edits

Undoes all edits made during this session of shelltool. 

Copy

Makes a copy of the selected text and places it in the clipboard. 

Paste

Pastes a copy of the text stored in the clipboard at the cursor location. 

Cut

Deletes the selected text and places it in the clipboard. 

Find >

Provides a set of find and replace functions as described below:
 
Find and Replace

Brings up a pop-up menu containing text fields and command buttons that allow you to search forward and backward through the file being edited for specific text strings. Allows you to specify options for the replacement of text. 

Find Selection >

Forward

Searches forward to find a selected text string. 

Backward

Searches backward to find a selected text string. 

Find Marked Text

Brings up a pop-up menu that allows you to find text that is included between specified bracket pairs. Also allows you to insert or remove bracket pairs around selected text. 

Replace |>field<| >

Allows you to replace selected text forward and backward throughout the file. 

Extras >

A user-definable pull-right menu conrolled by the /usr/lib/text_extras_menu file. 

File Editor >

Enable

Allows you to edit files from within shelltool. 

Disable

Turns off the ability to edit files from within shelltool. 

Scrolling >

Enables scrolling within shelltool. 

Disable Scrolling >

Turns off the ability to scroll 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 ALSO

cmdtool(1), defaultsedit(1), gfxtool(1), input_from_defaults(1), more(1), rlogin(1C), kbd(4S), termcap(5)

SunView 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 keystrokes in input buffer’.  Choosing the Flush Input Buffer menu item may correct the problem.  This is a bug for a terminal emulator subwindow running on top of or rlogin(1C) to a machine with pre-4.0 release kernel. 

Sun Release 4.1  —  Last change: 1 September 1989