[xen staging-4.15] public/gnttab: relax v2 recommendation

[patchbot@xxxxxxx]

commit 2a19ee2ba6fa2b36e4d9331f9dc40bda40f7358e
Author:     Jan Beulich <jbeulich@xxxxxxxx>
AuthorDate: Fri Nov 19 09:33:03 2021 +0100
Commit:     Jan Beulich <jbeulich@xxxxxxxx>
CommitDate: Fri Nov 19 09:33:03 2021 +0100

    public/gnttab: relax v2 recommendation
    
    With there being a way to disable v2 support, telling new guests to use
    v2 exclusively is not a good suggestion.
    
    Signed-off-by: Jan Beulich <jbeulich@xxxxxxxx>
    Reviewed-by: Luca Fancellu <luca.fancellu@xxxxxxx>
    master commit: 2d72d2784eb71d8532bfbd6462d261739c9e82e4
    master date: 2021-11-16 17:34:06 +0100
---
 xen/include/public/grant_table.h | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/xen/include/public/grant_table.h b/xen/include/public/grant_table.h
index 84b1d26b36..61be5accee 100644
--- a/xen/include/public/grant_table.h
+++ b/xen/include/public/grant_table.h
@@ -121,8 +121,9 @@ typedef uint32_t grant_ref_t;
  */
 
 /*
- * Version 1 of the grant table entry structure is maintained purely
- * for backwards compatibility.  New guests should use version 2.
+ * Version 1 of the grant table entry structure is maintained largely for
+ * backwards compatibility.  New guests are recommended to support using
+ * version 2 to overcome version 1 limitations, but to default to version 1.
  */
 #if __XEN_INTERFACE_VERSION__ < 0x0003020a
 #define grant_entry_v1 grant_entry
--
generated by git-patchbot for /home/xen/git/xen.git#staging-4.15