Tue Jun 13 06:37:21 2017 UTC ()
Update for inclusion of references to the new wsbell(4)


(pgoyette)
diff -r1.12 -r1.13 src/share/man/man4/wsmux.4
cvs diff -r1.12 -r1.13 src/share/man/man4/wsmux.4 (expand / switch to unified diff)

--- src/share/man/man4/wsmux.4 2011/03/06 17:39:05 1.12
+++ src/share/man/man4/wsmux.4 2017/06/13 06:37:21 1.13
@@ -1,81 +1,87 @@ @@ -1,81 +1,87 @@
1.\" $NetBSD: wsmux.4,v 1.12 2011/03/06 17:39:05 wiz Exp $ 1.\" $NetBSD: wsmux.4,v 1.13 2017/06/13 06:37:21 pgoyette Exp $
2.\" 2.\"
3.\" Copyright (c) 1999 The NetBSD Foundation, Inc. 3.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 15.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 16.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 17.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 18.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 19.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 20.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 21.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 22.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 23.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 24.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25.\" POSSIBILITY OF SUCH DAMAGE. 25.\" POSSIBILITY OF SUCH DAMAGE.
26.\" 26.\"
27.Dd July 26, 1999 27.Dd June 13, 2017
28.Dt WSMUX 4 28.Dt WSMUX 4
29.Os 29.Os
30.Sh NAME 30.Sh NAME
31.Nm wsmux 31.Nm wsmux
32.Nd console keyboard/mouse multiplexor for wscons 32.Nd console keyboard/mouse multiplexor for wscons
33.Sh SYNOPSIS 33.Sh SYNOPSIS
34.Cd "wskbd* at ... mux 1" 34.Cd "wskbd* at ... mux 1"
35.Cd "wsmouse* at ... mux 0" 35.Cd "wsbell* at ... mux 1"
 36.Cd "wsmouse* at ... mux 0"
36.Pp 37.Pp
37.Cd pseudo-device wsmux 38.Cd pseudo-device wsmux
38.Sh DESCRIPTION 39.Sh DESCRIPTION
39The 40The
40.Nm 41.Nm
41is a pseudo-device driver that allows several 42is a pseudo-device driver that allows several
42.Xr wscons 4 43.Xr wscons 4
43input devices to have their events multiplexed into one stream. 44input devices to have their events multiplexed into one stream.
44.Pp 45.Pp
45The typical usage for this device is to have two multiplexors, one 46The typical usage for this device is to have two multiplexors, one
46for mouse events and one for keyboard events. 47for mouse events and one for keyboard and bell events.
47All 48All
48.Xr wsmouse 4 49.Xr wsmouse 4
49devices should direct their events to the mouse mux (normally 0) 50devices should direct their events to the mouse mux (normally 0)
50and all keyboard devices, except the console, should direct their 51and all keyboard devices, except the console, should direct their
51events to the keyboard mux (normally 1). 52events to the keyboard mux (normally 1).
52A device will send its events to the mux indicated by the 53A device will send its events to the mux indicated by the
53.Va mux 54.Va mux
54locator. 55locator.
55If none is given the device will not use a multiplexor. 56If none is given the device will not use a multiplexor.
56The keyboard multiplexor should be connected to the display, using 57The keyboard multiplexor should be connected to the display, using
57the 58the
58.Xr wsconscfg 8 59.Xr wsconscfg 8
59command. 60command.
60It will then receive all keystrokes from all keyboards 61It will then receive all keystrokes from all keyboards
61and, furthermore, keyboards can be dynamically attached and detached without 62and, furthermore, keyboards can be dynamically attached and detached without
62further user interaction. 63further user interaction.
 64Additionally, bell events generated for the display will be directed to
 65all attached
 66.Xr wsbell 4
 67devices.
63In a similar way, the window system will open the mouse multiplexor 68In a similar way, the window system will open the mouse multiplexor
64and receive all mouse events; mice can also be dynamically attached 69and receive all mouse events; mice can also be dynamically attached
65and detached. 70and detached.
66.Pp 71.Pp
67If a 72If a
68.Xr wskbd 4 73.Xr wskbd 4 ,
 74.X4 wsbell 4 ,
69or 75or
70.Xr wsmouse 4 76.Xr wsmouse 4
71device is opened despite having a mux it will be detached from the mux. 77device is opened despite having a mux it will be detached from the mux.
72.Pp 78.Pp
73It is also possible to inject events into a multiplexor from a 79It is also possible to inject events into a multiplexor from a
74user program. 80user program.
75.\" This is used by the 81.\" This is used by the
76.\" .Xr moused 8 82.\" .Xr moused 8
77.\" daemon to take data from a mouse connected to a serial port and 83.\" daemon to take data from a mouse connected to a serial port and
78.\" make it appear on the standard mouse mux. 84.\" make it appear on the standard mouse mux.
79.Sh FILES 85.Sh FILES
80For each mux device, 86For each mux device,
81.Pa /dev/wsmuxN 87.Pa /dev/wsmuxN
@@ -89,23 +95,24 @@ e.g., by @@ -89,23 +95,24 @@ e.g., by
89.Bl -item 95.Bl -item
90.It 96.It
91.Pa /dev/wsmouse 97.Pa /dev/wsmouse
92a.k.a. 98a.k.a.
93.Pa /dev/wsmux0 99.Pa /dev/wsmux0
94.It 100.It
95.Pa /dev/wskbd 101.Pa /dev/wskbd
96a.k.a. 102a.k.a.
97.Pa /dev/wsmux1 103.Pa /dev/wsmux1
98.It 104.It
99.Pa /usr/include/dev/wscons/wsconsio.h 105.Pa /usr/include/dev/wscons/wsconsio.h
100.El 106.El
101.Sh SEE ALSO 107.Sh SEE ALSO
 108.Xr wsbell 4 ,
102.Xr wscons 4 , 109.Xr wscons 4 ,
103.Xr wsdisplay 4 , 110.Xr wsdisplay 4 ,
104.Xr wskbd 4 , 111.Xr wskbd 4 ,
105.Xr wsmouse 4 , 112.Xr wsmouse 4 ,
106.Xr moused 8 , 113.Xr moused 8 ,
107.Xr wsconscfg 8 , 114.Xr wsconscfg 8 ,
108.Xr wsconsctl 8 , 115.Xr wsconsctl 8 ,
109.Xr wsfontload 8 , 116.Xr wsfontload 8 ,
110.Xr wsmoused 8 , 117.Xr wsmoused 8 ,
111.Xr wsmuxctl 8 118.Xr wsmuxctl 8