xref: /freebsd/share/man/man4/dcons.4 (revision efa60c7aa3034fb9755f763207be38849d584c70)
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.\"
28869093b1SHidetoshi Shimokawa.Dd February 11, 2003
29869093b1SHidetoshi Shimokawa.Dt DCONS 4
30869093b1SHidetoshi Shimokawa.Os
31869093b1SHidetoshi Shimokawa.Sh NAME
32869093b1SHidetoshi Shimokawa.Nm dcons
33869093b1SHidetoshi Shimokawa.Nd dumb console device driver
34869093b1SHidetoshi Shimokawa.Sh SYNOPSIS
35869093b1SHidetoshi Shimokawa.Cd device dcons
36869093b1SHidetoshi Shimokawa.Pp
37869093b1SHidetoshi Shimokawa.Cd options DDB
38869093b1SHidetoshi Shimokawa.Cd options ALT_BREAK_TO_DEBUGGER
39869093b1SHidetoshi Shimokawa.Pp
40869093b1SHidetoshi Shimokawa.Cd device firewire
41869093b1SHidetoshi Shimokawa.Sh DESCRIPTION
42869093b1SHidetoshi ShimokawaThe
43869093b1SHidetoshi Shimokawa.Nm
44869093b1SHidetoshi Shimokawadevice is the simple console device which just reads from and writes to
45869093b1SHidetoshi Shimokawaan allocated buffer for input and output respectivly.
46869093b1SHidetoshi ShimokawaIt is no use by itself and it is supposed that the buffer is accessed
47869093b1SHidetoshi Shimokawavia a bus like
48869093b1SHidetoshi Shimokawa.Xr FireWire 4
49efa60c7aSHidetoshi Shimokawaor
50efa60c7aSHidetoshi Shimokawa.Xr kvm 3
51869093b1SHidetoshi Shimokawafor interaction.
52869093b1SHidetoshi Shimokawa.Pp
53869093b1SHidetoshi ShimokawaThe buffer consists of 4 channels.
54869093b1SHidetoshi ShimokawaThere are 2 ports, one for console tty and other is GDB ports then each port
55869093b1SHidetoshi Shimokawahas a input channel and a output channel.
56869093b1SHidetoshi Shimokawa.Sh EXAMPLE
57869093b1SHidetoshi ShimokawaIf you want to run
58869093b1SHidetoshi Shimokawa.Xr getty 8
59869093b1SHidetoshi Shimokawaon dcons, insert following line into
60869093b1SHidetoshi Shimokawa.Xr /etc/ttys 5
61869093b1SHidetoshi Shimokawaand
62869093b1SHidetoshi Shimokawasend a HUP signal to
63869093b1SHidetoshi Shimokawa.Xr init 8
64869093b1SHidetoshi Shimokawausing
65869093b1SHidetoshi Shimokawa.Xr kill 1 .
66869093b1SHidetoshi Shimokawa.Bd -literal -offset indent
67869093b1SHidetoshi Shimokawadcons	"/usr/libexec/getty std.9600"	vt100	on  secure
68869093b1SHidetoshi Shimokawa.Ed
69869093b1SHidetoshi Shimokawa.Pp
70869093b1SHidetoshi ShimokawaOnce
71869093b1SHidetoshi Shimokawa.Xr fwochi 4
72869093b1SHidetoshi Shimokawadevice is initialized to allow physical access,
73869093b1SHidetoshi Shimokawathe buffer can be accessed from another host via FireWire bus using
74efa60c7aSHidetoshi Shimokawa.Xr dconschat 8
75869093b1SHidetoshi Shimokawaapplication. See
76efa60c7aSHidetoshi Shimokawa.Xr dconschat 8
77869093b1SHidetoshi Shimokawafor more details.
78869093b1SHidetoshi Shimokawa.Pp
79869093b1SHidetoshi Shimokawa.Sh FILES
80869093b1SHidetoshi Shimokawa.Bl -tag -width indent -compact
81869093b1SHidetoshi Shimokawa.It Pa /dev/dcons
82869093b1SHidetoshi Shimokawa.It Pa /etc/ttys
83869093b1SHidetoshi Shimokawa.El
84869093b1SHidetoshi Shimokawa.Sh SEE ALSO
85efa60c7aSHidetoshi Shimokawa.Xr dcons_crom 4 ,
86869093b1SHidetoshi Shimokawa.Xr ddb 4 ,
87869093b1SHidetoshi Shimokawa.Xr firewire 4 ,
88869093b1SHidetoshi Shimokawa.Xr fwohci 4 ,
89efa60c7aSHidetoshi Shimokawa.Xr dconschat 8 ,
90869093b1SHidetoshi Shimokawa.Xr fwcontrol 8 ,
91869093b1SHidetoshi Shimokawa.Xr ttys 5
92869093b1SHidetoshi Shimokawa.Sh AUTHORS
93869093b1SHidetoshi Shimokawa.An Hidetoshi Shimokawa Aq simokawa@FreeBSD.org
94869093b1SHidetoshi Shimokawa.Sh BUGS
95869093b1SHidetoshi ShimokawaThis driver is still under development.
96869093b1SHidetoshi Shimokawa.Pp
97