/ 
Sysync-0.38
River stage zero No dependents
/ Sysync

NAME

Sysync - Simplistic system management

SYNOPSIS

See: http://sysync.nongnu.org/tutorial.html

METHODS

new

Creates a new Sysync object.

my $sysync = Sysync->new({
   sysdir      => '/var/sysync',
   stagedir    => '/var/sysync/stage', # if omitted, appends ./stage to sysdir
   salt_prefix => '', # if omitted, defaults to '$6$'
   log         => $file_handle_for_logging,
});

log

Log a message.

$self->log('the moon is broken');

sysdir

Returns the base system directory for sysync.

stagedir

Returns stage directory.

stagefilesdir

Returns stage-files directory.

get_user

Returns hashref of user information. It's worth noting that passwords should not be returned here for normal users.

Example:

{
  username => 'wafflewizard',
  uid => 1001,
  fullname => 'Waffle E. Wizzard',
  homedir => '/home/wafflewizard',
  shell => '/bin/bash',
  disabled => 0,
  ssh_keys => [
     'ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA10YAFEAByOlrMmd5Beh73SOg7okHpK5Bz9dOgmYb4idR3A6iz+ycyXtnCmwSGdmh6AQoeKfJx+9rxLtvdHUzhRa/YejqBGsTwYl5Q+1bKbCkJfgZhtB99Xt5j7grXzrJ0zp2vTfG2mPndnD7xuQQQnLsZrFSoTY8FPvQo3a9R1wPIuxBGs5jWm9+pvluJtAT3I7IaVfylNBCGU8+Fw/qvJtWEesyqyRmFJZ47XzFKJ5EzB6hLaW+MAaCH6fZDycdjiTfJOMThtpFF557rqz5EN76VRqHpnkiqKpatMX4h0hiL/Snl+fbUxOYm5qcHughuis4Sf6xXoABsyz2lsrqiQ== wafflewizard',
  ],
}

get_all_users

Return array of all usernames.

get_user_password

Return a user's encrypted password.

set_user_password

Set a user's encrypted password.

get_users_from_group

Returns array of users in a given group.

get_all_groups

Returns array of all groups.

get_all_hosts

Returns all hosts.

must_refresh

Returns true if sysync must refresh.

Passing 1 or 0 as an argument sets whether this returns true.

must_refresh_files

Returns true if sysync must refresh managed files.

Passing 1 or 0 as an argument sets whether this returns true.

generate_user_line

Generate a line for both the user and shadow file.

generate_group_line

Generate a line for the group file.

is_valid_host

Returns true if host is valid.

get_host_user

Given a host, then a username, return a hashref with user details.

get_host_group

Given a host, then a group name, return a hashref with group details.

get_host_users

Given a host return a hashref with user details.

get_host_groups

Given a host return a hashref with group details.

get_host_ent

For a generate all of the password data, including ssh keys, for a specific host.

get_host_files

Generate a list of files with their content.

Returns hashref:
'/etc/filename.conf' => {
   mode     => 600,
   gid      => 0,
   uid      => 0,
   data     => 'data is here'
}

update_host_files

Build host files from specifications.

update_all_hosts

Iterate through every host and build password files.

write_file_contents

read_file_contents

COPYRIGHT

Bizowie cloud erp

LICENSE

Copyright (C) 2012, 2013 Bizowie

This file is part of Sysync.

Sysync is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

Sysync 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 Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

AUTHOR

Michael J. Flickinger, <mjflick@gnu.org>