Section: chiark utilities (8)Updated: 14th July 2002Local indexUp
sync-accounts - synchronise accounts and passwords
sync-accounts [options] [source ...]
is a tool for copying account information into the local system's
password and group databases, or equivalent, from other systems. It
can be used to slave individual accounts, whole systems, or various
By default, when invoked, sync-accounts reads is configuration file
and updates all of the local details it is configured to synchronise,
from all relevant sources.
If one or more sources are named as command-line arguments, only
information from those sources is installed locally.
for detailed information about sync-accounts's behaviour and
Instead of updating local information, sync-accounts displays a
summary of which accounts are synchronised or not, and from where.
Causes sync-accounts not to actually install the new information in
the local password and group databases. Instead, updated versions are
written to the files
in the current directory. With
new accounts are not created at all. The system databases are not
sync-accounts is not resistant to malicious data in the local
password and group databases, or its configuration file or command
Malicious data in source information will not be able to take control
of sync-accounts, but will be copied to the local databases if
sync-accounts is configured to do so.
To update the local databases, sync-accounts must be run as root.
For -q and -n sync-accounts still needs to be able to successfuly
invoke the commands specified in the configuration for getpasswd and
All went well and there were no warnings.
There were problems. The local databases may or may not have been
Default configuration file. (Override with
Default command invoked by sync-accounts to create local users.
Default location for created users' home directories.
The sync-accounts package is 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.