networking.7: Clarifications

[ziaee]

Summary

It is no longer necessay to load the USB tetherning interface driver
in any supported release, as well as less ambiguous since there are
several drivers that populate ue interfaces. Use common, actively
developed 10g Ethernet and our most current and reliable usb wifi
drivers in the examples. Explain the bhyve(8) caveat as I promised
to allanjude on IRC in 2023. Finally, clean up some markup.

MFC after: 3 days

[ziaee]

s/bhyve(8)/bhyve(8) virtual machines./

[ziaee]

Switch to the most common internal wifi devices.

[AAFreeBSD_outlook.com]

share/man/man7/networking.7

32

while its true that usb tethering devices do not have to be loaded manually, on ipheth(4) devices require manual steps. possibly have to be noted.

the same aforementioned manual steps are not required for android.

[ziaee]

share/man/man7/networking.7

32

Do they? What are they?

[AAFreeBSD_outlook.com]

share/man/man7/networking.7

32

ipheth(4) man page summarized is:

1. identifying USB address using

# usbconfig | grep Apple
`

2. getting the different configs available using

#usbconfig -d {USB_address} dump_all_config_desc | grep -E '(^ Conf|iConf)'

3. you should now confirm to trust the device over your iphone.

figuring out which configuration lists USB tethering, you now send set_config to its index.

# usbconfig -d ${USB_address} set_config ${configuration}

3.5: extra step on some devices ( not needed for iphone 13 here)
sometimes usbmuxd(1) is neccessary and should be used before step 4.

# usbmuxd --enable-exit --foreground	--user root --verbose

4. you should be able to see ue0 now:

# sysrc ifconfig_ue0 = "SYNCDHCP"
# service dhclient restart ue0

[ziaee]

share/man/man7/networking.7

32

That is only for older iPhones. Newer iPhones and everything else Just Works. I do not want to add that.

[quentin.thebault_defenso.fr]

share/man/man7/networking.7

22

28

34

48

64

68

It's not a sentence and we already have a colon before so I think it would be easier on the eyes to just remove the second one.

If you keep it anyway: no space before punctuation in English.

95

Maybe we should explain what happens to jail networking, which might be different for VNET or non-VNET jails or interfaces.

[ziaee]

share/man/man7/networking.7

68

Yes, I am a native English speaker. These spaces are part of the syntax of the Roff language. If you test the patch, they do not render with a space between.

95

This is a quick start guide for connecting to basic networks and getting yourself going. The caveat is that stopping netif stops networking, and it might not be obvious to people who are quick starting that some things are using networking internally. I do not want to digress here. Maybe I have digressed too much already by providing an example which is naturally incomplete.

[quentin.thebault_defenso.fr]

share/man/man7/networking.7

68

You are right about rendering. I do not see any difference with or without the extra space. But that also means there is no benefit from having a space?

Regarding the colon, I checked with and without in the rendering, and I maintain that I think without ending colons is more readable. It makes the line look more like a (sub)section title, which it actually is.

I would add that if you test it with MANWIDTH=59, lines wrap and you end up with colons close to the one of the Example N: pattern, which I think hurts readability.

[ziaee]

These spaces are part of the Roff language

But that also means there is no benefit from having a space?

No. See above. Removed punctuation and bhyve example.

[adrian]

I think this is a good checkpoint to land and then iterate on some more in -head. Thanks for this!

Just bump the modified date :-)

[ziaee]

Ping? I would like to put these improvements in 14.3.

[mhorne]

Approved.

[ziaee]

Thank you! Very excited about this one, demonstrating drivers for wifi 7 and 10 gbe hardware!