]> git.kaiwu.me - nginx.git/commit
Control API.
authorAva Hahn <a.hahn@f5.com>
Wed, 25 Mar 2026 01:08:25 +0000 (01:08 +0000)
committerAva Hahn <110854134+avahahn@users.noreply.github.com>
Tue, 1 Sep 2026 17:34:56 +0000 (10:34 -0700)
commit4bc459a15cfc95a843e322664f38a87920050281
tree72d686ae13809f1c7aab8235911b251046fce28d
parent032e181dad305e5f3d2cc6636069cb117a1c25ec
Control API.

A new nginx option -l specifies control socket listen address.
The socket is providing an HTTP/1 REST API for retrieving information
about running nginx instance.

Example:

$ nginx -l 127.0.0.1:1234

$ curl 127.0.0.1:1234/1/control/processes | jq
[
  {
    "pid": 41536,
    "name": "worker process",
    "exiting": false
  }
]

Co-authored-by: Roman Arutyunyan <arut@nginx.com>
Co-authored-by: Pavel Pautov <p.pautov@f5.com>
Co-authored-by: Dmitry Plotnikov <d.plotnikov@f5.com>
Co-authored-by: Sergey Kandaurov <pluknet@nginx.com>
Co-authored-by: Ivan Ovchinnikov <i.ovchinnikov@f5.com>
auto/modules
auto/options
auto/sources
src/core/nginx.c
src/core/ngx_core.h
src/os/unix/ngx_control.c [new file with mode: 0644]
src/os/unix/ngx_control.h [new file with mode: 0644]
src/os/unix/ngx_process_cycle.c