GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  LOG::HANDLER::OUTPUT::SOCKET (3)

.ds Aq ’

NAME

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

CONTENTS

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:
<B>peeraddrB> The address of the server.
<B>peerportB> The port to connect to.
<B>protoB> The protocol you wish to use. Default is TCP.
<B>timeoutB> The timeout to send message. The default is 5 seconds.
<B>persistentB> and <B>reconnectB> 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.

<B>dumpB> Do you like to dump the message? If you enable this option then all messages will be dumped with Data::Dumper.
<B>dumperB> 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]) }



<B>connectB> 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.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 LOG::HANDLER::OUTPUT::SOCKET (3) 2013-11-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.