libxc: document save/restore protocol
PATCH 1/1 libxc: document save/restore protocol
# HG changeset patch
# User Ian Campbell <[email protected]> # Date 1283510636 -3600
# Node ID d1449697345dee7b345ce835f14bbf5f86f8ef4e # Parent ff636f6a2fcb846ebd9002b4f339d2c44a45c1b2
libxc: document save/restore protocol
Reverse engineered from the code, likely contains inaccuracies but I think provides a base to work from.
Add symbolic names for the minus-flags.
Signed-off-by Ian Campbell <[email protected]>
tools/libxc/xc_domain_restore.c +8 -8
@@ -690,11 +690,11 @@ static int pagebuf_get_one(xc_interfaceif (!count) {// DPRINTF("Last batch read\n"); return 0 ; - }else if (count ==-1 ) { + }else if (count ==XC_SAVE_ID_ENABLE_VERIFY_MODE ) {DPRINTF ("Entering page verify mode\n" ); buf->verify =1 ;return pagebuf_get_one (xch, ctx, buf, fd, dom); - } else if (count == -2) { + } else if (count == XC_SAVE_ID_VCPU_INFO) { buf->new_ctxt_format = 1; if ( RDEXACT(fd, &buf->max_vcpu_id, sizeof(buf->max_vcpu_id)) || buf->max_vcpu_id >= 64 || RDEXACT(fd, &buf->vcpumap,
@@ -704,7 +704,7 @@ static int pagebuf_get_one(xc_interface }// DPRINTF("Max VCPU ID: %d, vcpumap: %llx\n", buf->max_vcpu_id, buf->vcpumap); return pagebuf_get_one (xch, ctx, buf, fd, dom); - }else if (count ==-3 ) { + }else if (count ==XC_SAVE_ID_HVM_IDENT_PT ) {/* Skip padding 4 bytes then read the EPT identity PT location. */ if (RDEXACT (fd, &buf->identpt,sizeof (uint32_t )) ||RDEXACT (fd, &buf->identpt,sizeof (uint64_t )) )
@@ -714,7 +714,7 @@ static int pagebuf_get_one(xc_interface }// DPRINTF("EPT identity map address: %llx\n", buf->identpt); return pagebuf_get_one (xch, ctx, buf, fd, dom); - }else if ( count ==-4 ) { + }else if ( count ==XC_SAVE_ID_HVM_VM86_TSS ) {/* Skip padding 4 bytes then read the vm86 TSS location. */ if (RDEXACT (fd, &buf->vm86_tss,sizeof (uint32_t )) ||RDEXACT (fd, &buf->vm86_tss,sizeof (uint64_t )) )
@@ -724,7 +724,7 @@ static int pagebuf_get_one(xc_interface }// DPRINTF("VM86 TSS location: %llx\n", buf->vm86_tss); return pagebuf_get_one (xch, ctx, buf, fd, dom); - }else if ( count ==-5 ) { + }else if ( count ==XC_SAVE_ID_TMEM ) {DPRINTF ("xc_domain_restore start tmem\n" );if (xc_tmem_restore (xch, dom, fd) ) {PERROR ("error reading/restoring tmem" );
@@ -732,13 +732,13 @@ static int pagebuf_get_one(xc_interface }return pagebuf_get_one (xch, ctx, buf, fd, dom); } -else if ( count ==-6 ) { +else if ( count ==XC_SAVE_ID_TMEM_EXTRA ) {if (xc_tmem_restore_extra (xch, dom, fd) ) {PERROR ("error reading/restoring tmem extra" );return -1 ; }return pagebuf_get_one (xch, ctx, buf, fd, dom); - }else if ( count ==-7 ) { + }else if ( count ==XC_SAVE_ID_TSC_INFO ) {uint32_t tsc_mode, khz, incarn;uint64_t nsec; if ( RDEXACT(fd, &tsc_mode, sizeof(uint32_t)) ||
@@ -750,7 +750,7 @@ static int pagebuf_get_one(xc_interfacereturn -1 ; }return pagebuf_get_one (xch, ctx, buf, fd, dom); - }else if (count ==-8 ) { + }else if (count ==XC_SAVE_ID_HVM_CONSOLE_PFN ) {/* Skip padding 4 bytes then read the console pfn location. */ if (RDEXACT (fd, &buf->console_pfn,sizeof (uint32_t )) ||RDEXACT (fd, &buf->console_pfn,sizeof (uint64_t )) )
tools/libxc/xc_domain_save.c +10 -10
@@ -861,7 +861,7 @@ static xen_pfn_t *map_and_save_p2m_table/* must be done AFTER suspend_and_state() */ static int save_tsc_info (xc_interface *xch,uint32_t dom,int io_fd) { -int marker =-7 ; +int marker =XC_SAVE_ID_TSC_INFO ;uint32_t tsc_mode, khz, incarn;uint64_t nsec;
@@ -1142,7 +1142,7 @@ int xc_domain_save(xc_interface *xch, inprint_stats (xch, dom,0 , &stats,0 ); - tmem_saved =xc_tmem_save (xch, dom, io_fd, live,-5 ); + tmem_saved =xc_tmem_save (xch, dom, io_fd, live,XC_SAVE_ID_TMEM );if ( tmem_saved ==-1 ) {PERROR ("Error when writing to state file (tmem)" );
@@ -1474,13 +1474,13 @@ int xc_domain_save(xc_interface *xch, inif ( last_iter && debug ) { -int minusone =-1 ; +int id =XC_SAVE_ID_ENABLE_VERIFY_MODE ;memset (to_send,0xff ,BITMAP_SIZE ); debug =0 ;DPRINTF ("Entering debug resend-all mode\n" );/* send "-1" to put receiver into debug mode */ -if (wrexact (io_fd, &minusone,sizeof (int )) ) +if (wrexact (io_fd, &id,sizeof (int )) ) {PERROR ("Error when writing to state file (6)" ); goto out;
@@ -1511,7 +1511,7 @@ int xc_domain_save(xc_interface *xch, inDPRINTF ("SUSPEND shinfo %08lx\n" , info.shared_info_frame);if ( (tmem_saved >0 ) && - (xc_tmem_save_extra (xch,dom,io_fd,-6 ) ==-1 ) ) + (xc_tmem_save_extra (xch,dom,io_fd,XC_SAVE_ID_TMEM_EXTRA ) ==-1 ) ) {PERROR ("Error when writing to state file (tmem)" ); goto out;
@@ -1545,10 +1545,10 @@ int xc_domain_save(xc_interface *xch, in {struct { -int minustwo; +int id;int max_vcpu_id;uint64_t vcpumap; - } chunk = {-2 , info.max_vcpu_id }; + } chunk = {XC_SAVE_ID_VCPU_INFO , info.max_vcpu_id };if ( info.max_vcpu_id >=64 ) {
@@ -1580,7 +1580,7 @@ int xc_domain_save(xc_interface *xch, inuint64_t data; } chunk = { 0, }; - chunk.id =-3 ; + chunk.id =XC_SAVE_ID_HVM_IDENT_PT ;xc_get_hvm_param (xch, dom,HVM_PARAM_IDENT_PT , (unsigned long *)&chunk.data);
@@ -1591,7 +1591,7 @@ int xc_domain_save(xc_interface *xch, in goto out; } - chunk.id =-4 ; + chunk.id =XC_SAVE_ID_HVM_VM86_TSS ;xc_get_hvm_param (xch, dom,HVM_PARAM_VM86_TSS , (unsigned long *)&chunk.data);
@@ -1602,7 +1602,7 @@ int xc_domain_save(xc_interface *xch, in goto out; } - chunk.id =-8 ; + chunk.id =XC_SAVE_ID_HVM_CONSOLE_PFN ;xc_get_hvm_param (xch, dom,HVM_PARAM_CONSOLE_PFN , (unsigned long *)&chunk.data);
tools/libxc/xg_save_restore.h +112 -1
123 lines not on this page · raw message