1. 05 3月, 2016 1 次提交
    • E
      qapi: Update docs to match recent generator changes · 9ee86b85
      Eric Blake 提交于
      Several commits have been changing the generator, but not updating
      the docs to match:
      - The implicit tag member is named "type", not "kind".  Screwed up in
      commit 39a18158.
      - Commit 9f08c8ec made list types lazy, and thereby dropped
      UserDefOneList if nothing explicitly uses the list type.
      - Commit 51e72bc1 switched the parameter order with 'name' occurring
      earlier.
      - Commit e65d89bf changed the layout of UserDefOneList.
      - Prefer the term 'member' over 'field'.
      - We now expose visit_type_FOO_members() for objects.
      - etc.
      
      Rework the examples to show slightly more output (we don't want to
      show too much; that's what the testsuite is for), and regenerate the
      output to match all recent changes.  Also, rearrange output to show
      .h files before .c (understanding the interface first often makes
      the implementation easier to follow).
      Reported-by: NMarc-André Lureau <marcandre.lureau@redhat.com>
      Signed-off-by: NEric Blake <eblake@redhat.com>
      Signed-off-by: NMarkus Armbruster <armbru@redhat.com>
      Message-Id: <1457021813-10704-5-git-send-email-eblake@redhat.com>
      9ee86b85
  2. 11 2月, 2016 1 次提交
  3. 30 10月, 2015 1 次提交
  4. 13 10月, 2015 1 次提交
  5. 06 5月, 2015 2 次提交
    • E
      qapi: Document type-safety considerations · e790e666
      Eric Blake 提交于
      Go into more details about the various types of valid expressions
      in a qapi schema, including tweaks to document fixes being done
      later in the current patch series.  Also fix some stale and missing
      documentation in the QMP specification.
      Signed-off-by: NEric Blake <eblake@redhat.com>
      Reviewed-by: NMarkus Armbruster <armbru@redhat.com>
      Signed-off-by: NMarkus Armbruster <armbru@redhat.com>
      e790e666
    • E
      qapi: Add copyright declaration on docs · 6fb55451
      Eric Blake 提交于
      While our top-level COPYING with its GPLv2+ license applies to
      any documentation file that omits explicit instructions, these
      days it's better to be a good example of calling out our
      intentions.  Correct use of GPL requires the use of a copyright
      statement, so I'm adding notice to two QAPI documents, by
      attributing these files to the initial authors and major
      contributors.  I used:
      
      $ git blame --line-porcelain $file \
        | sed -n 's/^author //p' | sort | uniq -c | sort -rn
      
      to determine authorship of these two files.  qmp-spec.txt blames
      entirely to Red Hat (easy, since my contribution falls in that
      category); while qapi-code-gen.txt has multiple contributors
      representing multiple entities.  But since it was originally
      supplied by Michael Roth, the notice I added there copies the
      notice he has used in other files.  As there is no intended
      change in license from the implicit one previously present from
      the top level, I have not bothered to CC other contributors;
      if we want to weaken things to something looser (such as LGPL)
      so that there is no question that someone re-implementing the
      spec is not forced to use GPL, that would be a different commit.
      
      CC: Michael Roth <mdroth@linux.vnet.ibm.com>
      Signed-off-by: NEric Blake <eblake@redhat.com>
      Reviewed-by: NMarkus Armbruster <armbru@redhat.com>
      Signed-off-by: NMarkus Armbruster <armbru@redhat.com>
      6fb55451
  6. 18 9月, 2013 2 次提交
  7. 14 8月, 2012 1 次提交
    • L
      qmp: switch to the new error format on the wire · de253f14
      Luiz Capitulino 提交于
      IMPORTANT: this BREAKS QMP's compatibility for the error response.
      
      This commit changes QMP's wire protocol to make use of the simpler
      error format introduced by previous commits.
      
      There are two important (and mostly incompatible) changes:
      
       1. Almost all error classes have been replaced by GenericError. The
          only classes that are still supported for compatibility with
          libvirt are: CommandNotFound, DeviceNotActive, KVMMissingCap,
          DeviceNotFound and MigrationExpected
      
       2. The 'data' field of the error dictionary is gone
      
      As an example, an error response like:
      
        { "error": { "class": "DeviceNotRemovable",
                     "data": { "device": "virtio0" },
                     "desc": "Device 'virtio0' is not removable" } }
      
      Will now be emitted as:
      
        { "error": { "class": "GenericError",
                     "desc": "Device 'virtio0' is not removable" } }
      Signed-off-by: NLuiz Capitulino <lcapitulino@redhat.com>
      Reviewed-by: NMarkus Armbruster <armbru@redhat.com>
      de253f14
  8. 27 3月, 2012 1 次提交
  9. 19 5月, 2010 1 次提交
  10. 11 2月, 2010 2 次提交
  11. 19 12月, 2009 1 次提交
  12. 08 12月, 2009 1 次提交
  13. 03 12月, 2009 1 次提交