Wed Feb 9 14:13:09 2011 UTC ()
- update SYNOPSIS and SEE ALSO for wscons support
- remove descriptions about obsolete ioctl


(tsutsui)
diff -r1.5 -r1.6 src/share/man/man4/man4.hp300/dvbox.4
diff -r1.5 -r1.6 src/share/man/man4/man4.hp300/gbox.4
diff -r1.5 -r1.6 src/share/man/man4/man4.hp300/rbox.4
diff -r1.5 -r1.6 src/share/man/man4/man4.hp300/topcat.4
diff -r1.3 -r1.4 src/share/man/man4/man4.hp300/hyper.4
cvs diff -r1.5 -r1.6 src/share/man/man4/man4.hp300/dvbox.4 (expand / switch to unified diff)

--- src/share/man/man4/man4.hp300/dvbox.4 2010/03/22 18:58:31 1.5
+++ src/share/man/man4/man4.hp300/dvbox.4 2011/02/09 14:13:09 1.6
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: dvbox.4,v 1.5 2010/03/22 18:58:31 joerg Exp $ 1.\" $NetBSD: dvbox.4,v 1.6 2011/02/09 14:13:09 tsutsui Exp $
2.\" 2.\"
3.\" Copyright (c) 1990, 1991, 1993 3.\" Copyright (c) 1990, 1991, 1993
4.\" The Regents of the University of California. All rights reserved. 4.\" The Regents of the University of California. All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to Berkeley by 6.\" This code is derived from software contributed to Berkeley by
7.\" the Systems Programming Group of the University of Utah Computer 7.\" the Systems Programming Group of the University of Utah Computer
8.\" Science Department. 8.\" Science Department.
9.\" 9.\"
10.\" Redistribution and use in source and binary forms, with or without 10.\" Redistribution and use in source and binary forms, with or without
11.\" modification, are permitted provided that the following conditions 11.\" modification, are permitted provided that the following conditions
12.\" are met: 12.\" are met:
13.\" 1. Redistributions of source code must retain the above copyright 13.\" 1. Redistributions of source code must retain the above copyright
14.\" notice, this list of conditions and the following disclaimer. 14.\" notice, this list of conditions and the following disclaimer.
@@ -23,142 +23,44 @@ @@ -23,142 +23,44 @@
23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 25.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32.\" SUCH DAMAGE. 32.\" SUCH DAMAGE.
33.\" 33.\"
34.\" from: @(#)dv.4 8.1 (Berkeley) 6/9/93 34.\" from: @(#)dv.4 8.1 (Berkeley) 6/9/93
35.\" 35.\"
36.Dd June 9, 1993 36.Dd February 9, 2011
37.Dt DVBOX 4 hp300 37.Dt DVBOX 4 hp300
38.Os 38.Os
39.Sh NAME 39.Sh NAME
40.Nm dvbox 40.Nm dvbox
41.Nd 41.Nd
42.Tn HP98730 42.Tn HP98730
43``DaVinci'' graphics device interface 43``DaVinci'' graphics device interface
 44.Sh SYNOPSIS
 45.Cd "dvbox* at intio?"
 46.Cd "dvbox* at dio? scode ?"
 47.Cd "wsdisplay* at dvbox?"
