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)