SysConf ABOUT This module is specifically to enable very simplified access to CentOS/Red Hat style sysconfig files. It reads/writes them, provides a simple way to create, update, delete keys within these files. Primarily it is for ease of munging /etc/sysconfig/* files, and specifically /etc/sysconfig/network-scripts/ifcfg-* files. NOTE/WARNING/CAVEAT: This code does NOT preserve comments in any form. If you use this module to process files, those files WILL NOT HAVE ANY COMMENTS IN THEM AFTER IT UPDATES THE FILE ON DISK. So if you document changes in the file via comments you probably want to be aware of this before you run this module against the file. USAGE: use SysConf; my $sysconf_file = 'name_of_file'; my $sysconf_path = '/etc/sysconfig'; my $foo = SysConf->new({'file' => $sysconf_file ,'path' => $sysconf_path}); # attach the object to the file $foo->attach; # get a list of all keys in the file (ignore commented ones) my @k = $foo->keys; # set a particular key to a particular value (will insert the key if needed) $foo->update('bar'=>1); # get a particular value given a key my $val = $foo->retrieve('oof'); # delete a key/value pair my $rv = $foo->delete('bar'); # detach the object from the file $foo->detach; INSTALLATION To install this module, run the following commands: perl Build.PL ./Build ./Build test ./Build install SUPPORT AND DOCUMENTATION After installing, you can find documentation for this module with the perldoc command. perldoc SysConf You can also look for information at: RT, CPAN's request tracker (report bugs here) http://rt.cpan.org/NoAuth/Bugs.html?Dist=SysConf AnnoCPAN, Annotated CPAN documentation http://annocpan.org/dist/SysConf CPAN Ratings http://cpanratings.perl.org/d/SysConf Search CPAN http://search.cpan.org/dist/SysConf/ LICENSE AND COPYRIGHT Copyright (C) 2013 Joe Landman This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 dated June, 1991 or at your option any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. A copy of the GNU General Public License is available in the source tree; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.