Date: Sun, 9 Oct 2005 13:05:36 -0700 (PDT) From: "Devon H. O'Dell" <dodell@offmyserver.com> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/87176: Message-ID: <200510092005.j99K5a3J036750@skik.dtrace.internal.sitetronics.com> Resent-Message-ID: <200510092010.j99KAIHV013733@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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@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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200510092005.j99K5a3J036750>