hw/arm/virt: pass VirtMachineState instead of VirtGuestInfo
[qemu.git] / docs / multiseat.txt
1
2 multiseat howto (with some multihead coverage)
3 ==============================================
4
5 host devices
6 ------------
7
8 First you must compile qemu with a user interface supporting
9 multihead/multiseat and input event routing.  Right now this
10 list includes sdl2, gtk (both 2+3) and vnc:
11
12   ./configure --enable-sdl --with-sdlabi=2.0
13
14 or
15
16   ./configure --enable-gtk
17
18
19 Next put together the qemu command line (sdk/gtk):
20
21 qemu    -enable-kvm -usb $memory $disk $whatever \
22         -display [ sdl | gtk ] \
23         -vga std \
24         -device usb-tablet
25
26 That is it for the first seat, which will use the standard vga, the
27 standard ps/2 keyboard (implicitly there) and the usb-tablet.  Now the
28 additional switches for the second seat:
29
30         -device pci-bridge,addr=12.0,chassis_nr=2,id=head.2 \
31         -device secondary-vga,bus=head.2,addr=02.0,id=video.2 \
32         -device nec-usb-xhci,bus=head.2,addr=0f.0,id=usb.2 \
33         -device usb-kbd,bus=usb.2.0,port=1,display=video.2 \
34         -device usb-tablet,bus=usb.2.0,port=2,display=video.2
35
36 This places a pci bridge in slot 12, connects a display adapter and
37 xhci (usb) controller to the bridge.  Then it adds a usb keyboard and
38 usb mouse, both connected to the xhci and linked to the display.
39
40 The "display=video2" sets up the input routing.  Any input coming from
41 the window which belongs to the video.2 display adapter will be routed
42 to these input devices.
43
44 Starting with qemu 2.4 and linux kernel 4.1 you can also use virtio
45 for the input devices, using this ...
46
47         -device pci-bridge,addr=12.0,chassis_nr=2,id=head.2 \
48         -device secondary-vga,bus=head.2,addr=02.0,id=video.2 \
49         -device virtio-keyboard-pci,bus=head.2,addr=03.0,display=video.2 \
50         -device virtio-tablet-pci,bus=head.2,addr=03.0,display=video.2
51
52 ... instead of xhci and usb hid devices.
53
54 host ui
55 -------
56
57 The sdl2 ui will start up with two windows, one for each display
58 device.  The gtk ui will start with a single window and each display
59 in a separate tab.  You can either simply switch tabs to switch heads,
60 or use the "View / Detach tab" menu item to move one of the displays
61 to its own window so you can see both display devices side-by-side.
62
63 For vnc some additional configuration on the command line is needed.
64 We'll create two vnc server instances, and bind the second one to the
65 second seat, simliar to input devices:
66
67         -display vnc=:1,id=primary \
68         -display vnc=:2,id=secondary,display=video.2
69
70 Connecting to vnc display :1 gives you access to the first seat, and
71 likewise connecting to vnc display :2 shows the second seat.
72
73 Note on spice: Spice handles multihead just fine.  But it can't do
74 multiseat.  For tablet events the event source is sent to the spice
75 agent.  But qemu can't figure it, so it can't do input routing.
76 Fixing this needs a new or extended input interface between
77 libspice-server and qemu.  For keyboard events it is even worse:  The
78 event source isn't included in the spice protocol, so the wire
79 protocol must be extended to support this.
80
81
82 guest side
83 ----------
84
85 You need a pretty recent linux guest.  systemd with loginctl.  kernel
86 3.14+ with CONFIG_DRM_BOCHS enabled.  Fedora 20 will do.  Must be
87 fully updated for the new kernel though, i.e. the live iso doesn't cut
88 it.
89
90 Now we'll have to configure the guest.  Boot and login.  "lspci -vt"
91 should list the pci bridge with the display adapter and usb controller:
92
93     [root@fedora ~]# lspci -vt
94     -[0000:00]-+-00.0  Intel Corporation 440FX - 82441FX PMC [Natoma]
95                [ ... ]
96                \-12.0-[01]--+-02.0  Device 1234:1111
97                             \-0f.0  NEC Corporation USB 3.0 Host Controller
98
99 Good.  Now lets tell the system that the pci bridge and all devices
100 below it belong to a separate seat by dropping a file into
101 /etc/udev/rules.d:
102
103     [root@fedora ~]# cat /etc/udev/rules.d/70-qemu-autoseat.rules
104     SUBSYSTEMS=="pci", DEVPATH=="*/0000:00:12.0", TAG+="seat", ENV{ID_AUTOSEAT}="1"
105
106 Reboot.  System should come up with two seats.  With loginctl you can
107 check the configuration:
108
109     [root@fedora ~]# loginctl list-seats
110     SEAT
111     seat0
112     seat-pci-pci-0000_00_12_0
113
114     2 seats listed.
115
116 You can use "loginctl seat-status seat-pci-pci-0000_00_12_0" to list
117 the devices attached to the seat.
118
119 Background info is here:
120   http://www.freedesktop.org/wiki/Software/systemd/multiseat/
121
122
123 guest side with pci-bridge-seat
124 -------------------------------
125
126 Qemu version 2.4 and newer has a new pci-bridge-seat device which
127 can be used instead of pci-bridge.  Just swap the device name in the
128 qemu command line above.  The only difference between the two devices
129 is the pci id.  We can match the pci id instead of the device path
130 with a nice generic rule now, which simplifies the guest
131 configuration:
132
133     [root@fedora ~]# cat /etc/udev/rules.d/70-qemu-pci-bridge-seat.rules
134     SUBSYSTEM=="pci", ATTR{vendor}=="0x1b36", ATTR{device}=="0x000a", \
135             TAG+="seat", ENV{ID_AUTOSEAT}="1"
136
137 Patch with this rule has been submitted to upstream udev/systemd, was
138 accepted and should be included in the next systemd release (222).
139 So, if your guest has this or a newer version, multiseat will work just
140 fine without any manual guest configuration.
141
142 Enjoy!
143
144 --
145 Gerd Hoffmann <kraxel@redhat.com>