| 1 | GLEP: 60 |
1 | GLEP: 60 |
| 2 | Title: Manifest2 filetypes |
2 | Title: Manifest2 filetypes |
| 3 | Version: $Revision: 1.7 $ |
3 | Version: $Revision: 1.10 $ |
| 4 | Last-Modified: $Date: 2010/01/13 03:26:53 $ |
4 | Last-Modified: $Date: 2010/04/07 21:34:24 $ |
| 5 | Author: Robin Hugh Johnson <robbat2@gentoo.org> |
5 | Author: Robin Hugh Johnson <robbat2@gentoo.org> |
| 6 | Status: Draft |
6 | Status: Draft |
| 7 | Type: Standards Track |
7 | Type: Standards Track |
| 8 | Content-Type: text/x-rst |
8 | Content-Type: text/x-rst |
| 9 | Requires: 44 |
9 | Requires: 44 |
| 10 | Created: November 2007 |
10 | Created: November 2007 |
| 11 | Updated: June 2008, July 2008, October 2008, January 2010 |
11 | Updated: June 2008, July 2008, October 2008, January 2010 |
| 12 | Updates: 44 |
12 | Updates: 44 |
| 13 | Post-History: December 2009 |
13 | Post-History: December 2009, January 2010 |
| 14 | |
14 | |
| 15 | Abstract |
15 | Abstract |
| 16 | ======== |
16 | ======== |
| 17 | Clarification of the Manifest2 [#GLEP44] specification, including new types to |
17 | Clarification of the Manifest2 [GLEP44] specification, including new types to |
| 18 | help in the tree-signing specification. |
18 | help in the tree-signing specification. |
| 19 | |
19 | |
| 20 | Motivation |
20 | Motivation |
| 21 | ========== |
21 | ========== |
| 22 | [#GLEP44] was not entirely clear on the usage of filetype specifiers. |
22 | [GLEP44] was not entirely clear on the usage of filetype specifiers. |
| 23 | This document serves to provide some of the internal logic used by |
23 | This document serves to provide some of the internal logic used by |
| 24 | Portage at the point of writing, as well as adding new types to cover |
24 | Portage at the point of writing, as well as adding new types to cover |
| 25 | the rest of the tree, for the purposes of tree-signing coverage. |
25 | the rest of the tree, for the purposes of tree-signing coverage. |
|
|
26 | |
|
|
27 | This GLEP is not mandatory for the tree-signing specification, but |
|
|
28 | instead aims to clarify the usage of the Manifest2 filetype specifiers, |
|
|
29 | and note which types signify files that are allowed to be missing from |
|
|
30 | the tree (e.g. a user excluding a package or category). As such, it is |
|
|
31 | also able to stand on it's own. |
| 26 | |
32 | |
| 27 | Specification |
33 | Specification |
| 28 | ============= |
34 | ============= |
| 29 | General |
35 | General |
| 30 | ------- |
36 | ------- |
| … | |
… | |
| 169 | On Bloat |
175 | On Bloat |
| 170 | -------- |
176 | -------- |
| 171 | If repeated use of a common path prefix is considered a bloat problem, a |
177 | If repeated use of a common path prefix is considered a bloat problem, a |
| 172 | Manifest file should be added inside the common directory, however this |
178 | Manifest file should be added inside the common directory, however this |
| 173 | should not be done blindly, as bloat by inodes is more significant for |
179 | should not be done blindly, as bloat by inodes is more significant for |
| 174 | the majority of use cases. See also [#GLEP58] on size reductions of |
180 | the majority of use cases. See also [GLEP58] on size reductions of |
| 175 | Manifests. |
181 | Manifests. |
| 176 | |
182 | |
| 177 | Chosing a filetype |
183 | Chosing a filetype |
| 178 | ------------------ |
184 | ------------------ |
| 179 | 1. matches ``Manifest`` |
185 | 1. matches ``Manifest`` |
| … | |
… | |
| 214 | continue to be present for the standard Portage deprecation cycle. |
220 | continue to be present for the standard Portage deprecation cycle. |
| 215 | The new entries may be included already in all Manifest files, as they |
221 | The new entries may be included already in all Manifest files, as they |
| 216 | will be ignored by older Portage versions. Over time, ECLASS, DATA, |
222 | will be ignored by older Portage versions. Over time, ECLASS, DATA, |
| 217 | EXEC, OTHER may replace the existing AUX type. |
223 | EXEC, OTHER may replace the existing AUX type. |
| 218 | |
224 | |
| 219 | The adoption of this proposal does also affect [#GLEP58] as part of |
225 | The adoption of this proposal does also affect [GLEP58] as part of |
| 220 | this GLEP series, however this GLEP was an offset of the research in |
226 | this GLEP series, however this GLEP was an offset of the research in |
| 221 | that GLEP. |
227 | that GLEP. |
| 222 | |
228 | |
| 223 | Thanks to |
229 | Thanks to |
| 224 | ========= |
230 | ========= |
| 225 | I'd like to thank the following people for input on this GLEP. |
231 | I'd like to thank the following people for input on this GLEP. |
| 226 | - Marius Mauch (genone) & Zac Medico (zmedico): Portage Manifest2 |
232 | - Marius Mauch (genone) & Zac Medico (zmedico): Portage Manifest2 |
| 227 | |
233 | |
| 228 | References |
234 | References |
| 229 | ========== |
235 | ========== |
| 230 | .. [#GLEP44] Mauch, M. (2005) GLEP44 - Manifest2 format. |
236 | .. [GLEP44] Mauch, M. (2005) GLEP44 - Manifest2 format. |
| 231 | http://www.gentoo.org/proj/en/glep/glep-0044.html |
237 | http://www.gentoo.org/proj/en/glep/glep-0044.html |
|
|
238 | |
|
|
239 | .. [GLEP58] Security of distribution of Gentoo software - Infrastructure to User distribution - MetaManifest |
|
|
240 | http://www.gentoo.org/proj/en/glep/glep-0058.html |
| 232 | |
241 | |
| 233 | Copyright |
242 | Copyright |
| 234 | ========= |
243 | ========= |
| 235 | Copyright (c) 2007-2010 by Robin Hugh Johnson. This material may be |
244 | Copyright (c) 2007-2010 by Robin Hugh Johnson. This material may be |
| 236 | distributed only subject to the terms and conditions set forth in the |
245 | distributed only subject to the terms and conditions set forth in the |
| 237 | Open Publication License, v1.0. |
246 | Open Publication License, v1.0. |
| 238 | |
247 | |
| 239 | vim: tw=72 ts=2 expandtab: |
248 | .. vim: tw=72 ts=2 expandtab: |
Parent Directory
| 
Revision Log
| 
Patch