Bug 273195 - FreeBSD Handbook: occasionally building a kernel module using both /usr/ports and /usr/src
Summary: FreeBSD Handbook: occasionally building a kernel module using both /usr/ports...
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: freebsd-doc (Nobody)
URL:
Keywords: needs-patch
Depends on:
Blocks:
 
Reported: 2023-08-18 04:52 UTC by Graham Perrin
Modified: 2023-08-21 18:40 UTC (History)
0 users

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin freebsd_committer freebsd_triage 2023-08-18 04:52:49 UTC
It's sometimes – not always – necessary to build a ported kernel module from source, after a minor update to the operating system. 

It's sometimes necessary to build a ported kernel module from source, after simply installing (not updating) the OS. 

Recent <https://github.com/freebsd/freebsd-src/commit/9051987e40c5a1f2396c5ceecff119fb4da28160#diff-7a99811ebf6b6268a2581fcf050df0a2c325fdbf1c02481dad16afd38f4bd6a1> on the main branch (for CURRENT) was an extraordinary change. From the commit message: 

> … Out-of-tree kernel modules will need to be rebuilt.

----

As far as I can tell, <https://docs.freebsd.org/en/books/handbook/ports/> does not yet cover the commonplace use cases. 

Elsewhere in the FreeBSD Handbook, parts of <https://docs.freebsd.org/en/books/handbook/cutting-edge/#makeworld> are misplaced; should probably be moved to a new chapter. 

From <https://old.reddit.com/r/freebsd/comments/15gssd3/-/jvpfm8h/?context=1>: 

> - you're packaging and installing a port
> 
> - you're neither updating, nor upgrading, the operating system.
> 
> Other problems around this subsection:
> 
> 1. the first sentence of 
> <https://docs.freebsd.org/en/books/handbook/book/#updating-src-preparing> 
> begins with direction to read /usr/src/UPDATING, which does not exist 
> because the copy of the source code has not been obtained (disorderly)
> 
> 2. then updating before obtaining (again, disorderly)
> 
> …