mbox series

[0/4] docs: improve -smp documentation

Message ID 20210628113047.462498-1-berrange@redhat.com (mailing list archive)
Headers show
Series docs: improve -smp documentation | expand

Message

Daniel P. Berrangé June 28, 2021, 11:30 a.m. UTC
This is a spin off from this thread:

  https://lists.gnu.org/archive/html/qemu-devel/2021-06/msg06135.html

to improve the documentation of the current behaviour of -smp
arg. In that thread it is suggested that we change the behaviour
to prefer use of cores over sockets, when topology is omitted. This
documentation update explicitly notes that default topology is liable
to change, to allow for this enhancement.

Daniel P. Berrangé (4):
  docs: fix typo s/Intel/AMD/ in CPU model notes
  qemu-options: re-arrange CPU topology options
  qemu-options: tweak to show that CPU count is optional
  qemu-options: rewrite help for -smp options

 docs/system/cpu-models-x86.rst.inc |  2 +-
 qemu-options.hx                    | 37 ++++++++++++++++++++----------
 2 files changed, 26 insertions(+), 13 deletions(-)

Comments

Andrew Jones June 28, 2021, 2:55 p.m. UTC | #1
On Mon, Jun 28, 2021 at 12:30:43PM +0100, Daniel P. Berrangé wrote:
> This is a spin off from this thread:
> 
>   https://lists.gnu.org/archive/html/qemu-devel/2021-06/msg06135.html
> 
> to improve the documentation of the current behaviour of -smp
> arg. In that thread it is suggested that we change the behaviour
> to prefer use of cores over sockets, when topology is omitted. This
> documentation update explicitly notes that default topology is liable
> to change, to allow for this enhancement.
> 
> Daniel P. Berrangé (4):
>   docs: fix typo s/Intel/AMD/ in CPU model notes
>   qemu-options: re-arrange CPU topology options
>   qemu-options: tweak to show that CPU count is optional
>   qemu-options: rewrite help for -smp options
> 
>  docs/system/cpu-models-x86.rst.inc |  2 +-
>  qemu-options.hx                    | 37 ++++++++++++++++++++----------
>  2 files changed, 26 insertions(+), 13 deletions(-)
> 
> -- 
> 2.31.1
> 
>

For the series

Reviewed-by: Andrew Jones <drjones@redhat.com>
Eduardo Habkost July 9, 2021, 8:48 p.m. UTC | #2
On Mon, Jun 28, 2021 at 12:30:43PM +0100, Daniel P. Berrangé wrote:
> This is a spin off from this thread:
> 
>   https://lists.gnu.org/archive/html/qemu-devel/2021-06/msg06135.html
> 
> to improve the documentation of the current behaviour of -smp
> arg. In that thread it is suggested that we change the behaviour
> to prefer use of cores over sockets, when topology is omitted. This
> documentation update explicitly notes that default topology is liable
> to change, to allow for this enhancement.

Queued, thanks!
Eduardo Habkost July 13, 2021, 1:22 p.m. UTC | #3
On Fri, Jul 09, 2021 at 04:48:57PM -0400, Eduardo Habkost wrote:
> On Mon, Jun 28, 2021 at 12:30:43PM +0100, Daniel P. Berrangé wrote:
> > This is a spin off from this thread:
> > 
> >   https://lists.gnu.org/archive/html/qemu-devel/2021-06/msg06135.html
> > 
> > to improve the documentation of the current behaviour of -smp
> > arg. In that thread it is suggested that we change the behaviour
> > to prefer use of cores over sockets, when topology is omitted. This
> > documentation update explicitly notes that default topology is liable
> > to change, to allow for this enhancement.
> 
> Queued, thanks!

I had to remove it due to build failures:
https://gitlab.com/ehabkost/qemu/-/jobs/1413791527#L1139


