2012-04-20 03:40:24 +02:00
|
|
|
check-qdict
|
|
|
|
check-qfloat
|
|
|
|
check-qint
|
|
|
|
check-qjson
|
|
|
|
check-qlist
|
|
|
|
check-qstring
|
2014-01-27 09:26:21 +01:00
|
|
|
check-qom-interface
|
qom: Add object_new_with_props() / object_new_withpropv() helpers
It is reasonably common to want to create an object, set a
number of properties, register it in the hierarchy and then
mark it as complete (if a user creatable type). This requires
quite a lot of error prone, verbose, boilerplate code to achieve.
First a pair of functions object_set_props() / object_set_propv()
are added which allow for a list of objects to be set in
one single API call.
Then object_new_with_props() / object_new_with_propv() constructors
are added which simplify the sequence of calls to create an
object, populate properties, register in the object composition
tree and mark the object complete, into a single method call.
Usage would be:
Error *err = NULL;
Object *obj;
obj = object_new_with_propv(TYPE_MEMORY_BACKEND_FILE,
object_get_objects_root(),
"hostmem0",
&err,
"share", "yes",
"mem-path", "/dev/shm/somefile",
"prealloc", "yes",
"size", "1048576",
NULL);
Note all property values are passed in string form and will
be parsed into their required data types, using normal QOM
semantics for parsing from string format.
Signed-off-by: Daniel P. Berrange <berrange@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
Signed-off-by: Andreas Färber <afaerber@suse.de>
2015-05-13 18:14:06 +02:00
|
|
|
check-qom-proplist
|
2015-02-27 16:21:22 +01:00
|
|
|
rcutorture
|
2013-02-21 03:34:40 +01:00
|
|
|
test-aio
|
2013-09-24 09:43:40 +02:00
|
|
|
test-bitops
|
2014-04-12 00:23:01 +02:00
|
|
|
test-coroutine
|
2015-07-01 19:10:32 +02:00
|
|
|
test-crypto-cipher
|
2015-07-01 19:10:29 +02:00
|
|
|
test-crypto-hash
|
2015-04-13 15:01:39 +02:00
|
|
|
test-crypto-tlscredsx509
|
|
|
|
test-crypto-tlscredsx509-work/
|
|
|
|
test-crypto-tlscredsx509-certs/
|
2015-03-02 18:23:31 +01:00
|
|
|
test-crypto-tlssession
|
|
|
|
test-crypto-tlssession-work/
|
|
|
|
test-crypto-tlssession-client/
|
|
|
|
test-crypto-tlssession-server/
|
2013-02-21 03:34:40 +01:00
|
|
|
test-cutils
|
|
|
|
test-hbitmap
|
2013-09-24 09:43:40 +02:00
|
|
|
test-int128
|
2013-02-21 03:34:40 +01:00
|
|
|
test-iov
|
|
|
|
test-mul64
|
2014-04-12 00:23:01 +02:00
|
|
|
test-opts-visitor
|
2014-09-26 17:20:32 +02:00
|
|
|
test-qapi-event.[ch]
|
2012-04-20 03:40:24 +02:00
|
|
|
test-qapi-types.[ch]
|
|
|
|
test-qapi-visit.[ch]
|
2013-07-10 22:08:40 +02:00
|
|
|
test-qdev-global-props
|
2014-09-26 17:20:32 +02:00
|
|
|
test-qemu-opts
|
2012-04-20 03:40:24 +02:00
|
|
|
test-qmp-commands
|
2014-04-12 00:23:01 +02:00
|
|
|
test-qmp-commands.h
|
2014-09-26 17:20:32 +02:00
|
|
|
test-qmp-event
|
2012-04-20 03:40:24 +02:00
|
|
|
test-qmp-input-strict
|
2014-04-12 00:23:01 +02:00
|
|
|
test-qmp-input-visitor
|
qapi: New QMP command query-qmp-schema for QMP introspection
qapi/introspect.json defines the introspection schema. It's designed
for QMP introspection, but should do for similar uses, such as QGA.
The introspection schema does not reflect all the rules and
restrictions that apply to QAPI schemata. A valid QAPI schema has an
introspection value conforming to the introspection schema, but the
converse is not true.
Introspection lowers away a number of schema details, and makes
implicit things explicit:
* The built-in types are declared with their JSON type.
All integer types are mapped to 'int', because how many bits we use
internally is an implementation detail. It could be pressed into
external interface service as very approximate range information,
but that's a bad idea. If we need range information, we better do
it properly.
* Implicit type definitions are made explicit, and given
auto-generated names:
- Array types, named by appending "List" to the name of their
element type, like in generated C.
- The enumeration types implicitly defined by simple union types,
named by appending "Kind" to the name of their simple union type,
like in generated C.
- Types that don't occur in generated C. Their names start with ':'
so they don't clash with the user's names.
* All type references are by name.
* The struct and union types are generalized into an object type.
* Base types are flattened.
* Commands take a single argument and return a single result.
Dictionary argument or list result is an implicit type definition.
The empty object type is used when a command takes no arguments or
produces no results.
The argument is always of object type, but the introspection schema
doesn't reflect that.
The 'gen': false directive is omitted as implementation detail.
The 'success-response' directive is omitted as well for now, even
though it's not an implementation detail, because it's not used by
QMP.
* Events carry a single data value.
Implicit type definition and empty object type use, just like for
commands.
The value is of object type, but the introspection schema doesn't
reflect that.
* Types not used by commands or events are omitted.
Indirect use counts as use.
* Optional members have a default, which can only be null right now
Instead of a mandatory "optional" flag, we have an optional default.
No default means mandatory, default null means optional without
default value. Non-null is available for optional with default
(possible future extension).
* Clients should *not* look up types by name, because type names are
not ABI. Look up the command or event you're interested in, then
follow the references.
TODO Should we hide the type names to eliminate the temptation?
New generator scripts/qapi-introspect.py computes an introspection
value for its input, and generates a C variable holding it.
It can generate awfully long lines. Marked TODO.
A new test-qmp-input-visitor test case feeds its result for both
tests/qapi-schema/qapi-schema-test.json and qapi-schema.json to a
QmpInputVisitor to verify it actually conforms to the schema.
New QMP command query-qmp-schema takes its return value from that
variable. Its reply is some 85KiBytes for me right now.
If this turns out to be too much, we have a couple of options:
* We can use shorter names in the JSON. Not the QMP style.
* Optionally return the sub-schema for commands and events given as
arguments.
Right now qmp_query_schema() sends the string literal computed by
qmp-introspect.py. To compute sub-schema at run time, we'd have to
duplicate parts of qapi-introspect.py in C. Unattractive.
* Let clients cache the output of query-qmp-schema.
It changes only on QEMU upgrades, i.e. rarely. Provide a command
query-qmp-schema-hash. Clients can have a cache indexed by hash,
and re-query the schema only when they don't have it cached. Even
simpler: put the hash in the QMP greeting.
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
2015-09-16 13:06:28 +02:00
|
|
|
test-qmp-introspect.[ch]
|
2012-04-20 03:40:24 +02:00
|
|
|
test-qmp-marshal.c
|
2014-04-12 00:23:01 +02:00
|
|
|
test-qmp-output-visitor
|
2015-02-27 16:21:22 +01:00
|
|
|
test-rcu-list
|
2014-04-12 00:23:02 +02:00
|
|
|
test-rfifolock
|
2014-04-12 00:23:01 +02:00
|
|
|
test-string-input-visitor
|
|
|
|
test-string-output-visitor
|
2013-02-21 03:34:40 +01:00
|
|
|
test-thread-pool
|
2014-04-12 00:23:01 +02:00
|
|
|
test-throttle
|
|
|
|
test-visitor-serialization
|
2013-11-28 15:01:18 +01:00
|
|
|
test-vmstate
|
2015-02-27 16:21:22 +01:00
|
|
|
test-write-threshold
|
2013-01-23 18:58:27 +01:00
|
|
|
test-x86-cpuid
|
2013-02-21 03:34:40 +01:00
|
|
|
test-xbzrle
|
2012-04-20 03:40:24 +02:00
|
|
|
*-test
|
2013-09-24 09:43:39 +02:00
|
|
|
qapi-schema/*.test.*
|