Description of problem: schedinfo command added two parameters, but no description about them in man page. Version-Release number of selected component (if applicable): libvirt-2.0.0-2.el7.x86_64 How reproducible: 100% Steps to Reproduce: 1. check schedinfo command # virsh schedinfo vm1 Scheduler : posix cpu_shares : 1024 vcpu_period : 100000 vcpu_quota : -1 emulator_period: 100000 emulator_quota : -1 global_period : 100000 global_quota : -1 2. check man page #man virsh schedinfo : ...... QEMU/KVM (posix scheduler): cpu_shares, vcpu_period, vcpu_quota, emulator_period, emulator_quota ...... Actual results: As above, There is no description for new added parameters. Expected results: It should add descriptions for them including value range, the relationships with other parameters. Such as global values should be equal or more than the vcpu values. Additional info:
Patch posted upstream. https://www.redhat.com/archives/libvir-list/2020-September/msg01045.html
Fix merged upstream. commit 1d46f03a55b7a22075046f03bf356ee89a32e0a6 Author: Andrea Bolognani <abologna> Date: Fri Sep 18 18:36:25 2020 +0200 docs: Document global_{period,quota} schedinfo fields These fields have existed for a very long time but they were never documented in virsh(1). https://bugzilla.redhat.com/show_bug.cgi?id=1354391 Signed-off-by: Andrea Bolognani <abologna> Reviewed-by: Pavel Hrdina <phrdina>
Verified in version libvirt-daemon-6.10.0-1.module+el8.4.0+8898+a84e86e1.x86_64 S1: Check the virsh schedinfo parameters all exist 1. Check the virsh man page about the schedinfo man virsh |grep -A10 schedinfo schedinfo Syntax: schedinfo domain [[--config] [--live] | [--current]] [[--set] parameter=value]... schedinfo [--weight number] [--cap number] domain Allows you to show (and set) the domain scheduler parameters. The parameters available for each hypervisor are: LXC (posix scheduler) : cpu_shares, vcpu_period, vcpu_quota QEMU/KVM (posix scheduler): cpu_shares, vcpu_period, vcpu_quota, emulator_period, emulator_quota, global_period, global_quota, iothread_period, iothread_quota Xen (credit scheduler): weight, cap 2. Check the domain schedinfo # virsh schedinfo rhel8 Scheduler : posix cpu_shares : 1024 vcpu_period : 100000 vcpu_quota : -1 emulator_period: 100000 emulator_quota : -1 global_period : 100000 global_quota : -1 iothread_period: 100000 iothread_quota : -1
Since the problem described in this bug report should be resolved in a recent advisory, it has been closed with a resolution of ERRATA. For information on the advisory (virt:av bug fix and enhancement update), and where to find the updated files, follow the link below. If the solution does not work for you, open a new bug report. https://access.redhat.com/errata/RHBA-2021:2098