Re: [PATCH] strerror: improve strerror_r description

[Eric Blake <eblake-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>]

[-- Attachment #1: Type: text/plain, Size: 1017 bytes --]

On 04/21/2012 06:19 PM, Michael Kerrisk (man-pages) wrote:
> Eric,
> 

> In addition to the above, I added the following, and I'd be happy if
> you could ack it.
> 
> =====
> --- a/man3/strerror.3
> +++ b/man3/strerror.3
> @@ -133,6 +133,19 @@ functions return
>  the appropriate error description string,
>  or an "Unknown error nnn" message if the error number is unknown.
> 
> +POSIX.1-2001 and POSIX.1-2008 require that a successful call to
> +.BR strerror (3)
> +shall leave
> +.I errno
> +unchanged, and note that,
> +since no function return value is reserved to indicate an error,
> +an application that wishes to check for errors should initialize
> +.I errno
> +to zero before the call,
> +and then check
> +.I errno
> +after the call.
> +
>  The XSI-compliant
>  .BR strerror_r ()
>  function returns 0 on success.
> =====

Correct.

-- 
Eric Blake   eblake-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org    +1-919-301-3266
Libvirt virtualization library http://libvirt.org


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 620 bytes --]