Skip to content
Snippets Groups Projects
  1. Jul 26, 2023
    • Markus Armbruster's avatar
      qapi: Reformat recent doc comments to conform to current conventions · 9e272073
      Markus Armbruster authored
      
      Since commit a937b6aa (qapi: Reformat doc comments to conform to
      current conventions), a number of comments not conforming to the
      current formatting conventions were added.  No problem, just sweep
      the entire documentation once more.
      
      To check the generated documentation does not change, I compared the
      generated HTML before and after this commit with "wdiff -3".  Finds no
      differences.  Comparing with diff is not useful, as the reflown
      paragraphs are visible there.
      
      Signed-off-by: default avatarMarkus Armbruster <armbru@redhat.com>
      Message-ID: <20230720071610.1096458-7-armbru@redhat.com>
      9e272073
  2. May 10, 2023
    • Markus Armbruster's avatar
      qapi: Reformat doc comments to conform to current conventions · a937b6aa
      Markus Armbruster authored
      
      Change
      
          # @name: Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed
          #        do eiusmod tempor incididunt ut labore et dolore magna aliqua.
      
      to
      
          # @name: Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed
          #     do eiusmod tempor incididunt ut labore et dolore magna aliqua.
      
      See recent commit "qapi: Relax doc string @name: description
      indentation rules" for rationale.
      
      Reflow paragraphs to 70 columns width, and consistently use two spaces
      to separate sentences.
      
      To check the generated documentation does not change, I compared the
      generated HTML before and after this commit with "wdiff -3".  Finds no
      differences.  Comparing with diff is not useful, as the reflown
      paragraphs are visible there.
      
      Signed-off-by: default avatarMarkus Armbruster <armbru@redhat.com>
      Message-Id: <20230428105429.1687850-18-armbru@redhat.com>
      Reviewed-by: default avatarJuan Quintela <quintela@redhat.com>
      Acked-by: default avatarLukas Straub <lukasstraub2@web.de>
      [Straightforward conflicts in qapi/audio.json qapi/misc-target.json
      qapi/run-state.json resolved]
      a937b6aa
  3. May 05, 2023
    • Daniel Henrique Barboza's avatar
      target/riscv: add query-cpy-definitions support · c0177f91
      Daniel Henrique Barboza authored
      
      This command is used by tooling like libvirt to retrieve a list of
      supported CPUs. Each entry returns a CpuDefinitionInfo object that
      contains more information about each CPU.
      
      This initial support includes only the name of the CPU and its typename.
      Here's what the command produces for the riscv64 target:
      
      $ ./build/qemu-system-riscv64 -S -M virt -display none -qmp stdio
      {"QMP": {"version": (...)}
      {"execute": "qmp_capabilities", "arguments": {"enable": ["oob"]}}
      {"return": {}}
      {"execute": "query-cpu-definitions"}
      {"return": [
      {"name": "rv64", "typename": "rv64-riscv-cpu", "static": false, "deprecated": false},
      {"name": "sifive-e51", "typename": "sifive-e51-riscv-cpu", "static": false, "deprecated": false},
      {"name": "any", "typename": "any-riscv-cpu", "static": false, "deprecated": false},
      {"name": "x-rv128", "typename": "x-rv128-riscv-cpu", "static": false, "deprecated": false},
      {"name": "shakti-c", "typename": "shakti-c-riscv-cpu", "static": false, "deprecated": false},
      {"name": "thead-c906", "typename": "thead-c906-riscv-cpu", "static": false, "deprecated": false},
      {"name": "sifive-u54", "typename": "sifive-u54-riscv-cpu", "static": false, "deprecated": false}]
      }
      
      Next patch will introduce a way to tell whether a given CPU is static or
      not.
      
      Signed-off-by: default avatarDaniel Henrique Barboza <dbarboza@ventanamicro.com>
      Reviewed-by: default avatarRichard Henderson <richard.henderson@linaro.org>
      Reviewed-by: default avatarAlistair Francis <alistair.francis@wdc.com>
      Message-Id: <20230411183511.189632-3-dbarboza@ventanamicro.com>
      Signed-off-by: default avatarAlistair Francis <alistair.francis@wdc.com>
      c0177f91
  4. Apr 28, 2023
  5. Jun 06, 2022
  6. May 16, 2022
  7. Aug 26, 2021
  8. Dec 10, 2020
  9. Oct 14, 2020
    • Robert Hoo's avatar
      cpu: Introduce CPU model deprecation API · 61ad65d0
      Robert Hoo authored
      
      Implement the ability of marking some versions deprecated. When
      that CPU model is chosen, print a warning.  The warning message
      can be customized, e.g. suggesting an alternative CPU model to be
      used instead.
      
      The deprecation message will be printed by x86_cpu_list_entry(),
      e.g. '-cpu help'.
      
      QMP command 'query-cpu-definitions' will return a bool value
      indicating the deprecation status.
      
      Signed-off-by: default avatarRobert Hoo <robert.hu@linux.intel.com>
      Message-Id: <1600758855-80046-1-git-send-email-robert.hu@linux.intel.com>
      [ehabkost: reword commit message]
      [ehabkost: Handle NULL cpu_type]
      Signed-off-by: default avatarEduardo Habkost <ehabkost@redhat.com>
      61ad65d0
  10. Aug 03, 2020
    • Andrea Bolognani's avatar
      schemas: Add vim modeline · f7160f32
      Andrea Bolognani authored
      
      The various schemas included in QEMU use a JSON-based format which
      is, however, strictly speaking not valid JSON.
      
      As a consequence, when vim tries to apply syntax highlight rules
      for JSON (as guessed from the file name), the result is an unreadable
      mess which mostly consist of red markers pointing out supposed errors
      in, well, pretty much everything.
      
      Using Python syntax highlighting produces much better results, and
      in fact these files already start with specially-formatted comments
      that instruct Emacs to process them as if they were Python files.
      
      This commit adds the equivalent special comments for vim.
      
      Signed-off-by: default avatarAndrea Bolognani <abologna@redhat.com>
      Message-Id: <20200729185024.121766-1-abologna@redhat.com>
      Reviewed-by: default avatarDaniel P. Berrangé <berrange@redhat.com>
      Reviewed-by: default avatarJohn Snow <jsnow@redhat.com>
      Signed-off-by: default avatarMarkus Armbruster <armbru@redhat.com>
      f7160f32
  11. Feb 15, 2020
    • Peter Maydell's avatar
      qapi: Fix indent level on doc comments in json files · 26ec4e53
      Peter Maydell authored
      
      The current doc generation doesn't care much about indentation levels,
      but we would like to switch to an rST format, and rST does care about
      indentation.
      
      Make the doc comments more strongly consistent about indentation
      for multiline constructs like:
      
      @arg: description line 1
            description line 2
      
      Returns: line one
               line 2
      
      so that there is always exactly one space after the colon, and
      subsequent lines align with the first.
      
      This commit is a purely whitespace change, and it does not alter the
      generated .texi files (because the texi generation code strips away
      all the extra whitespace).  This does mean that we end up with some
      over-length lines.
      
      Note that when the documentation for an argument fits on a single
      line like this:
      
      @arg: one line only
      
      then stray extra spaces after the ':' don't affect the rST output, so
      I have not attempted to methodically fix them, though the preference
      is a single space here too.
      
      Signed-off-by: default avatarPeter Maydell <peter.maydell@linaro.org>
      Message-Id: <20200213175647.17628-10-peter.maydell@linaro.org>
      Reviewed-by: default avatarMarkus Armbruster <armbru@redhat.com>
      [Commit message tweaked]
      Signed-off-by: default avatarMarkus Armbruster <armbru@redhat.com>
      26ec4e53
  12. Nov 01, 2019
    • Andrew Jones's avatar
      target/arm/monitor: Introduce qmp_query_cpu_model_expansion · e19afd56
      Andrew Jones authored
      
      Add support for the query-cpu-model-expansion QMP command to Arm. We
      do this selectively, only exposing CPU properties which represent
      optional CPU features which the user may want to enable/disable.
      Additionally we restrict the list of queryable cpu models to 'max',
      'host', or the current type when KVM is in use. And, finally, we only
      implement expansion type 'full', as Arm does not yet have a "base"
      CPU type. More details and example queries are described in a new
      document (docs/arm-cpu-features.rst).
      
      Note, certainly more features may be added to the list of advertised
      features, e.g. 'vfp' and 'neon'. The only requirement is that we can
      detect invalid configurations and emit failures at QMP query time.
      For 'vfp' and 'neon' this will require some refactoring to share a
      validation function between the QMP query and the CPU realize
      functions.
      
      Signed-off-by: default avatarAndrew Jones <drjones@redhat.com>
      Reviewed-by: default avatarRichard Henderson <richard.henderson@linaro.org>
      Reviewed-by: default avatarEric Auger <eric.auger@redhat.com>
      Reviewed-by: default avatarBeata Michalska <beata.michalska@linaro.org>
      Message-id: 20191031142734.8590-2-drjones@redhat.com
      Signed-off-by: default avatarPeter Maydell <peter.maydell@linaro.org>
      e19afd56
  13. Jul 05, 2019
  14. Jul 02, 2019
  15. Feb 21, 2019
  16. Feb 18, 2019
Loading