44.Sh DESCRIPTION 48.Sh DESCRIPTION
45This driver is for the 49This driver is for the
46.Tn HP98730 50.Tn HP98730
47and 98731 graphics device, also known as 51and 98731 graphics device, also known as
48the DaVinci. This driver has not been tested with all possible 52the DaVinci. This driver has not been tested with all possible
49combinations of frame buffer boards and scan boards installed in the device. 53combinations of frame buffer boards and scan boards installed in the device.
50The driver merely checks for the existence of the device and does minimal set 54The driver merely checks for the existence of the device and does minimal set
51up. 55up.
52.Pp 56.Pp
53The DaVinci can be configured at either the ``internal'' address 57The DaVinci can be configured at either the ``internal'' address
54(frame buffer address 0x200000, control register space address 0x560000) 58(frame buffer address 0x200000, control register space address 0x560000)
55or at an external select code less than 32. 59or at an external select code less than 32.
56At the internal address it will be the ``preferred'' console device. 60At the internal address it will be the ``preferred'' console device.
57The hardware installation manual describes the procedure for 61The hardware installation manual describes the procedure for
58setting these values. 62setting these values.
59.Pp 63.Pp
60A user process communicates to the device initially by means of 
61.Xr ioctl 2 
62calls. For the 
63.Tn HP-UX 
64.Xr ioctl 2 
65calls supported, refer to 
66.Tn HP-UX 
67manuals. 
68The 
69.Bx 
70calls supported are: 
71.Bl -tag -width indent 
72.It Dv GRFIOCGINFO 
73Get Graphics Info 
74.Pp 
75Get info about device, setting the entries in the 
76.Ar grfinfo 
77structure, as defined in 
78.In hpdev/grfioctl.h . 
79For the standard 98730, the number of planes should be 4. The number of 
80colors would therefore be 15, excluding black. If one 98732A frame buffer 
81board is installed, there will still be 4 planes, with the 4 planes on the 
82colormap board becoming overlay planes. With each additional 98732 frame 
83buffer board 4 planes will be added up to a maximum of 32 planes total. 
84.It Dv GRFIOCON 
85Graphics On 
86.Pp 
87Turn graphics on by enabling 
88.Tn CRT 
89output. The screen will come on, displaying 
90whatever is in the frame buffer, using whatever colormap is in place. 
91.It Dv GRFIOCOFF 
92Graphics Off 
93.Pp 
94Turn graphics off by disabling output to the 
95.Tn CRT . 
96The frame buffer contents 
97are not affected. 
98.It Dv GRFIOCMAP 
99Map Device to user space 
100.Pp 
101Map in control registers and frame buffer space. Once the device file is 
102mapped, the frame buffer structure is accessible. The structure describing 
103the 98730 is defined in 
104.In hpdev/grf_dvreg.h . 
105.El 
106.Sh FILES 
107.Bl -tag -width /dev/MAKEDEV.hpux -compact 
108.It Pa /dev/grf? 
109.Bx 
110special file 
111.It Pa /dev/crt98730 
112.It Pa /dev/ocrt98730 
113.Tn HP-UX 
114.Em starbase 
115special files 
116.It Pa /dev/MAKEDEV.hpux 
117script for creating 
118.Tn HP-UX 
119special files 
120.El 
121.Sh EXAMPLES 
122This is a short segment of code showing how the device is opened and mapped 
123into user process address space assuming that it is 
124.Ql grf0 : 
125.Bd -literal -offset indent 
126struct dvboxfb *dvbox; 
127u_char *Addr, frame_buffer; 
128struct grfinfo gi; 
129int disp_fd; 
130 
131disp_fd = open("/dev/grf0",1); 
132 
133if (ioctl (disp_fd, GRFIOCGINFO, \*[Am]gi) \*[Lt] 0) return -1; 
134 
135(void) ioctl (disp_fd, GRFIOCON, 0); 
136 
137Addr = (u_char *) 0; 
138if (ioctl (disp_fd, GRFIOCMAP, \*[Am]Addr) \*[Lt] 0) { 
139(void) ioctl (disp_fd, GRFIOCOFF, 0); 
140return -1; 
141} 
142dvbox = (dvboxfb *) Addr; /* Control Registers */ 
143frame_buffer=(u_char *)Addr+gi.gd_regsize; /* Frame buffer memory */ 
144.Ed 
145.Sh DIAGNOSTICS 
146None under 
147.Bx . 
148.Tn HP-UX 
149.Tn CE.utilities 
150must be used. 
151.Sh ERRORS 
152.Bl -tag -width [EINVAL] 
153.It Bq Er ENODEV 
154no such device. 
155.It Bq Er EBUSY 
156Another process has the device open. 
157.It Bq Er EINVAL 
158Invalid ioctl specification. 
159.El 
160.Sh SEE ALSO 64.Sh SEE ALSO
161.Xr ioctl 2 , 65.Xr wsdisplay 4 ,
162.Xr grf 4 66.Xr wscons 4
163.Sh BUGS 
164Not tested for all configurations of scan board and frame buffer memory boards. 
cvs diff -r1.5 -r1.6 src/share/man/man4/man4.hp300/gbox.4 (expand / switch to unified diff)

