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

2012 Ohio-Pennsylvania Software, LLC.

LICENSE

 Copyright (C) 2012 Ohio-Pennsylvania Software, LLC.

 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>

cpanm Sysync

perl -MCPAN -e shell
install Sysync