hpterm man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

HPTERM(1X)							    HPTERM(1X)

NAME
       hpterm - X window system Hewlett-Packard terminal emulator.

SYNOPSIS
       hpterm [-toolkitoption] [-option]

DESCRIPTION
       The  hpterm program is a terminal emulator for the X Window system.  It
       provides a Term0 compatible terminal for programs that  can't  use  the
       window  system  directly.  It also emulates many of the block mode fea‐
       tures of HP terminals.  Refer to the WARNINGS section below  for	 addi‐
       tional information about running block mode applications.

OPTIONS
       The hpterm terminal emulator accepts all of the standard X Toolkit com‐
       mand line options along with additional options all of which are listed
       below  (if the option begins with a `+' instead of a `-', the option is
       restored to its default value):

       -b number
	       This option specifies the size of the inner  border  (the  dis‐
	       tance  between  the  outer edge of the character and the window
	       border) in pixels.  Associated resource: *borderWidth.

       -background color
	       This option specifies the color to use for  the	background  of
	       the window.  Associated resource: *background.

       -bd color
	       This  option  specifies	the color to use for the border of the
	       window.	Associated resource: *borderColor.

       -bg color
	       This option specifies the color to use for  the	background  of
	       the window.  Associated resource: *background.

       -borderwidth number
	       This  option  specifies	the width in pixels of the border sur‐
	       rounding the window.  Associated resource: *borderWidth.

       -bs     This option indicates that the "background" of the  term0  text
	       entry window should be the select color that corresponds to the
	       specified  background  color.   Associated   resource:	*back‐
	       groundIsSelect.

       +bs     This  option  indicates that the "background" of the term0 text
	       entry window should be the  specified  background.   Associated
	       resource: *backgroundIsSelect.

       -bw number
	       This  option  specifies	the width in pixels of the border sur‐
	       rounding the window.  Associated resource: *borderWidth.

       -cr color
	       This option specifies the color to use  for  the	 text  cursor.
	       Associated resource: *cursorColor.

       -display display
	       This option specifies the X server to contact; see X(1).	 Asso‐
	       ciated resource: none.

       -e command
	       This option specifies the command (and its command  line	 argu‐
	       ments) to be run in the hpterm window.  The default is to start
	       the user's shell.  This must be the last option on the  command
	       line.  Associated resource: none.

       -fb fontset
	       This  option  specifies	a font to be used when displaying bold
	       (alternate) text.  This font must be the same height and	 width
	       as  the normal (primary) font.  If only one of the normal (pri‐
	       mary) or bold (alternate) fonts is specified, it will  be  used
	       for  both  fonts.   The	fontset should be specified as a Motif
	       XmFontList(3X).	Associated resource: *userBoldFont.

       -fg color
	       This option specifies the color to  use	for  displaying	 text.
	       Associated resource: *foreground.

       -fn fontset
	       This  option specifies a font to be used when displaying normal
	       (primary) text.	If only one of the normal  (primary)  or  bold
	       (alternate) fonts is specified, it will be used for both fonts.
	       The fontset should be  specified	 as  a	Motif  XmFontList(3X).
	       Associated resource: *userFont.

       -font fontset
	       This  option specifies a font to be used when displaying normal
	       (primary) text.	If only one of the normal  (primary)  or  bold
	       (alternate) fonts is specified, it will be used for both fonts.
	       The fontset should be  specified	 as  a	Motif  XmFontList(3X).
	       This  option  is	 provided for backwards compatability only and
	       will be removed in the next major release of HP-UX; use the -fn
	       option instead.	Associated resource: *userFont.

       -foreground color
	       This  option  specifies	the  color to use for displaying text.
	       Associated resource: *foreground.

       -geometry geometry
	       This option specifies the preferred size and  position  of  the
	       hpterm window; see X(1).	 Associated resource: hpterm*geometry.

       -help   This  option will display a help message.  Associated resource:
	       none.

       -i      This option indicates that hpterm should supply the window man‐
	       ager with a bitmapped icon.  Associated resource: bitmapIcon.

       +i      This  option  indicates that the window manager should generate
	       its own icon for hpterm.	 Associated resource: bitmapIcon.

       -iconic This option indicates that hpterm should be placed on the  dis‐
	       play in icon form.  Associated resource: *term0.iconic.

       +iconic This  option  indicates that hpterm should not be placed on the
	       display in icon form.  Associated resource: *term0.iconic.

       -kshmode
	       This option indicates that  hpterm  should  convert  characters
	       entered	with  the  extend  key	pressed	 into  a two character
	       sequence consisting of an ASCII	escape	followed  by  the  un-
	       extended character.  Associated resource: *kshMode.

       -l      This option indicates that hpterm should send all terminal out‐
	       put to a log  file  as  well  as	 to  the  screen.   Associated
	       resource: *logging.

       +l      This option indicates that hpterm should not do logging.	 Asso‐
	       ciated resource: *logging.

       -lf file
	       This option specifies the name of the file to which the	output
	       log  described  above  is  written.  If file begins with a pipe
	       symbol (|), the rest of the string is assumed to be  a  command
	       to  be used as the endpoint of a pipe.  The default filename is
	       HptermLogXXXXX (where XXXXX is the process id of hpterm) and is
	       created	in the directory from which hpterm was started.	 Asso‐
	       ciated resource: *logFile.

       -ls     This option indicates that the shell that  is  started  in  the
	       hpterm window should be a login shell (i.e. the first character
	       of argv[0] will be a dash, indicating  to  the  shell  that  it
	       should  read  the user's /etc/profile and .profile (for ksh and
	       sh) or /etc/csh.login and .login (for  csh).   This  option  is
	       ignored	when the -e option is also used.  Associated resource:
	       *loginShell.

       +ls     This option indicates that the shell that is started should not
	       be  a  login  shell  (i.e.  it  will be a normal ``subshell'').
	       Associated resource: *loginShell.

       -map    This option  indicates  that  hpterm  should  map  (de-iconify)
	       itself  upon pty output if it is unmapped (iconified).  An ini‐
	       tial period of time during which hpterm	will  not  map	itself
	       upon  pty  output  may  be  specified  via the mapOnOutputDelay
	       resource.  Associated resource: *mapOnOutput.

       +map    This option indicates that hpterm should not  map  (de-iconify)
	       itself  upon pty output if it is unmapped (iconified).  Associ‐
	       ated resource: *mapOnOutput.

       -mb     This option indicates that the pointer  cursor  should  be  put
	       into blanking mode.  In this mode, the cursor will turn on when
	       the pointer is moved,  and  will	 be  blanked  either  after  a
	       selectable  number  of  seconds	or  after  keyboard  input has
	       occurred.  The delay is set via the pointerBlankDelay resource.
	       Associated resource: *pointerBlank.

       +mb     This option indicates that the pointer cursor should remain on.
	       Associated resource: *pointerBlank.

       -mc mode
	       This option determines how hpterm will generate the  foreground
	       color,  shadow  colors,	and  shadow tiles of the scrollbar and
	       softkey widgets.	 Valid	modes  are  ``all'',  ``shadow'',  and
	       ``none.''  Associated resource: *makeColors.

       -ms color
	       This option specifies the color to be used for the pointer cur‐
	       sor.  Associated resource: *pointerColor.

       -name name
	       This  option  specifies	the  application  name	 under	 which
	       resources  are  to  be  obtained,  rather than the default exe‐
	       cutable file name (``hpterm'').	Associated resource: .name.

       -reverse
	       This option indicates that reverse video should be simulated by
	       swapping	 the  foreground  and  background  colors.  Associated
	       resource: *reverseVideo.

       -rv     This option indicates that reverse video should be simulated by
	       swapping	 the  foreground  and  background  colors.  Associated
	       resource: *reverseVideo.

       +rv     This option indicates that reverse video should	not  be	 simu‐
	       lated.  Associated resource: *reverseVideo.

       -sb     This  option  indicates	that  a scrollbar should be displayed.
	       Associated resource: *scrollBar.

       +sb     This option indicates that a scrollbar should not be displayed.
	       Associated resource: *scrollBar.

       -sbbg color
	       This  option  specifies	the color to use for the background of
	       the scrollbar window.   Associated  resource:  *scrollBar.back‐
	       ground.

       -sbfg color
	       This  option  specifies	the color to use for the foreground of
	       the scrollbar window.  This value will be ignored if the	 make‐
	       Colors  resource	 is set to all.	 Associated resource: *scroll‐
	       Bar.foreground.

       -skbg color
	       This option specifies the color to use for  the	background  of
	       the softkey window.  Associated resource: *softkey.background.

       -skfg color
	       This  option  specifies the color to use for displaying softkey
	       text.  This value will be ignored if the makeColors resource is
	       set to all.  Associated resource: *softkey.foreground.

       -skfn fontset
	       This option specifies a font to be used when displaying softkey
	       text.   The  fontset   should   be   specified	as   a	 Motif
	       XmFontList(3X).	Associated resource: *softkey.userFont.

       -sl number[suffix]
	       This  option  indicates	the  number  of off screen lines to be
	       saved in the terminal buffer.  If no suffix is included or  the
	       suffix  is  l,  the total length of the terminal buffer will be
	       number plus the length of the terminal window.  If  the	suffix
	       is  s  the  total length of the terminal buffer will be (number
	       plus one) times the length of the terminal window.   Associated
	       resource: *saveLines.

       -ti name
	       This option specifies a name for hpterm to use when identifying
	       itself to application programs.	Refer to the WARNINGS  section
	       for  additional	information about using hpterm with block mode
	       applications.  Associated resource: *termId.

       -title name
	       This option specifies a window title for hpterm.	  This	string
	       may  be used by the window manager when displaying the applica‐
	       tion.  Associated resource: *title.

       -tm string
	       This option specifies a string containing terminal-setting key‐
	       words  and  the characters to which they may be bound.  Associ‐
	       ated resource: *ttyModes.

       -tn name
	       This option specifies a name for hpterm to set the $TERM	 envi‐
	       ronment variable to.  Associated resource: *termName.

       -vb     This  option  indicates that a visual bell is preferred over an
	       audible one.  Instead of ringing the terminal bell  whenever  a
	       Control-G  is received, the window will be flashed.  Associated
	       resource: *visualBell.

       +vb     This option indicates that a visual bell should	not  be	 used.
	       Associated resource: *visualBell.

       -xrm resourcestring
	       This  option  specifies	a resource string to be used.  This is
	       especially useful for setting resources that do not have	 sepa‐
	       rate command line options.  Associated resource: none.

       -C      This  option  indicates	that the window should receive console
	       output.	The server must be authorized to receive console  out‐
	       put.   See  ``XConsoles''  below	 for  additional  information.
	       Associated resource: none.

       -Sccn   This option specifies the last two letters of  the  name	 of  a
	       pseudoterminal to use in slave mode, and the file descriptor of
	       the pseudoterminal's master.  This allows hpterm to be used  as
	       an  input  and  output  channel	for an existing program and is
	       sometimes used in  specialized  applications  such  as  pam(1).
	       This  option  will  only	 work  with  pty  names	 of  the  form
	       ``ttyxx.''  For example, ``-S p01'' specifies ``ttyp0'' on file
	       descriptor 1.  Associated resource: none.

       -Spty.fd
	       This option specifies the unique portion of the name of a pseu‐
	       doterminal to use in slave mode, and the file descriptor of the
	       pseudoterminal's	 master.   This allows hpterm to be used as an
	       input and output channel for an existing program and  is	 some‐
	       times  used  in	specialized applications such as pam(1).  This
	       option will work for all pty names.  For example,  ``-S	p0.1''
	       specifies  ``ttyp0''  on	 file  descriptor  1 and ``-S p02.13''
	       specifies  ``ttyp02''  on  file	descriptor   13.    Associated
	       resource: none.

	      The  following  command line arguments are provided for compati‐
	      bility with
	      older versions.  They may not be supported in future releases as
	      the X Toolkit provides standard options that accomplish the same
	      task.

       Thisoptionspecifiesthepreferredpositionoftheiconwindow.
	       It is shorthand	for  specifying	 the  *iconGeometry  resource.
	       Associated resource: .iconGeometry.

       -T string
	       This  option  specifies	the  title for hpterm's window.	 It is
	       equivalent to -title string.  Associated resource: *title.

       -n string
	       This option specifies the icon name for hpterm's	 windows.   It
	       is shorthand for specifying the *iconName resource.  Associated
	       resource: *iconName.

       -r      This option indicates that reverse video should be simulated by
	       swapping	 the  foreground and background colors.	 It is equiva‐
	       lent to -reversevideo or -rv.  Associated resource:  *reverseV‐
	       ideo.

       +r      This  option  indicates	that reverse video should not be simu‐
	       lated.  It is equivalent to +rv.	 Associated resource:  *rever‐
	       seVideo.

       -w number
	       This  option  specifies	the width in pixels of the border sur‐
	       rounding the window.  It is equivalent to  -borderwidth	number
	       or -bw number.  Associated resource: *borderWidth.

