git: 29d13f3d06de - main - newbus: Document new DEVICE_UNIT_ANY
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Thu, 25 Jul 2024 04:49:03 UTC
The branch main has been updated by imp:
URL: https://cgit.FreeBSD.org/src/commit/?id=29d13f3d06dec06a2fc9636ca8308c0462f80cfc
commit 29d13f3d06dec06a2fc9636ca8308c0462f80cfc
Author: Warner Losh <imp@FreeBSD.org>
AuthorDate: 2024-07-25 04:22:55 +0000
Commit: Warner Losh <imp@FreeBSD.org>
CommitDate: 2024-07-25 04:22:55 +0000
newbus: Document new DEVICE_UNIT_ANY
In the past, device_add_child took a -1 to mean any unit. Document it
now taking DEVICE_UNIT_ANY.
Sponsored by: Netflix
---
share/man/man9/device_add_child.9 | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/share/man/man9/device_add_child.9 b/share/man/man9/device_add_child.9
index 423869d6ff6b..dfd0d19049bc 100644
--- a/share/man/man9/device_add_child.9
+++ b/share/man/man9/device_add_child.9
@@ -51,7 +51,7 @@ arguments specify the name and unit number of the device.
If the name is unknown then the caller should pass
.Dv NULL .
If the unit is unknown then the caller should pass
-.Dv -1
+.Dv DEVICE_UNIT_ANY
and the system will choose the next available unit number.
.Pp
The name of the device is used to determine which drivers might be
@@ -70,7 +70,7 @@ be specified as the device name.
.Pp
Normally unit numbers will be chosen automatically by the system and a
unit number of
-.Dv -1
+.Dv DEVICE_UNIT_ANY
should be given.
When a specific unit number is desired (e.g.,\& for wiring a particular
piece of hardware to a pre-configured unit number), that unit should