From: Jonathan Lebon <jlebon@redhat.com>
Date: Fri, 2 Jun 2017 17:18:49 +0000 (-0400)
Subject: manual: document bare-user-only repo mode
X-Git-Tag: archive/raspbian/2022.1-3+rpi1~1^2~4^2~36^2~46
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=ab7c3fd8003220304717aa8a951ec64b1ebf8182;p=ostree.git

manual: document bare-user-only repo mode

Closes: #903
Approved by: cgwalters
---

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.