RE: Possible erratum: Section 17.2.7 $ferror

From: Michael McNamara (mac@verisity.com)
Date: Fri Jul 26 2002 - 10:30:44 PDT


Precedence: bulk

Daryl Stewart writes:
> Sorry if this is the wrong address, or errata are closed now but...
>
> Section 17.2.7 describes the system function
>
> errno = $ferror( fd, str );
>
> but fails to explain how fd is used - does it fetch the last error
> for fd as opposed to the last error of all? How does that apply to
> mcds, each with a different last error... More importantly, if
> $fopen returns 0 indicating an error, no fd or mcd is available.
>
> I suspect the inclusion of fd is a typo, or it should be an optional second
> argument.
>
> cheers
> Daryl
>

This is a good email address; however, etf@boyd.com is better; or indeed,
going to http://www.boyd.com you can enter errata descriptions
directly.

In truth, fd is a required operand, and in order to make this
absolutely clear, perhaps the text should be modified from:

  A string description of type of error encountered by the most recent
  file I/O operation is written into str which should be at least 640
  bits wide. The intergral value of the error code is returned in
  errno. If the most recent operation did not result in an error ,
  then the value returned shall be zero, and the reg str shall be
  cleared.

To:

  A string description of the error encountered by the most recent
  file I/O operation on file descriptor fd is written into str which
  should be at least 640 bits wide. The intergral value of the error
  code is returned in errno. If the most recent operation on file
  descriptor fd did not result in an error, then the value returned
  shall be zero, and the reg str shall be cleared.

-mac



This archive was generated by hypermail 2.1.4 : Thu Oct 10 2002 - 09:24:26 PDT and
sponsored by Boyd Technology, Inc.