debian man page for log::handler::output::socket

Log::Handler::Output::Socket(3pm)			User Contributed Perl Documentation			 Log::Handler::Output::Socket(3pm)

NAME
       Log::Handler::Output::Socket - Send messages to a socket.

SYNOPSIS
	   use Log::Handler::Output::Socket;

	   my $sock = Log::Handler::Output::Socket->new(
	       peeraddr    => "127.0.0.1",
	       peerport    => 44444,
	       proto	   => "tcp",
	       timeout	   => 10
	   );

	   $sock->log(message => $message);

DESCRIPTION
       With this module it's possible to send messages over the network.

METHODS
   new()
       Call "new()" to create a new Log::Handler::Output::Socket object.

       The following options are possible:

       peeraddr
	   The address of the server.

       peerport
	   The port to connect to.

       proto
	   The protocol you wish to use. Default is TCP.

       timeout
	   The timeout to send message. The default is 5 seconds.

       persistent and reconnect
	   With this option you can enable or disable a persistent connection and re-connect if the connection was lost.

	   Both options are set to 1 on default.

       dump
	   Do you like to dump the message? If you enable this option then all messages will be dumped with "Data::Dumper".

       dumper
	   Do you want to use another dumper as "Data::Dumper"? You can do the following as example:

	       use Convert::Bencode_XS;

		   dumper => sub { Convert::Bencode_XS::bencode($_[0]) }

	       # or maybe

	       use JSON::PC;

		   dumper => sub { JSON::PC::convert($_[0]) }

       connect
	   This option is only useful if you want to pass your own arguments to "IO::Socket::INET" and don't want use "peeraddr" and "peerhost".

	   Example:

		   connect => {
		       PerrAddr  => "127.0.0.1",
		       PeerPort  => 44444,
		       LocalPort => 44445
		   }

	   This options are passed to "IO::Socket::INET".

   log()
       Call "log()" if you want to send a message over the socket.

       Example:

	   $sock->log("message");

   connect()
       Connect to the socket.

   disconnect()
       Disconnect from socket.

   validate()
       Validate a configuration.

   reload()
       Reload with a new configuration.

   errstr()
       This function returns the last error message.

PREREQUISITES
	   Carp
	   Params::Validate;
	   IO::Socket::INET;
	   Data::Dumper;

EXPORTS
       No exports.

REPORT BUGS
       Please report all bugs to <jschulz.cpan(at)bloonix.de>.

       If you send me a mail then add Log::Handler into the subject.

AUTHOR
       Jonny Schulz <jschulz.cpan(at)bloonix.de>.

COPYRIGHT
       Copyright (C) 2007-2009 by Jonny Schulz. All rights reserved.

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

perl v5.14.2							    2012-11-21					 Log::Handler::Output::Socket(3pm)