bin/58638: mount_qemufwcfg(8): usage is confusing

[campbell+netbsd%mumble.net@localhost]

>Number:         58638
>Category:       bin
>Synopsis:       mount_qemufwcfg(8): usage is confusing
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    bin-bug-people
>State:          open
>Class:          sw-bug
>Submitter-Id:   net
>Arrival-Date:   Sun Aug 25 13:35:00 +0000 2024
>Originator:     Taylor R Campbell
>Release:        current, 10, 9
>Organization:
The NetQemuFW Configuration
>Environment:
>Description:
The usage for mount_qemufwcfg(8), for access to the Qemu firmware configuration (https://www.qemu.org/docs/master/specs/fw_cfg.html), is apparently:

# mount_qemufwcfg /mnt

This disagrees with the man page, whose synopsis reads:

SYNOPSIS
     mount_qemufwcfg [-F path] [-g gid] [-M dir-mode] [-m file-mode] [-u uid]
                     [fuse-options] special node

This is also incompatible with the mount(8) command.

At the very least, the man page should correctly show how to use it.

Ideally, `mount -t qemufwcfg qemufwcfg /mnt' would work too, and you could put this into fstab(5).
>How-To-Repeat:
try to use mount_qemufwcfg(8) by rtfm
>Fix:
Yes, please!