share/man/man4/man4.amiga/ite.4

   1 .\" Copyright (c) 1990, 1991 The Regents of the University of California.
   2 .\" All rights reserved.
   3 .\"
   4 .\" This code is derived from software contributed to Berkeley by
   5 .\" the Systems Programming Group of the University of Utah Computer
   6 .\" Science Department.
   7 .\"
   8 .\" Redistribution and use in source and binary forms, with or without
   9 .\" modification, are permitted provided that the following conditions
  10 .\" are met:
  11 .\" 1. Redistributions of source code must retain the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer.
  13 .\" 2. Redistributions in binary form must reproduce the above copyright
  14 .\"    notice, this list of conditions and the following disclaimer in the
  15 .\"    documentation and/or other materials provided with the distribution.
  16 .\" 3. Neither the name of the University nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\"     from: @(#)ite.4 5.2 (Berkeley) 3/27/91
  33 .\"     $NetBSD: ite.4,v 1.8 2001/10/28 18:47:03 wiz Exp $
  34 .\"
  35 .Dd August 30, 1994
  36 .Dt ITE 4 amiga
  37 .Os
  38 .Sh NAME
  39 .Nm ite
  40 .Nd
  41 .Tn Amiga
  42 Internal Terminal Emulator
  43 .Sh SYNOPSIS
  44 .Cd "ite0 at grf0"
  45 .Cd "ite1 at grf1"
  46 .Cd "ite2 at grf2"
  47 .Cd "ite3 at grf3"
  48 .Cd "ite4 at grf4"
  49 .Cd "ite5 at grf5"
  50 .Cd "ite6 at grf6"
  51 .Cd "ite7 at grf7"
  52 .Sh DESCRIPTION
  53 .Tn TTY
  54 special files of the form ``ttye?''
  55 are interfaces to the
  56 .Tn Amiga ITE
  57 for bit-mapped displays.
  58 An
  59 .Nm
  60 is the main system console on most
  61 .Tn Amiga
  62 workstations and
  63 is the mechanism through which a user communicates with the machine.
  64 If more than one of the supported displays exists on a system,
  65 any or all can be used as
  66 .Nm
  67 .Ns s
  68 with the limitation that only
  69 one will have a keyboard (since only one keyboard is supported) and only
  70 one of each type can be used.
  71 .Pp
  72 .Nm
  73 devices use the
  74 .Tn HP-UX
  75 .Sq Li 300h
  76 .Xr termcap 5
  77 entry.
  78 However, as currently implemented,
  79 the
  80 .Nm
  81 does not support the full range of
  82 .Tn HP-UX
  83 capabilities for this device.
  84 Missing are multiple colors, blinking, softkeys,
  85 programmable tabs, scrolling memory and keyboard arrow keys.
  86 The keyboard will use the left and right
  87 .Tn Em Amiga
  88 keys as meta keys, in that it will set the eighth bit of the character code.
  89 .Nm
  90 devices also do a good job at emulating the
  91 .Sq Li vt100
  92 .Xr termcap 5
  93 entry.
  94 .Pp
  95 Upon booting, the kernel will first look for an
  96 .Nm
  97 device
  98 to use as the system console
  99 .Pq Pa /dev/console .
 100 If a display exists at any hardware address, it will be the console.
 101 The kernel looks for them in decreasing order (that is, choosing the
 102 highest-numbered one).
 103 .Pp
 104 On most systems,
 105 a display is used both as an
 106 .Nm
 107 .Pf ( Pa /dev/ttye?
 108 aka
 109 .Pa /dev/console )
 110 and as a graphics device
 111 .Pq /dev/grf? .
 112 In this environment,
 113 there is some interaction between the two uses that should be noted.
 114 For example, opening
 115 .Pa /dev/grf0
 116 will deactivate the
 117 .Nm
 118 that is, write over whatever may be on the
 119 .Nm
 120 display.
 121 When the graphics application is finished and
 122 .Pa /dev/grf0
 123 closed,
 124 the
 125 .Nm
 126 will be reinitialized with the frame buffer cleared
 127 and the
 128 old colormap installed.
 129 .Sh SEE ALSO
 130 .Xr grf 4 ,
 131 .Xr kbd 4
 132 .Sh HISTORY
 133 The
 134 .Tn Amiga
 135 .Nm
 136 first appeared in
 137 .Nx 1.0