RESOURCES
       The  hpterm  window  consists  of a Motif shell widget which contains a
       form widget.  The form widget contains a term0 widget,  scrollbar  wid‐
       get, and softkey widget.	 Resources specific to the shell widget are:

			     hpterm Resource Set
	   Name		  Class		 Type	  Default
	   ─────────────────────────────────────────────────────────
	   borderColor	  BorderColor	 Pixel	  black
	   borderWidth	  BorderWidth	 int	  2
	   geometry	  Geometry	 string
	   iconGeometry	  IconGeometry	 string
	   name		  Name		 string	  hpterm
	   title	  Title		 string	  Terminal emulator

       borderColor
	      This resource defines the border color of the hpterm window.

       borderWidth
	      This  resource  specifies the width of the hpterm window border.
	      This value may be modified by the window manager.

       geometry
	      This resource specifies the preferred size and position  of  the
	      hpterm window.

       iconGeometry
	      This  resource  specifies	 the  preferred	 size  and position of
	      hpterm when iconified.  It is not necessarily obeyed by all win‐
	      dow managers.

       name   This resource specifies the name of the instance of the program.
	      It is used when extracting resources from the resource database.

       title  This resource specifies  the  window  title  for	hpterm.	  This
	      string  may  be  used by the window manager when displaying this
	      application.

			      term0 Resource Set
