Re: Документация, директива pid

[Maxim Dounin]

Hello!

On Wed, Nov 29, 2017 at 04:10:46PM +0200, Gena Makhomed wrote:

> Здравствуйте, All!
> 
> В документации по директиве pid есть ошибки:
> 
> http://nginx.org/ru/docs/ngx_core_module.html#pid
> http://nginx.org/en/docs/ngx_core_module.html#pid
> 
> Default: pid nginx.pid;
> 
> На самом деле значение по-умолчанию для директивы pid
> берется из аргумента configure --pid-path=
> 
> А если аргумент configure --pid-path не задан,
> тогда значение по-умолчанию равно logs/nginx.pid
> 
> Например, для официальных linux-сборок с сайта nginx.org
> будет такое значение Default: pid /var/run/nginx.pid;
> 
> А для официальных windows-сборок с сайта nginx.org
> будет такое значение Default: pid logs/nginx.pid;

По очевидным причинам документация не может отражать значение, 
специфичное для конкретной сборки.  Так что мы там указываем 
значение по умолчанию, которое таки по умолчанию.

Какими именно параметрами configure можно переопределить какие 
значения - сейчас документировано в выводе "configure --help":

  --error-log-path=PATH              set error log pathname
  --pid-path=PATH                    set nginx.pid pathname
  --lock-path=PATH                   set nginx.lock pathname

  --user=USER                        set non-privileged user for
                                     worker processes
  --group=GROUP                      set non-privileged group for
                                     worker processes


  --http-log-path=PATH               set http access log pathname
  --http-client-body-temp-path=PATH  set path to store
                                     http client request body temporary files
  --http-proxy-temp-path=PATH        set path to store
                                     http proxy temporary files
  --http-fastcgi-temp-path=PATH      set path to store
                                     http fastcgi temporary files
  --http-uwsgi-temp-path=PATH        set path to store
                                     http uwsgi temporary files
  --http-scgi-temp-path=PATH         set path to store
                                     http scgi temporary files

Частично эта же информация есть на странице 
http://nginx.org/en/docs/configure.html.

Возможно, стоит добавить эту информацию в описания соответствующих 
директив (в виде note?).  Patches, что называется, are welcome.

-- 
Maxim Dounin
http://mdounin.ru/