Mercurial > hg > nginx-site
comparison xml/en/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 |
---|---|
457 <para> | 457 <para> |
458 Sets an alignment for | 458 Sets an alignment for |
459 <link id="directio"/>. | 459 <link id="directio"/>. |
460 In most cases, a 512-byte alignment is enough, however, when | 460 In most cases, a 512-byte alignment is enough, however, when |
461 using XFS under Linux, it needs to be increased to 4K. | 461 using XFS under Linux, it needs to be increased to 4K. |
462 </para> | |
463 | |
464 </directive> | |
465 | |
466 | |
467 <directive name="disable_symlinks"> | |
468 <syntax> | |
469 <literal>on</literal> | | |
470 <literal>off</literal> | | |
471 <literal>if_not_owner</literal></syntax> | |
472 <default>off</default> | |
473 <context>http</context> | |
474 <context>server</context> | |
475 <context>location</context> | |
476 <appeared-in>1.1.15</appeared-in> | |
477 | |
478 <para> | |
479 Determines how nginx treats symbolic links when opening files: | |
480 <list type="tag"> | |
481 | |
482 <tag-name><literal>off</literal></tag-name> | |
483 <tag-desc> | |
484 Symbolic links in the pathname are not processed specially. | |
485 This is the default behavior. | |
486 </tag-desc> | |
487 | |
488 <tag-name><literal>on</literal></tag-name> | |
489 <tag-desc> | |
490 If any component of the pathname is a symbolic link, | |
491 access to a file is denied. | |
492 </tag-desc> | |
493 | |
494 <tag-name><literal>if_not_owner</literal></tag-name> | |
495 <tag-desc> | |
496 Access to a file is denied if any component of the pathname | |
497 is a symbolic link, and the link and object that the link | |
498 points to have different owners. | |
499 </tag-desc> | |
500 | |
501 </list> | |
502 </para> | |
503 | |
504 <para> | |
505 This directive is only available on systems that have the | |
506 <c-func>openat</c-func> and <c-func>fstatat</c-func> interfaces. | |
507 This includes modern versions of FreeBSD, Linux, and Solaris. | |
508 </para> | |
509 | |
510 <para> | |
511 Parameters <literal>on</literal> and <literal>if_not_owner</literal> | |
512 add a processing overhead. | |
462 </para> | 513 </para> |
463 | 514 |
464 </directive> | 515 </directive> |
465 | 516 |
466 | 517 |