FAILED: libqemu-microblazeel-softmmu.fa.p/softmmu_vl.c.o
cc -Ilibqemu-microblazeel-softmmu.fa.p -I. -I.. -Itarget/microblaze -I../target/microblaze -I../capstone/include/capstone -Iqapi -Itrace -Iui -Iui/shader -I/usr/include/pixman-1 -I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include -fdiagnostics-color=auto -pipe -Wall -Winvalid-pch -Werror -std=gnu11 -O2 -g -isystem /builds/ehabkost/qemu/linux-headers -isystem linux-headers -iquote . -iquote /builds/ehabkost/qemu -iquote /builds/ehabkost/qemu/include -iquote /builds/ehabkost/qemu/disas/libvixl -iquote /builds/ehabkost/qemu/tcg/i386 -pthread -U_FORTIFY_SOURCE -D_FORTIFY_SOURCE=2 -m32 -D_GNU_SOURCE -D_FILE_OFFSET_BITS=64 -D_LARGEFILE_SOURCE -Wstrict-prototypes -Wredundant-decls -Wundef -Wwrite-strings -Wmissing-prototypes -fno-strict-aliasing -fno-common -fwrapv -m32 -Wold-style-declaration -Wold-style-definition -Wtype-limits -Wformat-security -Wformat-y2k -Winit-self -Wignored-qualifiers -Wempty-body -Wnested-externs -Wendif-labels -Wexpansion-to-defined -Wimplicit-fallthrough=2 -Wno-missing-include-dirs -Wno-shift-negative-value -Wno-psabi -fstack-protector-strong -fPIC -isystem../linux-headers -isystemlinux-headers -DNEED_CPU_H '-DCONFIG_TARGET="microblazeel-softmmu-config-target.h"' '-DCONFIG_DEVICES="microblazeel-softmmu-config-devices.h"' -MD -MQ libqemu-microblazeel-softmmu.fa.p/softmmu_vl.c.o -MF libqemu-microblazeel-softmmu.fa.p/softmmu_vl.c.o.d -o libqemu-microblazeel-softmmu.fa.p/softmmu_vl.c.o -c ../softmmu/vl.c
./qemu-options.def: In function 'help':
./qemu-options.def:52:1: error: expected ')' before 'QEMU_ARCH_ALL'
   52 | QEMU_ARCH_ALL)
      | ^~~~~~~~~~~~~
../softmmu/vl.c:809:10: note: in definition of macro 'DEF'
  809 |     if ((arch_mask) & arch_type)                               \
      |          ^~~~~~~~~
../softmmu/vl.c:809:9: note: to match this '('
  809 |     if ((arch_mask) & arch_type)                               \
      |         ^
./qemu-options.def:43:1: note: in expansion of macro 'DEF'
   43 | DEF("smp", HAS_ARG, QEMU_OPTION_smp,
      | ^~~
../softmmu/vl.c:809:21: error: invalid operands to binary & (have 'const char *' and 'uint32_t' {aka 'const unsigned int'})
  809 |     if ((arch_mask) & arch_type)                               \
      |         ~           ^
      |         |
      |         const char *
./qemu-options.def:43:1: note: in expansion of macro 'DEF'
   43 | DEF("smp", HAS_ARG, QEMU_OPTION_smp,
      | ^~~
./qemu-options.def: At top level:
./qemu-options.def:49:1: error: initialization of 'unsigned int' from 'const char *' makes integer from pointer without a cast [-Werror=int-conversion]
   49 | "                dies= number of CPU dies on one socket (for PC only)\n"
      | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
../softmmu/vl.c:845:34: note: in definition of macro 'DEF'
  845 |     { option, opt_arg, opt_enum, arch_mask },
      |                                  ^~~~~~~~~
./qemu-options.def:49:1: note: (near initialization for 'qemu_options[7].arch_mask')
   49 | "                dies= number of CPU dies on one socket (for PC only)\n"
      | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
../softmmu/vl.c:845:34: note: in definition of macro 'DEF'
  845 |     { option, opt_arg, opt_enum, arch_mask },
      |                                  ^~~~~~~~~
./qemu-options.def:52:1: error: expected '}' before 'QEMU_ARCH_ALL'
   52 | QEMU_ARCH_ALL)
      | ^~~~~~~~~~~~~
../softmmu/vl.c:845:34: note: in definition of macro 'DEF'
  845 |     { option, opt_arg, opt_enum, arch_mask },
      |                                  ^~~~~~~~~
../softmmu/vl.c:845:5: note: to match this '{'
  845 |     { option, opt_arg, opt_enum, arch_mask },
      |     ^
./qemu-options.def:43:1: note: in expansion of macro 'DEF'
   43 | DEF("smp", HAS_ARG, QEMU_OPTION_smp,
      | ^~~
cc1: all warnings being treated as errors
[663/5259] Compiling C object libqemu-microblazeel-softmmu.fa.p/accel_tcg_tcg-accel-ops-icount.c.o
ninja: build stopped: subcommand failed.
make: *** [Makefile:154: run-ninja] Error 1