summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJonathan Lebon <jlebon@redhat.com>2017-06-02 13:18:49 -0400
committerAtomic Bot <atomic-devel@projectatomic.io>2017-06-02 17:46:16 +0000
commitab7c3fd8003220304717aa8a951ec64b1ebf8182 (patch)
tree64446f2ceb90f912ad8830362b134054d7a9ea44 /docs
parenta32c6d2c70c82b583e8ee7c2a2f4e00b0d888fe5 (diff)
downloadostree-ab7c3fd8003220304717aa8a951ec64b1ebf8182.tar.gz
manual: document bare-user-only repo mode
Closes: #903 Approved by: cgwalters
Diffstat (limited to 'docs')
-rw-r--r--docs/manual/repo.md7
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/manual/repo.md b/docs/manual/repo.md
index 6e307ba3..6b547be6 100644
--- a/docs/manual/repo.md
+++ b/docs/manual/repo.md
@@ -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
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
HTTP. Like tar files, it can be read/written by non-root users.