getgrent.3: Add ENOENT to error list.
Commit Message
On 09/10/2014 10:23 AM, Carlos O'Donell wrote:
> Michael,
>
> It's possible to get ENOENT returned from getgrent
> if the backend, for example say SSSD, isn't configured
> or the daemon isn't running. The same can be said of any
> of the NSS backend.
>
> As POSIX does not list ENOENT, we can list it ourselves
> and define it how we like.
>
> I don't know how you handle errno values that are glibc
> specific, but here is the patch that enhances getgrent
> to make users aware of what ENOENT is intended to mean
> from glibc.
>
> Patch against master. Please apply.
While I'm fixing one I might as well fix the other.
v1
- Add ENOENT.
v2
- Add EAGAIN.
---
Cheers,
Carlos.
@@ -129,6 +129,11 @@ or
.BR free (3).)
.SH ERRORS
.TP
+.B EAGAIN
+The service was temporarily unavailable; try again later.
+For NSS backends in glibc this indicates a temporary error talking to the backend.
+The error may correct itself, retrying later is suggested.
+.TP
.B EINTR
A signal was caught.
.TP
@@ -141,6 +146,11 @@ The calling process already has too many open files.
.B ENFILE
Too many open files in the system.
.TP
+.\" not in POSIX
+.B ENOENT
+A necessary input file cannot be found.
+For NSS backends in glibc this indicates the backend is not correctly configured.
+.TP
.B ENOMEM
.\" not in POSIX
Insufficient memory to allocate