Add genet.4 for RPi 4 Ethernet

[• karels]

Summary

Add new man page for genet(4) Ethernet on Raspberry Pi 4B, based on
several other Ethernet man pages. Hook into build.

Note, this could potentially be added as an aarch64 man page; not
sure if that matters now. Include if_genet(4) link as for other
network devices.

Copyright notice yet to be determined.

Test Plan

Tested with mandoc in UTF-8 and Postscript.

[pauamma_gundo.com]

share/man/man4/genet.4

20

Maybe add instructions for having loader(8) load it at boot time?

These are common for other Ethernet interfaces, eg for re(4);

Alternatively, to load the driver as a module at boot time, place the
following line in loader.conf(5):

      if_re_load="YES"

[• karels]

share/man/man4/genet.4

20

That is not implemented in the driver.

[pauamma_gundo.com]

Grammar and language look good to me.

[bcr]

Same here, can't find any grammar or other nits.

[maciphone2_googlemail.com]

should work on all BCM2711xxx SOC-revisions, not only on the mentioned P4b(BCM2711B08)
while not specifically inspected I didn't notice any problem with the CM4(BCM2711C0)

[• karels]

Good point. I had more hardware information in the Description section originally, but moved it to Hardware. I'll try to come up with something more generic. I still want to mention the RPi 4, as that is the most common.

[maciphone2_googlemail.com]

In D33360#754185, @karels wrote:

...mention the RPi 4, as that is the most common.

of course... e.g. removing the "B" should match, thanks.

[• karels]

Added copyright; touched up hardware info

[maciphone2_googlemail.com]

In D33360#755447, @karels wrote:

Added copyright; touched up hardware info

┈┈┈┈┈┈▕▔╲
┈┈┈┈┈┈┈▏▕
┈┈┈┈┈┈┈▏▕▂▂▂
▂▂▂▂▂▂╱┈▕▂▂▂▏
▉▉▉▉▉┈┈┈▕▂▂▂▏
▉▉▉▉▉┈┈┈▕▂▂▂▏
▔▔▔▔▔▔╲▂▕▂▂▂I

[pauamma_gundo.com]

ObAccessibility; in case anyone visits this (now or later) using a screenreader and is wondering, the ASCII art in maciphone2_googlemail.com's comment earlier is a thumb-up sign.

[maciphone2_googlemail.com]

In D33360#755573, @pauamma_gundo.com wrote:

ObAccessibility; in case anyone visits this (now or later) using a screenreader and is wondering, the ASCII art in maciphone2_googlemail.com's comment earlier is a thumb-up sign.

👍

[danfe]

@pauamma_gundo.com wrote:

the ASCII art in comment earlier is a thumb-up sign.

Technically, it was not ASCII art, it was UTF-8 art (and not very good one).

[maciphone2_googlemail.com]

In D33360#755717, @danfe wrote:

Technically, it was not ASCII art, it was UTF-8 art (and not very good one).

since not accepted as it landed I abandone that revision

[pauamma_gundo.com]

In D33360#755717, @danfe wrote:

@pauamma_gundo.com wrote:

the ASCII art in comment earlier is a thumb-up sign.

Technically, it was not ASCII art, it was UTF-8 art (and not very good one).

Psst. This is (well, was) a documentation review. Art reviews are ----> over that way.

[maciphone2_googlemail.com]

In D33360#755946, @pauamma_gundo.com wrote:

...Art reviews are ----> over that way.

good point . for amazed screenreaders : the ASCII art in @pauamma_gundo.com`s comment
is an invalid access operator sign.