[Bug 39652] New: connect (2) under IPv6 has an incomplete list of returnable error numbers

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



https://bugzilla.kernel.org/show_bug.cgi?id=39652

           Summary: connect (2) under IPv6 has an incomplete list of
                    returnable error numbers
           Product: Documentation
           Version: unspecified
    Kernel Version: 2.6.37
          Platform: All
        OS/Version: Linux
              Tree: Mainline
            Status: NEW
          Severity: normal
          Priority: P1
         Component: man-pages
        AssignedTo: documentation_man-pages@xxxxxxxxxxxxxxxxxxxx
        ReportedBy: kernel@xxxxxxxxxxxxxxxxxxx
        Regression: No


I believe this applies to many 2.6.xx kernel documentation sets.

The man-page for connect (2) has an incomplete list of potential error reasons
(indicated in errno) and their descriptive causes when attempting to connect to
a remote IPv6 server and the return value indicates an error (-1).

Observed by testing with 2.6.37:

ENETUNREACH – reason should additionally include reference to the receipt of an
ICMPv6 type 1 code 0 (no route to destination) response.

EACCES – reason should additionally include reference to the receipt of an
ICMPv6 type 1 code 1 (Administratively prohibited) response.

EHOSTUNREACH – this isn't documented as a potential reason at present, but I
believe it should be added and the causes are ICMPv6 type 1 code 3 (Address
unreachable - I've verified this to be the case) or ICMPv6 type 3 (Time
exceeded – I haven't verified this case - please check source code).

ECONNREFUSED – reason should additionally include reference to the receipt of
an ICMPv6 type 1 code 4 (Port unreachable) or TCP RST/ACK response.

Having looked through v2.6.31 source it appears that potentially the following
could also occur although I haven't verified this to be the case:

EMSGSIZE – ICMPv6 type 2 – ICMPv6 type 2 (Packet too big)
EPROTO – ICMPv6 type 4 – ICMPv6 type 4 (Parameter problem)

Thanks.

-- 
Configure bugmail: https://bugzilla.kernel.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are watching the assignee of the bug.--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux