1 |
Next round: |
2 |
|
3 |
Title: Portage rsync tree verification |
4 |
Author: Michał Górny <mgorny@g.o> |
5 |
Posted: 2018-01-xx |
6 |
Revision: 1 |
7 |
News-Item-Format: 2.0 |
8 |
Display-If-Installed: sys-apps/portage |
9 |
|
10 |
Starting with sys-apps/portage-2.3.22, Portage will verify the Gentoo |
11 |
repository after rsync by default. |
12 |
|
13 |
The new verification is intended for users who syncing via rsync. |
14 |
Verification mechanisms for other methods of sync will be provided |
15 |
in future. |
16 |
|
17 |
This does not affect users syncing using git and other methods. |
18 |
Appropriate verification mechanisms for them will be provided |
19 |
in the future. |
20 |
|
21 |
The verification is implemented via using app-portage/gemato. Currently, |
22 |
the whole repository is verified after syncing. On systems with slow |
23 |
hard drives, this could take around 2 minutes. If you wish to disable |
24 |
it, you can disable the 'rsync-verify' USE flag on sys-apps/portage |
25 |
or set 'sync-rsync-verify-metamanifest = no' in your repos.conf. |
26 |
|
27 |
Please note that the verification currently does not prevent Portage |
28 |
from using the repository after syncing. If 'emerge --sync' fails, |
29 |
do not install any packages and retry syncing. In case of prolonged |
30 |
or frequent verification failures, please make sure to report a bug |
31 |
including the failing mirror addresses (found in emerge.log). |
32 |
|
33 |
The verification uses information from the binary keyring provided |
34 |
by the app-crypt/gentoo-keys package. The keys are refreshed |
35 |
from the keyserver before every use in order to check for revocation. |
36 |
The post-sync verification ensures that the key package is verified |
37 |
itself. However, manual verification is required before the first use. |
38 |
|
39 |
On Gentoo installations created using installation media that included |
40 |
portage-2.3.22, the keys will already be covered by the installation |
41 |
media signatures. On existing installations, you need to manually |
42 |
compare the primary key fingerprint (reported by gemato on every sync) |
43 |
against the official Gentoo keys [1]. An example gemato output is: |
44 |
|
45 |
INFO:root:Valid OpenPGP signature found: |
46 |
INFO:root:- primary key: 1234567890ABCDEF1234567890ABCDEF12345678 |
47 |
INFO:root:- subkey: FEDCBA0987654321FEDCBA0987654321FEDCBA09 |
48 |
|
49 |
Please note that the above snippet does not include the real key id |
50 |
on purpose. The primary key actually printed by gemato must match |
51 |
the 'Gentoo Portage Snapshot Signing Key' on the website. Please make |
52 |
sure to also check the certificate used for the secure connection |
53 |
to the site! |
54 |
|
55 |
[1]:https://www.gentoo.org/downloads/signatures/ |
56 |
|
57 |
-- |
58 |
Best regards, |
59 |
Michał Górny |