# virt-admin --help

virt-admin [options]... [<command_string>]
virt-admin [options]... <command> [args...]
....

# virsh --help

virsh [options]... [<command_string>]
virsh [options]... <command> [args...]
....

# virsh list --help
  NAME
    list - list domains
....

# virt-admin daemon-timeout --help
  NAME
    daemon-timeout - set the auto shutdown timeout of the daemon
....

# virt-admin help server-list
  NAME
    server-list - list available servers on a daemon

  SYNOPSIS
    server-list
....

# virsh help list
  NAME
    list - list domains
....

# virt-admin help "Monitoring commands"
 Monitoring commands (help keyword 'monitor'):
    server-list                    list available servers on a daemon
    server-threadpool-info         get server workerpool parameters
    client-list                    list clients connected to <server>
....

# virsh help virsh
 Virsh itself (help keyword 'virsh'):
    cd                             change the current directory
    echo                           echo arguments. Used for internal testing.
    exit                           quit this interactive terminal
....

# virsh nodedev-list --help
  NAME
    nodedev-list - enumerate devices on this host

  SYNOPSIS
    nodedev-list [--tree] [--cap <string>] [--inactive] [--all] [--persistent] [--transient]

  OPTIONS
    --tree           list devices in a tree
    --cap <string>   capability names, separated by comma
    --inactive       list inactive devices
    --all            list inactive & active devices
    --persistent     list persistent devices
    --transient      list transient devices

# virt-admin daemon-log-filters --help
  NAME
    daemon-log-filters - fetch or set the currently defined set of logging filters on daemon

  SYNOPSIS
    daemon-log-filters [<filters>]

  DESCRIPTION
    Depending on whether run with or without options, the command fetches or redefines the existing active set of filters on daemon.

  OPTIONS
    [--filters] <string>  redefine the existing set of logging filters

commit 0fea7a103a57d3599e9841924c2678b7a7b0f794
Author: Peter Krempa <pkrempa@redhat.com>
Date:   Wed May 15 08:59:18 2024 +0200

    NEWS: Mention '--help' bug in virsh and virt-admin
    
    Signed-off-by: Peter Krempa <pkrempa@redhat.com>
    Reviewed-by: Martin Kletzander <mkletzan@redhat.com>

commit 6d098a0cedf34be26fda5cf79105cd4281e100cb
Author: Peter Krempa <pkrempa@redhat.com>
Date:   Wed May 15 08:53:08 2024 +0200

    virshtest: Add tests for '--help'
    
    Add test cases for help handling.
    
    Signed-off-by: Peter Krempa <pkrempa@redhat.com>
    Reviewed-by: Martin Kletzander <mkletzan@redhat.com>

commit 811ce0e13b6d319df54e86b8c698e45cfbd8b940
Author: Peter Krempa <pkrempa@redhat.com>
Date:   Wed May 15 08:42:57 2024 +0200

    vsh: Fix '--help' option for virsh/virt-admin
    
    The refactor of the libvirt tools command parser introduced a bug where
    the '--help' option would cause an error:
    
     $ virsh list --help
     error: command 'list' doesn't support option --help
    
    rather than printing the help for the command as the help option is
    supposed to be handled separately from the real options.
    
    Re-introduce the separate handling to the new parser code.
    
    Fixes: 5540c3d2415c194b206f8946cf74b13648163332
    Resolves: https://issues.redhat.com/browse/RHEL-36565
    Reported-by: Lili Zhu <lizhu@redhat.com>
    Signed-off-by: Peter Krempa <pkrempa@redhat.com>
    Reviewed-by: Martin Kletzander <mkletzan@redhat.com>

v10.3.0-70-g0fea7a103a