Digital Mages - Net::ICAP(3)

Net::ICAP

Section: User Contributed Perl Documentation (3)
Updated: 2017-04-12
Index

NAME

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

VERSION

$Id: lib/Net/ICAP.pm, 0.04 2017/04/12 15:54:19 acorliss Exp $

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

Net::ICAP 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 Paranoid::Debug 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 Net::ICAP::Request and Net::ICAP::Response modules explicitly.

DEPENDENCIES

o Class::EHierarchy
o Paranoid

BUGS AND LIMITATIONS

Alpha software... use at your own risk.

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.