GRAB-ACCOUNT(8) 						 chiark utilities						   GRAB-ACCOUNT(8)

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)

Greenend							  14th July 2002						   GRAB-ACCOUNT(8)