[PATCH] xbzrle: update xbzrle doc

Mao Zhongyi posted 1 patch 4 years ago
Test docker-mingw@fedora passed
Test docker-quick@centos7 passed
Test checkpatch passed
Test FreeBSD passed
Test asan passed
Patches applied successfully (tree, apply log)
git fetch https://github.com/patchew-project/qemu tags/patchew/20200320143216.423374-1-maozhongyi@cmss.chinamobile.com
Maintainers: "Dr. David Alan Gilbert" <dgilbert@redhat.com>, Juan Quintela <quintela@redhat.com>
docs/xbzrle.txt       | 7 ++++++-
migration/migration.c | 2 +-
monitor/hmp-cmds.c    | 2 +-
3 files changed, 8 insertions(+), 3 deletions(-)
[PATCH] xbzrle: update xbzrle doc
Posted by Mao Zhongyi 4 years ago
Add new parameter description, also:
1. Remove unsociable space.
2. Nit picking: s/two/2 in report

Signed-off-by: Mao Zhongyi <maozhongyi@cmss.chinamobile.com>
---
 docs/xbzrle.txt       | 7 ++++++-
 migration/migration.c | 2 +-
 monitor/hmp-cmds.c    | 2 +-
 3 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/docs/xbzrle.txt b/docs/xbzrle.txt
index c0a7dfd44c..b431bdaf0f 100644
--- a/docs/xbzrle.txt
+++ b/docs/xbzrle.txt
@@ -92,6 +92,11 @@ Usage
 power of 2. The cache default value is 64MBytes. (on source only)
     {qemu} migrate_set_cache_size 256m
 
+Commit 73af8dd8d7 "migration: Make xbzrle_cache_size a migration parameter"
+(v2.11.0) deprecated migrate-set-cache-size, therefore, the new parameter
+is recommended.
+    {qemu} migrate_set_parameter xbzrle-cache-size 256m
+
 4. Start outgoing migration
     {qemu} migrate -d tcp:destination.host:4444
     {qemu} info migrate
@@ -108,7 +113,7 @@ power of 2. The cache default value is 64MBytes. (on source only)
     xbzrle transferred: I kbytes
     xbzrle pages: J pages
     xbzrle cache miss: K
-    xbzrle overflow : L
+    xbzrle overflow: L
 
 xbzrle cache-miss: the number of cache misses to date - high cache-miss rate
 indicates that the cache size is set too low.
diff --git a/migration/migration.c b/migration/migration.c
index c1d88ace7f..4b26110d57 100644
--- a/migration/migration.c
+++ b/migration/migration.c
@@ -1243,7 +1243,7 @@ static bool migrate_params_check(MigrationParameters *params, Error **errp)
         error_setg(errp, QERR_INVALID_PARAMETER_VALUE,
                    "xbzrle_cache_size",
                    "is invalid, it should be bigger than target page size"
-                   " and a power of two");
+                   " and a power of 2");
         return false;
     }
 
diff --git a/monitor/hmp-cmds.c b/monitor/hmp-cmds.c
index f8be6bbb16..dbfb121eb2 100644
--- a/monitor/hmp-cmds.c
+++ b/monitor/hmp-cmds.c
@@ -303,7 +303,7 @@ void hmp_info_migrate(Monitor *mon, const QDict *qdict)
                        info->xbzrle_cache->cache_miss);
         monitor_printf(mon, "xbzrle cache miss rate: %0.2f\n",
                        info->xbzrle_cache->cache_miss_rate);
-        monitor_printf(mon, "xbzrle overflow : %" PRIu64 "\n",
+        monitor_printf(mon, "xbzrle overflow: %" PRIu64 "\n",
                        info->xbzrle_cache->overflow);
     }
 
-- 
2.17.1




Re: [PATCH] xbzrle: update xbzrle doc
Posted by Dr. David Alan Gilbert 4 years ago
* Mao Zhongyi (maozhongyi@cmss.chinamobile.com) wrote:
> Add new parameter description, also:
> 1. Remove unsociable space.
> 2. Nit picking: s/two/2 in report
> 
> Signed-off-by: Mao Zhongyi <maozhongyi@cmss.chinamobile.com>

Reviewed-by: Dr. David Alan Gilbert <dgilbert@redhat.com>

