diff --git a/tools/virsh.pod b/tools/virsh.pod index 6c10245a8723604030253b509e8909ae41afacae..36fedb76cd8179c95de0c92c35881cf77bf8c966 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -322,87 +322,6 @@ running B. When in a paused state the domain will still consume allocated resources like memory, but will not be eligible for scheduling by the hypervisor. -=item B I [I<--codeset> B] -[I<--holdtime> B] I... - -Parse the I sequence as keystrokes to send to I. -Each I can either be a numeric value or a symbolic name from -the corresponding codeset. If I<--holdtime> is given, each keystroke -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. - -=over 4 - -=item B - -The numeric values are those defined by the Linux generic input -event subsystem. The symbolic names match the corresponding -Linux key constant macro names. - -=item B - -The numeric values are those defined by the original XT keyboard -controller. No symbolic names are provided - -=item B - -The numeric values are those defined by the AT keyboard controller, -set 1 (aka XT compatible set). Extended keycoes from B -may differ from extended keycodes in the B codeset. No symbolic -names are provided - -=item B - -The numeric values are those defined by the AT keyboard controller, -set 2. No symbolic names are provided - -=item B - -The numeric values are those defined by the AT keyboard controller, -set 3 (aka PS/2 compatible set). No symbolic names are provided - -=item B - -The numeric values are those defined by the OS-X keyboard input -subsystem. The symbolic names match the corresponding OS-X key -constant macro names - -=item B - -The numeric values are those defined by the Linux KBD device. -These are a variant on the original XT codeset, but often with -different encoding for extended keycodes. No symbolic names are -provided. - -=item B - -The numeric values are those defined by the Win32 keyboard input -subsystem. The symbolic names match the corresponding Win32 key -constant macro names - -=item B - -The numeric values are those defined by the USB HID specification -for keyboard input. No symbolic names are provided - -=item B - -The numeric values are those defined by the RFB extension for sending -raw keycodes. These are a variant on the XT codeset, but extended -keycodes have the low bit of the second byte set, instead of the high -bit of the first byte. No symbolic names are provided. - -=back - -B - # send three strokes 'k', 'e', 'y', using xt codeset - 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 - =item B The domain is in the process of shutting down, i.e. the guest operating system @@ -1017,6 +936,87 @@ of screen. In case of multiple graphics cards, heads are enumerated before devices, e.g. having two graphics cards, both with four heads, screen ID 5 addresses the second head on the second card. +=item B I [I<--codeset> B] +[I<--holdtime> B] I... + +Parse the I sequence as keystrokes to send to I. +Each I can either be a numeric value or a symbolic name from +the corresponding codeset. If I<--holdtime> is given, each keystroke +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. + +=over 4 + +=item B + +The numeric values are those defined by the Linux generic input +event subsystem. The symbolic names match the corresponding +Linux key constant macro names. + +=item B + +The numeric values are those defined by the original XT keyboard +controller. No symbolic names are provided + +=item B + +The numeric values are those defined by the AT keyboard controller, +set 1 (aka XT compatible set). Extended keycoes from B +may differ from extended keycodes in the B codeset. No symbolic +names are provided + +=item B + +The numeric values are those defined by the AT keyboard controller, +set 2. No symbolic names are provided + +=item B + +The numeric values are those defined by the AT keyboard controller, +set 3 (aka PS/2 compatible set). No symbolic names are provided + +=item B + +The numeric values are those defined by the OS-X keyboard input +subsystem. The symbolic names match the corresponding OS-X key +constant macro names + +=item B + +The numeric values are those defined by the Linux KBD device. +These are a variant on the original XT codeset, but often with +different encoding for extended keycodes. No symbolic names are +provided. + +=item B + +The numeric values are those defined by the Win32 keyboard input +subsystem. The symbolic names match the corresponding Win32 key +constant macro names + +=item B + +The numeric values are those defined by the USB HID specification +for keyboard input. No symbolic names are provided + +=item B + +The numeric values are those defined by the RFB extension for sending +raw keycodes. These are a variant on the XT codeset, but extended +keycodes have the low bit of the second byte set, instead of the high +bit of the first byte. No symbolic names are provided. + +=back + +B + # send three strokes 'k', 'e', 'y', using xt codeset + 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 + =item B I B [[I<--config>] [I<--live>] | [I<--current>]]