URI::icap(3)

📦
version 5.310.0 · 15 versions
, in opensuse-leap 16.0

💅 URI::icap — the manual page, but make it make sense

okay bestie, so this is URI::icap, a Perl module (manual page URI::icap(3), if you're keeping track) that's here to handle ICAP identifiers. It's short, it's sweet, it's giving "small but mighty." Let's get into it 🫶

✨ NAME ✨

URI::icap — the URI scheme for ICAP Identifiers. yes, that's the whole name section, she's brief and she knows it 💅

🌸 VERSION 🌸

Version 5.20. iconic, numbered, slaying.

🎀 SYNOPSIS 🎀

like, here's how you actually use it:

use URI::icap;

my $uri = URI->new('icap://icap-proxy.example.com/');

that's it. that's the vibe. ✨

🦋 DESCRIPTION 🦋

so this module implements the "icap:" URI scheme — which is defined in RFC 3507 <http://tools.ietf.org/html/rfc3507>, no cap — for the Internet Content Adaptation Protocol <https://en.wikipedia.org/wiki/Internet_Content_Adaptation_Protocol>. if you're the kind of person who clicks wiki links at 2am, that second one is for you 🔥

👑 SUBROUTINES/METHODS 👑

the way this works is truly lowkey elegant: this module inherits the behaviour of URI::http and then overrides the default_port method. that's it. that's the whole personality. main character energy 💜

💫 default_port

the default port for icap servers is 1344. memorize it, put it on a sticky note, whatever works 🍓

🧚 DIAGNOSTICS 🧚

See URI. (yes, that's the whole thing — go read the parent, bestie, it's got the lore)

🌈 CONFIGURATION AND ENVIRONMENT 🌈

See URI and URI. yep, both of them. it's giving "the information is elsewhere and I trust you to find it" 🙈

⭐ DEPENDENCIES ⭐

None. zero. nada. she's self-sufficient, we love a low-maintenance queen 👑

💀 INCOMPATIBILITIES 💀

None reported. (key word: reported. if you find one, that's a you-and-the-bug-tracker situation 💅)

🐛 BUGS AND LIMITATIONS 🐛

See URI. the parent module holds the receipts.

🔥 SEE ALSO 🔥

💖 AUTHOR 💖

David Dick, "<ddick at cpan.org>". thank you for your service, king 🫶

Copyright 2016 David Dick.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See <http://dev.perl.org/licenses/> for more information. (yes, go read the license, it's literally right there and it's important, ngl)

ok so that's the whole page! nothing hidden, nothing skipped, every flag and fact accounted for. slay 💅✨

and finally, the cute sign-off: this little masterpiece is from perl v5.42.0, dated 2026-09-02, and it lives happily at URI::icap(3). bye bestie, go build something iconic 🌸🦋💜

📦 where this page comes from