> ---
>  docs/xbzrle.txt       | 7 ++++++-
>  migration/migration.c | 2 +-
>  monitor/hmp-cmds.c    | 2 +-
>  3 files changed, 8 insertions(+), 3 deletions(-)
> 
> diff --git a/docs/xbzrle.txt b/docs/xbzrle.txt
> index c0a7dfd44c..b431bdaf0f 100644
> --- a/docs/xbzrle.txt
> +++ b/docs/xbzrle.txt
> @@ -92,6 +92,11 @@ Usage
>  power of 2. The cache default value is 64MBytes. (on source only)
>      {qemu} migrate_set_cache_size 256m
>  
> +Commit 73af8dd8d7 "migration: Make xbzrle_cache_size a migration parameter"
> +(v2.11.0) deprecated migrate-set-cache-size, therefore, the new parameter
> +is recommended.
> +    {qemu} migrate_set_parameter xbzrle-cache-size 256m
> +
>  4. Start outgoing migration
>      {qemu} migrate -d tcp:destination.host:4444
>      {qemu} info migrate
> @@ -108,7 +113,7 @@ power of 2. The cache default value is 64MBytes. (on source only)
>      xbzrle transferred: I kbytes
>      xbzrle pages: J pages
>      xbzrle cache miss: K
> -    xbzrle overflow : L
> +    xbzrle overflow: L
>  
>  xbzrle cache-miss: the number of cache misses to date - high cache-miss rate
>  indicates that the cache size is set too low.
> diff --git a/migration/migration.c b/migration/migration.c
> index c1d88ace7f..4b26110d57 100644
> --- a/migration/migration.c
> +++ b/migration/migration.c
> @@ -1243,7 +1243,7 @@ static bool migrate_params_check(MigrationParameters *params, Error **errp)
>          error_setg(errp, QERR_INVALID_PARAMETER_VALUE,
>                     "xbzrle_cache_size",
>                     "is invalid, it should be bigger than target page size"
> -                   " and a power of two");
> +                   " and a power of 2");
>          return false;
>      }
>  
> diff --git a/monitor/hmp-cmds.c b/monitor/hmp-cmds.c
> index f8be6bbb16..dbfb121eb2 100644
> --- a/monitor/hmp-cmds.c
> +++ b/monitor/hmp-cmds.c
> @@ -303,7 +303,7 @@ void hmp_info_migrate(Monitor *mon, const QDict *qdict)
>                         info->xbzrle_cache->cache_miss);
>          monitor_printf(mon, "xbzrle cache miss rate: %0.2f\n",
>                         info->xbzrle_cache->cache_miss_rate);
> -        monitor_printf(mon, "xbzrle overflow : %" PRIu64 "\n",
> +        monitor_printf(mon, "xbzrle overflow: %" PRIu64 "\n",
>                         info->xbzrle_cache->overflow);
>      }
>  
> -- 
> 2.17.1
> 
> 
> 
--
Dr. David Alan Gilbert / dgilbert@redhat.com / Manchester, UK


Re: [PATCH] xbzrle: update xbzrle doc
Posted by Dr. David Alan Gilbert 4 years ago
* Mao Zhongyi (maozhongyi@cmss.chinamobile.com) wrote:
> Add new parameter description, also:
> 1. Remove unsociable space.
> 2. Nit picking: s/two/2 in report
> 
> Signed-off-by: Mao Zhongyi <maozhongyi@cmss.chinamobile.com>

Queued

> ---
>  docs/xbzrle.txt       | 7 ++++++-
>  migration/migration.c | 2 +-
>  monitor/hmp-cmds.c    | 2 +-
>  3 files changed, 8 insertions(+), 3 deletions(-)
> 
> diff --git a/docs/xbzrle.txt b/docs/xbzrle.txt
> index c0a7dfd44c..b431bdaf0f 100644
> --- a/docs/xbzrle.txt
> +++ b/docs/xbzrle.txt
> @@ -92,6 +92,11 @@ Usage
>  power of 2. The cache default value is 64MBytes. (on source only)
>      {qemu} migrate_set_cache_size 256m
>  
> +Commit 73af8dd8d7 "migration: Make xbzrle_cache_size a migration parameter"
> +(v2.11.0) deprecated migrate-set-cache-size, therefore, the new parameter
> +is recommended.
> +    {qemu} migrate_set_parameter xbzrle-cache-size 256m
> +
>  4. Start outgoing migration
>      {qemu} migrate -d tcp:destination.host:4444
>      {qemu} info migrate
> @@ -108,7 +113,7 @@ power of 2. The cache default value is 64MBytes. (on source only)
>      xbzrle transferred: I kbytes
>      xbzrle pages: J pages
>      xbzrle cache miss: K
> -    xbzrle overflow : L
> +    xbzrle overflow: L
>  
>  xbzrle cache-miss: the number of cache misses to date - high cache-miss rate
>  indicates that the cache size is set too low.
> diff --git a/migration/migration.c b/migration/migration.c
> index c1d88ace7f..4b26110d57 100644
> --- a/migration/migration.c
> +++ b/migration/migration.c
> @@ -1243,7 +1243,7 @@ static bool migrate_params_check(MigrationParameters *params, Error **errp)
>          error_setg(errp, QERR_INVALID_PARAMETER_VALUE,
>                     "xbzrle_cache_size",
>                     "is invalid, it should be bigger than target page size"
> -                   " and a power of two");
> +                   " and a power of 2");
>          return false;
>      }
>  
> diff --git a/monitor/hmp-cmds.c b/monitor/hmp-cmds.c
> index f8be6bbb16..dbfb121eb2 100644
> --- a/monitor/hmp-cmds.c
> +++ b/monitor/hmp-cmds.c
> @@ -303,7 +303,7 @@ void hmp_info_migrate(Monitor *mon, const QDict *qdict)
>                         info->xbzrle_cache->cache_miss);
>          monitor_printf(mon, "xbzrle cache miss rate: %0.2f\n",
>                         info->xbzrle_cache->cache_miss_rate);
> -        monitor_printf(mon, "xbzrle overflow : %" PRIu64 "\n",
> +        monitor_printf(mon, "xbzrle overflow: %" PRIu64 "\n",
>                         info->xbzrle_cache->overflow);
>      }
>  
> -- 
> 2.17.1
> 
> 
> 
> 
--
Dr. David Alan Gilbert / dgilbert@redhat.com / Manchester, UK