Skip to content

Commit a5c006c

Browse files
add doc about new ingest command tarball ownership functions
1 parent 9acdf56 commit a5c006c

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

cpt-repo.rst

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -588,6 +588,17 @@ removing a directory tree:
588588
The ``ingest`` command internally opens and closes a transaction. Therefore,
589589
it can only run if no other transactions are currently open.
590590

591+
When ingesting a tarball the default is to change the file ownership to the cvmfs repository owner
592+
defined by ``CVMFS_USER`` in ``/etc/cvmfs/repositories.d/<repo>/server.conf``.
593+
In case this is not wanted, the ``ingest`` command offers with
594+
595+
* ``-k`` or ``--keep-ownership`` to keep the current file ownerships set in the tarball
596+
* ``-u <uid>`` or ``--user <uid>`` to set a different user as the new owner (default ``gid`` of this user will be used)
597+
* ``-g <gid>`` or ``--group <gid>`` to set a different ``gid`` for the user. This only works if ``-u`` is used
598+
599+
600+
.. note::
601+
Directory ownership is always the ``CVMFS_USER`` of the given repository.
591602

592603
.. _sct_grafting:
593604

0 commit comments

Comments
 (0)