From: ian <ian>
Date: Sun, 3 Jan 1999 01:56:57 +0000 (+0000)
Subject: Document createaccount script.
X-Git-Tag: branchpoint-2001-05-11-withlockex-old~11
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?p=chiark-utils.git;a=commitdiff_plain;h=53dfb827b51b510f92c975cb6fd32afb02fdf209

Document createaccount script.
---

diff --git a/sync-accounts/sync-accounts b/sync-accounts/sync-accounts
index ea4e79c..6acfe4b 100755
--- a/sync-accounts/sync-accounts
+++ b/sync-accounts/sync-accounts
@@ -1,5 +1,5 @@
 #!/usr/bin/perl
-# $Id: sync-accounts,v 1.8 1999-01-03 01:30:46 ian Exp $
+# $Id: sync-accounts,v 1.9 1999-01-03 01:56:57 ian Exp $
 # usage: sync-accounts [-n] [-C<config-file>] [<host> ...]
 # options:
 #   -n     do not really do anything
@@ -72,6 +72,22 @@
 #      the PATH if necessary.  Either sameuid, or both uidmin and
 #      uidmax, must be specified, if accounts are to be created.
 #
+#      The command (which will be run with sh -c) must at least create
+#      the new account's home directory.  The passwd and group entries
+#      will not have been set up.  The following environment variables
+#      will be set, giving details about the account to be created:
+#        SYNCACCOUNT_CREATE_USER
+#        SYNCACCOUNT_CREATE_UID
+#        SYNCACCOUNT_CREATE_GID
+#        SYNCACCOUNT_CREATE_COMMENT
+#        SYNCACCOUNT_CREATE_HOME
+#        SYNCACCOUNT_CREATE_SHELL
+#      If it chooses, the script may modify the password entry which
+#      will be added to the system, by outputting a replacement
+#      password file entry.  (The password field of that is ignored.)
+#      If the script outputs a line which does not contain a : then
+#      the account will not be created after all.
+#
 #  group <glob-pattern>
 #  nogroup <glob-pattern>
 #      Specifies that the membership of the local groups specified