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

📦
version 2.23.3 · 9 versions
, in ubuntu stonking

✨ llng-fastcgi-server ✨

okay bestie, welcome to the llng-fastcgi-server(8) era, because this little icon is the FastCGI server that serves up LemonLDAP::NG services and honestly? it eats.

🎀 NAME 🎀

llng-fastcgi-server — the FastCGI server used for providing LemonLDAP::NG services. that's it, that's the girl. 💅

🌸 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 llng-fastcgi-server was designed to hand LemonLDAP::NG services over to Nginx or to a DevOps Handler. 💖

the Portal, the Manager and the Handler all get compiled just-in-time, no cap. which means this FastCGI server can be dropped onto every LemonLDAP::NG server, even when that server only needs some parts of the whole thing — isolated handlers, portal, whatever, it literally does not care, it's flexible like that. 🌈

👑 PARAMETERS 👑

every single parameter can be set either with an option or with an environment variable. both are valid, pick your vibe. ✨

  • --pid, -p — the pid file. ($ENV{PID})
  • --user, -u — the user. ($ENV{USER})
  • --group, -g — the group. ($ENV{GROUP})
  • --proc, -n — number of processus for FCGI. ($ENV{NPROC})
  • --socket, -s — Unix socket. ($ENV{SOCKET})
  • --listen, -l — listening address, and it can be HOST:PORT, :PORT, or PATH. ($ENV{LISTEN})
  • --customFunctionsFile, -f — the file to load for custom functions. ($ENV{CUSTOM_FUNCTIONS_FILE})
  • --engine, -e — the Plack::Handler engine, defaults to FCGI (more on that below). ($ENV{ENGINE})
  • --plackOptions — for passing other options through to the Plack handler. this one is multi-valued, so every value has to be a "key=value" pair. 💫

scroll over to Plack::Handler::FCGI if you wanna find out the full list of available options for the default FCGI engine. iykyk.

💜 ENGINES 💜

by default, llng-fastcgi-server uses FCGI, which is Plack::Handler::FCGI. but some other engines can be used too, because we're not monogamous with our handlers. 🫶

🌟 FCGI (default)

it uses FCGI::ProcManager as manager. other managers:

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 💖

http://lemonldap-ng.org/

💫 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, bestie, they wanna hear from you:

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 is the legal bit and we do not edit the legal bit. periodt. put it in your notes.

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/>.

and that's the whole page babes!! 🌸 written on 2026-08-11, and it's running under perl v5.40.1 — so yeah, the version stamp at the bottom is giving main character energy, slay. 💅✨

📦 where this page comes from