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