| … | |
… | |
| 6 | PEP, see http://www.python.org/peps/pep-0001.html for instructions and links |
6 | PEP, see http://www.python.org/peps/pep-0001.html for instructions and links |
| 7 | to templates. DO NOT USE THIS HTML FILE AS YOUR TEMPLATE! |
7 | to templates. DO NOT USE THIS HTML FILE AS YOUR TEMPLATE! |
| 8 | --> |
8 | --> |
| 9 | <head> |
9 | <head> |
| 10 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
10 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
| 11 | <meta name="generator" content="Docutils 0.3.0: http://docutils.sourceforge.net/" /> |
11 | <meta name="generator" content="Docutils 0.3.3: http://docutils.sourceforge.net/" /> |
| 12 | <title>GLEP 25 -- Distfile Patching Support</title> |
12 | <title>GLEP 25 -- Distfile Patching Support</title> |
| 13 | <link rel="stylesheet" href="tools/glep.css" type="text/css" /> |
13 | <link rel="stylesheet" href="tools/glep.css" type="text/css" /> |
| 14 | </head> |
14 | </head> |
| 15 | <body bgcolor="white"> |
15 | <body bgcolor="white"> |
| 16 | <table class="navigation" cellpadding="0" cellspacing="0" |
16 | <table class="navigation" cellpadding="0" cellspacing="0" |
| … | |
… | |
| 20 | <img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]" |
20 | <img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]" |
| 21 | border="0" width="150" height="35" /></a></td> |
21 | border="0" width="150" height="35" /></a></td> |
| 22 | <td class="textlinks" align="left"> |
22 | <td class="textlinks" align="left"> |
| 23 | [<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>] |
23 | [<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>] |
| 24 | [<b><a href="http://www.gentoo.org/proj/en/glep">GLEP Index</a></b>] |
24 | [<b><a href="http://www.gentoo.org/proj/en/glep">GLEP Index</a></b>] |
| 25 | [<b><a href="http://www.gentoo.org/proj/en/glep/glep-0025.txt">GLEP Source</a></b>] |
25 | [<b><a href="./glep-0025.txt">GLEP Source</a></b>] |
| 26 | </td></tr></table> |
26 | </td></tr></table> |
| 27 | <div class="document"> |
27 | <div class="document"> |
| 28 | <table class="rfc2822 field-list" frame="void" rules="none"> |
28 | <table class="rfc2822 field-list" frame="void" rules="none"> |
| 29 | <col class="field-name" /> |
29 | <col class="field-name" /> |
| 30 | <col class="field-body" /> |
30 | <col class="field-body" /> |
| 31 | <tbody valign="top"> |
31 | <tbody valign="top"> |
| 32 | <tr class="field"><th class="field-name">GLEP:</th><td class="field-body">25</td> |
32 | <tr class="field"><th class="field-name">GLEP:</th><td class="field-body">25</td> |
| 33 | </tr> |
33 | </tr> |
| 34 | <tr class="field"><th class="field-name">Title:</th><td class="field-body">Distfile Patching Support</td> |
34 | <tr class="field"><th class="field-name">Title:</th><td class="field-body">Distfile Patching Support</td> |
| 35 | </tr> |
35 | </tr> |
| 36 | <tr class="field"><th class="field-name">Version:</th><td class="field-body">1.0</td> |
36 | <tr class="field"><th class="field-name">Version:</th><td class="field-body">1.2</td> |
| 37 | </tr> |
37 | </tr> |
| 38 | <tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference" href="http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/proj/en/glep/glep-0025.txt?cvsroot=gentoo">2004/04/01 01:07:40</a></td> |
38 | <tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference" href="http://www.gentoo.org/cgi-bin/viewcvs/xml/htdocs/proj/en/glep/glep-0025.txt?cvsroot=gentoo">2004/11/11 21:34:36</a></td> |
| 39 | </tr> |
39 | </tr> |
| 40 | <tr class="field"><th class="field-name">Author:</th><td class="field-body">Brian Harring <ferringb at gentoo.org></td> |
40 | <tr class="field"><th class="field-name">Author:</th><td class="field-body">Brian Harring <ferringb at gentoo.org></td> |
| 41 | </tr> |
41 | </tr> |
| 42 | <tr class="field"><th class="field-name">Status:</th><td class="field-body">Draft</td> |
42 | <tr class="field"><th class="field-name">Status:</th><td class="field-body">deferred</td> |
| 43 | </tr> |
43 | </tr> |
| 44 | <tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td> |
44 | <tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td> |
| 45 | </tr> |
45 | </tr> |
| 46 | <tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference" href="glep-0002.html">text/x-rst</a></td> |
46 | <tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference" href="glep-0012.html">text/x-rst</a></td> |
| 47 | </tr> |
47 | </tr> |
| 48 | <tr class="field"><th class="field-name">Created:</th><td class="field-body">6-Mar-2004</td> |
48 | <tr class="field"><th class="field-name">Created:</th><td class="field-body">6-Mar-2004</td> |
| 49 | </tr> |
49 | </tr> |
| 50 | <tr class="field"><th class="field-name">Post-History:</th><td class="field-body">4-Apr-2004</td> |
50 | <tr class="field"><th class="field-name">Post-History:</th><td class="field-body">4-Apr-2004, 11-Nov-2004</td> |
| 51 | </tr> |
51 | </tr> |
| 52 | </tbody> |
52 | </tbody> |
| 53 | </table> |
53 | </table> |
| 54 | <hr /> |
54 | <hr /> |
| 55 | <div class="contents topic" id="contents"> |
55 | <div class="contents topic" id="contents"> |
| 56 | <p class="topic-title"><a name="contents">Contents</a></p> |
56 | <p class="topic-title first"><a name="contents">Contents</a></p> |
| 57 | <ul class="simple"> |
57 | <ul class="simple"> |
| 58 | <li><a class="reference" href="#abstract" id="id7" name="id7">Abstract</a></li> |
58 | <li><a class="reference" href="#abstract" id="id7" name="id7">Abstract</a></li> |
|
|
59 | <li><a class="reference" href="#status" id="id8" name="id8">Status</a></li> |
| 59 | <li><a class="reference" href="#motivation" id="id8" name="id8">Motivation</a></li> |
60 | <li><a class="reference" href="#motivation" id="id9" name="id9">Motivation</a></li> |
| 60 | <li><a class="reference" href="#binary-patches-vs-gnudiff-patches" id="id9" name="id9">Binary patches vs GNUDiff patches</a></li> |
61 | <li><a class="reference" href="#binary-patches-vs-gnudiff-patches" id="id10" name="id10">Binary patches vs GNUDiff patches</a></li> |
| 61 | <li><a class="reference" href="#rationale" id="id10" name="id10">Rationale</a></li> |
62 | <li><a class="reference" href="#rationale" id="id11" name="id11">Rationale</a></li> |
| 62 | <li><a class="reference" href="#specification" id="id11" name="id11">Specification</a><ul> |
63 | <li><a class="reference" href="#specification" id="id12" name="id12">Specification</a><ul> |
| 63 | <li><a class="reference" href="#additions-to-the-tree" id="id12" name="id12">Additions to the tree</a></li> |
64 | <li><a class="reference" href="#additions-to-the-tree" id="id13" name="id13">Additions to the tree</a></li> |
| 64 | <li><a class="reference" href="#portage-implementation" id="id13" name="id13">Portage Implementation</a><ul> |
65 | <li><a class="reference" href="#portage-implementation" id="id14" name="id14">Portage Implementation</a><ul> |
| 65 | <li><a class="reference" href="#fetching" id="id14" name="id14">Fetching</a></li> |
66 | <li><a class="reference" href="#fetching" id="id15" name="id15">Fetching</a></li> |
| 66 | <li><a class="reference" href="#reconstruction" id="id15" name="id15">Reconstruction</a></li> |
67 | <li><a class="reference" href="#reconstruction" id="id16" name="id16">Reconstruction</a></li> |
| 67 | <li><a class="reference" href="#compressed-md5sums" id="id16" name="id16">Compressed MD5sums:</a><ul> |
68 | <li><a class="reference" href="#compressed-md5sums" id="id17" name="id17">Compressed MD5sums:</a><ul> |
| 68 | <li><a class="reference" href="#the-problem-in-detail" id="id17" name="id17">The Problem in Detail</a></li> |
69 | <li><a class="reference" href="#the-problem-in-detail" id="id18" name="id18">The Problem in Detail</a></li> |
| 69 | <li><a class="reference" href="#the-proposed-solution" id="id18" name="id18">The Proposed Solution</a></li> |
70 | <li><a class="reference" href="#the-proposed-solution" id="id19" name="id19">The Proposed Solution</a></li> |
| 70 | </ul> |
71 | </ul> |
| 71 | </li> |
72 | </li> |
| 72 | </ul> |
73 | </ul> |
| 73 | </li> |
74 | </li> |
| 74 | <li><a class="reference" href="#distfile-mirror-additions" id="id19" name="id19">Distfile Mirror Additions</a></li> |
75 | <li><a class="reference" href="#distfile-mirror-additions" id="id20" name="id20">Distfile Mirror Additions</a></li> |
| 75 | <li><a class="reference" href="#patch-creation" id="id20" name="id20">Patch Creation</a></li> |
76 | <li><a class="reference" href="#patch-creation" id="id21" name="id21">Patch Creation</a></li> |
| 76 | </ul> |
77 | </ul> |
| 77 | </li> |
78 | </li> |
| 78 | <li><a class="reference" href="#backwards-compatability" id="id21" name="id21">Backwards Compatability</a></li> |
79 | <li><a class="reference" href="#backwards-compatability" id="id22" name="id22">Backwards Compatability</a></li> |
| 79 | <li><a class="reference" href="#reference-implementation" id="id22" name="id22">Reference Implementation</a></li> |
80 | <li><a class="reference" href="#reference-implementation" id="id23" name="id23">Reference Implementation</a></li> |
| 80 | <li><a class="reference" href="#references" id="id23" name="id23">References</a></li> |
81 | <li><a class="reference" href="#references" id="id24" name="id24">References</a></li> |
| 81 | <li><a class="reference" href="#copyright" id="id24" name="id24">Copyright</a></li> |
82 | <li><a class="reference" href="#copyright" id="id25" name="id25">Copyright</a></li> |
| 82 | </ul> |
83 | </ul> |
| 83 | </div> |
84 | </div> |
| 84 | <div class="section" id="abstract"> |
85 | <div class="section" id="abstract"> |
| 85 | <h1><a class="toc-backref" href="#id7" name="abstract">Abstract</a></h1> |
86 | <h1><a class="toc-backref" href="#id7" name="abstract">Abstract</a></h1> |
| 86 | <p>The intention of this GLEP is to propose the creation of patching support for |
87 | <p>The intention of this GLEP is to propose the creation of patching support for |
| 87 | portage, and iron out the implementation details.</p> |
88 | portage, and iron out the implementation details.</p> |
| 88 | </div> |
89 | </div> |
|
|
90 | <div class="section" id="status"> |
|
|
91 | <h1><a class="toc-backref" href="#id8" name="status">Status</a></h1> |
|
|
92 | <p>Timed out</p> |
|
|
93 | </div> |
| 89 | <div class="section" id="motivation"> |
94 | <div class="section" id="motivation"> |
| 90 | <h1><a class="toc-backref" href="#id8" name="motivation">Motivation</a></h1> |
95 | <h1><a class="toc-backref" href="#id9" name="motivation">Motivation</a></h1> |
| 91 | <p>Reduce the bandwidth load placed on our mirrors by decreasing the amount of |
96 | <p>Reduce the bandwidth load placed on our mirrors by decreasing the amount of |
| 92 | bytes transferred when upgrading between versions. Side benefit of this is to |
97 | bytes transferred when upgrading between versions. Side benefit of this is to |
| 93 | significantly decrease the download requirements for users lacking broadband.</p> |
98 | significantly decrease the download requirements for users lacking broadband.</p> |
| 94 | </div> |
99 | </div> |
| 95 | <div class="section" id="binary-patches-vs-gnudiff-patches"> |
100 | <div class="section" id="binary-patches-vs-gnudiff-patches"> |
| 96 | <h1><a class="toc-backref" href="#id9" name="binary-patches-vs-gnudiff-patches">Binary patches vs GNUDiff patches</a></h1> |
101 | <h1><a class="toc-backref" href="#id10" name="binary-patches-vs-gnudiff-patches">Binary patches vs GNUDiff patches</a></h1> |
| 97 | <p>Most people are familiar with diff patches (unified diff for example)- this |
102 | <p>Most people are familiar with diff patches (unified diff for example)- this |
| 98 | glep is specifically proposing the use of an actual binary differencer. The |
103 | glep is specifically proposing the use of an actual binary differencer. The |
| 99 | reason for this is that diff patches are line based- you change a single |
104 | reason for this is that diff patches are line based- you change a single |
| 100 | character in a line, and the whole line must be included in the patch. Binary |
105 | character in a line, and the whole line must be included in the patch. Binary |
| 101 | differencers work at the byte level- it encodes just that byte. In that |
106 | differencers work at the byte level- it encodes just that byte. In that |
| … | |
… | |
| 113 | <p>Currently, this glep is proposing only the usage of binary patches- that's not |
118 | <p>Currently, this glep is proposing only the usage of binary patches- that's not |
| 114 | to say (with a fair amount of work) it couldn't be extended to support |
119 | to say (with a fair amount of work) it couldn't be extended to support |
| 115 | standard diffs.</p> |
120 | standard diffs.</p> |
| 116 | </div> |
121 | </div> |
| 117 | <div class="section" id="rationale"> |
122 | <div class="section" id="rationale"> |
| 118 | <h1><a class="toc-backref" href="#id10" name="rationale">Rationale</a></h1> |
123 | <h1><a class="toc-backref" href="#id11" name="rationale">Rationale</a></h1> |
| 119 | <p>The difference between source releases typically isn't very large, especially |
124 | <p>The difference between source releases typically isn't very large, especially |
| 120 | for minor releases. As an example, kdelibs-3.1.4.tar.bz2 is 10.53 MB, and |
125 | for minor releases. As an example, kdelibs-3.1.4.tar.bz2 is 10.53 MB, and |
| 121 | kdelibs-3.1.5.tar.bz2 is 10.54 MB. A bzip2'ed patch between those versions is |
126 | kdelibs-3.1.5.tar.bz2 is 10.54 MB. A bzip2'ed patch between those versions is |
| 122 | 75.6 kb <a class="footnote-reference" href="#id5" id="id2" name="id2">[2]</a>, less then 1% the size of 3.1.5's tbz2.</p> |
127 | 75.6 kb <a class="footnote-reference" href="#id5" id="id2" name="id2">[2]</a>, less then 1% the size of 3.1.5's tbz2.</p> |
| 123 | </div> |
128 | </div> |
| 124 | <div class="section" id="specification"> |
129 | <div class="section" id="specification"> |
| 125 | <h1><a class="toc-backref" href="#id11" name="specification">Specification</a></h1> |
130 | <h1><a class="toc-backref" href="#id12" name="specification">Specification</a></h1> |
| 126 | <p>Quite a few sections of gentoo are affected- mirroring, the portage tree, and |
131 | <p>Quite a few sections of gentoo are affected- mirroring, the portage tree, and |
| 127 | portage itself.</p> |
132 | portage itself.</p> |
| 128 | <div class="section" id="additions-to-the-tree"> |
133 | <div class="section" id="additions-to-the-tree"> |
| 129 | <h2><a class="toc-backref" href="#id12" name="additions-to-the-tree">Additions to the tree</a></h2> |
134 | <h2><a class="toc-backref" href="#id13" name="additions-to-the-tree">Additions to the tree</a></h2> |
| 130 | <p>For adding patch info into the tree, this glep proposes a global patch list |
135 | <p>For adding patch info into the tree, this glep proposes a global patch list |
| 131 | (stored in profiles as patches.global), and individual patch lists stored in |
136 | (stored in profiles as patches.global), and individual patch lists stored in |
| 132 | relevant package directories (named patches). Using the kernel packages as an |
137 | relevant package directories (named patches). Using the kernel packages as an |
| 133 | example, a global list of patches enables us to create a patch once, add an |
138 | example, a global list of patches enables us to create a patch once, add an |
| 134 | entry, and have all kernel packages benefit from that single entry. Both |
139 | entry, and have all kernel packages benefit from that single entry. Both |
| … | |
… | |
| 153 | <p>Finally, note that this is a unidirectional patch- using the above example, |
158 | <p>Finally, note that this is a unidirectional patch- using the above example, |
| 154 | kdelibs-3.1.4-3.1.5 can <strong>only</strong> be used to upgrade from 3.1.4 to 3.1.5, not |
159 | kdelibs-3.1.4-3.1.5 can <strong>only</strong> be used to upgrade from 3.1.4 to 3.1.5, not |
| 155 | in reverse (originally explained in <a class="reference" href="#binary-patches-vs-gnudiff-patches">Binary patches vs GNUDiff patches</a>).</p> |
160 | in reverse (originally explained in <a class="reference" href="#binary-patches-vs-gnudiff-patches">Binary patches vs GNUDiff patches</a>).</p> |
| 156 | </div> |
161 | </div> |
| 157 | <div class="section" id="portage-implementation"> |
162 | <div class="section" id="portage-implementation"> |
| 158 | <h2><a class="toc-backref" href="#id13" name="portage-implementation">Portage Implementation</a></h2> |
163 | <h2><a class="toc-backref" href="#id14" name="portage-implementation">Portage Implementation</a></h2> |
| 159 | <p>This glep proposes the patching support should be (at this stage) optional- |
164 | <p>This glep proposes the patching support should be (at this stage) optional- |
| 160 | specifically, enabled via FEATURES="patching".</p> |
165 | specifically, enabled via FEATURES="patching".</p> |
| 161 | <div class="section" id="fetching"> |
166 | <div class="section" id="fetching"> |
| 162 | <h3><a class="toc-backref" href="#id14" name="fetching">Fetching</a></h3> |
167 | <h3><a class="toc-backref" href="#id15" name="fetching">Fetching</a></h3> |
| 163 | <p>When patching is enabled, the global patch list is read, and the packages |
168 | <p>When patching is enabled, the global patch list is read, and the packages |
| 164 | patch list is read. From there, portage determines what files could be used |
169 | patch list is read. From there, portage determines what files could be used |
| 165 | as a base for patching to the desired file- further, determining if it's |
170 | as a base for patching to the desired file- further, determining if it's |
| 166 | actually worth patching (case where it wouldn't be is when the target file is |
171 | actually worth patching (case where it wouldn't be is when the target file is |
| 167 | less then the sum of the patches needed). Any patches to be used are fetched, |
172 | less then the sum of the patches needed). Any patches to be used are fetched, |
| 168 | and md5 verified.</p> |
173 | and md5 verified.</p> |
| 169 | </div> |
174 | </div> |
| 170 | <div class="section" id="reconstruction"> |
175 | <div class="section" id="reconstruction"> |
| 171 | <h3><a class="toc-backref" href="#id15" name="reconstruction">Reconstruction</a></h3> |
176 | <h3><a class="toc-backref" href="#id16" name="reconstruction">Reconstruction</a></h3> |
| 172 | <p>Upon fetching and md5 verification of patch(es), the desired file is |
177 | <p>Upon fetching and md5 verification of patch(es), the desired file is |
| 173 | reconstructed. Assuming reconstruction didn't return any errors, the target |
178 | reconstructed. Assuming reconstruction didn't return any errors, the target |
| 174 | file has its uncompressed md5sum calculated and verified, then is recompressed |
179 | file has its uncompressed md5sum calculated and verified, then is recompressed |
| 175 | and the compressed md5sum calculated. At this point, if the compressed md5 |
180 | and the compressed md5sum calculated. At this point, if the compressed md5 |
| 176 | matches the md5 stored in the tree, then portage transfers the file into |
181 | matches the md5 stored in the tree, then portage transfers the file into |
| … | |
… | |
| 178 | <p>If the compressed md5 is different from the tree's value, then the (proposed) |
183 | <p>If the compressed md5 is different from the tree's value, then the (proposed) |
| 179 | md5 database is updated with new compressed md5. Details of this database |
184 | md5 database is updated with new compressed md5. Details of this database |
| 180 | (and the issue it addresses) follow.</p> |
185 | (and the issue it addresses) follow.</p> |
| 181 | </div> |
186 | </div> |
| 182 | <div class="section" id="compressed-md5sums"> |
187 | <div class="section" id="compressed-md5sums"> |
| 183 | <h3><a class="toc-backref" href="#id16" name="compressed-md5sums">Compressed MD5sums:</a></h3> |
188 | <h3><a class="toc-backref" href="#id17" name="compressed-md5sums">Compressed MD5sums:</a></h3> |
| 184 | <p>There will be instances where a file is reconstructed perfectly, recompressed, |
189 | <p>There will be instances where a file is reconstructed perfectly, recompressed, |
| 185 | and the recompressed md5sum differs from what is stored in the tree- the |
190 | and the recompressed md5sum differs from what is stored in the tree- the |
| 186 | problem is that the md5sum of a compressed file is inherently tied to the |
191 | problem is that the md5sum of a compressed file is inherently tied to the |
| 187 | compressor version/options used to compress the original source.</p> |
192 | compressor version/options used to compress the original source.</p> |
| 188 | <div class="section" id="the-problem-in-detail"> |
193 | <div class="section" id="the-problem-in-detail"> |
| 189 | <h4><a class="toc-backref" href="#id17" name="the-problem-in-detail">The Problem in Detail</a></h4> |
194 | <h4><a class="toc-backref" href="#id18" name="the-problem-in-detail">The Problem in Detail</a></h4> |
| 190 | <p>A good example of this problem is related to bzip2 versions used for |
195 | <p>A good example of this problem is related to bzip2 versions used for |
| 191 | compression. Between bzip2 0.9x and bzip2 1.x, there was a subtle change in |
196 | compression. Between bzip2 0.9x and bzip2 1.x, there was a subtle change in |
| 192 | the compressor resulting in a slightly better compression result- end result |
197 | the compressor resulting in a slightly better compression result- end result |
| 193 | being a different file, eg a different md5sum. Assuming compressor versions |
198 | being a different file, eg a different md5sum. Assuming compressor versions |
| 194 | are the same, there also is the issue of what compression level the target |
199 | are the same, there also is the issue of what compression level the target |
| … | |
… | |
| 202 | required to have multiple versions of the same compressor installed just for |
207 | required to have multiple versions of the same compressor installed just for |
| 203 | the sake of recreating a compressed md5sum <em>even though</em> the uncompressed |
208 | the sake of recreating a compressed md5sum <em>even though</em> the uncompressed |
| 204 | source's md5 has already been verified.</p> |
209 | source's md5 has already been verified.</p> |
| 205 | </div> |
210 | </div> |
| 206 | <div class="section" id="the-proposed-solution"> |
211 | <div class="section" id="the-proposed-solution"> |
| 207 | <h4><a class="toc-backref" href="#id18" name="the-proposed-solution">The Proposed Solution</a></h4> |
212 | <h4><a class="toc-backref" href="#id19" name="the-proposed-solution">The Proposed Solution</a></h4> |
| 208 | <p>The creation of a clientside flatfile/db of valid alternate md5/size pairs |
213 | <p>The creation of a clientside flatfile/db of valid alternate md5/size pairs |
| 209 | would enable portage to handle perfectly reconstructed files, that have a |
214 | would enable portage to handle perfectly reconstructed files, that have a |
| 210 | different md5sum due to compression differences. The proposed format is thus:</p> |
215 | different md5sum due to compression differences. The proposed format is thus:</p> |
| 211 | <pre class="literal-block"> |
216 | <pre class="literal-block"> |
| 212 | MD5 md5sum orig-file size MD5 md5sum [ optional new-name ] size |
217 | MD5 md5sum orig-file size MD5 md5sum [ optional new-name ] size |
| … | |
… | |
| 233 | also.</p> |
238 | also.</p> |
| 234 | </div> |
239 | </div> |
| 235 | </div> |
240 | </div> |
| 236 | </div> |
241 | </div> |
| 237 | <div class="section" id="distfile-mirror-additions"> |
242 | <div class="section" id="distfile-mirror-additions"> |
| 238 | <h2><a class="toc-backref" href="#id19" name="distfile-mirror-additions">Distfile Mirror Additions</a></h2> |
243 | <h2><a class="toc-backref" href="#id20" name="distfile-mirror-additions">Distfile Mirror Additions</a></h2> |
| 239 | <p>One issue of contention is where these files will actually be stored. As of |
244 | <p>One issue of contention is where these files will actually be stored. As of |
| 240 | the writing of this glep, a full distfiles mirror is roughly around 40 gb- a |
245 | the writing of this glep, a full distfiles mirror is roughly around 40 gb- a |
| 241 | rough estimate by the author places the space requirements for patches for |
246 | rough estimate by the author places the space requirements for patches for |
| 242 | each version at a total of around 4gb. Note this isn't even remotely a hard |
247 | each version at a total of around 4gb. Note this isn't even remotely a hard |
| 243 | figure yet, and a better figure is being checked into currently.</p> |
248 | figure yet, and a better figure is being checked into currently.</p> |
| … | |
… | |
| 269 | <p>Of the options listed above, the first is the easiest, although the second |
274 | <p>Of the options listed above, the first is the easiest, although the second |
| 270 | could be made to work. Feedback and any possible alternatives would be |
275 | could be made to work. Feedback and any possible alternatives would be |
| 271 | greatly appreciated.</p> |
276 | greatly appreciated.</p> |
| 272 | </div> |
277 | </div> |
| 273 | <div class="section" id="patch-creation"> |
278 | <div class="section" id="patch-creation"> |
| 274 | <h2><a class="toc-backref" href="#id20" name="patch-creation">Patch Creation</a></h2> |
279 | <h2><a class="toc-backref" href="#id21" name="patch-creation">Patch Creation</a></h2> |
| 275 | <p>Maintenance of patch lists, and the actual patch creation ought to be managed |
280 | <p>Maintenance of patch lists, and the actual patch creation ought to be managed |
| 276 | by a high level script- essentally a dev says "I want a patch between this |
281 | by a high level script- essentally a dev says "I want a patch between this |
| 277 | version, and that version: make it so", the script churns away |
282 | version, and that version: make it so", the script churns away |
| 278 | creating/updating the patch list, and generating the patch locally. The |
283 | creating/updating the patch list, and generating the patch locally. The |
| 279 | utility next uploads the new patch to /space/distfiles-local on dev.gentoo.org |
284 | utility next uploads the new patch to /space/distfiles-local on dev.gentoo.org |
| … | |
… | |
| 286 | <p>The initial bulk of patches to get will be generated by the author, to ease |
291 | <p>The initial bulk of patches to get will be generated by the author, to ease |
| 287 | the transition and offer patches for people to test out.</p> |
292 | the transition and offer patches for people to test out.</p> |
| 288 | </div> |
293 | </div> |
| 289 | </div> |
294 | </div> |
| 290 | <div class="section" id="backwards-compatability"> |
295 | <div class="section" id="backwards-compatability"> |
| 291 | <h1><a class="toc-backref" href="#id21" name="backwards-compatability">Backwards Compatability</a></h1> |
296 | <h1><a class="toc-backref" href="#id22" name="backwards-compatability">Backwards Compatability</a></h1> |
| 292 | <p>As noted in <a class="reference" href="#the-proposed-solution">The Proposed Solution</a>, a system using patching and sharing out |
297 | <p>As noted in <a class="reference" href="#the-proposed-solution">The Proposed Solution</a>, a system using patching and sharing out |
| 293 | it's distfiles must share out it's alternate md5 db. Any system that uses the |
298 | it's distfiles must share out it's alternate md5 db. Any system that uses the |
| 294 | distfiles share must support the alternate md5 db also. If this is considered |
299 | distfiles share must support the alternate md5 db also. If this is considered |
| 295 | enough of an issue, it is conceivable to place reconstructed sources with an |
300 | enough of an issue, it is conceivable to place reconstructed sources with an |
| 296 | alternate md5 into a subdirectory of distdir- portage only looks within |
301 | alternate md5 into a subdirectory of distdir- portage only looks within |
| 297 | distdir, unwilling to descend into subdirectories.</p> |
302 | distdir, unwilling to descend into subdirectories.</p> |
| 298 | <p>Also note that <a class="reference" href="#distfile-mirror-additions">Distfile Mirror Additions</a> may add additional backwards |
303 | <p>Also note that <a class="reference" href="#distfile-mirror-additions">Distfile Mirror Additions</a> may add additional backwards |
| 299 | compatability issues, depending on what solution is accepted.</p> |
304 | compatability issues, depending on what solution is accepted.</p> |
| 300 | </div> |
305 | </div> |
| 301 | <div class="section" id="reference-implementation"> |
306 | <div class="section" id="reference-implementation"> |
| 302 | <h1><a class="toc-backref" href="#id22" name="reference-implementation">Reference Implementation</a></h1> |
307 | <h1><a class="toc-backref" href="#id23" name="reference-implementation">Reference Implementation</a></h1> |
| 303 | <p>TODO</p> |
308 | <p>TODO</p> |
| 304 | </div> |
309 | </div> |
| 305 | <div class="section" id="references"> |
310 | <div class="section" id="references"> |
| 306 | <h1><a class="toc-backref" href="#id23" name="references">References</a></h1> |
311 | <h1><a class="toc-backref" href="#id24" name="references">References</a></h1> |
| 307 | <table class="footnote" frame="void" id="id4" rules="none"> |
312 | <table class="footnote" frame="void" id="id4" rules="none"> |
| 308 | <colgroup><col class="label" /><col /></colgroup> |
313 | <colgroup><col class="label" /><col /></colgroup> |
| 309 | <tbody valign="top"> |
314 | <tbody valign="top"> |
| 310 | <tr><td class="label"><a class="fn-backref" href="#id1" name="id4">[1]</a></td><td><a class="reference" href="http://dev.gentoo.org/~ferringb/patches/kdelibs-3.1.4-3.1.5">http://dev.gentoo.org/~ferringb/patches/kdelibs-3.1.4-3.1.5</a>.{patch,diff}.bz2.</td></tr> |
315 | <tr><td class="label"><a class="fn-backref" href="#id1" name="id4">[1]</a></td><td><a class="reference" href="http://dev.gentoo.org/~ferringb/patches/kdelibs-3.1.4-3.1.5">http://dev.gentoo.org/~ferringb/patches/kdelibs-3.1.4-3.1.5</a>.{patch,diff}.bz2.</td></tr> |
| 311 | </tbody> |
316 | </tbody> |
| … | |
… | |
| 324 | (<a class="reference" href="http://glep.gentoo.org/glep-0009.html">http://glep.gentoo.org/glep-0009.html</a>)</td></tr> |
329 | (<a class="reference" href="http://glep.gentoo.org/glep-0009.html">http://glep.gentoo.org/glep-0009.html</a>)</td></tr> |
| 325 | </tbody> |
330 | </tbody> |
| 326 | </table> |
331 | </table> |
| 327 | </div> |
332 | </div> |
| 328 | <div class="section" id="copyright"> |
333 | <div class="section" id="copyright"> |
| 329 | <h1><a class="toc-backref" href="#id24" name="copyright">Copyright</a></h1> |
334 | <h1><a class="toc-backref" href="#id25" name="copyright">Copyright</a></h1> |
| 330 | <p>This document has been placed in the public domain.</p> |
335 | <p>This document has been placed in the public domain.</p> |
| 331 | </div> |
336 | </div> |
| 332 | </div> |
337 | </div> |
| 333 | |
338 | |
| 334 | <hr class="footer"/> |
339 | <hr class="footer" /> |
| 335 | <div class="footer"> |
340 | <div class="footer"> |
| 336 | <a class="reference" href="glep-0025.txt">View document source</a>. |
341 | <a class="reference" href="glep-0025.txt">View document source</a>. |
| 337 | Generated on: 2004-04-04 22:55 UTC. |
342 | Generated on: 2004-11-11 21:27 UTC. |
| 338 | Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source. |
343 | Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source. |
| 339 | </div> |
344 | </div> |
| 340 | </body> |
345 | </body> |
| 341 | </html> |
346 | </html> |
| 342 | |
347 | |