Document nss-nonlocal-users and nss-local-users

Signed-off-by: Anders Kaseorg <andersk@mit.edu>

diff --git a/README b/README
index 1e0d6b2ecab81abc6ef776fa4c0ca66be47b20df..47067fb7b362aa08065747f53ccff3f4f5188148 100644 (file)
--- a/README
+++ b/README
@@ -9,6 +9,15 @@ passwd_nonlocal: hesiod
 group:          compat nonlocal
 group_nonlocal: hesiod
 
+The module also assigns special properties to two local groups, if
+they exist:
+
+• If the local group ‘nss-nonlocal-users’ exists, then nonlocal users
+  will be automatically added to it.
+
+• If the local group ‘nss-local-users’ exists, then local users will
+  be automatically added to it.
+
 Copyright © 2007–2010 Anders Kaseorg <andersk@mit.edu> and Tim Abbott
 <tabbott@mit.edu>
 

diff --git a/nonlocal-group.c b/nonlocal-group.c
index 97ce4a66f62324fd64884f3630613aab6a923e75..e93a3a25de8225cc584b4dbf9364f5a93e4b28cd 100644 (file)
--- a/nonlocal-group.c
+++ b/nonlocal-group.c
@@ -38,7 +38,16 @@
 #include "nsswitch-internal.h"
 #include "nonlocal.h"
 
+/*
+ * If the MAGIC_NONLOCAL_GROUPNAME local group exists, then nonlocal
+ * users will be automatically added to it.
+ */
 #define MAGIC_NONLOCAL_GROUPNAME "nss-nonlocal-users"
+
+/*
+ * If the MAGIC_LOCAL_GROUPNAME local group exists, then local users
+ * will be automatically added to it.
+ */
 #define MAGIC_LOCAL_GROUPNAME "nss-local-users"