Module Name: src
Committed By: uwe
Date: Tue Aug 13 15:01:52 UTC 2024
Modified Files:
src/usr.bin/config: config.5
Log Message:
config(5): mention ioconf and pseudo-root
Add barebones descriptions for ioconf and pseudo-root added by pooka@
long time ago for rump and kmods. Definitely could be improved and
expanded, so feel free...
PR bin/58583
To generate a diff of this commit:
cvs rdiff -u -r1.48 -r1.49 src/usr.bin/config/config.5
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/usr.bin/config/config.5
diff -u src/usr.bin/config/config.5:1.48 src/usr.bin/config/config.5:1.49
--- src/usr.bin/config/config.5:1.48 Thu Jan 18 04:41:37 2024
+++ src/usr.bin/config/config.5 Tue Aug 13 15:01:52 2024
@@ -1,4 +1,4 @@
-.\" $NetBSD: config.5,v 1.48 2024/01/18 04:41:37 thorpej Exp $
+.\" $NetBSD: config.5,v 1.49 2024/08/13 15:01:52 uwe Exp $
.\"
.\" Copyright (c) 2006, 2007 The NetBSD Foundation.
.\" All rights reserved.
@@ -739,6 +739,16 @@ the
and each of the
.Ar subarch .
.\"
+.It Ic ioconf Ar name
+Used instead of
+.Ic machine
+in config file snippets for kernel modules to generate just the
+.Pa ioconf.c
+definions.
+The generated file contains subtrees that start with attachments
+declared with
+.Ic pseudo-root .
+.\"
.It Ic package Ar path
Simpler version of:
.Bd -literal -offset indent
@@ -844,6 +854,24 @@ Removes
.Ar name
from the list of kernel binaries to compile from the configuration file.
.\"
+.It Ic pseudo-root Ar instance
+Used in conjunction with
+.Ic ioconf
+in kernel modules.
+Declares an instance of a device that serves as the root for a subtree
+described in the module config.
+The declared
+.Ar instance
+can then be used as an
+.Ar attachment
+for devices in the kernel module.
+Multiple such attachment points may be declared in the config file.
+.Ar instance
+may name a device
+.Pq e.g. Ql pci*
+an interface attribute
+.Pq e.g. Ql audiobus*
+.\"
.It Ar instance Ic at Ar attachment Op Ar locator-specifications ...
Configures an instance of a device attaching at a specific location in the
device tree.
