Digital Mages

Digital Mages - Net::ICAP(3)


NAME

Net::ICAP - Internet Content Adapataion Protocol (rfc3507)


VERSION

$Id: lib/Net/ICAP.pm, v0.03 $


SYNOPSIS

    use Net::ICAP;
    use Net::ICAP::Common qw(:all);
    my $request = Net::ICAP::Request->new(
        method  => ICAP_REQMOD,
        url     => $url,
        headers => {
            Host    => $host,
            Allow   => 204,
            },
        reqhdr  => $http_headers,
        body    => $http_body,
        );
    $request->generate($io_handle);
    my $response = new Net::ICAP::Response;
    $response->parse($io_handle);


DESCRIPTION

the Net::ICAP manpage is a rough implementation of the Internet Content Adaptation Protocol (ICAP) protocol as defined in RFC 3507. The parser and generator are rather crude, doing only the most basic of sanity checks on input. It does, however, provide some convenience functionality, such as automatic generation of Encapsulated headers based on internal state, along with the ability to do chunked encoding for message body entities.

In its current incarnation it only implements a protocol parser and generator, it does not include a working client at this time. That will be including in future versions.

All the modules use the the Paranoid::Debug manpage framework to provide internal trace messages to STDERR. The debug levels for these modules start at 5 and end at 8.


SUBROUTINES/METHODS

None. This module will provide a working client in the future. It currently only provides the convenience of not having to load the the Net::ICAP::Request manpage and the Net::ICAP::Response manpage modules explicitly.


DEPENDENCIES

o the Class::EHierarchy manpage
o Paranoid


BUGS AND LIMITATIONS

Alpha software... use at your own risk.


SEE ALSO

the Net::ICAP::Common manpage
the Net::ICAP::Message manpage
the Net::ICAP::Request manpage
the Net::ICAP::Response manpage
the Net::ICAP::Server manpage


AUTHOR

Arthur Corliss (corliss@digitalmages.com)


LICENSE AND COPYRIGHT

This software is licensed under the same terms as Perl, itself. Please see http://dev.perl.org/licenses/ for more information.

(c) 2014, Arthur Corliss (corliss@digitalmages.com)