"man loader.efi" and comconsole vs. eficom for aarch64 for 14.* and later

From: Mark Millard <marklmi_at_yahoo.com>
Date: Sun, 10 Nov 2024 20:22:57 UTC
# man -K comconsole
/usr/share/man/man8/loader.8.gz:     console variable, or set it to serial console (“comconsole”) if the
/usr/share/man/man8/loader.efi.8.gz:     work) and “comconsole” for the serial on COM1 at the default baud rate.
/usr/share/man/man8/loader.efi.8.gz:     “comconsole”.  The default port is COM1 with an I/O address of 0x3f8.
/usr/share/man/man8/loader.efi.8.gz:     comconsole_port is used to set this to a different port address.
/usr/share/man/man8/loader.efi.8.gz:     comconsole_speed is used to set the of the serial port (the default is
/usr/share/man/man8/loader.efi.8.gz:     9600).  If you have console set to “efi,comconsole” you will get output
/usr/share/man/man8/loader_4th.8.gz:     console variable, or set it to serial console (“comconsole”) if the
/usr/share/man/man8/loader_lua.8.gz:     console variable, or sets it to serial console (“comconsole”) if the
/usr/share/man/man8/loader_simp.8.gz:     console variable, or set it to serial console (“comconsole”) if the
/usr/share/man/man5/loader.conf.5.gz:           console   (“vidconsole”) “comconsole” selects serial console,
# man -K eficom
#

Note: The above is for both main and stable/14 . No mention
of eficom or in what types of contexts it should be used
vs. not.

But:

#if defined(__aarch64__) && __FreeBSD_version < 1500000
static void
comc_probe_compat(struct console *sc)
{
        comc_probe(&eficom);
        if (eficom.c_flags & (C_PRESENTIN | C_PRESENTOUT)) {
                printf("comconsole: comconsole device name is deprecated, switch to eficom\n");
        }
        /*
         * Note: We leave the present bits unset in sc to avoid ghosting.
         */
}
#endif

There are other places with the documentation issue, for
example https://wiki.freebsd.org/HyperV references:

QUOTE
Enable the serial in the VM. Below is the example of FreeBSD VM.

        • echo 'console="comconsole"' >> /boot/loader.conf
END QUOTE

I got into this from trying to get a Windows Dev Kit 2023
running Windows Pro 11 Hyper-V to be operational for running
FreeBSD. Its output stops after the mask line for the efi
buffer reporting. (Hyper-V indicates 12% cpu usage. 1 core
of 8 busy?) I was looking for any extra instructions that
I'd not previously found. (I had remembered that eficom
activity had happened --but not all the detail.)

===
Mark Millard
marklmi at yahoo.com