From 6bae2c413d6a65a56e043464af4508d10d64cd48 Mon Sep 17 00:00:00 2001 From: Cole Robinson Date: Sat, 20 Oct 2012 19:55:24 -0400 Subject: [PATCH] docs: virsh: clarify behavior of send-key https://bugzilla.redhat.com/show_bug.cgi?id=860004 (cherry picked from commit 2143ced7f557db6486623c8ce0ca296aeb7b8392) --- tools/virsh.pod | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/tools/virsh.pod b/tools/virsh.pod index c02ffe8232..1b771c73c8 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -1289,6 +1289,10 @@ will be held for that many milliseconds. The default codeset is B, but use of the I<--codeset> option allows other codesets to be chosen. +If multiple keycodes are specified, they are all sent simultaneously +to the guest, and they may be received in random order. If you need +distinct keypresses, you must use multiple send-key invocations. + =over 4 =item B @@ -1353,10 +1357,14 @@ bit of the first byte. No symbolic names are provided. =back B - # send three strokes 'k', 'e', 'y', using xt codeset + # send three strokes 'k', 'e', 'y', using xt codeset. these + # are all pressed simultaneously and may be received by the guest + # in random order virsh send-key dom --codeset xt 37 18 21 + # send one stroke 'right-ctrl+C' virsh send-key dom KEY_RIGHTCTRL KEY_C + # send a tab, held for 1 second virsh send-key --holdtime 1000 0xf