NAME

Slaughter - Perl Automation Tool Helper

SYNOPSIS

This module is the platform-independant library which is used to abstract the implementations of the Slaughter primitives.

It is loaded via:

use Slaughter;

This usage actually dynamically loads the appropriate module from beneath the Slaughter::API namespace - which will contain the primitive implementation.

Initially we load the Slaughter::API::generic module which contains pure-perl implemenation, and then we load the OS-specific module from the supported set:

Slaughter::API::linux

The implemetnation of our primitive API for GNU/Linux.

Slaughter::API::freebsd

The implemetnation of our primitive API for FreeBSD.

Assuming that the OS-specific module is successfully loaded we we will also load any local OS-specific module. (e.g. Slaughter::API::Local::linux.)

Fallback implementations in our generic module merely output a suitable error message:

This module is not implemented for $^O

This allows compiled policies to execute, without throwing errors, and also report upon the primitives which need to be implemented or adapted.

EXTENSIONS

At the same time as loading the appropriate module from beneath the Slaughter::API name-space this module will attempt to load an identically named module from beneath the Slaughter::API::Local namespace.

This allows you to keep develop your own custom-primitives.

METHODS

Now follows documentation on the available methods.

AUTHOR

Steve Kemp <steve@steve.org.uk>

LICENSE

Copyright (c) 2010-2014 by Steve Kemp. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. The LICENSE file contains the full text of the license.