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);

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 1.

persistent

Enable a persistent connection to the server. The default is 1.

reconnect

You can enable this if you want to reconnect to the server after the connection lost. The default is 1.

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.

errstr()

This function returns the last error message.

EXPORTS

No exports.

REPORT BUGS

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

AUTHOR

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

QUESTIONS

Do you have any questions or ideas?

MAIL: <jschulz.cpan(at)bloonix.de>

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

COPYRIGHT

Copyright (C) 2007 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.

cpanm Log::Handler

perl -MCPAN -e shell
install Log::Handler