Name		       Class		      Type	     Default
────────────────────────────────────────────────────────────────────────────────
allowSendEvents	       AllowSendEvents	      Boolean	     FALSE
background	       Background	      Pixel	     ``white''
backgroundIsSelect     BackgroundIsSelect     string	     FALSE
bitmap		       Bitmap		      string
bitmapIcon	       BitmapIcon	      Boolean	     FALSE
boldFont	       UserBoldFont	      XmFontList     dynamic
copyLine	       CopyLine		      string	     ``right''
cursorColor	       Foreground	      Pixel	     ``black''
cut		       Cut		      string	     ``left''
dc1Handshake	       Dc1Handshake	      DC1Handshake   ``auto''
flashBorder	       FlashBorder	      Boolean	     FALSE
foreground	       Foreground	      Pixel	     ``black''
fnAttribute	       SoftkeyAttribute	      int	     2
fnLabel		       SoftkeyLabel	      string	     see below
fnString	       SoftkeyString	      string	     see below
halfBrightInhibit      HalfBrightInhibit      Boolean	     FALSE
iconic		       Iconic		      Boolean	     FALSE
internalBorder	       BorderWidth	      int	     2
kshMode		       KshMode		      Boolean	     FALSE
logFile		       LogFile		      string	     ``HptermLogXXXXX''
logging		       Logging		      Boolean	     FALSE
loginShell	       LoginShell	      Boolean	     FALSE
makeColors	       MakeColors	      string	     ``none''
mapOnOutput	       AutoMap		      Boolean	     FALSE
mapOnOutputDelay       MapDelay		      int	     0
paste		       Paste		      string	     ``middle''
pointerBlank	       PointerBlank	      Boolean	     FALSE
pointerBlankDelay      PointerBlankDelay      int	     3
pointerColor	       Foreground	      Pixel	     ``black''
pointerShape	       PointerShape	      string	     ``xterm''
reverseVideo	       ReverseVideo	      Boolean	     FALSE
roman8		       Roman8		      Boolean	     TRUE
saveLines	       SaveLines	      string	     ``1s''
scrollBar	       ScrollBar	      Boolean	     FALSE
softkeyInitialize16    SoftkeyInitialize16    Boolean	     FALSE
softkeyInitializeAll   SoftkeyInitializeAll   Boolean	     FALSE
softkeyLast	       SoftkeyLast	      int	     16
softkeySelect	       SoftkeySelect	      string	     ``left''
stickyNextCursor       StickyCursor	      Boolean	     TRUE
stickyPrevCursor       StickyCursor	      Boolean	     TRUE
termId		       TermId		      string	     ``hpterm''
termName	       TermName		      string	     ``hpterm''
ttyModes	       TtyModes		      string	     none
userBoldFont	       UserBoldFont	      XmFontList     dynamic
userFont	       UserFont		      XmFontList     dynamic
visualBell	       VisualBell	      Boolean	     FALSE

       allowSendEvents
	      This resource defines whether synthetic key  and	button	events
	      (generated  using	 the  X	 protocol SendEvent request) should be
	      interpreted or discarded.

       background
	      This resource defines the background color of the text window.

       backgroundIsSelect
	      This resource controls the color used as the "background" of the
	      term0  text entry window and defaults to False.  When False, the
	      background is the color specified.  When True, the background is
	      the "select color" that corresponds to the background.  For vis‐
	      ual consistency with other Motif-based  applications,  set  this
	      resource to True.

       bitmap This  resource defines whether hpterm will override its built in
	      bitmap icon with a user specified bitmap icon.  If the path does
	      not  begin with a ``/'' or ``./'', it will be processed relative
	      to ``/usr/lib/X11/bitmaps''.

       bitmapIcon
	      This resource defines whether hpterm will supply the window man‐
	      ager  with a bitmapped icon.  The supplied bitmap may be ignored
	      by the window manager.

       boldFont
	      This resource defines the font used for bold  (alternate)	 text.
	      This  resource  is provided for backwards compatability only and
	      will be removed in the next major	 release  of  HP-UX;  use  the
	      "userBoldFont" resource instead.

       copyLine
	      This resource defines the pointer button/modifier combination to
	      be used  to  activate  the  CopyLine  function.	See  ``POINTER
	      USAGE'' below.

       cursorColor
	      This resource defines the text cursor color.  The pointer cursor
	      color is defined by the pointerColor resource.

       cut    This resource defines the pointer button/modifier combination to
	      be  used	to  activate  the Cut function.	 See ``POINTER USAGE''
	      below.

       dc1Handshake
	      This resource controls how DC1/DC2 handshaking  is  enabled  for
	      transferring  data between hpterm and the application requesting
	      the data.	 This resource can have one of three values: ``auto'',
	      ``enabled'',  or	``disabled''.	When  set  to ``disabled'', no
	      handshaking is required for transferring data from hpterm to the
	      application;  when  set  to ``enabled'', the handshaking mode is
	      controlled strictly by the state of the InhHndShk (strap G)  and
	      InhDC2 (strap H) flags.  Setting dc1Handshake to ``auto'' causes
	      hpterm to start out with DC1 handshaking initially disabled,  it
	      is  automatically	 enabled  the first time hpterm receives a DC1
	      character and is once again controlled by the state of the InhH‐
	      ndShk (strap G) and InhDC2 (strap H) flags.

       flashBorder
	      This  resource  defines whether hpterm window border will change
	      color when the pointer cursor enters or leaves the window.

       foreground
	      This resource defines the foreground (text) color	 of  the  text
	      window.

       fnAttribute
	      This  resource defines the softkey attribute for softkey n (1 to
	      softkeyLast).  If	 softkeyInitializeAll  is  true,  all  softkey
	      attributes  can  be initialized.	If it is false, only the first
	      softkeyLast / 2 softkey attributes can be initialized.

       fnLabel
	      This resource defines the softkey label  for  softkey  n	(1  to
	      softkeyLast).   If  softkeyInitializeAll	is  true,  all softkey
	      labels can be initialized.  If it is false, only the first soft‐
	      keyLast  /  2  softkey  labels  can be initialized.  The default
	      labels for softkeys 1 to softkeyLast  /  2  are  ``f1''  through
	      ``fsoftkeyLast  /	 2''.	The  default  labels for the remaining
	      softkeys are empty if softkeyInitializeAll is  false,  otherwise
	      they are ``fsoftkeyLast / 2 + 1'' through ``fsoftkeyLast''.

       fnString
	      This  resource  defines  the  softkey string for softkey n (1 to
	      softkeyLast).  If softkeyInitializeAll is true, all  softkeyLast
	      softkey  strings	can  be initialized.  If it is false, only the
	      first softkeyLast / 2 softkey strings can be  initialized.   The
	      default  strings	for  softkeys  1  to  8 are ``<esc>p'' through
	      ``<esc>w''; the default strings for the remaining	 softkeys  are
	      empty.

       halfBrightInhibit
	      This  resource  defines whether half-bright enhancements will be
	      not be generated.	 When true,  full-bright  characters  will  be
	      used instead of half-bright characters.

       iconic This  resource  defines  whether	hpterm will start up in iconic
	      form.

       internalBorder
	      This resource defines the number of pixels between  the  charac‐
	      ters and the window border.

       kshMode
	      This  resource  defines whether hpterm will operate in ksh mode.
	      In ksh mode, hpterm converts characters entered with the	extend
	      key pressed into a two-character sequence consisting of an ASCII
	      escape followed by the un-extended character.

       logFile
	      This resource defines the name of the file to which  a  terminal
	      session  is  logged.   The  default is ``HptermLogXXXXX'' (where
	      XXXXX is the process id of hpterm).

       logging
	      This resource defines whether a terminal session will be logged.
	      It is also available at runtime via the Device Control menu.

       loginShell
	      This  resource defines whether the shell to be run in the window
	      will be started as a login shell (i.e., the first	 character  of
	      argv[0]  will  be a dash, indicating to the shell that it should
	      read the user's /etc/profile and .profile (for ksh  and  sh)  or
	      /etc/csh.login and .login (for csh).

       makeColors
	      This  resource is provided for backward compatibility with older
	      versions of hpterm; since it may	not  be	 supported  in	future
	      releases,	 it  is	 no longer recommended for use.	 This resource
	      defines how the bottomShadowColor,  foreground,  and  topShadow‐
	      Color  resources	of  the	 scrollbar and softkey widgets will be
	      generated and how the foreground resource of  the	 term0	widget
	      will  be	generated.   If the value of this resource is ``all'',
	      then hpterm will use the value of the background resource of the
	      term0  widget  to	 generate  a value for the foreground, and the
	      background resource of the softkey and scrollbar widgets to gen‐
	      erate values for the bottomShadowColor, foreground, and topShad‐
	      owColor resources such that there is a 3-D look.	In  this  case
	      the topShadowTile and bottomShadowTile are always set to ``fore‐
	      ground.''	 If the makeColors resource value  is  ``shadow''  the
	      bottomShadowColor and topShadowColor will be generated but fore‐
	      ground will not be generated.  If the makeColors resource	 value
	      is set to ``none'' then no colors will be generated.

       mapOnOutput
	      This  resource  defines  whether	hpterm	will  map (de-iconify)
	      itself upon pty output if it is unmapped (iconified).   An  ini‐
	      tial period of time during which hpterm will not map itself upon
	      pty output may be specified to allow hpterm to  not  map	itself
	      upon  initial  shell output.  The delay is set via the mapOnOut‐
	      putDelay resource.

       mapOnOutputDelay
	      This resource defines the number of seconds  at  startup	during
	      which hpterm will not map (de-iconify) itself upon pty output.

       paste  This resource defines the pointer button/modifier combination to
	      be used to activate the Paste function.  See  ``POINTER  USAGE''
	      below.

       pointerBlank
	      This resource defines whether hpterm will put the pointer cursor
	      into blanking mode.  In blanking mode, the pointer  cursor  will
	      turn  on	when  the pointer is moved, and will be blanked either
	      after a selectable number of seconds or after keyboard input has
	      occurred.	 The delay is set via the pointerBlankDelay resource.

       pointerBlankDelay
	      This  resource  defines  the  number  of	seconds to wait before
	      blanking the pointer cursor after the pointer  has  been	moved.
	      When  set	 to  ``0'', the pointer will be blanked only upon key‐
	      board input.

       pointerColor
	      This resource defines the pointer cursor color.  The text cursor
	      color is defined by the cursorColor resource.

       pointerShape
	      This  resource  defines  the pointer cursor shape.  Valid cursor
	      shapes may  be  found  in	 the  file  ``/usr/include/X11/cursor‐
	      font.h.''	  Shapes  are  specified  as the name with the leading
	      ``XC_'' dropped.	 Valid	cursor	shapes	include	 ``left_ptr'',
	      ``crosshair'', and ``xterm.''

       reverseVideo
	      This resource defines whether reverse video will be simulated by
	      swapping the foreground and background colors.

       roman8 This resource controls the mapping of keys to characters and  is
	      effective	 only for western european keyboards.  Roman8 encoding
	      is used when set to TRUE, ISO 8859-1 encoding is used  when  set
	      to  FALSE.  (It is the user's responsibility to ensure that cor‐
	      rectly encoded fonts are used; refer to the discussion on	 fonts
	      in your Using the X Window System Manual for more information on
	      font characteristics.)

       saveLines
	      This resource 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'' the total length of the ter‐
	      minal buffer will be number plus the length of the terminal win‐
	      dow.   If	 the  suffix is ``s'' the total length of the terminal
	      buffer will be (number plus one) times the length of the	termi‐
	      nal window.  Hpterm will try to maintain the same buffer to win‐
	      dow ratio when the window is resized larger.

       scrollBar
	      This resource defines whether the scrollbar will be displayed.

       softkeyInitialize16
	      This resource enables initialization of  all  softkeyLast	 soft‐
	      keys.   If false, only the first softkeyLast / 2 softkeys can be
	      initialized via resources.  (This resource has  been  superceded
	      by  softkeyInitializeAll,	 and  will  be	eliminated in the next
	      release of HP-UX.)

       softkeyInitializeAll
	      This resource enables initialization of  all  softkeyLast	 soft‐
	      keys.   If false, only the first softkeyLast / 2 softkeys can be
	      initialized via resources.

       softkeyLast
	      This resource tells hpterm the maximum number of	user  softkeys
	      to  recognize  (16  or  24).   The  only	valid  values for this
	      resource are 16 or 24; values greater than 16 are forced to  24,
	      values less then 16 are forced to 16.

       softkeySelect
	      This resource defines the pointer button/modifier combination to
	      be used for selecting softkeys.  See ``POINTER USAGE'' below.

       stickyNextCursor
	      This resource defines whether the cursor should  be  homed  when
	      the  Next	 key is pressed.  When true, the cursor will be in the
	      same screen position after the key is pressed  that  it  was  in
	      before  pressing	the key.  When false, the cursor will be moved
	      to the upper left hand corner of the screen  after  the  key  is
	      pressed.

       stickyPrevCursor
	      This  resource  defines  whether the cursor should be homed when
	      the Prev key is pressed.	When true, the cursor will be  in  the
	      same  screen  position  after  the key is pressed that it was in
	      before pressing the key.	When false, the cursor will  be	 moved
	      to  the  upper  left  hand corner of the screen after the key is
	      pressed.

       termId This resource defines the name for hpterm to use when  identify‐
	      ing  itself to application programs.  Refer to the WARNINGS sec‐
	      tion for additional information about using  hpterm  with	 block
	      mode applications.

       termName
	      This resource defines the string for setting the ``$TERM'' envi‐
	      ronment variable.

       ttyModes
	      This resource specifies  a  string  containing  terminal-setting
	      keywords	and the characters to which they may be bound.	Allow‐
	      able keywords include: intr, quit, erase, kill, eof, eol, swtch,
	      start,  stop,  brk, susp, dsusp, rprnt, flush, weras, and Inext.
	      Control characters may be specified as ^char (e.g.  ^c  or  ^u),
	      and  ^? may be used to indicate delete.  This is very useful for
	      overriding the default terminal settings without having to do an
	      stty every time an hpterm is started.

       userBoldFont
	      This resource defines the font used for bold (alternate) text.

       userFont
	      This resource defines the font used for normal (primary) text.

       visualBell
	      This  resource  defines  whether	a visible bell (i.e. flashing)
	      should be used instead of an  audible  bell  when	 Control-G  is
	      received.

       The following resources are specified as part of the ``softkey'' widget
       (name ``softkey'', class ``Softkey'').  For example, the softkey	 user‐
       Font resource would be specified one of:

					  HPterm*softkey*userFont:   hp8.8x16
					  HPterm*Softkey*userFont:   hp8.8x16
					  *Softkey*UserFont:	     hp8.8x16

       Additional  resources  and  information	can  be	 found in the XmPrimi‐
       tive(3X) and CORE(3X) man pages along with additional information about
       the various shadow options.

			      Softkey Resource Set
Name		    Class	       Type	    Default
──────────────────────────────────────────────────────────────────────────────────
background	    Background	       Pixel	    ``white''
bottomShadowColor   Foreground	       Pixel	    ``black'' (see below)
bottomShadowTile    BottomShadowTile   string	    ``foreground'' (see below)
foreground	    Foreground	       Pixel	    ``black'' (see below)
topShadowColor	    Background	       Pixel	    ``white'' (see below)
topShadowTile	    TopShadowTile      string	    ``50_foreground'' (see below)
userFont	    UserFont	       XmFontList   dynamic

       background
	      This  resource  defines the background color of the softkey win‐
	      dow.

       bottomShadowColor
	      This resource defines the color that is combined with the bottom
	      shadow tile and foreground color to create a pixmap used to draw
	      the bottom and right sides of the softkey borders.  This may  be
	      overridden by the term0 makeColors resource described above.

       bottomShadowTile
	      This  resource defines the tile used in creating the pixmap used
	      for drawing the bottom and right shadows for  the	 softkey  bor‐
	      ders.  Valid tile names are described in XmCreateTile(3X).  This
	      may be overridden by the	term0  makeColors  resource  described
	      above.

       foreground
	      This resource defines the foreground (text) color of the softkey
	      window.  This may be overridden by the term0 makeColors resource
	      described above.

       topShadowColor
	      This  resource  defines  the color that is combined with the top
	      shadow tile and foreground color to create a pixmap used to draw
	      the  top	and  left  sides  of the softkey borders.  This may be
	      overridden by the term0 makeColors resource described above.

       topShadowTile
	      This resource defines the tile used in creating the pixmap  used
	      for  drawing  the	 top and left shadows for the softkey borders.
	      Valid tile names are described in XmCreateTile(3X).  This may be
	      overridden by the term0 makeColors resource described above.

       userFont
	      This resource defines the font used for softkey text.  The soft‐
	      key font will default to the normal (primary) font of  the  text
	      window.

       The  following  resources  are specified as part of the ``Xmscrollbar''
       widget (name ``scrollBar'', class ``ScrollBar'').  Some example scroll‐
       bar resources are:

					  HPterm*scrollBar*initialDelay:   10
					  HPterm*ScrollBar*RepeatRate:	   10
					  *ScrollBar*Granularity:	   1
					  hpterm*scrollBar*width:	   20

       Additional  resources  and  information	can  be	 found in the XmPrimi‐
       tive(3X), XmScrollBar(3X), XmValuator(3X), and Core(3X) man pages along
       with additional information about the various shadow options.

      Scrollbar Resource Set (name ``scrollBar'', class ``ScrollBar'')
Name		    Class	       Type	Default
──────────────────────────────────────────────────────────────────────────────
background	    Background	       Pixel	``white''
bottomShadowColor   Foreground	       Pixel	``black'' (see below)
bottomShadowTile    BottomShadowTile   string	``foreground'' (see below)
foreground	    Foreground	       Pixel	``black'' (see below)
granularity	    Granularity	       int	2
initialDelay	    InitialDelay       int	500
repeatRate	    RepeatRate	       int	100
topShadowColor	    Background	       Pixel	``white'' (see below)
topShadowTile	    TopShadowTile      string	``50_foreground'' (see below)
width		    Width	       int	10

       background
	      This resource defines the background color of the scrollbar win‐
	      dow.

       bottomShadowColor
	      This resource defines the color that is combined with the bottom
	      shadow tile and foreground color to create a pixmap used to draw
	      the bottom and right sides of the scrollbar borders.   This  may
	      be overridden by the term0 makeColors resource described above.

       bottomShadowTile
	      This  resource defines the tile used in creating the pixmap used
	      for drawing the bottom and right shadows for the scrollbar  bor‐
	      ders.  Valid tile names are described in XmCreateTile(3X).  This
	      may be overridden by the	term0  makeColors  resource  described
	      above.

       foreground
	      This resource defines the foreground color of the scrollbar win‐
	      dow.  This may be overridden by the  term0  makeColors  resource
	      described above.

       granularity
	      This  resource defines the number of lines to advance the slider
	      when the button is being held down on an arrow.	The  value  is
	      defined in milliseconds.

       initialDelay
	      This  resource  defines  the  delay to wait between the time the
	      button is held down on an arrow before  the  slider  starts  its
	      repetitive movement.  The value is defined in milliseconds.

       repeatRate
	      This  resource defines the continuous repeat rate to use to move
	      the slider while the button is being held down on an arrow.  The
	      value is also defined in milliseconds.

       topShadowColor
	      This  resource  defines  the color that is combined with the top
	      shadow tile and foreground color to create a pixmap used to draw
	      the  top	and  left sides of the scrollbar borders.  This may be
	      overridden by the term0 makeColors resource described above.

       topShadowTile
	      This resource defines the tile used in creating the pixmap  used
	      for  drawing the top and left shadows for the scrollbar borders.
	      Valid tile names are described in XmCreateTile(3X).  This may be
	      overridden by the term0 makeColors resource described above.

       width  This resource defines the width of the scrollbar in pixels.

POINTER USAGE
       Hpterm  allows  you  to cut and paste text within its own or other win‐
       dows.  All cutting and pasting is done  using  the  PRIMARY  selection.
       (To  maintain compatability with previous versions of hpterm (and other
       applications that use cut buffers), the cutting	and  pasting  is  also
       done  to/from  the  first global cut buffer.  When pasting, hpterm gets
       its text from the PRIMARY selection; if the PRIMARY  selection  is  not
       owned, or the current owner cannot supply the data as text, hpterm will
       try to get its data from the first global  cut  buffer.)	  The  PRIMARY
       selection  will be disowned (and the selected text unhighlighted) under
       the following conditions:

	 1)
	   the cursor is moved anywhere	 before	 the  end  of  the  selected
	   region

	 2)
	   the beginning of the selected region is scrolled off the end of
	   the terminal buffer

	 3)
	   the selected region is scrolled across the boundaries of  the
	   locked region when memory lock is enabled.

       The  default  button  assignments  may  be  changed  via	 various
       resource strings.  The cut and paste functions and their	 default
       button assignments are:

       Cut   The  left	button is used to ``cut'' text into the cut buf‐
	     fer.  Move the pointer to the beginning of the text to cut,
	     press the button, move the cursor to the end of the region,
	     and release the button.  The ``cut'' text will not	 include
	     the character currently under the pointer.

       Paste The  middle button ``pastes'' the text from the cut buffer,
	     inserting it as keyboard input.

       CopyLine
	     The right hand button ``cuts'' the text  from  the	 pointer
	     (at  button release) through the end of line (including the
	     new line), saving it in the  cut  buffer,	and  immediately
	     ``pastes''	 the line, inserting it as keyboard input.  This
	     provides a history mechanism.

       The copyLine, cut, and paste key functions can be  configured  to
       any   button   and   modifier  combination  desired  via	 various
       resources.  Each assignment consists of an  optional  combination
       of modifiers (``none'' or any combination of ``shift'', ``meta'',
       ``lock'',  ``control'',	``mod1'',  ...,	 ``mod5''  separated  by
       blanks),	 followed  by  a  ``|''	 and  the  name	 of  the  button
       (``left'', ``middle'', ``right'', ``button1'', ..., ``button5'').
       For  example, if it is desired for the cut function to be associ‐
       ated with the middle button with shift and control  pressed,  one
       could use the following resource line:

			*cut:		   shift control | middle

       For a full list of resource names, see ``RESOURCES'' above.

