NAME¶

Mon::Protocol - Methods for parsing / dumping a protocol block

SYNOPSIS¶

    use Mon::Protocol;

DESCRIPTION¶

METHODS¶

new

Creates a new object. A hash can be supplied which sets the default values. An example which contains all of the variables that you can initialize:

    $c = new Mon::Protocol;
    

dump_data

Returns the current internal structure as a string dump suitable for passing to "parse_data".

"parse_data"

Parses a command block (from begin_block to end_block), as generated by dump_data.

"type"(new_type)

Sets or returns the type of the current command block. See @TYPES for valid type codes.

In the future, it is possible that this module will perform additional checking based on the type, for now it is left to the application to interpret this.

"get_section_list"

Returns an array containing all section names within the block.

"get_section"(section_name)

Returns a hash containing the key/value pairs of the specific section.

"delete_section"(section_name)

Completely removes the specified section from the block.

"add_to_section"(section_name,$hash_ref)

Adds the key/value pairs in the hash to the specified section.

        $foo->add_to_section("_hostgroup", { "ns1.baz.com" -> "ok" });
    

"delete_from_section"(section_name,$key)

Deletes the key/value pair from the section.

        $foo->delete_from_section("_hostgroup", "ns1.baz.com");
    

"error"

Should any of the functions return an error (-1), this function can be used to retrieve a more elaborate error message and to reset the internal error state.