php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #78611 listen.backlog is not -1, and -1 does not mean 'unlimited'.
Submitted: 2019-09-30 05:34 UTC Modified: 2022-03-09 21:25 UTC
From: psi at 7io dot org Assigned: bukka (profile)
Status: Closed Package: FPM related
PHP Version: Irrelevant OS: Linux
Private report: No CVE-ID: None
View Developer Edit
Welcome! If you don't have a Git account, you can't do anything here.
If you reported this bug, you can edit this bug over here.
(description)
Block user comment
Status: Assign to:
Package:
Bug Type:
Summary:
From: psi at 7io dot org
New email:
PHP Version: OS:

 

 [2019-09-30 05:34 UTC] psi at 7io dot org 
Description:
------------
As described in this code:

https://github.com/php/php-src/blob/1ad08256f349fa513157437abc4feb245cce03fc/sapi/fpm/fpm/fpm_sockets.h#L17

the default value of "listen.backlog" in php-fpm.conf is not -1. It is 511.

In BSD, the default value is -1, but it does not mean "unlimited".

Please see here(freebsd):
https://www.freebsd.org/cgi/man.cgi?listen(2)#end

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2019-09-30 08:45 UTC] requinix@php.net
-Status: Open +Status: Verified
 [2019-09-30 08:45 UTC] requinix@php.net 
https://www.php.net/manual/en/install.fpm.configuration.php
> listen.backlog int
> Set listen(2) backlog. A value of '-1' means unlimited. Default value: -1.


> In BSD, the default value is -1, but it does not mean "unlimited".
Source? Neither the FreeBSD, NetBSD, nor OpenBSD manpages talk about a backlog <= 0. Meanwhile die.net's POSIX docs say such a backlog "may be set to an implementation-defined minimum value".
Unless you're talking about the literal meaning of not having any limit whatsoever? Which obviously could not be the case.
 [2019-10-02 16:40 UTC] henry dot paradiz at gmail dot com 
Hello my name henry. The value -1 does not mean unlimited in BSD but it can continuously go on for a long long time which is why it is important to keep the documentation the way it is. If we changed everything over some minor details we would have successfully deleted the documentation. What I recommend is changing BSD to accept it as "unlimited". One and done.
 [2021-03-18 23:53 UTC] cmb@php.net
-Type: Bug +Type: Documentation Problem -Package: Documentation problem +Package: FPM related
 [2022-03-09 21:25 UTC] bukka@php.net
-Status: Verified +Status: Closed -Assigned To: +Assigned To: bukka
 [2022-03-09 21:25 UTC] bukka@php.net 
The docs updated in https://github.com/php/doc-en/commit/317a816da564d570986b2d9aed9c68e9ec173d4c
 
PHP Copyright © 2001-2025 The PHP Group
All rights reserved. 		Last updated: Sat Jul 12 02:01:35 2025 UTC