From d4e301c5c65393837e438b6d81feabfbfde7b9c7 Mon Sep 17 00:00:00 2001 From: Carlos O'Donell Date: Thu, 10 Dec 2015 00:48:15 -0500 Subject: 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. --- manual/nss.texi | 7 +++++++ 1 file changed, 7 insertions(+) (limited to 'manual') diff --git a/manual/nss.texi b/manual/nss.texi index bf3e69d..66dccef 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 -- cgit v1.1