Skip to content

Commit f43e93c

Browse files
committed
Documented the ssl_object_cache_inheritable directive.
1 parent a3201c5 commit f43e93c

File tree

2 files changed

+97
-2
lines changed

2 files changed

+97
-2
lines changed

xml/en/docs/ngx_core_module.xml

Lines changed: 48 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
<module name="Core functionality"
1111
link="/en/docs/ngx_core_module.html"
1212
lang="en"
13-
rev="28">
13+
rev="29">
1414

1515
<section id="example" name="Example Configuration">
1616

@@ -432,6 +432,53 @@ The module may be dynamically loaded by OpenSSL during configuration testing.
432432
</directive>
433433

434434

435+
<directive name="ssl_object_cache_inheritable">
436+
<syntax><literal>on</literal> | <literal>off</literal></syntax>
437+
<default>on</default>
438+
<context>main</context>
439+
<appeared-in>1.27.4</appeared-in>
440+
441+
<para>
442+
If enabled, SSL objects
443+
(SSL certificates, secret keys, trusted CA certificates, CRL lists)
444+
will be inherited across configuration reloads.
445+
</para>
446+
447+
<para>
448+
SSL objects loaded from a file are inherited
449+
if the modification time and file index has not been changed
450+
since the previous configuration load.
451+
Secret keys specified as
452+
<literal>engine:name:id</literal> are never inherited.
453+
Secret keys specified as
454+
<literal>data:value</literal> are always inherited.
455+
</para>
456+
457+
<para>
458+
<note>
459+
SSL objects loaded from variables cannot be inherited.
460+
</note>
461+
</para>
462+
463+
<para>
464+
Example:
465+
<example>
466+
ssl_object_cache_inheritable on;
467+
468+
http {
469+
...
470+
server {
471+
...
472+
ssl_certificate example.com.crt;
473+
ssl_certificate_key example.com.key;
474+
}
475+
}
476+
</example>
477+
</para>
478+
479+
</directive>
480+
481+
435482
<directive name="thread_pool">
436483
<syntax>
437484
<value>name</value>

xml/ru/docs/ngx_core_module.xml

Lines changed: 49 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
<module name="Основная функциональность"
1111
link="/ru/docs/ngx_core_module.html"
1212
lang="ru"
13-
rev="28">
13+
rev="29">
1414

1515
<section id="example" name="Пример конфигурации">
1616

@@ -431,6 +431,54 @@ load_module modules/ngx_mail_module.so;
431431
</directive>
432432

433433

434+
<directive name="ssl_object_cache_inheritable">
435+
<syntax><literal>on</literal> | <literal>off</literal></syntax>
436+
<default>on</default>
437+
<context>main</context>
438+
<appeared-in>1.27.4</appeared-in>
439+
440+
<para>
441+
Если включено, то SSL-объекты
442+
(SSL-сертификаты, секретные ключи, доверенные сертификаты,
443+
отозванные сертификаты (CRL)),
444+
будут наследоваться при перезагрузках конфигурации.
445+
</para>
446+
447+
<para>
448+
SSL-объекты, загруженные из файла, наследуются,
449+
если время изменения и файловый индекс не изменились
450+
с момента последней перезагрузки конфигурации.
451+
Секретные ключи, указанные как
452+
<literal>engine:name:id</literal>, никогда не наследуются.
453+
Секретные ключи, указанные как
454+
<literal>data:literal</literal>, всегда наследуются.
455+
</para>
456+
457+
<para>
458+
<note>
459+
SSL-объекты, загруженные из переменных, не могут наследоваться.
460+
</note>
461+
</para>
462+
463+
<para>
464+
Пример:
465+
<example>
466+
ssl_object_cache_inheritable on;
467+
468+
http {
469+
...
470+
server {
471+
...
472+
ssl_certificate example.com.crt;
473+
ssl_certificate_key example.com.key;
474+
}
475+
}
476+
</example>
477+
</para>
478+
479+
</directive>
480+
481+
434482
<directive name="thread_pool">
435483
<syntax>
436484
<value>имя</value>

0 commit comments

Comments
 (0)