ISSUE 158

Number 158
Category errata
Synopsis Section 27.32 vpi_put_value() w/vpiReleaseFlag; Whose data?
State lrmdraft
Class errata-ptf
Arrival-DateOct 11 2002
Originator Charles Dawson
Release 2001b: 27.32
Environment
Description
Section 27.32 says "The value_p shall be updated with the
value of the object after its release" when the vpiReleaseFlag
is used. It is unclear if the data pointed to by the
value_p argument is owned by the application or by the
interface.
Fix
Part I:

In the first paragraph of 27.32 vpi_put_value():

REPLACE the 2nd sentence which reads:

"The value to be set shall be stored in an s_vpi_value structure that
has been allocated."

WITH:

"The value to be set shall be stored in an s_vpi_value
structure that has been allocated by the calling routine.
Any storage referenced by the s_vpi_value structure shall
also be allocated by the calling routine.

The delay time before the value is set shall be stored in
an s_vpi_time structure that has been allocated by the
calling routine.


Part II:

In the description of the "vpiReleaseFlag" in the table
following the first paragraph of 27.32 vpi_put_value():

REPLACE the last sentence:

"The value_p shall be updated with the value of the object
after its release."

WITH:

"The value_p shall be updated with the value of the object
after its release. If the value is a string, time,
vector, strength or miscellaneous value, the data pointed
to by the value_p argument shall be owned by the
interface."
Audit-Trail
From: Shalom.Bresticker@motorola.com
To: ptf-bugs@boyd.com
Cc: 1364@accellera.org
Subject: Re: errata/158: PROPOSAL - Section 27.32 vpi_put_value() w/vpiReleaseFlag;
Whose data?
Date: Tue, 25 Nov 2003 11:55:27 +0200 (IST)

I wish to implement this VSG-passed change in the LRM.
The change to be made in Part I of the Fix is not clear.

The current text says,
"The value to be set shall be stored in an s_vpi_value structure that has been allocated. The legal values which may be specified for each value format are listed in Table 214 in 27.14. The delay time before the value is set shall be stored in an s_vpi_time structure that has been allocated."

Part I of The Fix says,

> REPLACE the 2nd sentence which reads:
>
> "The value to be set shall be stored in an s_vpi_value structure that
> has been allocated."
>
> WITH:
>
> "The value to be set shall be stored in an s_vpi_value
> structure that has been allocated by the calling routine.
> Any storage referenced by the s_vpi_value structure shall
> also be allocated by the calling routine.
>
> The delay time before the value is set shall be stored in
> an s_vpi_time structure that has been allocated by the
> calling routine.

My questions are,

1. What happens to the sentence,
"The legal values which may be specified for each value format are listed in Table 214 in 27.14." ?

2. Is the sentence,
"The delay time before the value is set ..." intended to start a new paragraph instead of continuing the same paragraph?

Thanks,
Shalom


On Tue, 6 May 2003 etf@boyd.com wrote:

> Date: Tue, 6 May 2003 11:32:25 -0700
> From: etf@boyd.com
> To: ptf-bugs@boyd.com
> Subject: errata/158: PROPOSAL - Section 27.32 vpi_put_value()
w/vpiReleaseFlag; Whose data?
>
>
> Part I:
>
> In the first paragraph of 27.32 vpi_put_value():
>
> REPLACE the 2nd sentence which reads:
>
> "The value to be set shall be stored in an s_vpi_value structure that
> has been allocated."
>
> WITH:
>
> "The value to be set shall be stored in an s_vpi_value
> structure that has been allocated by the calling routine.
> Any storage referenced by the s_vpi_value structure shall
> also be allocated by the calling routine.
>
> The delay time before the value is set shall be stored in
> an s_vpi_time structure that has been allocated by the
> calling routine.
>
>
> Part II:
>
> In the description of the "vpiReleaseFlag" in the table
> following the first paragraph of 27.32 vpi_put_value():
>
> REPLACE the last sentence:
>
> "The value_p shall be updated with the value of the object
> after its release."
>
> WITH:
>
> "The value_p shall be updated with the value of the object
> after its release. If the value is a string, time,
> vector, strength or miscellaneous value, the data pointed
> to by the value_p argument shall be owned by the
> interface."
>
> http://boydtechinc.com/cgi-bin/issueproposal.pl?cmd=view&pr=158
>

--
Shalom Bresticker Shalom.Bresticker@motorola.com
Design & Reuse Methodology Tel: +972 9 9522268
Motorola Semiconductor Israel, Ltd. Fax: +972 9 9522890
POB 2208, Herzlia 46120, ISRAEL Cell: +972 50 441478

Unformatted




Hosted by Boyd Technology