Extend linuxkpi.4 adding kenrel compile time options,
information on how to compile a driver into the kernel or how to
compile as a module. Add a sysctl section. Rework other bits from
the initial "dummy" page.
MFC after: 3 days
Details
Details
Diff Detail
Diff Detail
- Repository
- rG FreeBSD src repository
- Lint
Lint Passed - Unit
No Test Coverage - Build Status
Buildable 78039 Build 74922: arc lint + arc unit
Event Timeline
Comment Actions
Please note there are a lot of commented out parts in there for drivers, etc. which do use LinuxKPI, which are in the tree, but not yet hooked up to the build.
Comment Actions
Some of this is stuff that we would normally keep on the wiki, I really like them being here in the tree instead. I think it's easier to see and maintain atomically.
| share/man/man4/linuxkpi.4 | ||
|---|---|---|
| 35 | We have this in 10 manuals as a section for consistency with SYSCTL VARIABLES and LOADER TUNABLES as the three ways to configure behavior. I would move this section to just before SYSCTL VARIABLES. | |
| 40 | (I think) | |
| 59 | This bit formats kinda weird. | |
| 63–64 | Crossreferences are kinda bad in titles. | |
| 196 | This is equivalent, but is a little cleaner | |
Comment Actions
Yes. The initial idea was to keep some of this in a README in sys/compat/linuxkpi but I figured I'd rather have one place than two.
I'll hold off for a second to see how the parent review goes (things may change) and will then do the updates here in one go; thanks a lot for your quick reply to this! Much appreciated!
| share/man/man4/linuxkpi.4 | ||
|---|---|---|
| 59 | Using .Sy instead makes it look better. | |
Comment Actions
There's some markup that I'm not really sure about, but... Its not hurting anything. This is a really great addition to the manual, I think.
| share/man/man4/linuxkpi.4 | ||
|---|---|---|
| 59 | I never used these options, but I'm not very advanced for a committer... You put them in the KERNCONF? If so, it should be Cd. | |
| share/man/man4/linuxkpi.4 | ||
|---|---|---|
| 59 | They go in the sys/conf/files* files used by config(8). Not sure if that qualifies. What would you say? Keep or change to .Cd? | |