Basic function is to append WEBTOOL_AUDIT_LOG file. It receives one optional argument (message). In file log is written in order of Timestamp,user,filename,line.

Example usage:

$service = 'named';
if ($services->start($service) == 0) {
  audit("Successfully started the '$service' service.");
}

Entry in webtool-audit.log will be something like this:

[2006/07/17 09:33:02] admin modules/services/toggle_current.cgi:42
Successfully started the 'named' service.

Basic function is to load perticular module. It receives one argument (module). New module is loaded into its own namespace. This function must be called from within BEGIN{ } block. In a result module is actully loaded using "use $module" as return value.

Example usage:

BEGIN { WebTool::load_module('services');

This function makes temporary filename. It takes a single, optional argument on what to use as the base filename(template). If you don't specify this base then 'webtool' will be used. It returns a result from running a mktemp command under WEBTOOL_TMPDIR/argument.XXXXXX .

This function generates uniquely named temporary directory. It takes a single, optional argument on what to use as the base filename(template). If you don't specify this base then ' webtool' will be used. It returns a result from running a mkdtemp command under WEBTOOL_TMPDIR/argument.XXXXXX .

Example usage:

my $tmpfile   = WebTool::mktemp('apt-get');
my $ajax      = new CGI::Ajax('progress' => "progress.cgi?tempfile=$tmpfile");

One argument is passed(0 or 1) to this function, according to that value function open/close STDOUT/STDERR and flushes.

Example usage:

output_ctl(0);
output_ctl(1);

This function receives one argument(file). It opens the file and read it line by line and puts every line in array. It returns array.

Example usage:

my @file  = WebTool::read_file($file);

This function receives two argument(file and array). It opens the file and writes in line by line from array.

Example usage:

WebTool::write_file(UPS_CONF, @f);