Commit 979da8b3 authored by Marc-André Lureau's avatar Marc-André Lureau Committed by Dr. David Alan Gilbert
Browse files

docs/devel/migration: start a debugging section 



Explain how to use analyze-migration.py, this may help.

Signed-off-by: default avatarMarc-André Lureau <marcandre.lureau@redhat.com>
Message-Id: <20200330174852.456148-1-marcandre.lureau@redhat.com>
Reviewed-by: default avatarDr. David Alan Gilbert <dgilbert@redhat.com>
Reviewed-by: default avatarDaniel P. Berrangé <berrange@redhat.com>
Signed-off-by: default avatarDr. David Alan Gilbert <dgilbert@redhat.com>
parent 7ac5529a

docs/devel/migration.rst

+20 −0
Original line number Diff line number Diff line
@@ -50,6 +50,26 @@ All these migration protocols use the same infrastructure to 
save/restore state devices.  This infrastructure is shared with the

savevm/loadvm functionality.



Debugging

=========



The migration stream can be analyzed thanks to `scripts/analyze_migration.py`.



Example usage:



.. code-block:: shell



  $ qemu-system-x86_64

   (qemu) migrate "exec:cat > mig"

  $ ./scripts/analyze_migration.py -f mig

  {

    "ram (3)": {

        "section sizes": {

            "pc.ram": "0x0000000008000000",

  ...



See also ``analyze_migration.py -h`` help for more options.



Common infrastructure

=====================