--- src/share/man/man4/man4.hp300/gbox.4 2010/03/22 18:58:31 1.5
+++ src/share/man/man4/man4.hp300/gbox.4 2011/02/09 14:13:09 1.6
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: gbox.4,v 1.5 2010/03/22 18:58:31 joerg Exp $ 1.\" $NetBSD: gbox.4,v 1.6 2011/02/09 14:13:09 tsutsui Exp $
2.\" 2.\"
3.\" Copyright (c) 1990, 1991, 1993 3.\" Copyright (c) 1990, 1991, 1993
4.\" The Regents of the University of California. All rights reserved. 4.\" The Regents of the University of California. All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to Berkeley by 6.\" This code is derived from software contributed to Berkeley by
7.\" the Systems Programming Group of the University of Utah Computer 7.\" the Systems Programming Group of the University of Utah Computer
8.\" Science Department. 8.\" Science Department.
9.\" 9.\"
10.\" Redistribution and use in source and binary forms, with or without 10.\" Redistribution and use in source and binary forms, with or without
11.\" modification, are permitted provided that the following conditions 11.\" modification, are permitted provided that the following conditions
12.\" are met: 12.\" are met:
13.\" 1. Redistributions of source code must retain the above copyright 13.\" 1. Redistributions of source code must retain the above copyright
14.\" notice, this list of conditions and the following disclaimer. 14.\" notice, this list of conditions and the following disclaimer.
@@ -23,34 +23,38 @@ @@ -23,34 +23,38 @@
23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 25.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32.\" SUCH DAMAGE. 32.\" SUCH DAMAGE.
33.\" 33.\"
34.\" from: @(#)gb.4 8.1 (Berkeley) 6/9/93 34.\" from: @(#)gb.4 8.1 (Berkeley) 6/9/93
35.\" 35.\"
36.Dd June 9, 1993 36.Dd February 9, 2011
37.Dt GB 4 hp300 37.Dt GB 4 hp300
38.Os 38.Os
39.Sh NAME 39.Sh NAME
40.Nm gb 40.Nm gb
41.Nd 41.Nd
42.Tn HP98700 42.Tn HP98700
43``Gatorbox'' graphics device interface 43``Gatorbox'' graphics device interface
 44.Sh SYNOPSIS
 45.Cd "gbox* at intio?"
 46.Cd "gbox* at dio? scode ?"
 47.Cd "wsdisplay* at gbox?"
