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 |