c-icap-stretch(8)

🌸 NAME 🌸

c-icap-stretch — a simple little utility for stretching ICAP servers, and when I say stretching I mean stress-testing, bestie. It's from the c-icap manual, section 8 (system manager's manual), so it's a grown-up admin tool, but we're gonna make it cute.

---

✨ SYNOPSIS ✨

c-icap-stretch [ -V ] [ -VV ] [ -i icap_servername ] [ -p port ] [ -s
service ] [ -urls filename ] [ -bU base_url ] [ -req ] [ -m max-requests
] [ -t threads-number ] [ -d debug level ] [ -x icap-header ] [ -hx
http-request-header ] [ -rhx http-response-header ] [ -O OutputDirectory
] [ --max-requests-to-save, requests-number ] file1 file2 ...

Like, that's the whole vibe right there. Flags, files, go 💅

---

🦋 DESCRIPTION 🦋

Okay so c-icap-stretch is a simple utility for loading ICAP servers. That's it, that's the whole job description. You point it at an ICAP server and it just sends it — over and over — to see how the server holds up under pressure. Main character energy for the server, honestly.

---

💖 OPTIONS 💖

• -V — Print version. Just the version, nothing else, she's lowkey mysterious.
• -VV — Print build informations. Yeah, double the V, double the info 🫶
• -i icap_servername — The hostname or the IP address of the ICAP server. Default? localhost, obviously, because we're all just hanging out on our own machine.
• -p port — The ICAP server port. The default port value is 1344.
• -s service — The service name. The default service name is "echo". Cute name, no notes.
• -urls filename — A file with HTTP urls, one url per line, that you use for the stress test. The utility takes these urls and uses them to construct random HTTP requests. Chaos, but make it structured ✨
• -bU base_url — A base HTTP URL you use as a template to build HTTP requests. The final HTTP url gets built from the base_url plus the path of the file that's being used as body data. Template girlie behavior.
• -req — Send ICAP request modification requests (reqmod). Periodt.
• -m max-requests — The maximum requests to send. Your ceiling, your limit, your "we stop here."
• -t threads-number — The number of client threads to start. More threads, more drama 🌈
• -d level — debug level info to stdout. Turn it up when you wanna see everything.
• -x icap-header — Include the icap-header in the ICAP request headers.
• -hx http-request-header — Include the http-request-header in the HTTP request headers.
• -rhx http-response-header — Include the http-response-header in the HTTP response headers.
• -O OutputDirectory — Output metadata (the ICAP and HTTP headers) plus the HTTP responses body data under this directory. She's a saver, she's an archivist, she keeps receipts 🎀
• --max-requests-to-save files-number — Sets the maximum requests to save when the -O parameter is used. By default no more than 4096 requests are saved. (In the synopsis this one's written as --max-requests-to-save, requests-number — same flag, different nickname, iykyk.)
• file1 file2 ... — The files to use as body data to the ICAP requests. Feed her, she's hungry 🍓

---

👑 SEE ALSO 👑

c-icap(8) c-icap-client(8) c-icap-config(8) c-icap-libicapapi-config(8) c-icap-mkbdb(8)

The whole friend group, go say hi 💜

---

💀 BUGS 💀

Not me being the bearer of bad news, but: it can used only for ICAP response modification services. So if you were hoping for request modification… that's literally not this girl. (Yeah, the original says "It can used only for" — we keep the facts, we keep the words, no cap.)

---

⭐ AUTHOR ⭐

Tsantilas Christos — the icon, the legend, the one who wrote it 👑

---

And that's the whole page, bestie! This one shipped with c_icap 0.6.5, from the System Manager's Manual era of c-icap-stretch(8) — go stretch something responsibly, mwah 💖