44.Sh DESCRIPTION 48.Sh DESCRIPTION
45This driver is for the 49This driver is for the
46.Tn HP98700 50.Tn HP98700
47and 98710 graphics devices, also known as 51and 98710 graphics devices, also known as
48the Gatorbox. The term ``Gator'' will often be used, and it is not to be 52the Gatorbox. The term ``Gator'' will often be used, and it is not to be
49confused with ``Gator'' used in reference to an 53confused with ``Gator'' used in reference to an
50.Tn HP 54.Tn HP
519837 or 200/237 machine. 559837 or 200/237 machine.
52Also, the term Gatorbox is used for the 98700 alone, with the 98701 frame 56Also, the term Gatorbox is used for the 98700 alone, with the 98701 frame
53buffer memory or with the 98710 accelerator installed. This driver merely 57buffer memory or with the 98710 accelerator installed. This driver merely
54checks for the existence of the device and does minimal set up, as it is 58checks for the existence of the device and does minimal set up, as it is
55expected the applications will initialize the device to their requirements. 59expected the applications will initialize the device to their requirements.
56.Pp 60.Pp
@@ -65,114 +69,16 @@ the DIO address 0x200000 and the control @@ -65,114 +69,16 @@ the DIO address 0x200000 and the control
65At this address it will be the ``preferred'' console device (see 69At this address it will be the ``preferred'' console device (see
66.Xr cons 4 ) . 70.Xr cons 4 ) .
67For use as a secondary device, 71For use as a secondary device,
68the 98287A should be set to frame buffer address 0x300000, 72the 98287A should be set to frame buffer address 0x300000,
69and to an external select code. 73and to an external select code.
70.Pp 74.Pp
71It should be noted that this configuration will conflict with the 98547 75It should be noted that this configuration will conflict with the 98547
72display card which has a 2 megabyte frame buffer starting at address 0x200000. 76display card which has a 2 megabyte frame buffer starting at address 0x200000.
73The 98700 should only be installed as a secondary device in a machine with a 77The 98700 should only be installed as a secondary device in a machine with a
741 bit 98544 display card or 4 bit 98545 card. 781 bit 98544 display card or 4 bit 98545 card.
75The 79The
76.%T 98700H Installation Guide 80.%T 98700H Installation Guide
77contains further configuration information. 81contains further configuration information.
78.Pp 
79The 
80.Xr ioctl 2 
81calls supported by the 
82.Bx 
83system for the Gatorbox are: 
84.Bl -tag -width indent 
85.It Dv GRFIOCGINFO 
86Get Graphics Info 
87.Pp 
88Get info about device, setting the entries in the 
89.Em grfinfo 
90structure, as defined in 
91.In hpdev/grfioctl.h . 
92For the standard 98700, the number of planes should be 4. The number of 
93colors would therefore be 15, excluding black. With the 98701 option installed 
94there will be another 4 planes for a total of 8, giving 255 colors. 
95.It Dv GRFIOCON 
96Graphics On 
97.Pp 
98Turn graphics on by enabling 
99.Tn CRT 
100output. The screen will come on, displaying 
101whatever is in the frame buffer, using whatever colormap is in place. 
102.It Dv GRFIOCOFF 
103Graphics Off 
104.Pp 
105Turn graphics off by disabling output to the 
106.Tn CRT . 
107The frame buffer contents 
108are not affected. 
109.It Dv GRFIOCMAP 
110Map Device to user space 
111.Pp 
112Map in control registers and framebuffer space. Once the device file is 
113mapped, the frame buffer structure is accessible. 
114The frame buffer structure describing the 98700 
115is given in 
116.In hpdev/grf_gbreg.h . 
117.It Dv GRFIOCUNMAP 
118Unmap Device 
119.Pp 
120Unmap control registers and framebuffer space. 
121.Pp 
122For further information about the use of ioctl see the man page. 
123.El 
124.Sh FILES 
125.Bl -tag -width /dev/crt98700 -compact 
126.It Pa /dev/grf? 
127.Bx 
128special file 
129.It Pa /dev/crt98700 
130.Tn HP-UX 
131.Em starbase 
132special file 
133.El 
134.Sh EXAMPLES 
135A small example of opening, mapping and using the device is given below. 
136For more examples of the details on the behavior of the device, see the device 
137dependent source files for the X Window System, in the 
138.Pa /usr/src/new/X/libhp.fb 
139directory. 
140.Bd -literal -offset indent 
141struct gboxfb *gbox; 
142u_char *Addr, frame_buffer; 
143struct grfinfo gi; 
144int disp_fd; 
145 
146disp_fd = open("/dev/grf0",1); 
147 
148if (ioctl (disp_fd, GRFIOCGINFO, \*[Am]gi) \*[Lt] 0) return -1; 
149 
150(void) ioctl (disp_fd, GRFIOCON, 0); 
151 
152Addr = (u_char *) 0; 
153if (ioctl (disp_fd, GRFIOCMAP, \*[Am]Addr) \*[Lt] 0) { 
154(void) ioctl (disp_fd, GRFIOCOFF, 0); 
155return -1; 
156} 
157gbox = (gboxfb *) Addr; /* Control Registers */ 
158frame_buffer = (u_char *) Addr + gi.gd_regsize; /* Frame buffer memory */ 
159.Ed 
160.Sh DIAGNOSTICS 
161None under 
162.Bx . 
163.Tn HP-UX 
164The 
165.Tn CE.utilities/Crtadjust 
166programs must be used. 
167.Sh ERRORS 
168.Bl -tag -width [EINVAL] 
169.It Bq Er ENODEV 
170no such device. 
171.It Bq Er EBUSY 
172Another process has the device open. 
173.It Bq Er EINVAL 
174Invalid ioctl specification. 
175.El 
176.Sh SEE ALSO 82.Sh SEE ALSO
177.Xr ioctl 2 , 83.Xr wsdisplay 4 ,
178.Xr grf 4 84.Xr wscons 4
cvs diff -r1.5 -r1.6 src/share/man/man4/man4.hp300/rbox.4 (expand / switch to unified diff)

