xref: /netbsd/share/man/man4/man4.amiga/ite.4 (revision 6550d01e)
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.9 2003/08/07 10:31:05 agc 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
42Internal 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
54special files of the form ``ttye?''
55are interfaces to the
56.Tn Amiga ITE
57for bit-mapped displays.
58An
59.Nm
60is the main system console on most
61.Tn Amiga
62workstations and
63is the mechanism through which a user communicates with the machine.
64If more than one of the supported displays exists on a system,
65any or all can be used as
66.Nm
67.Ns s
68with the limitation that only
69one will have a keyboard (since only one keyboard is supported) and only
70one of each type can be used.
71.Pp
72.Nm
73devices use the
74.Tn HP-UX
75.Sq Li 300h
76.Xr termcap 5
77entry.
78However, as currently implemented,
79the
80.Nm
81does not support the full range of
82.Tn HP-UX
83capabilities for this device.
84Missing are multiple colors, blinking, softkeys,
85programmable tabs, scrolling memory and keyboard arrow keys.
86The keyboard will use the left and right
87.Tn Em Amiga
88keys as meta keys, in that it will set the eighth bit of the character code.
89.Nm
90devices also do a good job at emulating the
91.Sq Li vt100
92.Xr termcap 5
93entry.
94.Pp
95Upon booting, the kernel will first look for an
96.Nm
97device
98to use as the system console
99.Pq Pa /dev/console .
100If a display exists at any hardware address, it will be the console.
101The kernel looks for them in decreasing order (that is, choosing the
102highest-numbered one).
103.Pp
104On most systems,
105a display is used both as an
106.Nm
107.Pf ( Pa /dev/ttye?
108aka
109.Pa /dev/console )
110and as a graphics device
111.Pq /dev/grf? .
112In this environment,
113there is some interaction between the two uses that should be noted.
114For example, opening
115.Pa /dev/grf0
116will deactivate the
117.Nm
118that is, write over whatever may be on the
119.Nm
120display.
121When the graphics application is finished and
122.Pa /dev/grf0
123closed,
124the
125.Nm
126will be reinitialized with the frame buffer cleared
127and the
128old colormap installed.
129.Sh SEE ALSO
130.Xr grf 4 ,
131.Xr kbd 4
132.Sh HISTORY
133The
134.Tn Amiga
135.Nm
136first appeared in
137.Nx 1.0
138