---
name: "llng-fastcgi-server"
section: "1"
platform: "linux"
package: "lemonldap-ng-fastcgi-server"
version: "2.0.2+ds-7+deb10u7"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/llng-fastcgi-server"
---

# llng-fastcgi-server(1)

FastCGI server used to provide Lemonldap::NG services to Nginx

## NAME

llng-fastcgi-server - FastCGI server used to provide Lemonldap::NG services to Nginx

## SYNOPSIS

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

## DESCRIPTION

llng-fastcgi-server has been designed provides Lemonldap::NG services to Nginx. Portal, manager and handler will be compiled only is used. So this FastCGI server can be used on every Lemonldap::NG server even if it needs only some parts (isolated handlers, portal,...).

## PARAMETERS

Each parameter can be set by an option or a environment variable.

- \--pid -p ($ENV{PID}):

  pid file

- \--user -u ($ENV{USER}):

  user

- \--group -g ($ENV{GROUP}):

  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 (see below)

- \--plackOptions:

  other options to pass to Plack. This multi-valued parameter must have "key=value" values.

  Example to use FCGI::ProcManager::Constrained instead of default FCGI manager (FCGI::ProcManager):

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

## ENGINES

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

### FCGI (default)

It uses FCGI::ProcManager as manager. Other managers:

- FCGI::ProcManager::Constrained

  Example to launch it:

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

  You can then set environment values (in /etc/default/llng-fastcgi-server file for example):

  ```
    PM_MAX_REQUESTS=10000
    PM_SIZECHECK_NUM_REQUESTS=100
    PM_MAX_SIZE=300000
  ```

- 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 OW2 system to report bug or ask for features: \<https://gitlab.ow2.org/lemonldap-ng/lemonldap-ng/issues\>

## DOWNLOAD

Lemonldap::NG is available at \<http://forge.objectweb.org/project/showfiles.php?group\_id=274\>

## COPYRIGHT AND LICENSE

- Copyright (C) 2008-2016 by Xavier Guimard, \<x.guimard@free.fr\>

  - Copyright (C) 2008-2016 by Clement 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/\>.