--- src/share/man/man4/man4.hp300/rbox.4 2010/03/22 18:58:31 1.5
+++ src/share/man/man4/man4.hp300/rbox.4 2011/02/09 14:13:09 1.6
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: rbox.4,v 1.5 2010/03/22 18:58:31 joerg Exp $ 1.\" $NetBSD: rbox.4,v 1.6 2011/02/09 14:13:09 tsutsui Exp $
2.\" 2.\"
3.\" Copyright (c) 1990, 1991, 1993 3.\" Copyright (c) 1990, 1991, 1993
4.\" The Regents of the University of California. All rights reserved. 4.\" The Regents of the University of California. All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to Berkeley by 6.\" This code is derived from software contributed to Berkeley by
7.\" the Systems Programming Group of the University of Utah Computer 7.\" the Systems Programming Group of the University of Utah Computer
8.\" Science Department. 8.\" Science Department.
9.\" 9.\"
10.\" Redistribution and use in source and binary forms, with or without 10.\" Redistribution and use in source and binary forms, with or without
11.\" modification, are permitted provided that the following conditions 11.\" modification, are permitted provided that the following conditions
12.\" are met: 12.\" are met:
13.\" 1. Redistributions of source code must retain the above copyright 13.\" 1. Redistributions of source code must retain the above copyright
14.\" notice, this list of conditions and the following disclaimer. 14.\" notice, this list of conditions and the following disclaimer.
@@ -23,149 +23,43 @@ @@ -23,149 +23,43 @@
23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 25.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32.\" SUCH DAMAGE. 32.\" SUCH DAMAGE.
33.\" 33.\"
34.\" from: @(#)rb.4 8.1 (Berkeley) 6/9/93 34.\" from: @(#)rb.4 8.1 (Berkeley) 6/9/93
35.\" 35.\"
36.Dd September 10, 2001 36.Dd February 9, 2011
37.Dt RBOX 4 hp300 37.Dt RBOX 4 hp300
38.Os 38.Os
39.Sh NAME 39.Sh NAME
40.Nm rbox 40.Nm rbox
41.Nd 41.Nd
42.Tn HP98720 42.Tn HP98720
43``Renaissance'' graphics device interface 43``Renaissance'' graphics device interface
44.Sh SYNOPSIS 44.Sh SYNOPSIS
45.Cd "rbox* at intio?" 45.Cd "rbox* at intio?"
46.Cd "rbox* at dio? scode ?" 46.Cd "rbox* at dio? scode ?"
 47.Cd "wsdisplay* at rbox?"
