|
405 | 405 | purposes (usually in the range beyond the host's UID/GID 65536). The parameter may be specified as follows:</para> |
406 | 406 |
|
407 | 407 | <orderedlist> |
408 | | - <listitem><para>If one or two colon-separated numers are specified, user namespacing is turned on. The first |
| 408 | + <listitem><para>If one or two colon-separated numbers are specified, user namespacing is turned on. The first |
409 | 409 | parameter specifies the first host UID/GID to assign to the container, the second parameter specifies the |
410 | 410 | number of host UIDs/GIDs to assign to the container. If the second parameter is omitted, 65536 UIDs/GIDs are |
411 | 411 | assigned.</para></listitem> |
|
425 | 425 | range is automatically chosen. As first step, the file owner of the root directory of the container's |
426 | 426 | directory tree is read, and it is checked that it is currently not used by the system otherwise (in |
427 | 427 | particular, that no other container is using it). If this check is successful, the UID/GID range determined |
428 | | - this way is used, similar to the behaviour if "yes" is specified. If the check is not successful (and thus |
| 428 | + this way is used, similar to the behavior if "yes" is specified. If the check is not successful (and thus |
429 | 429 | the UID/GID range indicated in the root directory's file owner is already used elsewhere) a new – currently |
430 | 430 | unused – UID/GID range of 65536 UIDs/GIDs is randomly chosen between the host UID/GIDs of 524288 and |
431 | 431 | 1878982656, always starting at a multiple of 65536. This setting implies |
432 | 432 | <option>--private-users-chown</option> (see below), which has the effect that the files and directories in |
433 | 433 | the container's directory tree will be owned by the appropriate users of the range picked. Using this option |
434 | | - makes user namespace behaviour fully automatic. Note that the first invocation of a previously unused |
| 434 | + makes user namespace behavior fully automatic. Note that the first invocation of a previously unused |
435 | 435 | container image might result in picking a new UID/GID range for it, and thus in the (possibly expensive) file |
436 | 436 | ownership adjustment operation. However, subsequent invocations of the container will be cheap (unless of |
437 | 437 | course the picked UID/GID range is assigned to a different use by then).</para></listitem> |
|
440 | 440 | <para>It is recommended to assign at least 65536 UIDs/GIDs to each container, so that the usable UID/GID range in the |
441 | 441 | container covers 16 bit. For best security, do not assign overlapping UID/GID ranges to multiple containers. It is |
442 | 442 | hence a good idea to use the upper 16 bit of the host 32-bit UIDs/GIDs as container identifier, while the lower 16 |
443 | | - bit encode the container UID/GID used. This is in fact the behaviour enforced by the |
| 443 | + bit encode the container UID/GID used. This is in fact the behavior enforced by the |
444 | 444 | <option>--private-users=pick</option> option.</para> |
445 | 445 |
|
446 | 446 | <para>When user namespaces are used, the GID range assigned to each container is always chosen identical to the |
|
722 | 722 | and the subdirectory is symlinked into the host at the same |
723 | 723 | location. <literal>try-host</literal> and |
724 | 724 | <literal>try-guest</literal> do the same but do not fail if |
725 | | - the host does not have persistent journalling enabled. If |
| 725 | + the host does not have persistent journaling enabled. If |
726 | 726 | <literal>auto</literal> (the default), and the right |
727 | 727 | subdirectory of <filename>/var/log/journal</filename> exists, |
728 | 728 | it will be bind mounted into the container. If the |
|
0 commit comments