aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/virtual
diff options
context:
space:
mode:
authorJan Kiszka <jan.kiszka@siemens.com>2012-04-24 10:40:16 -0400
committerMarcelo Tosatti <mtosatti@redhat.com>2012-04-27 18:40:29 -0400
commit0589ff6c11d8128cf053c3ddc75b0f6d8b71c62b (patch)
treea83f052199ead693e8aa1299100e2f0da168d982 /Documentation/virtual
parent414fa985f91bdf61fe2baf8111c0ddbdb94808ea (diff)
KVM: x86: Document in-kernel PIT API
Add descriptions for KVM_CREATE_PIT2 and KVM_GET/SET_PIT2. Signed-off-by: Jan Kiszka <jan.kiszka@siemens.com> Signed-off-by: Marcelo Tosatti <mtosatti@redhat.com>
Diffstat (limited to 'Documentation/virtual')
-rw-r--r--Documentation/virtual/kvm/api.txt63
1 files changed, 63 insertions, 0 deletions
diff --git a/Documentation/virtual/kvm/api.txt b/Documentation/virtual/kvm/api.txt
index b48f92786ab3..a7cb93cb2154 100644
--- a/Documentation/virtual/kvm/api.txt
+++ b/Documentation/virtual/kvm/api.txt
@@ -1789,6 +1789,69 @@ struct kvm_msi {
1789No flags are defined so far. The corresponding field must be 0. 1789No flags are defined so far. The corresponding field must be 0.
1790 1790
1791 1791
17924.71 KVM_CREATE_PIT2
1793
1794Capability: KVM_CAP_PIT2
1795Architectures: x86
1796Type: vm ioctl
1797Parameters: struct kvm_pit_config (in)
1798Returns: 0 on success, -1 on error
1799
1800Creates an in-kernel device model for the i8254 PIT. This call is only valid
1801after enabling in-kernel irqchip support via KVM_CREATE_IRQCHIP. The following
1802parameters have to be passed:
1803
1804struct kvm_pit_config {
1805 __u32 flags;
1806 __u32 pad[15];
1807};
1808
1809Valid flags are:
1810
1811#define KVM_PIT_SPEAKER_DUMMY 1 /* emulate speaker port stub */
1812
1813This IOCTL replaces the obsolete KVM_CREATE_PIT.
1814
1815
18164.72 KVM_GET_PIT2
1817
1818Capability: KVM_CAP_PIT_STATE2
1819Architectures: x86
1820Type: vm ioctl
1821Parameters: struct kvm_pit_state2 (out)
1822Returns: 0 on success, -1 on error
1823
1824Retrieves the state of the in-kernel PIT model. Only valid after
1825KVM_CREATE_PIT2. The state is returned in the following structure:
1826
1827struct kvm_pit_state2 {
1828 struct kvm_pit_channel_state channels[3];
1829 __u32 flags;
1830 __u32 reserved[9];
1831};
1832
1833Valid flags are:
1834
1835/* disable PIT in HPET legacy mode */
1836#define KVM_PIT_FLAGS_HPET_LEGACY 0x00000001
1837
1838This IOCTL replaces the obsolete KVM_GET_PIT.
1839
1840
18414.73 KVM_SET_PIT2
1842
1843Capability: KVM_CAP_PIT_STATE2
1844Architectures: x86
1845Type: vm ioctl
1846Parameters: struct kvm_pit_state2 (in)
1847Returns: 0 on success, -1 on error
1848
1849Sets the state of the in-kernel PIT model. Only valid after KVM_CREATE_PIT2.
1850See KVM_GET_PIT2 for details on struct kvm_pit_state2.
1851
1852This IOCTL replaces the obsolete KVM_SET_PIT.
1853
1854
17925. The kvm_run structure 18555. The kvm_run structure
1793------------------------ 1856------------------------
1794 1857