1 |
Title: SquashDelta syncing support |
2 |
Author: Michał Górny <mgorny@g.o> |
3 |
Content-Type: text/plain |
4 |
Posted: 2015-05-xx |
5 |
Revision: 1 |
6 |
News-Item-Format: 1.0 |
7 |
Display-If-Installed: >=sys-apps/portage-2.2.19 |
8 |
|
9 |
Starting with Portage 2.2.19, a new SquashDelta syncing method has been |
10 |
introduced. It is meant to provide lightweight and efficient solution |
11 |
for stable systems. The whole repository is contained within a single |
12 |
pre-generated SquashFS image file. The daily snapshot of the repository |
13 |
is first fetched from the mirrors, and afterwards updated in-place using |
14 |
deltas (without repacking). |
15 |
|
16 |
In order to enable SquashDelta syncing, please install |
17 |
dev-util/squashmerge utility first: |
18 |
|
19 |
$ emerge -v dev-util/squashmerge |
20 |
|
21 |
Afterwards, you can use a repos.conf entry similar to the following: |
22 |
|
23 |
[gentoo] |
24 |
location = /var/db/repos/gentoo |
25 |
sync-type = squashdelta |
26 |
sync-uri = mirror://gentoo/../snapshots/squashfs |
27 |
|
28 |
During the initial sync, Portage will fetch the current Gentoo SquashFS |
29 |
snapshot from the mirrors (~105M). For the synces following, it will |
30 |
only fetch a single delta, and use squashmerge to quickly update |
31 |
the local copy. |
32 |
|
33 |
If possible, Portage will automatically mount (or remount) the SquashFS |
34 |
after syncing. However, you may want to add an explicit /etc/fstab entry |
35 |
for the filesystem to make it available before invoking 'emerge --sync': |
36 |
|
37 |
/var/cache/portage/squashfs/gentoo-current.sqfs /var/db/repos/gentoo \ |
38 |
squashfs defaults 0 0 |
39 |
|
40 |
Please note that the current syncing code does not verify the OpenPGP |
41 |
signature to confirm the authenticity of fetched snapshots and deltas. |
42 |
This feature will be added as soon as gentoo-keys support in Portage is |
43 |
available. |
44 |
|
45 |
-- |
46 |
Best regards, |
47 |
Michał Górny |