xref: /freebsd/share/man/man4/dcons.4 (revision 01ddd31ffccbca094d9ea9bbbf06d94aeede12e7)
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.
5501ddd31fSRuslan Ermilov.Sh EXAMPLES
56869093b1SHidetoshi ShimokawaIf you want to run
57869093b1SHidetoshi Shimokawa.Xr getty 8
5801ddd31fSRuslan Ermilovon
5901ddd31fSRuslan Ermilov.Nm ,
6001ddd31fSRuslan Ermilovinsert the following line into
61869093b1SHidetoshi Shimokawa.Xr /etc/ttys 5
6201ddd31fSRuslan Ermilovand send a
6301ddd31fSRuslan Ermilov.Dv HUP
6401ddd31fSRuslan Ermilovsignal to
65869093b1SHidetoshi Shimokawa.Xr init 8
66869093b1SHidetoshi Shimokawausing
67869093b1SHidetoshi Shimokawa.Xr kill 1 .
68869093b1SHidetoshi Shimokawa.Bd -literal -offset indent
69869093b1SHidetoshi Shimokawadcons	"/usr/libexec/getty std.9600"	vt100	on  secure
70869093b1SHidetoshi Shimokawa.Ed
71869093b1SHidetoshi Shimokawa.Pp
72b7da4442SChristian BruefferOnce the
73869093b1SHidetoshi Shimokawa.Xr fwochi 4
74869093b1SHidetoshi Shimokawadevice is initialized to allow physical access,
7501ddd31fSRuslan Ermilovthe buffer can be accessed from another host via a
7601ddd31fSRuslan Ermilov.Xr firewire 4
7701ddd31fSRuslan Ermilovbus using the
78efa60c7aSHidetoshi Shimokawa.Xr dconschat 8
7901ddd31fSRuslan Ermilovapplication.
8001ddd31fSRuslan ErmilovSee
81efa60c7aSHidetoshi Shimokawa.Xr dconschat 8
82869093b1SHidetoshi Shimokawafor more details.
83869093b1SHidetoshi Shimokawa.Sh FILES
84869093b1SHidetoshi Shimokawa.Bl -tag -width indent -compact
85869093b1SHidetoshi Shimokawa.It Pa /dev/dcons
86869093b1SHidetoshi Shimokawa.It Pa /etc/ttys
87869093b1SHidetoshi Shimokawa.El
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