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.