bionic (8) grab-account.8.gz

Provided by: chiark-scripts_5.0.2_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)