Re: [Xen-devel] [PATCH 3/3] docs: document CONTROL command of xenstore protocol

[Ian Jackson <ian.jackson@xxxxxxxxxxxxx>]

Juergen Gross writes ("[PATCH 3/3] docs: document CONTROL command of xenstore 
protocol"):
> The CONTROL command (former DEBUG command) isn't specified in the
> xenstore protocol doc. Add it.
...
> -DEBUG                        print|<string>|??           sends <string> to 
> debug log
> -DEBUG                        print|<thing-with-no-nul>   EINVAL
> -DEBUG                        check|??                    checks xenstored 
> innards
> -DEBUG                        <anything-else|>            no-op (future 
> extension)
> +CONTROL                      <command>|[<parameters>|]
> +     Send a control command <command> with optional parameters
> +     (<parameters>) to Xenstore daemon. <command> support is
> +     implementation specific and might change in future.
>  
> -     These requests should not generally be used and may be
> -     withdrawn in the future.

I should retain a stronger imprecation.  How about:

      The set of commands and their semantics is implementation
      specific and is likely to change from one Xen version to the
      next.  Out-of-tree users will encounter compatibility issues.

Ian.

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxx
https://lists.xen.org/xen-devel