xsync README
============

xsync is a simple tool providing basic package and services management via
a unified directory/file interface - touching a file in the appropriate 
directory indicates that a package should be installed or uninstalled, or a 
service configured to run or not run. Running xsync then ensures that the 
running system reflects those policies. The interface is simple, easy to 
understand, and amenable to remote large-scale administration.

xsync currently handles:

 - chkconfig/service-based and daemontools-based services
 - package management of rpm- and debian-based packages
 - the installation of cpan modules (requires CPAN module to be configured)
 - the execution of arbitrary scripts (repeatedly, or once-only)


Configuration
-------------

All xsync configuration files live under /etc/xsync. The following
directory structure is used:

  /etc/xsync
  |-- apt-install.d
  |-- apt-remove.d
  |-- chkconfig-off.d
  |-- chkconfig-on.d
  |-- cpan-install.d
  |-- daemontools-off.d
  |-- daemontools-on.d
  |-- rpm-remove.d
  |-- scripts.d
  |-- scripts-once.d
  |-- service-restart.d
  `-- yum-install.d

For everything except the scripts directories, touching a file in the 
appropriate directory is sufficient to indicate that the package of that
name should be installed or removed, or that the service of that name
should be configured to be off or on (and stopped or started), or
restarted.

See the documentation (perldoc doc/xsync.pod, or 'man xsync') for more.

