Provided by: chiark-scripts_4.4.2build1_all bug

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)