xref: /freebsd/share/man/man4/dcons.4 (revision 9cbda59000e0f366b04c83d8d852c7c34b467722)
1869093b1SHidetoshi Shimokawa.\" Copyright (c) 2003 Hidetoshi Shimokawa
2869093b1SHidetoshi Shimokawa.\" All rights reserved.
3869093b1SHidetoshi Shimokawa.\"
4869093b1SHidetoshi Shimokawa.\" Redistribution and use in source and binary forms, with or without
5869093b1SHidetoshi Shimokawa.\" modification, are permitted provided that the following conditions
6869093b1SHidetoshi Shimokawa.\" are met:
7869093b1SHidetoshi Shimokawa.\" 1. Redistributions of source code must retain the above copyright
8869093b1SHidetoshi Shimokawa.\"    notice, this list of conditions and the following disclaimer.
9869093b1SHidetoshi Shimokawa.\" 2. Redistributions in binary form must reproduce the above copyright
10869093b1SHidetoshi Shimokawa.\"    notice, this list of conditions and the following disclaimer in the
11869093b1SHidetoshi Shimokawa.\"    documentation and/or other materials provided with the distribution.
12869093b1SHidetoshi Shimokawa.\"
13869093b1SHidetoshi Shimokawa.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
14869093b1SHidetoshi Shimokawa.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
15869093b1SHidetoshi Shimokawa.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
16869093b1SHidetoshi Shimokawa.\" DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
17869093b1SHidetoshi Shimokawa.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
18869093b1SHidetoshi Shimokawa.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
19869093b1SHidetoshi Shimokawa.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20869093b1SHidetoshi Shimokawa.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
21869093b1SHidetoshi Shimokawa.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
22869093b1SHidetoshi Shimokawa.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
23869093b1SHidetoshi Shimokawa.\" POSSIBILITY OF SUCH DAMAGE.
24869093b1SHidetoshi Shimokawa.\"
25869093b1SHidetoshi Shimokawa.\" $FreeBSD$
26869093b1SHidetoshi Shimokawa.\"
27869093b1SHidetoshi Shimokawa.Dd February 11, 2003
28869093b1SHidetoshi Shimokawa.Dt DCONS 4
29869093b1SHidetoshi Shimokawa.Os
30869093b1SHidetoshi Shimokawa.Sh NAME
31869093b1SHidetoshi Shimokawa.Nm dcons
32869093b1SHidetoshi Shimokawa.Nd dumb console device driver
33869093b1SHidetoshi Shimokawa.Sh SYNOPSIS
34869093b1SHidetoshi Shimokawa.Cd device dcons
35869093b1SHidetoshi Shimokawa.Pp
36869093b1SHidetoshi Shimokawa.Cd options DDB
37869093b1SHidetoshi Shimokawa.Cd options ALT_BREAK_TO_DEBUGGER
38869093b1SHidetoshi Shimokawa.Pp
39869093b1SHidetoshi Shimokawa.Cd device firewire
40869093b1SHidetoshi Shimokawa.Sh DESCRIPTION
41869093b1SHidetoshi ShimokawaThe
42869093b1SHidetoshi Shimokawa.Nm
43b7da4442SChristian Bruefferdevice is a simple console device which just reads from and writes to
4401ddd31fSRuslan Ermilovan allocated buffer for input and output respectively.
45b7da4442SChristian BruefferIt is of no use by itself and it is supposed that the buffer is accessed
46869093b1SHidetoshi Shimokawavia a bus like
4769c6f506SHidetoshi Shimokawa.Xr firewire 4
48efa60c7aSHidetoshi Shimokawaor
49efa60c7aSHidetoshi Shimokawa.Xr kvm 3
50869093b1SHidetoshi Shimokawafor interaction.
51869093b1SHidetoshi Shimokawa.Pp
52869093b1SHidetoshi ShimokawaThe buffer consists of 4 channels.
5301ddd31fSRuslan ErmilovThere are 2 ports, one for the console TTY and another is GDB port,
5401ddd31fSRuslan Ermilovthen each port has an input channel and an output channel.
559cbda590SRuslan Ermilov.Sh FILES
569cbda590SRuslan Ermilov.Bl -tag -width indent -compact
579cbda590SRuslan Ermilov.It Pa /dev/dcons
589cbda590SRuslan Ermilov.It Pa /etc/ttys
599cbda590SRuslan Ermilov.El
6001ddd31fSRuslan Ermilov.Sh EXAMPLES
61869093b1SHidetoshi ShimokawaIf you want to run
62869093b1SHidetoshi Shimokawa.Xr getty 8
6301ddd31fSRuslan Ermilovon
6401ddd31fSRuslan Ermilov.Nm ,
6501ddd31fSRuslan Ermilovinsert the following line into
66869093b1SHidetoshi Shimokawa.Xr /etc/ttys 5
6701ddd31fSRuslan Ermilovand send a
6801ddd31fSRuslan Ermilov.Dv HUP
6901ddd31fSRuslan Ermilovsignal to
70869093b1SHidetoshi Shimokawa.Xr init 8
71869093b1SHidetoshi Shimokawausing
72869093b1SHidetoshi Shimokawa.Xr kill 1 .
73869093b1SHidetoshi Shimokawa.Bd -literal -offset indent
74869093b1SHidetoshi Shimokawadcons	"/usr/libexec/getty std.9600"	vt100	on  secure
75869093b1SHidetoshi Shimokawa.Ed
76869093b1SHidetoshi Shimokawa.Pp
77b7da4442SChristian BruefferOnce the
78869093b1SHidetoshi Shimokawa.Xr fwochi 4
79869093b1SHidetoshi Shimokawadevice is initialized to allow physical access,
8001ddd31fSRuslan Ermilovthe buffer can be accessed from another host via a
8101ddd31fSRuslan Ermilov.Xr firewire 4
8201ddd31fSRuslan Ermilovbus using the
83efa60c7aSHidetoshi Shimokawa.Xr dconschat 8
8401ddd31fSRuslan Ermilovapplication.
8501ddd31fSRuslan ErmilovSee
86efa60c7aSHidetoshi Shimokawa.Xr dconschat 8
87869093b1SHidetoshi Shimokawafor more details.
88869093b1SHidetoshi Shimokawa.Sh SEE ALSO
89efa60c7aSHidetoshi Shimokawa.Xr dcons_crom 4 ,
90869093b1SHidetoshi Shimokawa.Xr ddb 4 ,
91869093b1SHidetoshi Shimokawa.Xr firewire 4 ,
92869093b1SHidetoshi Shimokawa.Xr fwohci 4 ,
93b7da4442SChristian Brueffer.Xr ttys 5 ,
94efa60c7aSHidetoshi Shimokawa.Xr dconschat 8 ,
95b7da4442SChristian Brueffer.Xr fwcontrol 8
96869093b1SHidetoshi Shimokawa.Sh AUTHORS
97869093b1SHidetoshi Shimokawa.An Hidetoshi Shimokawa Aq simokawa@FreeBSD.org
98869093b1SHidetoshi Shimokawa.Sh BUGS
9901ddd31fSRuslan ErmilovThis driver is
10001ddd31fSRuslan Ermilov.Ud .
101