* [Bug 214171] New: I am not sure why the definition of EAI_SYSTEM, from getaddrinfo, was changed from POSIX
@ 2021-08-25 14:49 bugzilla-daemon
2021-08-25 15:41 ` [Bug 214171] " bugzilla-daemon
0 siblings, 1 reply; 2+ messages in thread
From: bugzilla-daemon @ 2021-08-25 14:49 UTC (permalink / raw)
To: linux-man
https://bugzilla.kernel.org/show_bug.cgi?id=214171
Bug ID: 214171
Summary: I am not sure why the definition of EAI_SYSTEM, from
getaddrinfo, was changed from POSIX
Product: Documentation
Version: unspecified
Hardware: All
OS: Linux
Status: NEW
Severity: normal
Priority: P1
Component: man-pages
Assignee: documentation_man-pages@kernel-bugs.osdl.org
Reporter: christian.morales.vega@gmail.com
Regression: No
https://man7.org/linux/man-pages/man3/freeaddrinfo.3p.html says:
"[EAI_SYSTEM] A system error occurred; the error code can be found in errno."
Which makes a lot of sense. The function can fall because of name-resolution
specific problem (EAI_NODATA). But otherwise it must be a plain old generic
error that can be expressed with errno, so you should look in errno.
It's not explicitly said. But IMHO it's clear that it would be a bug to return
EAI_SYSTEM without setting errno/setting errno to zero.
But then https://man7.org/linux/man-pages/man3/getaddrinfo.3.html replaces it
with:
"EAI_SYSTEM Other system error, check errno for details."
Which, I'm not a native speaker, but it seems to me to leave returning
EAI_SYSTEM and setting errno to 0 more open to interpretation. You can argue
that in such a case errno == 0 simply means "no details".
--
You may reply to this email to add a comment.
You are receiving this mail because:
You are watching the assignee of the bug.
^ permalink raw reply [flat|nested] 2+ messages in thread
* [Bug 214171] I am not sure why the definition of EAI_SYSTEM, from getaddrinfo, was changed from POSIX
2021-08-25 14:49 [Bug 214171] New: I am not sure why the definition of EAI_SYSTEM, from getaddrinfo, was changed from POSIX bugzilla-daemon
@ 2021-08-25 15:41 ` bugzilla-daemon
0 siblings, 0 replies; 2+ messages in thread
From: bugzilla-daemon @ 2021-08-25 15:41 UTC (permalink / raw)
To: linux-man
https://bugzilla.kernel.org/show_bug.cgi?id=214171
Alejandro Colomar (man-pages) (alx.manpages@gmail.com) changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |alx.manpages@gmail.com
--- Comment #1 from Alejandro Colomar (man-pages) (alx.manpages@gmail.com) ---
It seems reasonable to have doubts about if (ret == EAI_SYSTEM && errno == 0)
can happen, with the current wording.
Perhaps we can use a wording similar to most pages' RETURN VALUE section:
[
EAI_SYSTEM Other system error; errno is set to indicate the error.
]
This is more explicit in that "errno is _set_".
Hmm?
--
You may reply to this email to add a comment.
You are receiving this mail because:
You are watching the assignee of the bug.
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2021-08-25 15:41 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-08-25 14:49 [Bug 214171] New: I am not sure why the definition of EAI_SYSTEM, from getaddrinfo, was changed from POSIX bugzilla-daemon
2021-08-25 15:41 ` [Bug 214171] " bugzilla-daemon
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).