Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

ropkg::rsync::logparser(3pm) [debian man page]

RoPkg::Rsync::LogParser(3pm)				User Contributed Perl Documentation			      RoPkg::Rsync::LogParser(3pm)

NAME

       RoPkg::Rsync::LogParser - a rsync log parser class

SYNOPSIS

	#!/usr/bin/perl

	use strict;
	use warning;

	sub main {
	  my $lp = new RoPkg::Rsync::LogParser( type => 'client' );

	  $lp->Parse('/tmp/debian-log.txt');
	}

	main();

Short description
       RoPkg::Rsync::LogParser is a class used to parse (for the moment) client side rsync logs. Using this class you can extract the transfered
       files, symlinks created, directories, total number of files, transfered bytes, speed of transfer etc. LogParser support list filter trough
       probes (used by many projects to verify the mirrors). The primary use of this class is inside Simba, but can be used without problems in
       any other project who needs a rsync client log parser.

METHODS

       new(hash)

       Constructor of the class. When creating a new class instance you must provide the type of log: client or server . For the moment only the
       client parsing routines are defined.

       Log($raw_log)

       Get/Set the raw rsync log. With no parameters, the get behaviour is selected. If a parameter is present (and valid) the method acts as a
       Set method.

       Probes(@probes_list)

       Get/Set the raw probes list. If no parameter is present, the method returns the number of probes defined (0 if none). If a list of probes
       is given, the list is added to the existing list of probes.

       Parse($filename)

       Parse a rsync client log. If no filename is specified, the method parses the log previsiously set with Log() method. Please take extra care
       with the filename. If it does not exists, or is not a file a exception will be raised (Param::Wrong and File::Open).

       Files()

       In scalar context returns the number of transfered files (filtered by probes list). In list context, returns the list of transfered files.

       RealFiles()

       In scalar context returns the number of transfered files. In list context, returns the list of transfered files.

       Deleted()

       In scalar context returns the number of deleted files (filtered by probes list). In list context, returns the list of deleted files.

       RealDeleted()

       In scalar context returns the number of deleted files.  In list context, returns the list of deleted files.

       Speed()

       Returns the speed (as reported by rsync [in bytes/sec]) of the transfer.

       Size()

       Returns the size of the synced content.

       TransfData()

       Returns the total number of bytes transfered during the sync session

       Symlinks()

       In scalar context returns the number of symlinks (filtered by probes list). In list context, returns the list of symlinks.

       RealSymlinks()

       In scalar context returns the number of symlinks.  In list context, returns the list of symlinks.

PREREQUISITES

       RoPkg::Utils requires perl 5.008 or later and RoPkg::Exceptions class. From CPAN, you need the Scalar::Util module. At build time
       Test::More is required for tests (if you don't plan to use the tests ignore this dependency).

SEE ALSO

       RoPkg::Rsync::Node RoPkg::Rsync::ConfFile RoPkg::Exceptions

AUTHOR

       Subredu Manuel <diablo@iasi.roedu.net>

LICENSE

       Copyright (C) 2005 Subredu Manuel.  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.

perl v5.8.8							    2006-06-09					      RoPkg::Rsync::LogParser(3pm)

Check Out this Related Man Page

RoPkg::Rsync::ConfFile(3pm)				User Contributed Perl Documentation			       RoPkg::Rsync::ConfFile(3pm)

NAME

       RoPkg::Rsync::ConfFile

DESCRIPTION

       RoPkg::Rsync::ConfFile is a class used to manipulate rsync configuration files. Is capable to maintaine the order of the modules, and even
       keep your comments and empty lines intact.

SYNOPSIS

	#!/usr/bin/perl

	use warnings;
	use strict;

	sub main {
	  my $cf = new RoPkg::Rsync::ConfFile(filename => '/etc/rsyncd.conf');

	  $cf->Write('/tmp/new_rsyncd.conf');
	  return 0;
	}

	main();

METHODS

       All methods, throw the OutsideClass exception, if you use them as class methods.  Besides OutsideClass the methods are throwing other
       exceptions as well. Refer to each method documentation for more information.

       new(%hash)

       The class constructor. Accepts a hash as parameter. At this moment only one parameter can be specified inside the hash: filename . If this
       parameter is present, the file specified is parsed and loaded into the object.

       AddParam($pname, $pvalue)

       Add a new global parameter named $pname with value $value.

       AddComment($pval)

       Add a new global comment with value $pval

       AddBlank($bval)

       Add a new global blank line with value $bval

       AddNode($node)

       Adds a new RoPkg::Rsync::Node object to the current object.  Before the node is added, the nodes list is checked for duplicates of the
       object. If a duplicate is found, the method does nothing.

       Exceptions:

       If $node is not a instance of RoPkg::Rsync::Node, Param::Wrong exception is raised.

       DelNode($node_name)

       Removes a node from the nodes list. The nodes are searched by their names. Returns -1 if the node was not found, the new number of nodes
       otherwise.

       HasNode($node_name)

       Returns 1 if the node with name $node_name was found in the nodes list, 0 otherwise.

       Clean()

       Clean the object. Removes all information (the nodes list, statistics, etc).  Always returns 1.

       Parse($filename)

       Parse the configuration file $filename and returns the number of nodes. If $filename is not defined Param::Missing exception is raised. If
       the path does not point to a existing file, File::NotFound exception is raised. If the file could not be opened, File::Open exception is
       raised.

       Write($path)

       Write the configuration into the file specified by path $path.

       ToString()

       Returns the string representation of the configuration file.

PREREQUISITES

       perl 5.008 (or later) is required. Besides perl, you must have the following:

       *) RoPkg::Exceptions
       *) Scalar::Util
       *) English

SEE ALSO

       RoPkg::Rsync::Atom RoPkg::Rsync::ConfFile RoPkg::Exceptions

AUTHOR

       Subredu Manuel <diablo@iasi.roedu.net>

LICENSE

       Copyright (C) 2005 Subredu Manuel.  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.

perl v5.8.8							    2006-06-09					       RoPkg::Rsync::ConfFile(3pm)
Man Page