Re: [patch] Clarified incompatibility and correct usage of XDR API

["Michael Kerrisk (man-pages)" <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>]

On 02/24/2015 07:20 PM, saulery-GANU6spQydw@public.gmane.org wrote:
> From: Stéphane Aulery <saulery-GANU6spQydw@public.gmane.org>
> 
> Debian Bug #628099
> Report and patch of Taisuke Yamada <tai-f4p32tzkXghg9hUCZPvPmw@public.gmane.org>

Thanks, Stéphane. Applied.

Cheers,

Michael


> Signed-off-by: Stéphane Aulery <saulery-GANU6spQydw@public.gmane.org>
> ---
>  man3/xdr.3 | 8 +++++---
>  1 file changed, 5 insertions(+), 3 deletions(-)
> 
> diff --git a/man3/xdr.3 b/man3/xdr.3
> index 8f931db..f4bb3e9 100644
> --- a/man3/xdr.3
> +++ b/man3/xdr.3
> @@ -291,9 +291,11 @@ Note: the XDR stream's
>  .I op
>  field must be set by the caller.
>  .IP
> -Warning: this XDR stream implements an intermediate record stream.
> -Therefore there are additional bytes in the stream
> -to provide record boundary information.
> +Warning: To read from XDR stream created by this API, you'll need to
> +call xdrrec_skiprecord(3) first before calling any other XDR APIs.
> +This is because this inserts additional bytes in the stream to provide
> +record boundary information. Also, XDR streams created with different
> +xdr*_create APIs are not compatible for the same reason.
>  .LP
>  .nf
>  .BI "bool_t xdrrec_endofrecord(XDR *" xdrs ", int " sendnow );
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html