NAME
grab-account - add new account synchronised to remote system
SYNOPSIS
grab-account local-user source [remote-user]
DESCRIPTION
grab-account reconfigures sync-accounts to start synchronising a
specified local user (which may not yet exist) from a specified remote
system, and then invokes sync-accounts once to synchronise from that
source.
/etc/sync-accounts/createuser should contain a addhere line in the
appropriate source section (ie, after host source). grab-account adds
a
user local-user [remote=remote-user]
directive just before addhere and runs sync-accounts source.
EXIT STATUS
0 All went well.
any other
There were problems.
FILES
/etc/sync-accounts; See also sync-accounts(8).
ENVIRONMENT
See sync-accounts(8).
BUGS
There is no locking of /etc/sync-accounts so do not invoke grab-account
from a script, or more than once at a time by hand. Do not edit
/etc/sync-accounts by hand and also simultaneously run grab-account.
The mechanism involving addhere is suboptimal. This should be done
with an include feature in sync-accounts, so that grab-account does not
have to edit a configuration file that really belongs to the sysadmin.
AUTHOR
grab-account and this manpage are part of the sync-accounts package
which was written by Ian Jackson <ian@chiark.greenend.org.uk>. They
are Copyright 1999-2000,2002 Ian Jackson
<ian@davenant.greenend.org.uk>, and Copyright 2000-2001 nCipher
Corporation Ltd.
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 details.
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.
SEE ALSO
sync-accounts(8), sync-accounts(5), passwd(5)