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)