summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authornjl <njl@FreeBSD.org>2005-05-20 05:04:22 +0000
committernjl <njl@FreeBSD.org>2005-05-20 05:04:22 +0000
commit9ab8d98ce568fc756b4d0a97f73188f2c593e49e (patch)
tree31206b66d860791dc40ccecc90058b86117a3d27
parentd8af4c8b76742ac9db58b0e960129399e40ac535 (diff)
downloadFreeBSD-src-9ab8d98ce568fc756b4d0a97f73188f2c593e49e.zip
FreeBSD-src-9ab8d98ce568fc756b4d0a97f73188f2c593e49e.tar.gz
Document that the returned pointer should be freed even if the number
of items returned is 0.
-rw-r--r--share/man/man9/devclass_get_devices.97
-rw-r--r--share/man/man9/devclass_get_drivers.95
-rw-r--r--sys/kern/subr_bus.c2
3 files changed, 10 insertions, 4 deletions
diff --git a/share/man/man9/devclass_get_devices.9 b/share/man/man9/devclass_get_devices.9
index 2872adc..797a2f6 100644
--- a/share/man/man9/devclass_get_devices.9
+++ b/share/man/man9/devclass_get_devices.9
@@ -28,7 +28,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd June 16, 1998
+.Dd May 19, 2005
.Dt DEVCLASS_GET_DEVICES 9
.Os
.Sh NAME
@@ -46,7 +46,10 @@ return the list in
and the count in
.Fa *devcountp .
The memory allocated for the list should be freed using
-.Fn free "*devlistp" "M_TEMP" .
+.Fn free "*devlistp" "M_TEMP" ,
+even if
+.Fa *devcountp
+is 0.
.Sh RETURN VALUES
Zero is returned on success, otherwise an appropriate error is returned.
.Sh SEE ALSO
diff --git a/share/man/man9/devclass_get_drivers.9 b/share/man/man9/devclass_get_drivers.9
index f9561eb..ee6629b 100644
--- a/share/man/man9/devclass_get_drivers.9
+++ b/share/man/man9/devclass_get_drivers.9
@@ -28,7 +28,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd April 3, 2005
+.Dd May 19, 2005
.Dt DEVCLASS_GET_DRIVERS 9
.Os
.Sh NAME
@@ -47,6 +47,9 @@ and the number of drivers in the list in
.Fa *countp .
The memory allocated for the list should be freed using
.Fn free "*listp" "M_TEMP" .
+even if
+.Fa *countp
+is 0.
.Sh RETURN VALUES
Zero is returned on success, otherwise an appropriate error is returned.
.Sh SEE ALSO
diff --git a/sys/kern/subr_bus.c b/sys/kern/subr_bus.c
index 3f2e477..1d7f3eb 100644
--- a/sys/kern/subr_bus.c
+++ b/sys/kern/subr_bus.c
@@ -1098,7 +1098,7 @@ devclass_get_softc(devclass_t dc, int unit)
* An array containing a list of all the devices in the given devclass
* is allocated and returned in @p *devlistp. The number of devices
* in the array is returned in @p *devcountp. The caller should free
- * the array using @c free(p, M_TEMP).
+ * the array using @c free(p, M_TEMP), even if @p *devcountp is 0.
*
* @param dc the devclass to examine
* @param devlistp points at location for array pointer return
OpenPOWER on IntegriCloud