Provided by: chiark-scripts_4.1.24_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)