manual: document bare-user-only repo mode

Closes: #903
Approved by: cgwalters
This commit is contained in:
Jonathan Lebon 2017-06-02 13:18:49 -04:00 committed by Atomic Bot
parent a32c6d2c70
commit ab7c3fd800
1 changed files with 7 additions and 0 deletions

View File

@ -81,6 +81,13 @@ The `bare-user` mode is useful for build systems that run as non-root
but want to generate root-owned content, as well as non-root container but want to generate root-owned content, as well as non-root container
systems. systems.
There is a variant to the `bare-user` mode called `bare-user-only`. Unlike
`bare-user`, neither ownership nor extended attributes are stored. These repos
are meant to to be checked out in user mode (with the `-U` flag), where this
information is not applied anyway. The main advantage of `bare-user-only` is
that repos can be stored on filesystems which do not support extended
attributes, such as tmpfs.
In contrast, the `archive-z2` mode is designed for serving via plain In contrast, the `archive-z2` mode is designed for serving via plain
HTTP. Like tar files, it can be read/written by non-root users. HTTP. Like tar files, it can be read/written by non-root users.