summaryrefslogtreecommitdiff
path: root/man/ostree-commit.xml
diff options
context:
space:
mode:
authorColin Walters <walters@verbum.org>2017-10-03 17:34:06 -0400
committerAtomic Bot <atomic-devel@projectatomic.io>2017-10-10 13:02:08 +0000
commitbba7eb80699cb789f31914bc98fc338c46237b37 (patch)
tree95a2a7f56342aa968ad07ffafb810f78f45bc19c /man/ostree-commit.xml
parentfc33ae018dccbcab633b69474db0811987355212 (diff)
downloadostree-bba7eb80699cb789f31914bc98fc338c46237b37.tar.gz
commit: Add _CONSUME modifier flag
For many cases of commit, we can actually optimize things by simply "adopting" the object rather than writing a new copy. For example, in rpm-ostree package layering. We can only make that optimization though if we take ownership of the file. This commit hence adds an API where a caller tells us to do so. For now, that just means we `unlink()` the files/dirs as we go, but we can now later add the "adopt" optimization. Closes: #1255 Approved by: jlebon
Diffstat (limited to 'man/ostree-commit.xml')
-rw-r--r--man/ostree-commit.xml11
1 files changed, 11 insertions, 0 deletions
diff --git a/man/ostree-commit.xml b/man/ostree-commit.xml
index 8f0037f6..66bc5fff 100644
--- a/man/ostree-commit.xml
+++ b/man/ostree-commit.xml
@@ -168,6 +168,17 @@ Boston, MA 02111-1307, USA.
</varlistentry>
<varlistentry>
+ <term><option>--consume</option></term>
+
+ <listitem><para>
+ When committing from a local directory (i.e. not an archive or --tree=ref),
+ assume ownership of the content. This may simply involve deleting it,
+ but if possible, the content may simply be <literal>rename()</literal>ed
+ into the repository rather than creating a new copy.
+ </para></listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>--statoverride</option>="PATH"</term>
<listitem><para>