47.Sh DESCRIPTION 48.Sh DESCRIPTION
48This driver is for the 49This driver is for the
49.Tn HP98720 50.Tn HP98720
50and 98721 graphics device, also known as 51and 98721 graphics device, also known as
51the Renaissance. This driver has not been tested with all possible 52the Renaissance. This driver has not been tested with all possible
52combinations of frame buffer boards and scan boards installed in the device. 53combinations of frame buffer boards and scan boards installed in the device.
53The driver merely checks for the existence of the device and does minimal set 54The driver merely checks for the existence of the device and does minimal set
54up. 55up.
55.Pp 56.Pp
56The Renaissance can be configured at either the ``internal'' address 57The Renaissance can be configured at either the ``internal'' address
57(frame buffer address 0x200000, control register space address 0x560000) 58(frame buffer address 0x200000, control register space address 0x560000)
58or at an external select code less than 32. 59or at an external select code less than 32.
59At the internal address it will be the ``preferred'' console device. 60At the internal address it will be the ``preferred'' console device.
60The hardware installation manual describes the procedure for 61The hardware installation manual describes the procedure for
61setting these values. 62setting these values.
62.Pp 
63A user process communicates to the device initially by means of 
64.Xr ioctl 2 
65calls. For the 
66.Tn HP-UX 
67.Xr ioctl 2 
68calls supported, refer to 
69.Tn HP-UX 
70manuals. 
71The 
72.Bx 
73calls supported are: 
74.Bl -tag -width indent 
75.It Dv GRFIOCGINFO 
76Get Graphics Info 
77.Pp 
78Get info about device, setting the entries in the 
79.Ar grfinfo 
80structure, as defined in 
81.In hpdev/grfioctl.h . 
82For the standard 98720, the number of planes should be 4. The number of 
83colors would therefore be 15, excluding black. If one 98722A frame buffer 
84board is installed, there will still be 4 planes, with the 4 planes on the 
85colormap board becoming overlay planes. With each additional 98722 frame 
86buffer board 4 planes will be added up to a maximum of 32 planes total. 
87.It Dv GRFIOCON 
88Graphics On 
89.Pp 
90Turn graphics on by enabling 
91.Tn CRT 
92output. The screen will come on, displaying 
93whatever is in the frame buffer, using whatever colormap is in place. 
94.It Dv GRFIOCOFF 
95Graphics Off 
96.Pp 
97Turn graphics off by disabling output to the 
98.Tn CRT . 
99The frame buffer contents 
100are not affected. 
101.It Dv GRFIOCMAP 
102Map Device to user space 
103.Pp 
104Map in control registers and framebuffer space. Once the device file is 
105mapped, the frame buffer structure is accessible. The structure describing 
106the 98720 is defined in 
107.Pa hpdev/grf_rbreg.h . 
108.El 
109.Sh FILES 
110.Bl -tag -width /dev/MAKEDEV.hpux -compact 
111.It Pa /dev/grf? 
112.Bx 
113special file 
114.It Pa /dev/crt98720 
115.It Pa /dev/ocrt98720 
116.Tn HP-UX 
117.Em starbase 
118special files 
119.It Pa /dev/MAKEDEV.hpux 
120script for creating 
121.Tn HP-UX 
122special files 
123.El 
124.Sh EXAMPLES 
125This is a short segment of code showing how the device is opened and mapped 
126into user process address space assuming that it is grf0: 
127.Bd -literal 
128struct rboxfb *rbox; 
129u_char *Addr, frame_buffer; 
130struct grfinfo gi; 
131int disp_fd; 
132 
133disp_fd = open("/dev/grf0",1); 
134 
135if (ioctl (disp_fd, GRFIOCGINFO, \*[Am]gi) \*[Lt] 0) return -1; 
136 
137(void) ioctl (disp_fd, GRFIOCON, 0); 
138 
139Addr = (u_char *) 0; 
140if (ioctl (disp_fd, GRFIOCMAP, \*[Am]Addr) \*[Lt] 0) { 
141 (void) ioctl (disp_fd, GRFIOCOFF, 0); 
142 return -1; 
143} 
144rbox = (rboxfb *) Addr; /* Control Registers */ 
145frame_buffer = (u_char *) Addr + gi.gd_regsize; /* Frame buffer memory */ 
146.Ed 
147.Sh DIAGNOSTICS 
148None under 
149.Bx . 
150The 
151.Tn HP-UX 
152.Tn CE.utilities 
153must be used. 
154.Sh ERRORS 
155.Bl -tag -width [EINVAL] 
156.It Bq Er ENODEV 
157no such device. 
158.It Bq Er EBUSY 
159Another process has the device open. 
160.It Bq Er EINVAL 
161Invalid ioctl specification. 
162.El 
163.Sh SEE ALSO 63.Sh SEE ALSO
164.Xr ioctl 2 , 64.Xr wsdisplay 4 ,
165.Xr grf 4 , 65.Xr wscons 4
166.Xr ite 4 
167.Pp 
168For extensive code examples using the 
169Renaissance, see the X device dependent source. 
170.Sh BUGS 
171Not tested for all configurations of scan board and frame buffer memory boards. 
cvs diff -r1.5 -r1.6 src/share/man/man4/man4.hp300/topcat.4 (expand / switch to unified diff)

--- src/share/man/man4/man4.hp300/topcat.4 2010/03/22 18:58:31 1.5
+++ src/share/man/man4/man4.hp300/topcat.4 2011/02/09 14:13:09 1.6
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: topcat.4,v 1.5 2010/03/22 18:58:31 joerg Exp $ 1.\" $NetBSD: topcat.4,v 1.6 2011/02/09 14:13:09 tsutsui Exp $
2.\" 2.\"
3.\" Copyright (c) 1990, 1991, 1993 3.\" Copyright (c) 1990, 1991, 1993
4.\" The Regents of the University of California. All rights reserved. 4.\" The Regents of the University of California. All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to Berkeley by 6.\" This code is derived from software contributed to Berkeley by
7.\" the Systems Programming Group of the University of Utah Computer 7.\" the Systems Programming Group of the University of Utah Computer
8.\" Science Department. 8.\" Science Department.
9.\" 9.\"
10.\" Redistribution and use in source and binary forms, with or without 10.\" Redistribution and use in source and binary forms, with or without
11.\" modification, are permitted provided that the following conditions 11.\" modification, are permitted provided that the following conditions
12.\" are met: 12.\" are met:
13.\" 1. Redistributions of source code must retain the above copyright 13.\" 1. Redistributions of source code must retain the above copyright
14.\" notice, this list of conditions and the following disclaimer. 14.\" notice, this list of conditions and the following disclaimer.
@@ -23,156 +23,51 @@ @@ -23,156 +23,51 @@
23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 25.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32.\" SUCH DAMAGE. 32.\" SUCH DAMAGE.
33.\" 33.\"
34.\" from: @(#)tc.4 8.1 (Berkeley) 6/9/93 34.\" from: @(#)tc.4 8.1 (Berkeley) 6/9/93
35.\" 35.\"
36.Dd September 10, 2001 36.Dd February, 2011
37.Dt TOPCAT 4 hp300 37.Dt TOPCAT 4 hp300
38.Os 38.Os
39.Sh NAME 39.Sh NAME
40.Nm topcat 40.Nm topcat
41.Nd 41.Nd
42.Tn HP98544 42.Tn HP98544
4398550 ``Topcat'' and ``Catseye'' device interface 4398550 ``Topcat'' and ``Catseye'' device interface
44.Sh SYNOPSIS 44.Sh SYNOPSIS
45.Cd "topcat* at intio?" 45.Cd "topcat* at intio?"
46.Cd "topcat* at dio? scode ?" 46.Cd "topcat* at dio? scode ?"
 47.Cd "wsdisplay* at topcat?"
