Package: manpages-dev
Version: 3.27-1
Severity: important
Tags: patch

XDR (eXternal Data Representation) is a codec format
well known for its use by Sun/ONC-RPC (see rpcgen(1)).

XDR API (xdr_*) which is described in this manpage
can be used for generic data encoding/decoding purpose
without using RPC. In that case, s/he needs to call
either of

- xdr_create(3)
- xdrstdio_create(3)
- xdrrec_create(3)

to instantiate XDR* stream required by the API.

However, xdrrec_create(3) manpage lacks information to
make it work. When reading from xdrrec_create(3)-ed
XDR* stream, xdrrec_skiprecord(3) API must be called
first to find record boundary:

  // example of correct API call sequence
  xdrrec_create(&xdrs, 0, 0, handle, myread, NULL);
  xdrs.x_op = XDR_DECODE;
  xdrrec_skiprecord(&xdrs);

However, this is not documented. It only warns as follows:

  Warning: this XDR stream implements an intermediate record
  stream. Therefore there are additional bytes in the stream
  to provide record boundary information.

This is too vague, and should be fixed.

Also due to this "record boundary", it is not possible to
read xdrstdio_create(3)-ed XDR* stream with xdrrec_* API
and vise versa.

I will post a diff in next email.

-- System Information:
Debian Release: squeeze/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.32-5-openvz-amd64 (SMP w/4 CPU cores)
Locale: LANG=C, LC_CTYPE=ja_JP.UTF-8 (charmap=ANSI_X3.4-1968) (ignored: LC_ALL 
set to C)
Shell: /bin/sh linked to /bin/bash

Versions of packages manpages-dev depends on:
ii  manpages                      3.25-1     Manual pages about using a GNU/Lin

manpages-dev recommends no packages.

Versions of packages manpages-dev suggests:
ii  man-db [man-browser]          2.5.6-5    on-line manual pager

-- no debconf information



-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org

Reply via email to