comparison xml/ru/docs/http/ngx_http_core_module.xml @ 418:2638f67205ee

Documented the disable_symlinks directive.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 15 Feb 2012 21:45:42 +0000
parents 98dac2bd7598
children 8fa5f2273014
comparison
equal deleted inserted replaced
417:cbc2d1b51cb6 418:2638f67205ee
446 <para> 446 <para>
447 Устанавливает выравнивание для 447 Устанавливает выравнивание для
448 <link id="directio"/>. 448 <link id="directio"/>.
449 В большинстве случаев достаточно 512-байтового выравнивания, однако 449 В большинстве случаев достаточно 512-байтового выравнивания, однако
450 при использовании XFS под Linux его нужно увеличить до 4K. 450 при использовании XFS под Linux его нужно увеличить до 4K.
451 </para>
452
453 </directive>
454
455
456 <directive name="disable_symlinks">
457 <syntax>
458 <literal>on</literal> |
459 <literal>off</literal> |
460 <literal>if_not_owner</literal></syntax>
461 <default>off</default>
462 <context>http</context>
463 <context>server</context>
464 <context>location</context>
465 <appeared-in>1.1.15</appeared-in>
466
467 <para>
468 Определяет, как следует поступать с символическими ссылками
469 при открытии файлов:
470 <list type="tag">
471
472 <tag-name><literal>off</literal></tag-name>
473 <tag-desc>
474 Символические ссылки в пути никак специально не обрабатываются.
475 Это стандартное поведение.
476 </tag-desc>
477
478 <tag-name><literal>on</literal></tag-name>
479 <tag-desc>
480 Если любой компонент пути является символической ссылкой,
481 доступ к файлу запрещается.
482 </tag-desc>
483
484 <tag-name><literal>if_not_owner</literal></tag-name>
485 <tag-desc>
486 Доступ к файлу запрещается, если любой компонент пути
487 является символической ссылкой, и ссылка и объект, на
488 который она ссылается, имеют разных владельцев.
489 </tag-desc>
490
491 </list>
492 </para>
493
494 <para>
495 Эта директива доступна только на системах, в которых есть
496 интерфейсы <c-func>openat</c-func> и <c-func>fstatat</c-func>.
497 К таким системам относятся современные версии FreeBSD, Linux и Solaris.
498 </para>
499
500 <para>
501 Параметры <literal>on</literal> и <literal>if_not_owner</literal>
502 требуют дополнительных затрат на обработку.
451 </para> 503 </para>
452 504
453 </directive> 505 </directive>
454 506
455 507