[xen staging] public/gnttab: relax v2 recommendation

[patchbot@xxxxxxx]

commit 2d72d2784eb71d8532bfbd6462d261739c9e82e4
Author:     Jan Beulich <jbeulich@xxxxxxxx>
AuthorDate: Tue Nov 16 17:34:06 2021 +0100
Commit:     Jan Beulich <jbeulich@xxxxxxxx>
CommitDate: Tue Nov 16 17:34:06 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>
    Release-Acked-by: Ian Jackson <iwj@xxxxxxxxxxxxxx>
---
 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 4dceed20bb..7934d7b718 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