llng-fa...i-server(8)

📦
version 2.23.4 · 5 versions
, in fedora 43, fedora 44

💖 llng-fastcgi-server 💖

okay bestie, so this is a User Contributed Perl Documentation page for llng-fastcgi-server (yes it's section 8, we love a system-administration girlie). sit down, grab a strawberry drink 🍓, and let's get into it.

✨ NAME ✨

llng-fastcgi-server — the FastCGI server used for providing LemonLDAP::NG services.

🦋 SYNOPSIS 🦋

  # Start server listening to /run/llng.sock with 10 workers
  llng-fastcgi-server -u nobody -g nobody -s /run/llng.sock -n 10

🌸 DESCRIPTION 🌸

So like… llng-fastcgi-server was designed to hand LemonLDAP::NG services over to Nginx or DevOps Handler. no cap.

And here's the iconic part: the Portal, the Manager and the Handler get compiled just-in-time ✨. which means this FastCGI server can literally run on every LemonLDAP::NG server, even if that server only needs some parts of it (like isolated handlers, or just the portal, etc). it's giving main character energy, it's giving flexibility. 💅

🎀 PARAMETERS 🎀

lowkey the cutest part: every single parameter can be set either by using options or by environment variables. pick your fighter, bestie. 🫶

  • --pid, -p ($ENV{PID}) — the pid file.
  • --user, -u ($ENV{USER}) — the user.
  • --group, -g ($ENV{GROUP}) — the group.
  • --proc, -n ($ENV{NPROC}) — number of processus for FCGI.
  • --socket, -s ($ENV{SOCKET}) — Unix socket.
  • --listen, -l ($ENV{LISTEN}) — listening address (HOST:PORT, :PORT, or PATH).
  • --customFunctionsFile, -f ($ENV{CUSTOM_FUNCTIONS_FILE}) — file to load for custom functions.
  • --engine, -e ($ENV{ENGINE}) — Plack::Handler engine, default to FCGI (more on that below).
  • --plackOptions — to pass other options to the Plack handler. This multi-valued parameter must have "key=value" values.

And like, go check out Plack::Handler::FCGI to find out the list of available options for the default FCGI engine. 👀

🔥 ENGINES 🔥

By default, llng-fastcgi-server uses FCGI (= Plack::Handler::FCGI). but bestie, some other engines can be used too:

FCGI (default) 💅

It uses FCGI::ProcManager as manager. other managers exist tho:

  • FCGI::ProcManager::Dynamic
  llng-fastcgi-server -u nobody -g nobody -s /run/llng.sock -e FCGI -n 10 \
                      --plackOptions manager=FCGI::ProcManager::Dynamic

Other FCGI::ProcManager style engines 🧚

  • FCGI::Engine

Event engines 🌈

  • AnyEvent::FCGI
  • FCGI::Async
  • FCGI::EV

👑 SEE ALSO 👑

💜 AUTHORS 💜

  • Clement Oudot, <clem.oudot@gmail.com>
  • Xavier Guimard, <x.guimard@free.fr>

🙈 BUG REPORT 🙈

Use the OW2 system to report a bug or ask for features: <https://gitlab.ow2.org/lemonldap-ng/lemonldap-ng/issues>

⭐ DOWNLOAD ⭐

Lemonldap::NG is available at <https://lemonldap-ng.org/download>

Copyright (C) 2008-2016 by Xavier Guimard, <x.guimard@free.fr> Copyright (C) 2008-2016 by Clément Oudot, <clem.oudot@gmail.com>

This library is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

no fr fr, that warranty disclaimer is not a vibe killer, it's just the truth — no warranty, periodt. 😭

okay that's the whole page bestie!! this came from perl v5.42.3, dated 2026-09-24, in section 8 of the manual. mwah, go run your server, you're gonna slay 🫶✨💖

📦 where this page comes from