Package: manpages-dev
Version: 2.79-4
Severity: normal
Hiya,
The CONFORMING TO section of inet_aton(3) says:
CONFORMING TO
4.3BSD. inet_addr(), inet_aton(), and inet_ntoa() are
specified in POSIX.1-2001.
AFAICT, that is not correct.
POSIX only specifies inet_addr, inet_pton and inet_ntoa.
(AFAICT from
http://www.opengroup.org/onlinepubs/009695399/idx/functions.html)
The man page also says that inet_addr is obsoleted by inet_ntoa.
I think it should either warn that inet_ntoa is not POSIX or
that inet_addr is obsoleted by inet_pton instead (as the
inet_pton man page says BTW) but then warn that inet_pton
doesn't recognise all the IP address notations that inet_addr
recognises. Or something like: "one may consider the inet_pton,
inet_ntoa (non-POSIX), getaddrinfo, gethostbyname alternatives
that don't have the problem" [of inet_addr returning
(in_attr_t)-1 for 255.255.255.255]
The SEE ALSO section could also mention getaddrinfo (that
obsoletes gethostbyname).
Best regards,
Stephane
-- System Information:
Debian Release: lenny/sid
APT prefers unstable
APT policy: (500, 'unstable')
Architecture: i386 (i686)
Kernel: Linux 2.6.25-rc8 (PREEMPT)
Locale: LANG=en_GB.ISO-8859-15, LC_CTYPE=en_US.ISO-8859-15 (charmap=ISO-8859-15)
Shell: /bin/sh linked to /bin/bash
Versions of packages manpages-dev depends on:
ii manpages 2.79-4 Manual pages about using a GNU/Lin
manpages-dev recommends no packages.
-- debconf-show failed
Subject: Re: Bug#482979: manpages-dev: inet_aton() is not POSIX
Date: Mon, 26 May 2008 18:03:17 +0200
tags 482979 fixed-upstream
thanks
Hi Stephane,
Thanks for your report.
On Mon, May 26, 2008 at 12:37 PM, Stephane Chazelas
<[email protected]> wrote:
> Package: manpages-dev
> Version: 2.79-4
> Severity: normal
>
>
> Hiya,
>
> The CONFORMING TO section of inet_aton(3) says:
>
> CONFORMING TO
> 4.3BSD. inet_addr(), inet_aton(), and inet_ntoa() are
> specified in POSIX.1-2001.
>
>
> AFAICT, that is not correct.
Agreed.
> POSIX only specifies inet_addr, inet_pton and inet_ntoa.
> (AFAICT from
> http://www.opengroup.org/onlinepubs/009695399/idx/functions.html)
Yes.
> The man page also says that inet_addr is obsoleted by inet_ntoa.
I think you meant "inet_aton"
> I think it should either warn that inet_ntoa is not POSIX or
However, inet_aton() does seem to be on every major Unix system (e.g.,
the BSDs, Solaris, HP-UX, Irix, AIX, Tru64) that I've checked.
> that inet_addr is obsoleted by inet_pton instead (as the
> inet_pton man page says BTW) but then warn that inet_pton
> doesn't recognise all the IP address notations that inet_addr
> recognises.
The existing page didn't describe all of those notations. That will
be fixed soon. (Therefore, it will be one or two upstream releases
into the future before the other changes mentioned here are released.
You'll get an email when they are.)
> Or something like: "one may consider the inet_pton,
> inet_ntoa (non-POSIX), getaddrinfo, gethostbyname alternatives
> that don't have the problem" [of inet_addr returning
> (in_attr_t)-1 for 255.255.255.255]
I've simply added a sentence recommending the use of inet_aton(),
inet_pton(), or getaddrinfo().
In the CONFORMING to section, I've added text to explicitly note that
inet_aton() is not in POSIX.1, but is widely available.
The inet_pton() page clearly points out that hex and octal numeric
forms are disallowed, so I don't think it's needed to mention that on
this page.
> The SEE ALSO section could also mention getaddrinfo (that
> obsoletes gethostbyname).
Yes, added.
Cheers,
Michael
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html
Source: manpages
Source-Version: 3.01-1
We believe that the bug you reported is fixed in the latest version of
manpages, which is due to be installed in the Debian FTP archive:
manpages-dev_3.01-1_all.deb
to pool/main/m/manpages/manpages-dev_3.01-1_all.deb
manpages_3.01-1.diff.gz
to pool/main/m/manpages/manpages_3.01-1.diff.gz
manpages_3.01-1.dsc
to pool/main/m/manpages/manpages_3.01-1.dsc
manpages_3.01-1_all.deb
to pool/main/m/manpages/manpages_3.01-1_all.deb
manpages_3.01.orig.tar.gz
to pool/main/m/manpages/manpages_3.01.orig.tar.gz
A summary of the changes between this version and the previous one is
attached.
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to [email protected],
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
Joey Schulze <[email protected]> (supplier of updated manpages package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing [email protected])
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Format: 1.8
Date: Fri, 27 Jun 2008 15:11:49 +0200
Source: manpages
Binary: manpages manpages-dev
Architecture: source all
Version: 3.01-1
Distribution: unstable
Urgency: low
Maintainer: Martin Schulze <[email protected]>
Changed-By: Joey Schulze <[email protected]>
Description:
manpages - Manual pages about using a GNU/Linux system
manpages-dev - Manual pages about using GNU/Linux for development
Closes: 482979482987485636486920487254
Changes:
manpages (3.01-1) unstable; urgency=low
.
* New upstream version
. inet_aton() is *not* in POSIX.1 (closes: Bug#482979)
. Improvements to inet_pton() (closes: Bug#482987)
. Improvements to nanosleep(2) (closes: Bug#485636)
. Added errors section for scanf(3) (closes: Bug#487254)
. Document guest time in proc(5) (closes: Bug#486920)
Checksums-Sha1:
1605e0806dc4854d3379150ffbb4e9b0eeed5d40 964 manpages_3.01-1.dsc
cfd01d341b259d44f8391789457d52e38bc8d327 1348851 manpages_3.01.orig.tar.gz
22fc4b999ed541f1a17373b152680cb362ecaa8c 46423 manpages_3.01-1.diff.gz
a6379d90da5015dff07767be4223f9699c5d2610 577032 manpages_3.01-1_all.deb
feb3784e22d92755113345b12d4c786c03a74a2e 1403326 manpages-dev_3.01-1_all.deb
Checksums-Sha256:
a7829005f845c3a710d597bbc5d46987f6109d1d50481ed0a27f1892442e2735 964 manpages_3.01-1.dsc
04ff9d05a43c5820a1127efba6caf06a6ba9bd9a98c18cd93f38ff3446c7c236 1348851 manpages_3.01.orig.tar.gz
c3352a5cb9c80f0fdf88fb29c3011397177186d45b856eb8cc0341b8fc2ac156 46423 manpages_3.01-1.diff.gz
8104d0c7bde81f81d52a85ba20bec58f2d58ae108fb8f37f4cdebdf2811ba1e7 577032 manpages_3.01-1_all.deb
e7da5ca23627565dce0fb8c77ea3f248408f8b9bf4d83d67f626e94f9cb0d0e8 1403326 manpages-dev_3.01-1_all.deb
Files:
0ce201ebec8b8d10bc745683d6a525fc 964 doc important manpages_3.01-1.dsc
5afc311cf7b96d08e17af30f566b1887 1348851 doc important manpages_3.01.orig.tar.gz
f2d94a71cc35c7dc99d0cd48d63480d4 46423 doc important manpages_3.01-1.diff.gz
1d8ffc83c891573da6bcbc04a5043982 577032 doc important manpages_3.01-1_all.deb
68a2acbedea8fde5d3e4bedb06a6aaa6 1403326 doc optional manpages-dev_3.01-1_all.deb
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)
iD8DBQFIZOfHW5ql+IAeqTIRAnIJAJ9liGLBOO9JmDmBuWCRH6Acgi0ThQCfe4AO
VpHRgibtbO0kTIl+qz19MDU=
=EyFw
-----END PGP SIGNATURE-----