]> git.decadent.org.uk Git - dak.git/blob - web/archive-criteria.html
Merge branch 'master' into content_generation
[dak.git] / web / archive-criteria.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="de" lang="de">
4   <head>
5     <meta http-equiv="content-type" content="text/xhtml+xml; charset=utf-8" />
6     <link type="text/css" rel="stylesheet" href="style.css" />
7     <link rel="shortcut icon" href="http://www.debian.org/favicon.ico" />
8     <title>
9       Debian Archive criteria
10     </title>
11   </head>
12   <body id="ARCHIVE">
13
14     <div id="logo">
15       <a href="http://www.debian.org/">
16         <img src="http://www.debian.org/logos/openlogo-nd-50.png"
17         alt="debian logo" /></a>
18       <a href="http://www.debian.org/">
19         <img src="http://www.debian.org/Pics/debian.png"
20         alt="Debian Project" /></a>
21     </div>
22     <div id="titleblock">
23
24       <img src="http://www.debian.org/Pics/red-upperleft.png"
25       id="red-upperleft" alt="corner image"/>
26
27       <img src="http://www.debian.org/Pics/red-lowerleft.png"
28       id="red-lowerleft" alt="corner image"/>
29       <img src="http://www.debian.org/Pics/red-upperright.png"
30       id="red-upperright" alt="corner image"/>
31       <img src="http://www.debian.org/Pics/red-lowerright.png"
32       id="red-lowerright" alt="corner image"/>
33       <span class="title">
34           Debian Archive criteria
35       </span>
36     </div>
37
38         <h2>Definitions</h2>
39     <table class="DEFINITION">
40           <thead>
41                 <tr>
42                   <th>&nbsp;</th>
43                   <th>Example</th>
44                 </tr>
45           </thead>
46       <tbody>
47                 <tr class="odd">
48                   <td>Architecture</td>
49                   <td>amd64, armel, alpha, m68k. Basically everything that uses
50     the Linux kernel.</td>
51                 </tr>
52                 <tr class="even">
53                   <td>OS</td>
54                   <td>hurd, opensolaris, kfreebsd. Ports that do not use the
55     Linux kernel, but their own.</td>
56                 </tr>
57           </tbody>
58         </table>
59
60         <p>
61         A new architecture has to follow the <em>Rules for new architectures</em>,
62         and answer all <em>Questions for new architectures</em>.
63         </p>
64         <p>
65         A new OS has to follow the <em>Rules for new architectures</em> and
66         answer all  <em>Questions for new architectures</em> as well as all
67         <em>Further questions for OSes</em>.
68         </p>
69
70         <p>To have the answers all at one location, please create a page below
71         <a href="http://wiki.debian.org/ArchiveQualification/">wiki.debian.org/ArchiveQualification/</a>.
72         </p>
73
74         <h1>Rules for existing architectures</h1>
75
76         <ul>
77           <li>If an architecture fails to be included in 2 successive
78           official releases, it is moved out of the official archive (and
79           away from the ftp-master.debian.org host).</li>
80
81           <li>If a removed architecture later can prove it will be able to
82           make the next official release, it can be re-included into the
83           official archive. This step additionally needs the acceptance of
84           the Security, the Release and the Debian Admin Team. (It needs
85           security autobuilders, porter machines, etc.)</li>
86         </ul>
87
88         <h1>Rules for new architectures</h1>
89         <ul>
90           <li>A newly included architecture has to be completely built using
91           packages available in plain Debian sources.  External patches cannot
92           be used.</li>
93
94           <li>At the time of inclusion a minimal set of binary packages will be
95           imported into the archive, just enough to get build-essential ready to
96           go and an official buildd setup and running. Everything else will be
97           rebuilt from scratch. As soon as enough is rebuilt to get the initial
98           toolchain built using "native" Debian, this will be rebuilt too.</li>
99
100           <li>The packages imported from external source and used for the initial
101           build run must be signed by one of the lead porters, who must be a DD.</li>
102
103           <li>There must be at least two machines ready to be maintained
104           by the Debian System Administrators, so at the start of its
105           lifetime there will be at least one buildd and one porter machine.<br />
106
107           The inclusion into the archive will almost certainly happen before
108           the machines are handed over to DSA, but this should happen as
109           soon as feasible afterwards.
110
111           (Note that this is the minimum to get into the archive. The release team
112           may have additional requirements to allow the architecture to release, so
113           there would normally need to be more machines, especially more
114           buildds.)<br />
115
116           <b>Note:</b> The machines, their setup and hosting etc should be
117           coordinated with DSA and needs to be acceptable to DSA. Please
118           <a href="mailto:debian-admin@lists.debian.org">coordinate with
119           them</a>, they might be able to help you in more ways
120           you can imagine, but at least they can help to avoid useless work
121           if a hosting wouldnt be acceptable. :)
122           </li>
123         </ul>
124
125         <h1>Questions for new architectures</h1>
126         <ul>
127           <!-- <li>Is port cursed?</li> -->
128           <li>Are machines available to buy for the general public?</li>
129           <li>Is full source available?</li>
130           <li>Is this architecture related to other architectures already in
131           the archive, or that also should be considered, either now or in
132           the future? Can the related architectures be supported in a single
133           architecture (eg, with a biarch arrangement)?</li>
134           <li>Are there 3 or more developers (or NMs) actively maintaining
135           the port? Who are they?</li>
136           <li>What sort of architecture is this? Desktop/workstation?
137           Mainframe/supercomputer? Embedded? Something else?</li>
138           <li>Does it have any users? If a desktop system, are there Debian
139           admins who run Debian systems on the arch? If an embedded system
140           are there real systems shipping that a Debian port will be useful
141           for? If a mainframe system are there real systems with many users
142           that a Debian port will be useful for? Who are they?</li>
143           <li>Is there kernel and toolchain support? At what level? Are the
144           latest versions supported, or are legacy releases required for
145           compatability with some hardware?</li>
146           <li>Has the ABI stabalised, or are there major ABI changes coming
147           up? Is the ABI stable enough to ensure users will be able just
148           "apt-get dist-upgrade" from one version to the next?</li>
149           <li>How do you install a system? (URL to a HOWTO)</li>
150           <li>Has a buildd been setup? How much of the archive has been
151           built (count by source package, builds of old versions are fine
152           for this case)?</li>
153           <li>What hardware is potentially available as a fast buildd?</li>
154           <li>Is there an example box developers can login to to see if it
155           works?</li>
156         </ul>
157
158         <p>It's also worth considering whether the port has any special
159         requirements. If the port is mainly for embedded systems, it may be
160         appropriate to have different installation or release arrangements
161         compared to normal desktop/workstation architectures.</p>
162
163         <h1>Further questions for OSes</h1>
164
165         <ul>
166           <li>Are there existing comprehensive free distributions of this OS? If
167           so, why is a Debian distribution useful?</li>
168           <li>What demonstrable benefits does this OS have over existing
169           Debian OSes?</li>
170           <li>Does this system have a standard Unix API?</li>
171           <li>Does the OS support modern glibc and gcc?</li>
172           <li>What is the license on the kernel and core libraries? Is the license
173           free? Is the license GPL compatible? (Note that if it's not free, distributing
174           the software violates the Social Contract; and if it's not GPL compatible,
175           GPL software such as dpkg can't be linked to it)</li>
176           <li>Does the OS build largely without source changes? If so, what proportion of
177           the archive has built?</li>
178         </ul>
179
180         <p>It's worth thinking about whether it makes sense to integrate the
181         port with Debian's Linux-based distribution -- having separate sources
182         may not only reduce the impact on the release architectures, but also
183         make it easier to do development on the new OS as well.</p>
184
185         <p>Note that if significant changes are needed to more than just a small
186         number of packages, your porting team will not only need to provide
187         patches for most of those changes and make sure they work, but also
188         ensure they don't cause problems for existing ports.</p>
189
190
191     <div class="footer">
192           <p>
193       <a href="http://validator.w3.org/check?uri=referer"><img src="http://www.w3.org/Icons/valid-xhtml10"
194         alt="Valid XHTML 1.0 Strict" height="31" width="88" /></a>
195       <a href="http://jigsaw.w3.org/css-validator/">
196         <img style="border:0;width:88px;height:31px" src="http://jigsaw.w3.org/css-validator/images/vcss"
197         alt="Valid CSS!" />
198       </a>
199       </p>
200     </div> </body> </html>