47.Sh DESCRIPTION 48.Sh DESCRIPTION
48This driver is for the 49This driver is for the
49.Tn HP98544 , 50.Tn HP98544 ,
5098545 and 98547 ``Topcat'' 5198545 and 98547 ``Topcat''
51and 52and
52.Tn HP98548 , 53.Tn HP98548 ,
5398549, and 98550 ``Catseye'' display cards. 5498549, and 98550 ``Catseye'' display cards.
54This driver merely checks for the existence of the device 55This driver merely checks for the existence of the device
55and does minimal set up, as it is expected the applications will initialize 56and does minimal set up, as it is expected the applications will initialize
56the device to their requirements. 57the device to their requirements.
57The Topcat and Catseye are nearly identical in common usage and only the 58The Topcat and Catseye are nearly identical in common usage and only the
58Topcat will be referred to from now on. 59Topcat will be referred to from now on.
59.Pp 60.Pp
60The Topcat display cards are not user configurable. If one is present on a 61The Topcat display cards are not user configurable. If one is present on a
61system, it will always have a frame buffer address of 0x200000 and a control 62system, it will always have a frame buffer address of 0x200000 and a control
62register address of 0x560000. These are the 63register address of 0x560000. These are the
63.Tn HP 64.Tn HP
64series 300 65series 300
65.Tn ITE 66.Tn ITE
66(Internal 67(Internal
67Terminal Emulator) defaults. The device can also be used as a graphics output 68Terminal Emulator) defaults. The device can also be used as a graphics output
68device. 69device.
69.Pp 70.Pp
70The 
71.Xr ioctl 2 
72calls supported by the 
73.Bx 
74system for the Topcat are: 
75.Bl -tag -width GRFIOCGINFO 
76.It Dv GRFIOCGINFO 
77Get Graphics Info 
78.Pp 
79Get info about device, setting the entries in the 
80.Ar grfinfo 
81structure, as defined in 
82.In hpdev/grfioctl.h . 
83For the 98544 or 98549, 
84the number of planes should be 1, as they are monochrome devices. 
85The number of planes for a 98545 is 4, translating to 15 colors, 
86excluding black. 
87The 98547 and 98548 cards have 6 planes, yielding 63 colors and black. 
88The 98550 has 8 planes, yielding 255 colors and black. 
89The displayed frame buffer size for the 98549 and 98550 is 2048 x 1024, 
90for the others it is 1024 x 768. 
91.It Dv GRFIOCON 
92Graphics On 
93.Pp 
94Turn graphics on by enabling 
95.Tn CRT 
96output. The screen will come on, displaying 
97whatever is in the frame buffer, using whatever colormap is in place. 
98.It Dv GRFIOCOFF 
99Graphics Off 
100.Pp 
101Turn graphics off by disabling output to the 
102.Tn CRT . 
103The frame buffer contents 
104are not affected. 
105.It Dv GRFIOCMAP 
106Map Device to user space 
107.Pp 
108Map in control registers and framebuffer space. Once the device file is 
109mapped, the frame buffer structure is accessible. The frame buffer structure 
110describing Topcat/Catseye devices is defined in 
111.In hpdev/grf_tcreg.h . 
112.El 
113.Pp 
114For further information about the use of 
115.Xr ioctl 2 
116see the man page. 
117.Sh FILES 
118.Bl -tag -width /dev/MAKEDEV.hpux -compact 
119.It Pa /dev/grf? 
120.Bx 
121special file 
122.It Pa /dev/crt9837 
123.It Pa /dev/crt98550 
124.Tn HP-UX 
125.Em starbase 
126special files 
127.It Pa /dev/MAKEDEV.hpux 
128script for creating 
129.Tn HP-UX 
130special files 
131.El 
132.Sh EXAMPLES 
133A small example of opening, mapping and using the device is given below. 
134For more examples of the details on the behavior of the device, see the device 
135dependent source files for the X Window System, in the 
136.Pa /usr/src/new/X/libhp 
137directory. 
138.Bd -literal 
139struct tcboxfb *tc; 
140u_char *Addr, frame_buffer; 
141struct grfinfo gi; 
142int disp_fd; 
143 
144disp_fd = open("/dev/grf0",1); 
145 
146if (ioctl (disp_fd, GRFIOCGINFO, \*[Am]gi) \*[Lt] 0) return -1; 
147 
148(void) ioctl (disp_fd, GRFIOCON, 0); 
149 
150Addr = (u_char *) 0; 
151if (ioctl (disp_fd, GRFIOCMAP, \*[Am]Addr) \*[Lt] 0) { 
152 (void) ioctl (disp_fd, GRFIOCOFF, 0); 
153 return -1; 
154} 
155tc = (tcboxfb *) Addr; /* Control Registers */ 
156frame_buffer = (u_char *) Addr + gi.gd_regsize; /* Frame buffer memory */ 
157.Ed 
158.Sh DIAGNOSTICS 
159None under 
160.Bx . 
161.Tn HP-UX 
162.Tn /usr/CE.utilities/Crtadjust 
163programs must be used. 
164.Sh ERRORS 
165.Bl -tag -width [EINVAL] 
166.It Bq Er ENODEV 
167no such device. 
168.It Bq Er EBUSY 
169Another process has the device open. 
170.It Bq Er EINVAL 
171Invalid 
172.Xr ioctl 2 
173specification. 
174.El 
175.Sh SEE ALSO 71.Sh SEE ALSO
176.Xr ioctl 2 , 72.Xr wsdisplay 4 ,
177.Xr grf 4 , 73.Xr wscons 4
178.Xr ite 4 
cvs diff -r1.3 -r1.4 src/share/man/man4/man4.hp300/hyper.4 (expand / switch to unified diff)