XCONSOLES
       It is possible to configure a system to allow redirection of con‐
       sole output (and input) to  an  hpterm  window.	 If  the  ``-C''
       option  is  used, hpterm will redirect console output (and input)
       if:

	       Hpterm is displaying on the local system.  Hpterm must be
	       running on the same system as the server that is display‐
	       ing the window.

	       The display is authorized.  The	display	 number	 of  the
	       display name (see ``Display Specification'' in X(1)) must
	       be authorized to take control of the console via the file
		``/etc/X11/Xconsoles.''	 The file is parsed as follows:

		       A `#' and  all  following  text	on  a  line  are
		       ignored.

		       Blank lines are ignored.

		       Leading tabs and spaces are ignored.

		       A  number  matching the display number authorizes
		       the  server  to	redirect  console  output   (and
		       input).

		       An asterisk (`*') matches all display numbers and
		       authorizes the server to redirect console  output
		       (and input).

       If  either  condition  is  not  met, a warning will be written to
       stderr and console output (and input) will not be redirected.

WARNINGS
       When running block mode applications, it	 may  be  necessary  for
       hpterm  to identify itself to application programs as some termi‐
       nal other than ``hpterm.''  Most applications understand the ter‐
       minal  id ``2392A.''  Newer applications also understand the ter‐
       minal id ``700/92'' while older applications may only  understand
       the  terminal  id  ``2622A.''  To set the terminal identification
       string, use the	``-ti''	 command  line	option,	 the  ``termId''
       resource, or the ``TermId'' class.

       Hpterm does not support line block mode.

       Hpterm  does  not  fully support locales that contain 3 or 4 byte
       characters and will silently ignore any 3 or 4 byte characters in
       the  data  stream.   Dtterm  is the recommended terminal emulator
       when operating in Asian EUC locales.

       The overflow protect mode of memory lock is not supported.

ENVIRONMENT
       Hpterm sets the environment variables ``$LINES'' and ``$COLUMNS''
       to  the	number	of lines and columns of the terminal screen.  It
       also uses and sets the environment variable ``$DISPLAY'' to spec‐
       ify  its server connection.  The resize(1) command may be used to
       reset ``$LINES'' and ``$COLUMNS'' after the window size has  been
       changed.

ORIGIN
       Hewlett-Packard Company.

SEE ALSO
       X(1),   dtterm(1),   resize(1),	 xset(1),   xterm(1),  Core(3X),
       XmFontList(3X),	XmForm(3X),  XmPrimitive(3X),	XmScrollBar(3X),
       pty(4)

								    HPTERM(1X)
[top]

List of man pages available for HP-UX

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