Gentoo Archives: gentoo-commits

From: Zac Medico <zmedico@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] data/gentoo-news:master commit in: 2018-07-11-portage-sync-allow-hardlinks/
Date: Wed, 11 Jul 2018 09:05:39
Message-Id: 1531299245.e398a453a62490fd3ff168887f761e0c91ab50e9.zmedico@gentoo
1 commit: e398a453a62490fd3ff168887f761e0c91ab50e9
2 Author: Zac Medico <zmedico <AT> gentoo <DOT> org>
3 AuthorDate: Sun Jul 8 05:51:09 2018 +0000
4 Commit: Zac Medico <zmedico <AT> gentoo <DOT> org>
5 CommitDate: Wed Jul 11 08:54:05 2018 +0000
6 URL: https://gitweb.gentoo.org/data/gentoo-news.git/commit/?id=e398a453
7
8 2018-07-11-portage-sync-allow-hardlinks: Add
9
10 Bug: https://bugs.gentoo.org/660410
11
12 .../2018-07-11-portage-sync-allow-hardlinks.en.txt | 34 ++++++++++++++++++++++
13 1 file changed, 34 insertions(+)
14
15 diff --git a/2018-07-11-portage-sync-allow-hardlinks/2018-07-11-portage-sync-allow-hardlinks.en.txt b/2018-07-11-portage-sync-allow-hardlinks/2018-07-11-portage-sync-allow-hardlinks.en.txt
16 new file mode 100644
17 index 0000000..d64f0cb
18 --- /dev/null
19 +++ b/2018-07-11-portage-sync-allow-hardlinks/2018-07-11-portage-sync-allow-hardlinks.en.txt
20 @@ -0,0 +1,34 @@
21 +Title: Portage rsync hardlink support
22 +Author: Zac Medico <zmedico@g.o>
23 +Posted: 2018-07-11
24 +Revision: 1
25 +News-Item-Format: 2.0
26 +Display-If-Installed: sys-apps/portage
27 +
28 +For users of the rsync tree, beginning with sys-apps/portage-2.3.42,
29 +the default behavior for sync operations will use hardlinks in order
30 +to ensure that a repository remains in a valid state if something
31 +goes wrong [1]. For example, if signature verification fails during a
32 +sync operation, the new hardlink behavior will preserve the previous
33 +state of the repository.
34 +
35 +The new behavior may conflict with configurations that restrict the
36 +use of hardlinks, such as overlay filesystems. Therefore, users will
37 +have to set "sync-allow-hardlinks = no" in repos.conf if they have
38 +a configuration that restricts the use of hardlinks, but this should
39 +not be very common:
40 +
41 +[DEFAULT]
42 +sync-allow-hardlinks = no
43 +
44 +Note that it is possible to sync more efficiently using git [2]
45 +instead of rsync, though git consumes an increasing amount of disk
46 +space over time unless shallow pull is enabled via the sync-depth
47 +option in repos.conf [3] (requires sys-apps/portage-2.3.42 or later).
48 +
49 +[1] https://bugs.gentoo.org/660410 sys-apps/portage: use rsync
50 + --link-dest to implement atomic repository updates (and abort if
51 + signature verification fails)
52 +[2] https://wiki.gentoo.org/wiki/Portage_Security#git-mirror_repo
53 +[3] https://bugs.gentoo.org/552814 sys-apps/portage: support shallow
54 + git pull by setting sync-depth = 1 in repos.conf