--- src/share/man/man4/man4.hp300/hyper.4 2008/04/30 13:10:56 1.3
+++ src/share/man/man4/man4.hp300/hyper.4 2011/02/09 14:13:09 1.4
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: hyper.4,v 1.3 2008/04/30 13:10:56 martin Exp $ 1.\" $NetBSD: hyper.4,v 1.4 2011/02/09 14:13:09 tsutsui Exp $
2.\" 2.\"
3.\" Copyright (c) 2001 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Gregory McGarry. 7.\" by Gregory McGarry.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -17,28 +17,29 @@ @@ -17,28 +17,29 @@
17.\" 17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE. 28.\" POSSIBILITY OF SUCH DAMAGE.
29.\" 29.\"
30.Dd September 10, 2001 30.Dd February 9, 2011
31.Dt HYPER 4 hp300 31.Dt HYPER 4 hp300
32.Os 32.Os
33.Sh NAME 33.Sh NAME
34.Nm hyper 34.Nm hyper
35.Nd 35.Nd
36.Tn A1096A 36.Tn A1096A
37``Hyperion'' graphics device interface 37``Hyperion'' graphics device interface
38.Sh SYNOPSIS 38.Sh SYNOPSIS
39.Cd "hyper* at dio? scode ?" 39.Cd "hyper* at dio? scode ?"
 40.Cd "wsdisplay* at hyper?"
40.Sh DESCRIPTION 41.Sh DESCRIPTION
41This driver is for the Hyperion monochrome framebuffer. 42This driver is for the Hyperion monochrome framebuffer.
42.Sh SEE ALSO 43.Sh SEE ALSO
43.Xr grf 4 , 44.Xr wsdisplay 4 ,
44.Xr ite 4 45.Xr wscons 4