about summary refs log tree commit diff
diff options
context:
space:
mode:
authorRyan Mulligan <ryan@ryantm.com>2014-08-10 08:39:31 -0700
committerRyan Mulligan <ryan@ryantm.com>2014-08-10 08:39:31 -0700
commitfee04927a46a8c2368225486ef9df17bea270b92 (patch)
tree1ce32a8eab5a3c19bad8983dc863be55e6055980
parentac00b1fe856e27dc1d6357344dc8f23163e926b3 (diff)
downloadnixlib-fee04927a46a8c2368225486ef9df17bea270b92.tar
nixlib-fee04927a46a8c2368225486ef9df17bea270b92.tar.gz
nixlib-fee04927a46a8c2368225486ef9df17bea270b92.tar.bz2
nixlib-fee04927a46a8c2368225486ef9df17bea270b92.tar.lz
nixlib-fee04927a46a8c2368225486ef9df17bea270b92.tar.xz
nixlib-fee04927a46a8c2368225486ef9df17bea270b92.tar.zst
nixlib-fee04927a46a8c2368225486ef9df17bea270b92.zip
add note about mutableUsers to user management section
-rw-r--r--nixos/doc/manual/configuration.xml6
1 files changed, 6 insertions, 0 deletions
diff --git a/nixos/doc/manual/configuration.xml b/nixos/doc/manual/configuration.xml
index 051f0fb8c1e0..bbfb434782d0 100644
--- a/nixos/doc/manual/configuration.xml
+++ b/nixos/doc/manual/configuration.xml
@@ -1053,6 +1053,12 @@ a password. However, you can use the <command>passwd</command> program
 to set a password, which is retained across invocations of
 <command>nixos-rebuild</command>.</para>
 
+<para>If you set users.mutableUsers to false, then the contents of /etc/passwd
+and /etc/group will be congruent to your NixOS configuration. For instance,
+if you remove a user from users.extraUsers and run nixos-rebuild, the user
+account will cease to exist. Also, imperative commands for managing users
+and groups, such as useradd, are no longer available.</para>
+
 <para>A user ID (uid) is assigned automatically.  You can also specify
 a uid manually by adding