NAME

Net::NSCA::Client::InitialPacket - Implements initial packet for the NSCA protocol

VERSION

This documentation refers to version 0.009002

SYNOPSIS

  use Net::NSCA::Client::InitialPacket;
  # Create a packet from scratch
  my $packet = Net::NSCA::Client::InitialPacket->new(
      initialization_vector => $iv,
      unix_timestamp        => time(),
  );
  # Create a packet recieved from over the network
  my $recieved_packet = Net::NSCA::Client::InitialPacket->new($recieved_data);

DESCRIPTION

Represents the initial packet used in the NSCA protocol.

CONSTRUCTOR

This is fully object-oriented, and as such before any method can be used, the constructor needs to be called to create an object to work with.

new

This will construct a new object.

new(%attributes): %attributes is a HASH where the keys are attributes (specified in the "ATTRIBUTES" section).
new($attributes): $attributes is a HASHREF where the keys are attributes (specified in the "ATTRIBUTES" section).
new($packet_string): $packet_string is a string of the data packet in the network form.

ATTRIBUTES

  # Get an attribute
  my $value = $object->attribute_name;

This is a binary string, which is the exact length of the constant "$INITIALIZATION_VECTOR_LENGTH". If a string less than this length is provided, then it is automatically padded with NULLs. If not specified, this will default to random bytes generated by a Crypt::Random.

server_config

This specifies the configuration of the remote NSCA server. See Net::NSCA::Client::ServerConfig for details about using this. Typically this does not need to be specified unless the NSCA server was compiled with customizations.

unix_timestamp

This is a UNIX timestamp, which is an integer specifying the number of non-leap seconds since the UNIX epoch. If not specified, this will default to the current timestamp, provided by time().

METHODS

to_string

This methods returns the string representation of the initial packet. This string representation is what will be sent over the network.

DEPENDENCIES

Data::Rand::Obscure 0.020
Moose 0.89
MooseX::StrictConstructor 0.08
Net::NSCA::Client::ServerConfig
namespace::clean 0.04

AUTHOR

Douglas Christopher Wilson, "<doug at somethingdoug.com>"

BUGS AND LIMITATIONS

Please report any bugs or feature requests to "bug-net-nsca-client at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-NSCA-Client>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

I highly encourage the submission of bugs and enhancements to my modules.

LICENSE AND COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the terms of either:

the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version, or
the Artistic License version 2.0.