about summary refs log tree commit diff
path: root/manual
diff options
context:
space:
mode:
authorCarlos O'Donell <carlos@systemhalted.org>2015-12-10 00:48:15 -0500
committerCarlos O'Donell <carlos@systemhalted.org>2015-12-10 00:48:15 -0500
commitd4e301c5c65393837e438b6d81feabfbfde7b9c7 (patch)
tree5694d892a65cf43eb7092c5db5f3c9de41b5e244 /manual
parent23256f5ed889266223380c02b2750d19e3fe666b (diff)
downloadglibc-d4e301c5c65393837e438b6d81feabfbfde7b9c7.tar.gz
glibc-d4e301c5c65393837e438b6d81feabfbfde7b9c7.tar.xz
glibc-d4e301c5c65393837e438b6d81feabfbfde7b9c7.zip
Document best practice for disconnected NSS modules.
NSS modules which can run in disconnected modes should
return NSS_STATUS_NOTFOUND and SUCCESS in order to follow
best practice for such modules and ensure user applications
can have these modules configured without causing problems
if the data sources are not connected.
Diffstat (limited to 'manual')
-rw-r--r--manual/nss.texi7
1 files changed, 7 insertions, 0 deletions
diff --git a/manual/nss.texi b/manual/nss.texi
index bf3e69dee5..66dcceffe0 100644
--- a/manual/nss.texi
+++ b/manual/nss.texi
@@ -448,6 +448,13 @@ The function should be called again with a larger buffer.
 @item
 @code{NSS_STATUS_NOTFOUND} @tab
         @code{ENOENT} @tab The requested entry is not available.
+
+@item
+@code{NSS_STATUS_NOTFOUND} @tab
+	@code{SUCCESS} @tab There are no entries.
+Use this to avoid returning errors for inactive services which may
+be enabled at a later time. This is not the same as the service
+being temporarily unavailable.
 @end multitable
 
 These are proposed values.  There can be other error codes and the