docs: virsh: clarify behavior of send-key

https://bugzilla.redhat.com/show_bug.cgi?id=860004
(cherry picked from commit 2143ced7f5)
This commit is contained in:
Cole Robinson 2012-10-20 19:55:24 -04:00
parent a5f8a78f90
commit 6bae2c413d

View File

@ -1289,6 +1289,10 @@ will be held for that many milliseconds. The default codeset is
B<linux>, but use of the I<--codeset> option allows other codesets to B<linux>, but use of the I<--codeset> option allows other codesets to
be chosen. 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 =over 4
=item B<linux> =item B<linux>
@ -1353,10 +1357,14 @@ bit of the first byte. No symbolic names are provided.
=back =back
B<Examples> B<Examples>
# 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 virsh send-key dom --codeset xt 37 18 21
# send one stroke 'right-ctrl+C' # send one stroke 'right-ctrl+C'
virsh send-key dom KEY_RIGHTCTRL KEY_C virsh send-key dom KEY_RIGHTCTRL KEY_C
# send a tab, held for 1 second # send a tab, held for 1 second
virsh send-key --holdtime 1000 0xf virsh send-key --holdtime 1000 0xf