FCGI::...rained(3pm)

📦
version 0.22 · 2 versions
  • 0.22 · debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking (latest)
  • 0.22 · ubuntu jammy
, in debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

🌸 FCGI::Engine::ProcManager::Constrained 🌸

okay so bestie, you're reading the manual page for FCGI::Engine::ProcManager::Constrained — it lives in the User Contributed Perl Documentation section, section 3pm if you're keeping score. It's giving process manager but make it responsible. 💅

✨ NAME ✨

FCGI::Engine::ProcManager::Constrained — FastCGI applications with memory and number of request limits. 🎀

🦋 DESCRIPTION 🦋

So this is a constrained process manager. What does that mean for you, bestie? It means it restarts child workers after a number of requests, or if they use too much memory. Like a bouncer for your workers, but the bouncer is a memory limit. 💀

Most of the memory usage code is stolen from Apache2::SizeLimit. Not me saying "stolen", that's literally what the docs say. Respect the source. 🙈

🧚 ATTRIBUTES 🧚

💖 max_requests

The number of requests a child process can handle before being terminated. 😭

0 (the default) means let child processes do an infinite number of requests. Live forever, king. 👑

💖 sizecheck_num_requests

The number of requests between a check on the process size taking place. 👀

0 (the default) means never attempt to check the process size. Blissful ignorance, honestly iconic.

💖 max_process_size

The maximum size of the process (both shared and unshared memory) in KB. 📏

0 (the default) means unlimited. No cap. Literally, no cap. 🧢

💖 max_unshared_size

The maximum amount of memory in KB this process can have that isn't Copy-On-Write shared with other processes. 🌸

0 (the default) means unlimited.

💖 min_share_size

The minimum amount of memory in KB this process can have Copy-On-Write from it's parent process before it is terminate. 💀

psst — this one has no default listed in the docs, so don't go assuming anything, bestie. 🫶

🎀 METHODS 🎀

Quote, unquote: "I will fill this in more eventually, but for now if you really wanna know, read the source." 😭

And honestly? Respect. The source is right there. Go read it. main character energy. ✨

🌈 SEE ALSO 🌈

  • FCGI::Engine::ProcManager
  • Apache2::SizeLimit

💀 BUGS 💀

All complex software has bugs lurking in it, and this module is no exception. Not the bugs lurking, the audacity. 🙈

If you find a bug please either:

  • email me, or
  • add the bug to cpan-RT.

👑 AUTHOR 👑

Tomas Doran <bobtfish@bobtfish.net> 🫶

Code sections copied from Apache2::SizeLimit are Copyright their respective authors.

Copyright 2007-2010 by Infinity Interactive, Inc.

<http://www.iinteractive.com>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 🎀

and that's the whole page, bestie ✨ this was shipped as perl v5.36.0 on 2022-12-10 — slay, go write some constrained FastCGI workers, ily, bye 💖🦋🌸

📦 where this page comes from