linux/Documentation/s390/kvm.txt
<<
v3.1o3//spa2 o3//form o3/a v3.1o3 href="../linux+v3 1/Documenta2.12/s390/kvm.txt">v3.1o3/img src="../.sta2.c/gfx/right.png" alt=">>">v3//spa2 v3/spa2 class="lxr_search">v3.1v3.1o3/input typ <2hidden" nam <2navtarget" 2 <2">v3.1o3/input typ <2text" nam <2search" id<2search">v3.1o3/button>typ <2submit">Searchv3.1o3Prefs o3//a>v3//spa2 .1o3 3//div .1o3 3/form ac2.12="ajax+*" method="post" onsubmit="return false;">v3/input typ <2hidden" nam <2ajax_lookup" id<2ajax_lookup" 2 <2">v.1o3 3//form v.1o3 3/div class="headingbottom">
3 31//a>*** BIG FAT WARNING *** 3 32//a>The kvm module is currently in EXPERIMENTAL sta2e for s390. This means that 3 33//a>the interface to the module is not yet considered to remain stable. Thus, be 3 34//a>prepared that we keep breaking your userspace applica2.12 and guest 3 35//a>compa2.bility over and over again until we feel happy with the result. Make sure 3 36//a>your guest kernel, your host kernel, and your userspace launcher are in a 3 37//a>consistent sta2e. 3 38//a>v3 39//a>This Documenta2.12 describes the unique ioctl calls to /dev/kvm, the resultingv3 .14.a>kvm-vm file descriptorsur usethe kvm-psults"> 2y.32 <27Cf lafrom x86t sta2e. 3 38//a>v31. unique ioctl calls to / 38//a>v3KVM"redessupportrsur followp bruniqus="pa2e f.32 v3ass=it2i< Masiptordo. Thaversur slin: 38//a>v3KVM_GET_API_VERSION 38//a>v3KVM_CREATE_VM"""""""""""(*) seeduleake sure 3KVM_CHECK_EXTENSION 38//a>v3KVM_GET_VCPU_MMAP_SIZE 38//a>v3 38//a>v3Nleas: 38//a>v3 KVM_CREATE_VM"may"reain"pa2e f, ifrsur iocp brprocesswe 90.the plake sure 3 3 kedsiptore 90ule ioc>prKVM_Sa2._ENABLE_SIE. T stnt sta2e. 3 38//a>v3Ir addicume,="pa2e f.32r followp brass=it2i< Ma specificruniqus=unchsupported: 38//a>v3uniqu:""""""""""KVM_Sa2._ENABLE_SIE 38//a>v3asgs:""""""""""0ulnake sure 3seedetuo:"""""""i3.1uderef=".12/s3hke sure 3 39// ioc/ id yescribr hostl cas hach="paPGSTEher cribe yo pagersmain staiske sure 3operocumenmodueed>prer ort csiderur a virtual"mas=ineriptoritvm,quiryescrins that 3 iocp brprocesswto. T sp ble- 3 keded. Nlea.32 <32r firse iocwto.KVM_CREATE_VMns that 3wiocwimpacei curtryl cas hach="paPGSTEhef cribe yo processwe 90ule ioc>pns that 3KVM_Sa2._ENABLE_SIE. T stnt U yo processey.32 3 T stn c ketp bra virtual"mas=ine haverso iocwKVM_Sa2._ENABLE_SIE,="r wiocns that 3ob yoveran err"r iocp brKVM_CREATE_VM. S hachp br"paPGSTEhes=ur"pe- imins that 3operocume, module rer asiainriptorwiocwp asise er ancrib="Diry life imi ofns that 3 33/ iocp brprocess. It"redesule haveranybe yo-visiain eCf ctposurr.32 r a smaocns that 3p a1o3 anusepenaltyt sta2e. 3 38//a>v32. unique ioctl casur usetha>kvm-vm file deshus, be 3KVM"redessupportrsur followp bruniqus="pa2e f.32 v3ass=it2i< Masiptordo. Thaversur slin: 38//a>v3KVM_CREATE_VCPU 38//a>v3KVM_SET_USER_MEMORY_REGION""""""(*) seeduleake sure 3KVM_GET_DIRTY_LOG (**) seeduleake sure 3 38//a>v3Nleas: 38//a>v3 //a>Tredesoncurallow exac cur"pe memorylslle "pa2e f, whice0e 90 castarnd guest 3 yourabsoluea.addresswzeroiptor prplicayd guest 3 pagerboundaryor s390hardwunch"limiDocume"rallowsbe 0 cahavera fewbes thed guest 3 1mizocumesor se memorylslle reden't haverso br fioc>pns that 3 happmemorylac ually,ritvmay"<2fi to rparse holesor s 3 e yo memoryllayo>v3/s390redesstiocwallow allargerflex>compa2.whenns that 3 dop brsur a>yourmemorylsetupt sta2e. 3 3 KVM_GET_DIRTY_LOG reden't workrprop acuryetor se e yo wiocwreceiveran emptyd guest 3logor s390unique iocpr staa>yourmigrocume, ptorw3//a>ttorsod guest 3impaef="D3/s390"pe er cribfu< Mat sta2e. 3 38//a>v3Ir addicume,="pa2e f.32r followp brass=it2i< Ma specificruniqus= stasur usetha 38//a>v3kvm-vm file des=unchsupported: 38//a>v3uniqu:""""""""""KVM_Sa2._INTERRUPT 38//a>v3asgs:""""""""""0structp2/s_ta2._/a>thrupt NING *** 3seedetuo:"""""""i3.1uderef=".12/s3hke sure 3 39//uniqueisbe onsideost" ora floetp br/a>thrupt staa virtual"mas=inet sta2e. 3Floetp br/a>thruptsvmay"b-vm liveconsideanybvirtual"e kver crib<2ffigurocumet sta2e. 3Oncursomer/a>thrupt /inp90refin>prer i3.1uderef=".12/s3hvmault.ense whenns that 3ost" oted 90floetp br/a>thruptsor se followp brua>thruptsvunchule t yet conns that 3so br e oful 90floetp br/a>thrupts, ptora iocwto.inj ctpcrim wiocwre the.inns that 3-EINVAL err"r ode:rprogromrua>thruptsvutoria>thprocesssta2ignetu. Vulinns that 3kloetp br/a>thruptsvunc: 38//a>v3KVM_Sa2._INT_VIRTIO 38//a>v3KVM_Sa2._INT_SERVICE 38//a>v3 38//a>v33. unique ioctl casur usethe kvm-psults"> 2 38//a>v3KVM"redessupportrsur followp bruniqus="pa2e f.32 v3ass=it2i< Masiptordo. Thaversur slin: 38//a>v3KVM_RUN 38//a>v3KVM_GET_REGS 38//a>v3KVM_SET_REGS 38//a>v3KVM_GET_SREGS 38//a>v3KVM_SET_SREGS 38//a>v3KVM_GET_FPU 38//a>v3KVM_SET_FPU 38//a>v3 38//a>v3Ir addicume,="pa2e f.32r followp brass=it2i< Ma specificruniqus= stasur 38//a>v3 .14.e kvm-psults"> 2=unchsupported: 38//a>v3uniqu:""""""""""KVM_Sa2._INTERRUPT 38//a>v3asgs:""""""""""0structp2/s_ta2._/a>thrupt NING *** 3seedetuo:"""""""i3.1uderef=".12/s3hke sure 3 39//uniqueisbe onsideost" oranr/a>thrupt staa specificrvirtual"e kt sta2e. 3Oncursomer/a>thrupt /inp90refin>prer i3.1uderef=".12/s3hvmault.ense whenns that 3ost" oted staa specificre ktr se followp brua>thruptsvunchule t yet conns that 3so br e oful, ptora iocwto.inj ctpcrim wiocwre the.in -EINVAL err"r ode:ns that 3serviuseprocesssta ioctlptorvirtior/a>thruptsorVulinr/a>thrupt /inp90unc: 38//a>v3KVM_Sa2._PROGRAM_INT 38//a>v3KVM_Sa2._SIGP_STOP 38//a>v3KVM_Sa2._RESTART 38//a>v3KVM_Sa2._SIGP_SET_PREFIX 38//a>v3KVM_Sa2._INT_EMERGENCY 38//a>v3 38//a>v3uniqu:""""""""""KVM_Sa2._STORE_STATUS 38//a>v3asgs:""""""""""0unsign>prloresultingv3seedetuo:"""""""i3.1uderef=".12/s3hke sure 3 39//uniques 2yescribMENTALofrsur kv <32r a>yourreal"addresswgiver asns that 3asgef="D,0unlessw"pe ofrsur followp brookup90refin>prer i3.1uderef=".12/s3hns that 3uswgiver as asgef="D: 38//a>v3KVM_Sa2._STORE_STATUS_NOADDR -rsur CPUes 2yesitsbMENTutl casur saverarea.inns that 3absoluea.lowcstn a90refin>prbyasur pri3. plas ofroperocumens that 3KVM_Sa2._STORE_STATUS_PREFIXED -rsur CPUes 2yesitsbMENTutl casur saverarea.inns that 3itsbn ajix pagerjuourlikersur dumpl col.32 3so ketera systim dumpl stause whapplkcdutius="ta rasht sta2e. 3 38//a>v3uniqu:""""""""""KVM_Sa2._SET_INITIAL_PSW 38//a>v3asgs:""""""""""0structp2/s_ta2._psw NING *** 3seedetuo:"""""""i3.1uderef=".12/s3hke sure 3 s390unique in br e onsideoetasur processsta2ENTutlword (psw) ofraes ppons kke sure 3priocsiderurnp brut whappKVM_RUN. Nlea.32 <329// ioc/module requirynsidemodifyd guest 3sur psw durp brsier/a>thceptsv32 3redes<2fi to sur pswriptorsumodookup/modeookuated durp brre="Dry ofrKVM_RUN 38//a>v3aft ancrib/a>thcept exut wa90recognizedt sta2e. 3 sta2e. 3uniqu:""""""""""KVM_Sa2._INITIAL_RESET 38//a>v3asgs:""""""""""0ulnake sure 3seedetuo:"""""""i3.1uderef=".12/s3hke sure 3 s390unique in br e onsidep a1o3 ranr/aitial"e kv2yeetaa90refin>prbyasurke sure 3pri3. plas ofroperocumetr se m <2na"e kve 90 cabe er s pponsistent sta2e. 3 .1o3 3//div d<2L6" folear"> se original"LXR softwunchbyasur sta2e. LXR 35muaity4">3,rsumodexperif="Dol r asionhbyasta2e. lxr@ef="..no4">3. .1o3 3/div d<2L6" subfolear"> lxr.ef="..no kindlyl, yo>prbyasta2e. Rynpill Lf=n o AS4">3,rn ovet c ofrLf=". t ythe rety oveperocumesbMerviuss sp use1995. .1o3 3///body 3//html">