diff options
author | Nate Lawson <njl@FreeBSD.org> | 2005-05-20 05:04:22 +0000 |
---|---|---|
committer | Nate Lawson <njl@FreeBSD.org> | 2005-05-20 05:04:22 +0000 |
commit | 96ab794b26668fec4aec812e0faca4e820652f1b (patch) | |
tree | 31206b66d860791dc40ccecc90058b86117a3d27 | |
parent | 1c9ec5385411c6308f57efe406ac1ba2e32b4ca4 (diff) | |
download | src-96ab794b26668fec4aec812e0faca4e820652f1b.tar.gz src-96ab794b26668fec4aec812e0faca4e820652f1b.zip |
Document that the returned pointer should be freed even if the number
of items returned is 0.
Notes
Notes:
svn path=/head/; revision=146432
-rw-r--r-- | share/man/man9/devclass_get_devices.9 | 7 | ||||
-rw-r--r-- | share/man/man9/devclass_get_drivers.9 | 5 | ||||
-rw-r--r-- | sys/kern/subr_bus.c | 2 |
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 2872adcf87b2..797a2f6dbeae 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 f9561eb28353..ee6629b0177f 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 3f2e47733e35..1d7f3ebc73ea 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 |