DtTerm man page on IRIX

Man page or keyword search:  
man Server   31559 pages
apropos Keyword Search (all sections)
Output format
IRIX logo
[printable version]



     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

     NAME
	  DtTerm - DtTerm widget class

     SYNOPSIS
	  #include <Dt/Term.h>

     DESCRIPTION
	  The DtTerm widget provides the core set of functionality
	  needed to emulate an ANSI X3.64-1979- and ISO 6429:1992(E)-
	  style terminal, such as the DEC VT220.  This functionality
	  includes text rendering, scrolling, margin and tab support,
	  escape sequence parsing and the low-level OS-specific
	  interface required to allocate and configure a pty or
	  STREAMS pseudo-terminal device and write the system's utmp
	  device.

	Classes
	  The DtTerm widget inherits behavior and resources from the
	  Core and XmPrimitive classes.

	  The class pointer is dtTermWidgetClass .

	  The class name is DtTerm.

	New Resources
	  The following table defines a set of widget resources used
	  by the application to specify data.  The application can
	  also set the resource values for the inherited classes to
	  set attributes for this widget.  To reference a resource by
	  name or by class in a .Xdefaults file, the application must
	  remove the DtN or DtC prefix and use the remaining letters.
	  To specify one of the defined values for a resource in a
	  .Xdefaults file, the application must remove the Dt prefix
	  and use the remaining letters (in either lower case or upper
	  case, but including any underscores between words).  The
	  codes in the access column indicate if the given resource
	  can be set at creation time (C), set by using XtSetValues()
	  (S), retrieved by using XtGetValues() (G), or is not
	  applicable (N/A).

				    DtTerm Resource Set, Part 1 of 2
	  ____________________________________________________________________________________
	  Name			   Class		  Type		Default		Access
	  ____________________________________________________________________________________
	  DtNallowSendEvents	   DtCAllowSendEvents	  Boolean	False		CSG
	  DtNappCursorDefault	   DtCAppCursorDefault	  Boolean	False		CSG
	  DtNappKeypadDefault	   DtCAppKeypadDefault	  Boolean	False		CSG
	  DtNautoWrap		   DtCAutoWrap		  Boolean	True		CSG
	  DtNbackgroundIsSelect	   DtCBackgroundIsSelect  Boolean	False		CG
	  DtNbaseHeight		   DtCBaseHeight	  int		0		G

     Page 1					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

	  DtNbaseWidth		   DtCBaseWidth		  int		0		G
	  DtNblinkRate		   DtCBlinkRate		  int		250		CSG
	  DtNc132		   DtCC132		  Boolean	False		CSG
	  DtNcharCursorStyle	   DtCCharCursorStyle	  unsigned	DtTERM_CHAR-	CSG
							     char	   _CURSOR_BOX
	  DtNcolumns		   DtCColumns		  short		80		CSG
	  DtNconsoleMode	   DtCConsoleMode	  Boolean	False		CG
	  DtNemulationID	   DtCEmulationID	  String	``DtTermWidget''CSG
	  DtNheightInc		   DtCHeightInc		  int		0		G
	  DtNinputVerifyCallback   DtCCallback		  XtCallbackListNULL		C
	  DtNjumpScroll		   DtCJumpScroll	  Boolean	True		CSG
	  DtNkshMode		   DtCKshMode		  Boolean	False		CSG
	  DtNlogging		   DtCLogging		  Boolean	False		CSG
	  DtNmapOnOutput	   DtCMapOnOutput	  Boolean	False		CSG
	  DtNmapOnOutputDelay	   DtCMapOnOutputDelay	  int		0		CSG
	  DtNmarginBell		   DtCMarginBell	  Boolean	False		CSG
	  DtNmarginHeight	   DtCMarginHeight	  Dimension	2		CSG
	  DtNmarginWidth	   DtCMarginWidth	  Dimension	2		CSG
	  DtNnMarginBell	   DtCNMarginBell	  int		10		CSG
	  DtNoutputLogCallback	   DtCCallback		  XtCallbackListNULL		C
	  DtNpointerBlank	   DtCPointerBlank	  Boolean	False		CSG
	  DtNpointerBlankDelay	   DtCPointerBlankDelay	  int		2		CSG
	  DtNpointerColor	   DtCForeground	  String	dynamic		CSG
	  DtNpointerColorBackgroundDtCBackground	  String	dynamic		CSG
	  DtNpointerShape	   DtCPointerShape	  String	xterm		CSG
	  DtNreverseWrap	   DtCReverseWrap	  Boolean	False		CSG
	  DtNrows		   DtCRows		  short		24		CSG
	  DtNsaveLines		   DtCSaveLines		  string	4s		CG
	  DtNshadowType		   DtCShadowType	  unsigned	DtSHADOW_IN	CSG
							     char
	  DtNstatusChangeCallback  DtCCallback		  XtCallbackListNULL		C
	  DtNsubprocessArgv	   DtCSubprocessArgv	  String *	NULL		CG
	  DtNsubprocessCmd	   DtCSubprocessCmd	  String	NULL		CG
	  DtNsubprocessExec	   DtCSubprocessExec	  Boolean	True		CSG
	  DtNsubprocessLoginShell  DtCSubprocessLoginShellBoolean	False		CG
	  DtNsubprocessPid	   DtCSubprocessPid	  int		-1		G
	  DtNsubprocess-	   DtCCallback		  XtCallbackListNULL		C
	     TerminationCallback
	  DtNsubprocess-	   DtCSubprocess-	  Boolean	True		CSG
	     TerminationCatch	      TerminationCatch
	  DtNsunFunctionKeys	   DtCSunFunctionKeys	  Boolean	False		CSG
	  DtNtermDevice		   DtCTermDevice	  int		-1		CG
	  DtNtermDeviceAllocate	   DtCTermDeviceAllocate  Boolean	True		CG
	  DtNtermId		   DtCTermId		  String	``vt220''	CSG
	  DtNtermName		   DtCTermName		  String	``dtterm''	CSG
	  DtNtermSlaveName	   DtCTermSlaveName	  String	NULL		CG
	  DtNttyModes		   DtCTtyModes		  String	NULL		CSG
	  DtNuserBoldFont	   DtCUserBoldFont	  XmFontList	dynamic		CSG
	  DtNuserFont		   DtCUserFont		  XmFontList	dynamic		CSG
	  DtNverticalScrollBar	   DtCVerticalScrollBar	  Widget	NULL		CSG

     Page 2					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

	  DtNvisualBell		   DtCVisualBell	  Boolean	False		CSG
	  DtNwidthInc		   DtCWidthInc		  int		0		G

	     allowSendEvents
		   Specifies that the terminal emulator allow
		   synthetic events (generated and sent by another
		   application).  Enabling this resource opens up a
		   possible security hole.

	     appCursorDefault
		   Specifies the initial cursor mode.  If True, the
		   cursor keys are initially in application mode.  If
		   False, the cursor keys are initially in cursor
		   mode.

	     appKeypadDefault
		   Specifies the initial keypad mode.  If True, the
		   keypad keys are initially in application mode.  If
		   False, the keypad keys are initially in numeric
		   mode.

	     c132
		   Specifies whether or not the DECCOLM escape
		   sequence that switches between a 132- and 80-column
		   window is honored.

	     consoleMode
		   Specifies that output directed at /dev/console be
		   directed instead to the terminal window.  It is
		   provided as a way to prevent output that would
		   normally be displayed on the internal terminal
		   emulator (ITE) from overwriting the X server's
		   display.  It is not provided as a general mechanism
		   to direct the output from an arbitrary system's
		   /dev/console to an arbitrary X server.  Ownership
		   of, and read-write permission for, /dev/console is
		   required to redirect console output.

	     DtNautoWrap
		   Specifies whether or not auto-wrap is initially
		   enabled.

	     DtNbackgroundIsSelect
		   Controls the background color.  When False, the
		   background color is the color specified.  When
		   True, the background color is the select color
		   corresponding to the background and is constant
		   with other Motif-based applications.

	     DtNbaseHeight
		   Specifies the terminal window's base height.	 With
		   this resource the application computes its base

     Page 3					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

		   height for the shell widget, which then allows the
		   window manager to provide appropriate sizing
		   feedback to the user.  The height of the terminal
		   window is:

			DtNbaseHeight + DtNrows x DtNheightInc

	     DtNbaseWidth
		   Specifies the terminal window's base width.	With
		   this resource the application computes its base
		   width for the shell widget, which then allows the
		   window manager to provide appropriate sizing
		   feedback to the user.  The width of the terminal
		   window is:

			DtNbaseWidth + DtNcolumns x DtNwidthInc

	     DtNblinkRate
		   Specifies the number of milliseconds the cursor is
		   in the on and off states while blinking.  A value
		   of 250 blinks the cursor two times per second.  A
		   value of zero turns blinking off.

	     DtNc132
		   This resource specifies whether or not the DECCOLM
		   escape sequence should be honored.

	     DtNcharCursorStyle
		   Specifies the text cursor shape.  A
		   DtTERM_CHAR_CURSOR_BOX value specifies a cursor the
		   width and height of the base font's bounding box.
		   A DtTERM_CHAR_CURSOR_BAR value specifies a cursor
		   the width of the base font's bounding box, two
		   pixels high, and drawn with its top on the
		   baseline.  The default is DtTERM_CHAR_CURSOR_BOX.

	     DtNcolumns
		   Specifies the number of text columns in the
		   terminal window.  For additional information, see
		   DtNbaseWidth.

	     DtNemulationID
		   Specifies the string to which the TERMINAL_EMULATOR
		   environment variable is set.

	     DtNheightInc
		   Specifies the character cell height used as the
		   height increment when calculating the size of the
		   terminal window.  For additional information, see
		   DtNbaseHeight.

	     DtNinputVerifyCallback

     Page 4					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

		   Specifies the list of callbacks called before the
		   DtTerm widget sends text to the child process.  The
		   text may be generated either in response to
		   keyboard input, selection or drag and drop.	The
		   DtTermInputVerifyCallbackStruct structure's address
		   is passed to this callback.	DtCR_TERM_INPUT_VERIFY
		   is the reason set by the callback.

	     DtNjumpScroll
		   Specifies that the DtTerm widget uses jump
		   scrolling.  Under jump scrolling, the screen may be
		   scrolled more than one line at a time.  This means
		   faster screen updates when multiple lines of text
		   are sent to the terminal.  The maximum number of
		   lines that may be jump scrolled is limited to the
		   number of lines in the terminal window.  The DtTerm
		   widget guarantees that all lines are displayed.

	     DtNkshMode
		   Enables ksh mode.  With ksh mode, a key pressed
		   with the extend modifier bit set generates an
		   escape character followed by the character
		   generated by the unextended keystroke.  This option
		   is provided for use with emacs(1) and the emacs
		   command-line editor mode of ksh(1).	It conflicts
		   with the normal meta key use for generating
		   extended single byte characters and for generating
		   multi-byte Asian characters.

	     DtNmapOnOutput
		   Indicates that the terminal widget map (de-iconify)
		   itself upon subprocess output if it is unmapped
		   (iconified).	 An initial period of time during
		   which the terminal widget does not map itself upon
		   subprocess output can be specified via the
		   DtNmapOnOutputDelay resource.

	     DtNmapOnOutputDelay
		   Specifies the number of seconds after start-up that
		   the widget does not honor the DtNmapOnOutput
		   resource.  This allows for initial output (for
		   example, shell prompts) to be sent to the terminal
		   without auto-mapping the window.  The default is
		   zero (no delay).

	     DtNmarginBell
		   Specifies whether or not the bell rings when the
		   user types near the right margin.  The distance
		   from the right margin is specified by the
		   nMarginBell resource.

	     DtNmarginHeight

     Page 5					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

		   Specifies the height of the margin between the text
		   and the top and bottom of the DtTerm widget's
		   window.

	     DtNmarginWidth
		   Specifies the width of the margin between the text
		   and both sides of the DtTerm widget's window.

	     DtNnMarginBell
		   Specifies the number of characters from the right
		   margin at which the margin bell rings when enabled
		   via the DtNmarginBell resource.

	     DtNoutputLogCallback
		   Specifies the list of callbacks called when the
		   widget receives text from the child process.
		   DtTermOutputLogCallbackStruct is the structure type
		   whose address is passed to this callback.
		   DtCR_TERM_OUTPUT_LOG is the reason set by the
		   callback.

	     DtNpointerBlank
		   Indicates that the pointer cursor is in blanking
		   mode.  In this mode, the cursor turns on when the
		   pointer is moved, and is blanked either after a
		   selectable number of seconds or after keyboard
		   input.  The delay is set via the
		   DtNpointerBlankDelay resource.

	     DtNpointerBlankDelay
		   Specifies the number of seconds to wait after the
		   pointer has stopped moving before blanking the
		   pointer (see DtNpointerBlank).  A value of zero
		   prevents the pointer from blanking until a key is
		   pressed.

	     DtNpointerColor
		   Specifies the foreground color the DtTerm widget
		   uses for the terminal window's pointer (X11
		   cursor).  The default is the terminal window's
		   foreground color.

	     DtNpointerColorBackground
		   Specifies the background color the DtTerm widget
		   uses for the terminal window's pointer (X11
		   cursor).  The default is the terminal window's
		   background color.

	     DtNpointerShape
		   Specifies the X cursor font character the DtTerm
		   widget uses as the pointer cursor.  The font
		   character should be specified as a string from the

     Page 6					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

		   include file, <X11/cursorfont.h>, with the leading
		   XC_ removed.	 The default is xterm(1X).

	     DtNreverseWrap
		   Specifies whether or not reverse-wraparound is
		   enabled.

	     DtNrows
		   Specifies the number of rows of text in the
		   terminal window.  For additional information, see
		   DtNbaseHeight.

	     DtNsaveLines
		   Defines the number of lines in the terminal buffer
		   beyond the length of the window.  The resource
		   value consists of a number followed by an optional
		   suffix.  If no suffix is included or the suffix is
		   ``l'' (ell), the total length of the terminal
		   buffer is the number plus the length of the
		   terminal window.  If the suffix is ``s,'' the total
		   length of the terminal buffer is (the number plus
		   one) times the length of the terminal window.  The
		   DtTerm widget tries to maintain the same buffer-
		   to-window ratio when the window is resized larger.

	     DtNshadowType
		   Specifies the type of shadow drawn around the
		   terminal window.  See the XmFrame(3X) widget for
		   supported shadow types.

	     DtNstatusChangeCallback
		   Specifies the list of callbacks called when the
		   DtTerm widget's status changes.  Status changes
		   include changes such as cursor position, caps lock
		   state and insert char state.	 The
		   DtTermStatusChangeCallbackStruct structure's
		   address is passed to this callback.
		   DtCR_TERM_STATUS_CHANGE is the reason the callback
		   sends.

	     DtNsubprocessArgv
		   Specifies the argument list passed to the
		   subprocess if DtNsubprocessExec is True.  If
		   DtNsubprocessCmd is NULL, the first string of this
		   argument is used as the name of the command to
		   execute.

	     DtNsubprocessCmd
		   Specifies the name of the command to run if
		   DtNsubprocessExec is True.  If DtNsubprocessExec is
		   NULL, the first string of the DtNsubprocessArgv
		   argument is used.

     Page 7					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

	     DtNsubprocessExec
		   This resource specifies whether or not a subprocess
		   is fork(2) and exec(2).  If True, a subprocess is
		   launched as specified via the DtNsubprocessArgv
		   resource, if set, or the DtNsubprocessCmd resource,
		   if set, or the SHELL environment variable, if set,
		   or the default system shell.

	     DtNsubprocessloginShell
		   Indicates that the starting shell be a login shell
		   (that is, the first character of argv[0] be a
		   dash), that tells the shell to read the system's
		   profile and the user's .profile files (for ksh(1)
		   and sh(1)) or the system's csh.login and the user's
		   .login (for csh(1)).

	     DtNsubprocessPid
		   Supplies the process ID of the subprocess running
		   in the terminal widget when DtNsubprocessExec is
		   True.

	     DtNsubprocessTerminationCallback
		   Supplies the list of callbacks called when the
		   subprocess associated with the DtTerm widget exits.
		   The DtTermSubprocessTerminationCallbackStruct
		   structure's address is passed to this callback.
		   DtCR_TERM_SUBPROCESS_TERMINATION is the reason the
		   callback sends.

	     DtNsubprocessTerminationCatch
		   Specifies whether or not the DtTerm widget installs
		   a signal handler to catch the subprocess
		   termination.	 If the application installs its own
		   signal handler, the application must catch the
		   subprocess termination and inform the DtTerm widget
		   via the DtTermSubprocReap(3) function.

	     DtNsunFunctionKeys
		   Specifies whether or not Sun Function Key escape
		   sequences are generated for function keys instead
		   of standard escape sequences.

	     DtNtermDevice
		   Supplies the file descriptor for the master side of
		   the pty or STREAMS pseudo-terminal device
		   associated with the DtTerm widget.

	     DtNtermDeviceAllocate
		   Specifies whether or not the DtTerm widget
		   allocates a pty or STREAMS pseudo-terminal device,
		   or uses the pseudo-terminal device passed to it via
		   the DtNtermDevice resource.

     Page 8					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

	     DtNtermId
		   Supplies the name the DtTerm widget uses to select
		   the correct response to terminal ID queries.	 Valid
		   values are vt100, vt101, vt102 and vt220.

	     DtNtermName
		   Supplies the name the DtTerm widget uses in setting
		   the TERM environment variable.  The default is
		   dtterm(1).

	     DtNtermSlaveName
		   Supplies the name of the slave device of the pty or
		   STREAMS pseudo-terminal device associated with the
		   DtTerm widget.  The DtTerm widget uses this
		   resource to update the system's utmp entry
		   associated with the subprocess.

	     DtNttyModes
		   Specifies a string containing terminal-setting
		   keywords and the characters to which they may be
		   bound.  Allowable keywords include:	intr, quit,
		   erase, kill, eof, eol, swtch, start, stop, brk,
		   susp, dsusp, rprnt, flush, weras and lnext.	The
		   terminal emulator correctly parses and silently
		   ignores keywords that do not apply to a specific
		   architecture.  Control characters can be specified
		   as ^char (for example, ^c or ^u), and ^? can be
		   used to indicate delete.  This is useful for
		   overriding the default terminal settings without
		   having to do an stty(1) every time a DtTerm widget
		   is created.

	     DtNuserBoldFont
		   Supplies the XmFontList the DtTerm widget uses to
		   display bold terminal text.	The terminal emulator
		   supports only character or mono-spaced fonts.  When
		   using proportional fonts, the behavior is
		   undefined.  The terminal emulator generates a
		   default bold font based on the XLFD name of the
		   userFont.  If that font is not available, the
		   terminal emulator generates bold text by
		   overstriking (with a one pixel offset) the
		   userFont.

	     DtNuserFont
		   Supplies the XmFontList the DtTerm widget uses to
		   display terminal text.  The terminal emulator
		   supports only character or mono-spaced fonts.  When
		   using proportional fonts, the behavior is
		   undefined.  The terminal emulator gets a default
		   font via the XmNtextFontList value of the parent
		   bulletin board (see the XmBulletinBoard(3X) widget)

     Page 9					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

		   in the same manner as the XmText(3X) widget.

	     DtNverticalScrollBar
		   Specifies a an application-supplied vertical scroll
		   bar widget to update as scrolling occurs.  The
		   DtTerm widget does not create the scroll bar.

	     DtNvisualBell
		   Specifies whether the DtTerm widget uses a visible
		   bell (that is, flashing) instead of an audible bell
		   when <control>-G is received.

	     DtNwidthInc
		   Specifies the character cell width the DtTerm
		   widget uses as the width increment when calculating
		   the size of the terminal window.  For additional
		   information, see DtNbaseWidth.

	Inherited Resources
	  The DtTerm widget inherits behavior and resources from the
	  following named superclasses.	 For a complete description of
	  each resource, see the man page for that superclass.

				    XmPrimitive Resource Set
	  ____________________________________________________________________________
	  Name		       Class		    Type	  Default	Access
	  ____________________________________________________________________________
	  XmNbottomShadowColor XmCBottomShadowColor Pixel	  dynamic	CSG
	  XmNbottom-	       XmCBottom-	    Pixmap	  XmUNSPECIFIED-CSG
	     ShadowPixmap	  ShadowPixmap			     _PIXMAP
	  XmNforeground	       XmCForeground	    Pixel	  dynamic	CSG
	  XmNhelpCallback      XmCCallback	    XtCallbackListNULL		C
	  XmNhighlightColor    XmCHighlightColor    Pixel	  dynamic	CSG
	  XmNhighlightOnEnter  XmCHighlightOnEnter  Boolean	  False		CSG
	  XmNhighlightPixmap   XmCHighlightPixmap   Pixmap	  dynamic	CSG
	  XmNhighlightThicknessXmCHighlightThicknessDimension	  2		CSG
	  XmNnavigationType    XmCNavigationType    XmNavigation- XmNONE	G
						       Type
	  XmNshadowThickness   XmCShadowThickness   Dimension	  2		CSG
	  XmNtopShadowColor    XmCTopShadowColor    Pixel	  dynamic	CSG
	  XmNtopShadowPixmap   XmCTopShadowPixmap   Pixmap	  dynamic	CSG
	  XmNtraversalOn       XmCTraversalOn	    Boolean	  True		CSG
	  XmNunitType	       XmCUnitType	    unsigned char dynamic	CSG
	  XmNuserData	       XmCUserData	    Pointer	  NULL		CSG

     Page 10					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

					   Core Resource Set
	  ___________________________________________________________________________________
	  Name			Class		      Type	    Default	       Access
	  ___________________________________________________________________________________
	  XmNaccelerators	XmCAccelerators	      XtAcceleratorsNULL	       CSG
	  XmNancestorSensitive	XmCSensitive	      Boolean	    dynamic	       G
	  XmNbackground		XmCBackground	      Pixel	    dynamic	       CSG
	  XmNbackgroundPixmap	XmCPixmap	      Pixmap	    XmUNSPECIFIED-     CSG
								       _PIXMAP
	  XmNborderColor	XmCBorderColor	      Pixel	    XtDefaultForegroundCSG
	  XmNborderPixmap	XmCPixmap	      Pixmap	    XmUNSPECIFIED-     CSG
								       _PIXMAP
	  XmNborderWidth	XmCBorderWidth	      Dimension	    0		       CSG
	  XmNcolormap		XmCColormap	      Colormap	    dynamic	       CG
	  XmNdepth		XmCDepth	      int	    dynamic	       CG
	  XmNdestroyCallback	XmCCallback	      XtCallbackListNULL	       C
	  XmNheight		XmCHeight	      Dimension	    dynamic	       CSG
	  XmNinitial-		XmCInitial-	      Boolean	    True	       CG
	     ResourcesPersistent   ResourcesPersistent
	  XmNmapped-		XmCMapped-	      Boolean	    True	       CSG
	  WhenManaged		WhenManaged
	  XmNscreen		XmCScreen	      Screen *	    dynamic	       CG
	  XmNsensitive		XmCSensitive	      Boolean	    True	       CSG
	  XmNtranslations	XmCTranslations	      XtTranslationsNULL	       CSG
	  XmNwidth		XmCWidth	      Dimension	    dynamic	       CSG
	  XmNx			XmCPosition	      Position	    0		       CSG
	  XmNy			XmCPosition	      Position	    0		       CSG

	Callback Information
	  A pointer to the DtTermStatusChangeCallbackStruct callback
	  structure, which includes at least the following members, is
	  passed to callbacks for DtNstatusChangeCallback.

	  int			 reason		  Indicates why the callback was
						  invoked:
						  DtCR_TERM_STATUS_CHANGE.
	  XEvent		 *event		  Points to the XEvent, if any,
						  that triggered the callback or
						  NULL.
	  int			 cursorX	  The current text cursor X
						  (column) position.
	  int			 cursorY	  The current text cursor Y (row)
						  position.
	  Boolean		 capsLock	  The current state of the caps
						  lock indicator.
	  Boolean		 stop		  The current state subprocess
						  output parsing.  Processing
						  output from the subprocess can
						  be turned on and off via the
						  stop() action (similar to the

     Page 11					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

						  XON/XOFF handshake invoked via
						  <control>-S/<control>-Q).
     DtTermInsertCharMode   insertCharMode   Not used by the DtTerm widget.
     Boolean		    locked	     The current state of the
					     keyboard caps lock.

	  A pointer to the DtTermSubprocessTerminationCallbackStruct
	  callback structure, which includes at least the following
	  members, is passed to callbacks for
	  DtNsubprocessTerminationCallback.

	  int	   reason   Indicates why the callback was invoked:
			    DtCR_TERM_SUBPROCESS_TERMINATION.
	  XEvent   *event   Points to the XEvent, if any, that
			    triggered the callback or NULL.
	  pid_t	   pid	    The process ID of the terminated
			    subprocess.
	  int	   status   The exit status of the terminated
			    subprocess.

	  A pointer to the DtTermInputVerifyCallbackStruct callback
	  structure, which includes at least the following members, is
	  passed to callbacks for DtNinputVerifyCallback.

	  int		  reason   Indicates why the callback was invoked:
				   DtCR_TERM_INPUT_VERIFY.
	  XEvent	  *event   Points to the XEvent, if any, that
				   triggered the callback or NULL.
	  Boolean	  doit	   Indicates whether the text should be
				   sent to the child process.  Setting doit
				   to False negates the action.
	  unsigned char	  *text	   Points to the text (either single- or
				   multi-byte depending on the locale) to
				   be sent to the child process.
	  int		  length   Specifies the number of bytes to be sent
				   to the child process.

	  A pointer to the DtTermOutputlogVerifyCallbackStruct
	  callback structure, which includes at least the following
	  members, is passed to callbacks for DtNoutputLogCallback.

	  int		  reason   Indicates why the callback was invoked:
				   DtCR_TERM_OUTPUT_LOG.
	  XEvent	  *event   Points to the XEvent, if any, that
				   triggered the callback or NULL.
	  unsigned char	  *text	   Points to the text (either single- or
				   multi-byte depending on the locale)
				   received from the child process.
				   Specifies the number of bytes received
				   from the child process.

     Page 12					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

	  int		  length

     Page 13					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

	Translations
	  The DtTerm widget includes translations from
	  XmPrimitive(3X).

	  Altering translations in #override or #augment mode is
	  undefined.

	      Key Pressed			Action Routine
      ____________________________________________________________________
      Shift ~Ctrl<Key>KP_Multiply:   XtDisplayInstalledAccelerators()
      ~Shift Ctrl<Key>KP_Multiply:   XtDisplayAccelerators()
      Shift Ctrl<Key>KP_Multiply:    XtDisplayTranslations()
      <Key>osfCancel:		     process-cancel()
      <Key>osfCopy:		     copy-clipboard()
      <Key>osfCut:		     copy-clipboard()
      <Key>osfPaste:		     paste-clipboard()
      <Key>osfBeginLine:	     beginning-of-buffer()
      <Key>osfEndLine:		     end-of-buffer()
      Shift<Key>osfUp:		     scroll(1,line)
      Shift<Key>osfDown:	     scroll(-1,line)
      <Key>osfUp:		     move-cursor(up)
      <Key>osfDown:		     move-cursor(down)
      <Key>osfLeft:		     move-cursor(backward)
      <Key>osfRight:		     move-cursor(forward)
      <Key>Do:			     vt-edit-key(do)
      <Key>Help:		     vt-edit-key(help)
      <Key>Menu:		     vt-edit-key(menu)
      <Key>Find:		     vt-edit-key(find)
      <Key>Insert:		     vt-edit-key(insert)
      <Key>Select:		     vt-edit-key(select)
      ~Shift<Key>osfPageUp:	     vt-edit-key(prior)
      ~Shift<Key>osfPageDown:	     vt-edit-key(next)
      <Key>osfPageUp:		     scroll(-1,page)
      <Key>osfPageDown:		     scroll(1,page)
      Mod1<Key>Break:		     soft-reset()
      Shift<Key>Break:		     hard-reset()
      ~Shift ~Mod1<Key>Break:	     vt-break()
      Ctrl<Key>Cancel:		     stop(long)
      ~Ctrl<Key>Cancel:		     stop()
      ~Shift<Key>Tab:		     tab()
      ~Mod1<Key>KP_Space:	     keypad-key-execute(space)
      ~Mod1<Key>KP_Tab:		     keypad-key-execute(tab)
      ~Mod1<Key>KP_Enter:	     keypad-key-execute(enter)
      ~Mod1<Key>KP_F1:		     keypad-key-execute(f1)
      ~Mod1<Key>KP_F2:		     keypad-key-execute(f2)
      ~Mod1<Key>KP_F3:		     keypad-key-execute(f3)
      ~Mod1<Key>KP_F4:		     keypad-key-execute(f4)
      ~Mod1<Key>KP_Equal:	     keypad-key-execute(equal)
      ~Mod1<Key>KP_Multiply:	     keypad-key-execute(multiply)
      ~Mod1<Key>KP_Add:		     keypad-key-execute(add)

     Page 14					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

      ~Mod1<Key>KP_Separator:	     keypad-key-execute(separator)
      ~Mod1<Key>KP_Subtract:	     keypad-key-execute(subtract)
      ~Mod1<Key>KP_Decimal:	     keypad-key-execute(decimal)
      ~Mod1<Key>KP_Divide:	     keypad-key-execute(divide)
      ~Mod1<Key>KP_0:		     keypad-key-execute(0)
      ~Mod1<Key>KP_1:		     keypad-key-execute(1)
      ~Mod1<Key>KP_2:		     keypad-key-execute(2)
      ~Mod1<Key>KP_3:		     keypad-key-execute(3)
      ~Mod1<Key>KP_4:		     keypad-key-execute(4)
      ~Mod1<Key>KP_5:		     keypad-key-execute(5)
      ~Mod1<Key>KP_6:		     keypad-key-execute(6)
      ~Mod1<Key>KP_7:		     keypad-key-execute(7)
      ~Mod1<Key>KP_8:		     keypad-key-execute(8)
      ~Mod1<Key>KP_9:		     keypad-key-execute(9)
      Shift<Key>F1:		     vt-function-key-execute(1, UDK)
      Shift<Key>F2:		     vt-function-key-execute(2, UDK)
      Shift<Key>F3:		     vt-function-key-execute(3, UDK)
      Shift<Key>F4:		     vt-function-key-execute(4, UDK)
      Shift<Key>F5:		     vt-function-key-execute(5, UDK)
      Shift<Key>F6:		     vt-function-key-execute(6, UDK)
      Shift<Key>F7:		     vt-function-key-execute(7, UDK)
      Shift<Key>F8:		     vt-function-key-execute(8, UDK)
      Shift<Key>F9:		     vt-function-key-execute(9, UDK)
      Shift<Key>F10:		     vt-function-key-execute(10, UDK)
      Shift<Key>F11:		     vt-function-key-execute(11, UDK)
      Shift<Key>F12:		     vt-function-key-execute(12, UDK)
      Shift<Key>F13:		     vt-function-key-execute(13, UDK)
      Shift<Key>F14:		     vt-function-key-execute(14, UDK)
      Shift<Key>F15:		     vt-function-key-execute(15, UDK)
      Shift<Key>F16:		     vt-function-key-execute(16, UDK)
      Shift<Key>F17:		     vt-function-key-execute(17, UDK)
      Shift<Key>F18:		     vt-function-key-execute(18, UDK)
      Shift<Key>F19:		     vt-function-key-execute(19, UDK)
      Shift<Key>F20:		     vt-function-key-execute(20, UDK)
      Shift<Key>F21:		     vt-function-key-execute(21, UDK)
      Shift<Key>F22:		     vt-function-key-execute(22, UDK)
      Shift<Key>F23:		     vt-function-key-execute(23, UDK)
      Shift<Key>F24:		     vt-function-key-execute(24, UDK)
      Shift<Key>F25:		     vt-function-key-execute(25, UDK)
      Shift<Key>F26:		     vt-function-key-execute(26, UDK)
      Shift<Key>F27:		     vt-function-key-execute(27, UDK)
      Shift<Key>F28:		     vt-function-key-execute(28, UDK)
      Shift<Key>F29:		     vt-function-key-execute(29, UDK)
      Shift<Key>F30:		     vt-function-key-execute(30, UDK)
      Shift<Key>F31:		     vt-function-key-execute(31, UDK)
      Shift<Key>F32:		     vt-function-key-execute(32, UDK)
      Shift<Key>F33:		     vt-function-key-execute(33, UDK)
      Shift<Key>F34:		     vt-function-key-execute(34, UDK)
      Shift<Key>F35:		     vt-function-key-execute(35, UDK)
      ~Shift<Key>F1:		     vt-function-key-execute(1, function)

     Page 15					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

      ~Shift<Key>F2:		     vt-function-key-execute(2, function)
      ~Shift<Key>F3:		     vt-function-key-execute(3, function)
      ~Shift<Key>F4:		     vt-function-key-execute(4, function)
      ~Shift<Key>F5:		     vt-function-key-execute(5, function)
      ~Shift<Key>F6:		     vt-function-key-execute(6, function)
      ~Shift<Key>F7:		     vt-function-key-execute(7, function)
      ~Shift<Key>F8:		     vt-function-key-execute(8, function)
      ~Shift<Key>F9:		     vt-function-key-execute(9, function)
      ~Shift<Key>F10:		     vt-function-key-execute(10, function)
      ~Shift<Key>F11:		     vt-function-key-execute(11, function)
      ~Shift<Key>F12:		     vt-function-key-execute(12, function)
      ~Shift<Key>F13:		     vt-function-key-execute(13, function)
      ~Shift<Key>F14:		     vt-function-key-execute(14, function)
      ~Shift<Key>F15:		     vt-function-key-execute(15, function)
      ~Shift<Key>F16:		     vt-function-key-execute(16, function)
      ~Shift<Key>F17:		     vt-function-key-execute(17, function)
      ~Shift<Key>F18:		     vt-function-key-execute(18, function)
      ~Shift<Key>F19:		     vt-function-key-execute(19, function)
      ~Shift<Key>F20:		     vt-function-key-execute(20, function)
      ~Shift<Key>F21:		     vt-function-key-execute(21, function)
      ~Shift<Key>F22:		     vt-function-key-execute(22, function)
      ~Shift<Key>F23:		     vt-function-key-execute(23, function)
      ~Shift<Key>F24:		     vt-function-key-execute(24, function)
      ~Shift<Key>F25:		     vt-function-key-execute(25, function)
      ~Shift<Key>F26:		     vt-function-key-execute(26, function)
      ~Shift<Key>F27:		     vt-function-key-execute(27, function)
      ~Shift<Key>F28:		     vt-function-key-execute(28, function)
      ~Shift<Key>F29:		     vt-function-key-execute(29, function)
      ~Shift<Key>F30:		     vt-function-key-execute(30, function)
      ~Shift<Key>F31:		     vt-function-key-execute(31, function)
      ~Shift<Key>F32:		     vt-function-key-execute(32, function)
      ~Shift<Key>F33:		     vt-function-key-execute(33, function)
      ~Shift<Key>F34:		     vt-function-key-execute(34, function)
      ~Shift<Key>F35:		     vt-function-key-execute(35, function)
      <KeyRelease>:		     key-release()
      <KeyPress>:		     insert()
      ~Shift~Ctrl<Btn1Down>:	     grab-focus()
      Shift~Ctrl<Btn1Down>:	     extend-start()
      ~Ctrl<Btn1Motion>:	     select-adjust()
      ~Ctrl<Btn1Up>:		     extend-end()
      ~Shift<Btn2Down>:		     process-bdrag()
      ~Shift<Btn2Up>:		     copy-to()
      <EnterWindow>:		     enter()
      <LeaveWindow>:		     leave()
      <FocusIn>:		     focus-in()
      <FocusOut>:		     focus-out()

	Action Routines
	  The DtTerm widget supports the following action routines:

	     bell([percentage])
		   Rings the keyboard bell at the specified percentage

     Page 16					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

		   above or below the base volume.

	     break()
		   Sends an RS232 break signal to the child process.

	     cancel()
		   Sends a CAN (cancel) character to the child
		   process.

	     copy-clipboard()
		   Copies current selection to the clipboard.

	     copy-to()
		   Sends the primary selection to the subprocess.

	     do()  Sends the escape sequence (see dtterm(5))
		   associated with the Do key to the child process.

	     edit-key(string)
		   Sends the escape sequence (see dtterm(5))
		   associated with the corresponding edit key to the
		   child process.  The interpretation of these keys is
		   application-specific.  Valid values for string are:

			find
			insert
			next
			prior
			remove
			select

	     extend-start()
		   Starts the extension of the currently selected
		   text.  The amount of text selected depends on the
		   number of mouse clicks (see grab-focus()).

	     extend-end()
		   Extends the current selection.  The amount of text
		   selected depends on the number of mouse clicks (see
		   grab-focus()).

	     function-key-execute(num[, type])
		   Sends the escape sequence (see dtterm(5))
		   associated with the corresponding function key num
		   to the child process.  Valid values for num are 1
		   to 35, inclusive.  If type is set to function (or
		   not set at all), the escape sequence (see
		   dtterm(5)) associated with function key num is sent
		   to the child process.  If type is set to UDK, then
		   the string associated with user defined key num is
		   sent to the child process.

     Page 17					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

	     grab-focus()
		   Performs one of the following depending on the
		   number of multiple mouse clicks.  One click
		   deselects any selected text and sets the selection
		   anchor at the pointer position; two clicks selects
		   a word; three clicks selects a line of text; and
		   four clicks selects all text.

	     hard-reset()
		   Performs a hard reset on the terminal emulator.
		   See dtterm(5) for a definition of hard reset.

	     help()
		   Sends the escape sequence (see dtterm(5))
		   associated with the DEC VT220 Help key to the child
		   process.  The interpretation of this key is
		   application-specific.

	     keymap(name)
		   Defines a new translation table whose resource name
		   is named with the suffix Keymap (case is
		   significant).  The name None restores the original
		   translation table.

	     keypad-key-execute(string)
		   Sends the escape sequence (see dtterm(5))
		   associated with the corresponding keypad key to the
		   child process.  The interpretation of these keys is
		   application-specific.  Valid values for string are:

			f1 - f4
			space
			tab
			enter
			equal
			multiply
			add
			separator
			subtract
			decimal
			divide
			0 - 9

	     move-cursor(direction)
		   Sends the escape sequence (see dtterm(5))
		   associated with the corresponding cursor motion to
		   the child process.  The interpretation of these
		   keys is application-specific.  Valid values for
		   direction are:

			up
			down

     Page 18					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

			backward
			forward

	     paste-clipboard()
		   Sends the contents of the clipboard to the
		   subprocess.

	     process-bdrag()
		   The result of this action is determined by several
		   factors:  position of the location cursor, motion
		   of the location cursor and the interval between a
		   BTransfer release.

		   This action sends the current selection to the
		   subprocess if text is selected, the location cursor
		   is disjoint from the current selection and no
		   motion is detected within a given time interval.

		   The action drags the current selection if the
		   location cursor is positioned on the selection, the
		   time interval is exceeded and movement of the
		   location cursor is detected.	 This action creates a
		   DragContext object whose XmNexportTargets resource
		   value includes target types of COMPOUND_TEXT,
		   STRING and TEXT.

	     redraw-display()
		   Redraws the contents of the text window.

	     scroll(count[, units])
		   Scrolls the display memory down if count is greater
		   than zero, or up if count is less than zero.	 The
		   number of lines scrolled is based on count and
		   units.  The default for units is line.  Valid
		   values for units are:

			page
			halfpage
			line

	     select-adjust()
		   Extends the selection.  The amount of text selected
		   depends on the number of mouse clicks.  One click
		   selects characters; two clicks selects words; three
		   clicks selects lines; and four clicks selects the
		   entire buffer.

	     select-all()
		   Selects all text.

	     select-page()
		   Selects all text currently displayed on the screen.

     Page 19					      (printed 9/3/04)

     DtTerm(3)	       UNIX System V (1 August 1995)	     DtTerm(3)

	     self-insert()
		   Sends the character associated with the key pressed
		   to the child process.

	     soft-reset()
		   Performs a soft reset of the terminal.  For a
		   definition of soft reset see the ``Reset'' section
		   in dtterm(5).

	     stop(state)
		   Toggles, starts, or stops the process of reading
		   data from the child process.	 Valid values for
		   state are:

			toggle
			on
			off

	     string(string)
		   Inserts the specified text string as if it had been
		   typed.  The string must be quoted if it contains
		   white space or non-alphanumeric characters.	The
		   string is interpreted as a hexadecimal character
		   constant if it begins with the characters 0x.

	     tab() Sends a tab to the child process.

	     visual-bell()
		   Flashes the window quickly.

	Virtual Bindings
	  The bindings for virtual keys are vendor-specific.  Virtual
	  bindings do not apply when the DtTerm widget has input
	  focus.  For information about bindings for virtual buttons
	  and keys, see VirtualBindings(3X).

     SEE ALSO
	  dtterm(1), DtTerm(5), DtTermInitialize(3),
	  DtTermDisplaySend(3), DtTermSubprocSend(3),
	  DtTermSubprocReap(3), dtterm(5), pty(7), XtSetValues(1X),
	  XtGetValues(1X), XmFrame(3X), XmPrimitive(3X),
	  XmFontList(3X), XmBulletinBoard(3X), XmText(3X),
	  VirtualBindings(3X), Core(3X).

     Page 20					      (printed 9/3/04)

[top]

List of man pages available for IRIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net