On Mon, Dec 14, 2015 at 12:28:50PM -0500, Paolo Bonzini wrote: > > Well qapi/qmp docs say things like: > > > > Any name (command, event, type, field, or enum value) beginning with > > "x-" is marked experimental, and may be withdrawn or changed > > incompatibly in a future release. > > > > It's thus reasonable to use this for internal properties, > > that we don't want users to play with. > > What distinguishes an internal from an external property? Everything > except links to backends would be "internal".
How do you mean? We have a ton of properties e.g. to control which offloads are allowed for virtio net. Internal are properties which are not there for users, performing some technical function instead. > We've used a much more restrictive definition so far than that---basically > known-broken or debugging-only---and I think it's more appropriate. > > > BTW, we probably should teach -help to hide these options by default. > > Please, no obscuring of functionality. Debugging-only functionality > definitely belongs in -help. > > Paolo Sure. This option is not for debugging though. It's set internally by machine types to avoid breaking migration. I don't see any reason for users to set it. -- MST
