docs/87176:

[Devon H. O'Dell]

>Number:         87176
>Category:       docs
>Synopsis:       
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Oct 09 20:10:17 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     Devon H. O'Dell
>Release:        FreeBSD 7.0-CURRENT amd64
>Organization:
	OffMyServer, Inc.
>Environment:
System: FreeBSD skik.dtrace.internal.sitetronics.com 7.0-CURRENT FreeBSD 7.0-CURRENT #0: Tue Oct 4 13:44:46 PDT 2005 dodell at skik.dtrace.internal.sitetronics.com:/usr/obj/usr/src/sys/SKIK-RD amd64


>Description:
	The device_get_softc(9) manpage incorrectly or ambiguously specifies
	when allocation of the device's softc takes place. My interpretation
	was that it takes place on the call of device_get_softc(9). To the
	contrary, the implementation of device_get_softc simply returns the
	dev->softc field; allocation is automatically done when the device
	attaches.
>How-To-Repeat:
	man 9 device_get_softc	
>Fix:

--- device_get_softc.9.patch begins here ---
--- share/man/man9/device_get_softc.9.old	Sun Oct  9 12:57:20 2005
+++ share/man/man9/device_get_softc.9	Sun Oct  9 12:58:05 2005
@@ -42,8 +42,8 @@
 .Sh DESCRIPTION
 Return the driver-specific state of
 .Fa dev .
-The softc is automatically allocated and zeroed the first
-time it is requested.
+The softc is automatically allocated and zeroed when the
+driver is attached.
 The size of the allocation is determined by the device's
 .Vt driver_t
 information used to define the driver.
--- device_get_softc.9.patch ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted:
 	[patch] device_get_softc(9) is ambiguous about when allocation takes place