The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

perfSONAR_PS::OWP::Conf

DESCRIPTION

This module is used to set configuration parameters for the OWP one-way-ping mesh configuration.

To add additional "scalar" parameters, just start using them. If the new parameter is a BOOL then also add it to the BOOL hash here. If the new parameter is an array then add it to the ARRS hash.

new()

TDB

resolve_path()

TDB

load_line()

grok a single line from the config file, and adding that parameter into the hash ref passed in, unless skip is set.

load_regex_section()

TDB

load_subhash()

TDB

load_subfile()

TDB

load_file()

TDB

init()

TDB

get_ref()

TDB

get_val()

This is a convienence routine that returns no value if the value isn't retrievable.

must_get_val()

This is a convienence routine that dies with an error message if the value isn't retrievable.

get_sublist()

This is a convienence routine that returns values from a LIST if and only if the sub-hash has a particular value set.

must_get_sublist()

This is a convienence routine that dies with an error message if the value isn't retrievable.

dump_hash()

TDB

dump()

TDB

get_mesh_description()

The Remaining functions should probably be moved into another module. They assume a particular set of configuration options exist in the file.

get_names_info()

Returns a list of crucial directories and filenames for the given resolution. $datadirname is the link's data directory $rel_dir is its (www) relative directory $filename is only useful with mode 2, where it gives a relative name for the summary line $mode indicates whether the summary file is needed.

get_rel_path()

Make a full www path out of the relative one.

USAGE

                my $conf = new perfSONAR_PS::OWP::Conf([
                                        NODE    =>      nodename,
                                        CONFDIR =>      path/to/confdir,
                                        ])
                NODE will default to ($node) = ($hostname =~ /^.*-(/w)/) CONFDIR will
                default to $HOME

                The config files can have sections that are only relevant to a particular
                system/node/addr by using the pseudo httpd.conf file syntax:

                <OS=$regex>
                osspecificsettings      val
                </OS>

                The names for the headings are OS and Host. $regex is a text string used to
                match uname -s, and uname -n. It can contain the wildcard chars '*' and '?'
                with '*' matching 0 or more occurances of *anything* and '?' matching
                exactly 1 occurance of *anything*.

SEE ALSO

FindBin

To join the 'perfSONAR-PS' mailing list, please visit:

  https://mail.internet2.edu/wws/info/i2-perfsonar

The perfSONAR-PS subversion repository is located at:

  https://svn.internet2.edu/svn/perfSONAR-PS

Questions and comments can be directed to the author, or the mailing list. Bugs, feature requests, and improvements can be directed here:

  https://bugs.internet2.edu/jira/browse/PSPS

VERSION

$Id: Conf.pm 1877 2008-03-27 16:33:01Z aaron $

AUTHOR

Jeff Boote, boote@internet2.edu Jason Zurawski, zurawski@internet2.edu

LICENSE

You should have received a copy of the Internet2 Intellectual Property Framework along with this software. If not, see <http://www.internet2.edu/membership/ip.html>

COPYRIGHT

Copyright (c) 2002-2008, Internet2

All rights reserved.