is invoked by
when sync-accounts is creating a local account.
It must perform all of the tasks involved with local account creation
except for the actual changes to the password, shadow and group
At the very minimum, it must create the new account's home directory
(with appropriate permissions). The supplied sync-accounts-createuser
script does exactly that.
It may also suggest to sync-accounts modifications to the new
account's passwd entry.
When sync-accounts-createuser is invoked, the passwd and group entries
will not yet have been set up, so it may not rely on them.
sync-accounts-createuser will not be supplied with any arguments.
However, the following environment variables will be set, giving
details about the account to be created:
SYNCUSER_CREATE_USER SYNCUSER_CREATE_UID SYNCUSER_CREATE_GID SYNCUSER_CREATE_COMMENT SYNCUSER_CREATE_HOME SYNCUSER_CREATE_SHELL
sync-accounts-createuser should usually produce no output.
It can inhibit the creation of the user by outputting a single line
not containing a colon; in this case, a diagnostic message will be
written to sync-accounts's logfile, and the user will be skipped.
Alternatively, it may write out an alternative password file entry, in
which case sync-accounts will use the supplied data for the local
passwd file instead of that from the remote host.
The line should be in
Sys-V passwd file format (regardless of
settings). The username field should be taken from
and the password field should be
All went well, or we wrote a line without a colon to say
that the account should not be created.
There were serious problems and sync-accounts should bomb out
The supplied sync-accounts-createuser does not check that it
was not supplied with any arguments; nor does it check that the
variables are set, or have sensible values.
sync-accounts-createuser and the sync-accounts package are free
software; you can redistribute it and/or modify it under the terms of
the GNU General Public License as published by the Free Software
Foundation; either version 3, or (at your option) any later version.
This is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
You should have received a copy of the GNU General Public License along
with this program; if not, consult the Free Software Foundation's
website at www.fsf.org, or the GNU Project website at www.gnu.org.