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

[Juergen Gross <jgross@xxxxxxxx>]

On 08/05/17 12:13, Ian Jackson wrote:
> 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.

I'm fine with this.


Juergen

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