sync-accounts-createuser8

Usage

Overview

sync-accounts-createuser is invoked by sync-accounts 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 databases.

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.

Invocation

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

Results

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 localformat or remoteformat settings). The username field should be taken from SYNCUSER_CREATE_USER, and the password field should be x.

Exit status

0

All went well, or we wrote a line without a colon to say that the account should not be created.

any other

There were serious problems and sync-accounts should bomb out immediately.

Files

None.

Environment

See above.