summaryrefslogtreecommitdiffstats
path: root/site/download/index.php
blob: 3e50b404cae3faaadd6f7e3773cce4d25751a278 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
<?php
/*
    Download page
    Copyright (C) 2015  Francis Rowe <info@gluglug.org.uk>

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU Affero General Public License as
    published by the Free Software Foundation, either version 3 of the
    License, or (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU Affero General Public License for more details.

    You should have received a copy of the GNU Affero General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
*/
?>
<?php
	include_once "../variables.php";
	include_once "../functions.php";
?>
<!DOCTYPE html>
<html>
<head>
	<meta charset="utf-8">
	<meta name="viewport" content="width=device-width, initial-scale=1">

<style type="text/css">
<?php include "../css/main.css"; ?>
</style>

	<title><?php echo gettext("Download libreboot"); ?></title>

</head>

<body>

	<div class="c">

		<div id="libreboot" class="s">
				
			<h1><?php echo gettext("Download libreboot"); ?></h1>

				<p><?php echo gettext("Links to HTTP mirrors, rsync mirrors and git repositories. Download libreboot here."); ?></p>

				<ul class="l">
					<li><a href="#archives"><?php echo gettext("Archived releases"); ?></a></li>
					<li><a href="#mirror"><?php echo gettext("Rsync mirrors"); ?></a></li>
					<li><a href="#git"><?php echo gettext("Git repositories (development)"); ?></a></li>
				</ul>
				
				<p>
					<a href="../"><?php echo gettext("Back to home page"); ?></a>
				</p>

		</div>
		
		<div class="s" id="gpg">
			
			<h1 id="gpg"><?php echo gettext("GPG signing key"); ?></h1>

				<p>
					<?php echo $lbProjectGpgKeyInfo; ?>
				</p>
				<p>
					<?php echo gettext("Download the key:"); ?><br/>
					$ <b>gpg --recv-keys <?php echo $lbProjectGpgKeyID; ?></b>
				</p>
				
				<p>
					<?php echo gettext("Download the SHA512 manifest and its corresponding GPG signature for the release that you are using, and put them in a directory."); ?>
					<?php echo gettext("Put the src, util and docs archives in the root of that directory, alongside the SHA512 manifest file."); ?>
					<?php echo gettext("Put your ROM image archives under <i>rom/</i> in that directory."); ?>
					<?php echo gettext("Put your crossgcc tarballs under <i>crossgcc/</i> in that directory."); ?>
				</p>
				<p>
					<?php echo gettext("After you've done this, verify the SHA512 checksums:"); ?><br/>
					$ <b>sha512sum -c sha512sum.txt</b>
				</p>
				<p>
					<?php echo gettext("You can verify the downloaded SHA512 manifest as follows:"); ?><br/>
					$ <b>gpg --verify sha512sum.txt.sig</b>
				</p>
		
		</div>
		
		<div class="s" id="archives">
		
			<h1><?php echo gettext("Archived releases"); ?></h1>
			
				<p>
					<?php echo gettext("These releases are more rigorously tested."); ?>
					<?php echo gettext("However, they might be out of date compared to the current development snapshots."); ?>
				</p>
				<p>
					<?php echo gettext("These archives are not updated very often, and will not receive any further changes."); ?>
				</p>

				<p>
					<?php echo gettext("Download libreboot from one of these mirrors."); ?>
				</p>
				
				<p>
					<b>
						<?php echo gettext("The latest release is:"); ?> <?php echo $lbRelease[0][0][0]; ?>.
						<?php echo gettext("Release date:"); ?> <?php echo $lbRelease[0][0][1]; ?>.
					</b>
				</p>

				<h2 id="http">HTTP mirrors</h2>
				
<?php
					/* show HTTP mirrors */
					echo list_items($lbHttpMirror, gettext("HTTP mirrors not added yet."),0,count($lbHttpMirror));
?>
				<h2 id="ftp">FTP mirrors</h2>
<?php
					/* show HTTP mirrors */
					echo list_items($lbFtpMirror,gettext("FTP mirrors not added yet."),0,count($lbFtpMirror));
?>
				

				<h2 id="mirror"><?php echo gettext("Rsync mirrors (for mirroring libreboot)"); ?></h2>
					<p>
						<?php echo gettext("Create a directory in your web server document root (e.g. libreboot/), and add one of these to your crontab:"); ?>
					</p>
<?php

	if (count($lbRsyncServer)>0) {
?>
					<h3><?php echo gettext("Main rsync mirror:"); ?></h3>
						<p>
							$ <b>rsync -avxP --delete --stats <?php echo $lbRsyncServer[0]; ?> /path/to/docroot/libreboot/</b>
						</p>
<?php
		if(count($lbRsyncServer)>1) {
?>
					<h3><?php echo gettext("Backup rsync mirrors:"); ?></h3>
						<p>
<?php
			for ($server=1; $server<count($lbRsyncServer); $server++) {
?>
							$ <b>rsync -avxP --delete --stats <?php echo $lbRsyncServer[$server]; ?> /path/to/docroot/libreboot/</b><br/>
<?php
			}
?>
						</p>
<?php
		}
	} else {
?>
					<p>
						<b><?php echo gettext("No mirrors available yet."); ?></b>
					</p>
<?php
	}
?>

					<p>
						<?php echo gettext("Are you running a mirror? Contact the libreboot project (details are on the home page), and the link will be added here."); ?>
					</p>
	
		</div>
		
		<div class="s" id="git">
		
			<h1><?php echo gettext("Git repositories (development)"); ?></h1>
			
				<p>
					<?php echo gettext("The git repositories are intended for developing libreboot."); ?>
					<?php echo gettext("For a list of current tasks in libreboot, see:"); ?> <a href="../docs/tasks.html">../docs/tasks.html</a>.
				</p>
				
				<p>
					<?php echo gettext("Maintenance guides for libreboot can be found at <a href=\"../docs/maintain/index.html\">../docs/maintain/index.html</a> and <a href=\"../docs/git/index.html\">../docs/git/index.html</a>."); ?>
				</p>

				<h2><?php echo gettext("How to download"); ?></h2>
					<p>
						<?php echo gettext("Firmware (coreboot distribution). <i>This also contains the documentation</i>:"); ?><br/>
						$ <b>git clone <a href="<?php echo $lbFirmwareGitwebAddress; ?>"><?php echo $lbFirmwareGitRepoAddress; ?></a></b>
					</p>
					<p>
						<?php echo gettext("Libreboot website. <i>The documentation is in the other repository linked above</i>:"); ?><br/>
						$ <b>git clone <a href="<?php echo $lbWebsiteGitwebAddress; ?>"><?php echo $lbWebsiteGitRepoAddress; ?></a></b>
					</p>
					<p>
						<?php echo gettext("You might not see a progress bar; it's still cloning, so just be patient."); ?>
					</p>
					<ul class="l">
						<li><a href="http://projects.mtjm.eu/projects/libreboot"><?php echo gettext("Bug tracker"); ?></a></li>
					</ul>
					
				<h2 id="contrib"><?php echo gettext("Submitting patches to libreboot"); ?></h3>
					<p>
						<?php echo gettext("The <a href=\"http://git-scm.com/doc\">git documentation</a> describes how to use git."); ?>
					</p>
					<p>
						<?php echo gettext("Make sure that you configured git so that your name and email address appear in the commits that you create:"); ?><br/>
						$ <b>git config --global user.name &quot;Your Name&quot;</b><br/>
						$ <b>git config --global user.email your@emailaddress.com</b>
					</p>
					<p>
						<?php echo gettext("The following is also useful:"); ?><br/>
						$ <b>git config --global core.editor nano</b><br/>
						$ <b>git config --global color.status auto</b><br/>
						$ <b>git config --global color.branch auto</b><br/>
						$ <b>git config --global color.interactive auto</b><br/>
						$ <b>git config --global color.diff auto</b>
					</p>
					<p>
						<?php echo gettext("Clone the git repository, and make your desired changes."); ?>
						<?php echo gettext("You can make one or several commits (as many as you like)."); ?>
						<?php echo gettext("Generally speaking, you should create separate commits on top of each other, for each kind of change."); ?>
					</p>
					<p>
						<?php echo gettext("Once you have made your change(s), you can use this to check the status:"); ?><br/>
						$ <b>git status</b>
					</p>
				</div>
					
				<div class="s">
					
					<p>
						<?php echo gettext("If you are modifying an existing file, make sure to update the copyright license header in that file; in source files or scripts, this would usually be at the top, and for documentation it is typically at the bottom of the document. It is good practise to use your real name in the commit logs."); ?><br/>
						<?php echo gettext("Example: <i>Copyright (C) 20XX John Doe &lt;john@doe.com&gt;</i>"); ?>
					</p>
					<p>
						<?php echo gettext("Generally speaking, using the same license as the file that you are modifying is much simpler."); ?>
						<?php echo gettext("If you are submitting new files, please make sure that they are under a free license (copyleft preferred)."); ?>
						<?php echo gettext("You can find a list on:"); ?>
						<a href="https://www.gnu.org/licenses/license-list.html">https://www.gnu.org/licenses/license-list.html</a>.
					</p>
					<p>
						<i>
							<?php echo gettext("The libreboot project will not accept documentation released under the <u>GNU Free Documentation License</u>, because we do not want to endorse or support the Invariant clauses that this license allows. Changes submitted under this license will be rejected, even if it contains no Invariant sections."); ?>
						</i>
					</p>
					
				</div>
					
				<div class="s">
						
					<p>
						<?php echo gettext("The status command will show any untracked files that you have. Add them using <b>git add path/to/file</b>. You should also add any other files that are listed as modified in the git status. If there are deleted files in the git status, you can use <b>git rm path/to/file</b>. As long as you have added all the untracked files, it is generally easier to use:"); ?><br/>
						$ <b>git commit -a</b><br/>
						<?php echo gettext("(instead of <b>git commit</b>)"); ?>
					</p>
					<p>
						<?php echo gettext("If you need to make a change to the current commit, you can do so with:"); ?><br/>
						$ <b>git commit --amend</b><br/>
						<?php echo gettext("or:"); ?><br/>
						$ <b>git commit -a --amend</b>
					</p>
					<p>
						<?php echo gettext("In your local git tree, you can use this to check your commits:"); ?><br/>
						$ <b>git log</b>
					</p>
					<p>
						<?php echo gettext("Shortened git logs showing the short commit ID and the commit title, plus info about what branch you are on, and where all your remotes/heads are:"); ?><br/>
						$ <b>git config --global --add alias.lol &quot;log --graph --decorate --pretty=oneline --abbrev-commit --all&quot;</b><br/>
						<?php echo gettext("From then on, you can use:"); ?><br/>
						$ <b>git lol</b><br/>
						<?php echo gettext("This is like <b>git log</b>, but on steroids."); ?>
					</p>
					<h3><?php echo gettext("Method 1: host a repository"); ?></h3>
						<p>
							<?php echo gettext("One way of contribiting a patch for review is to host a repository containing your modified branch. Give the checkout details to the libreboot project, along with information on which commits in what branch contain your changes. Contact the libreboot project using the details on the home page."); ?>
						</p>
					<h3><?php echo gettext("Method 2: git format-patch -N"); ?></h3>
						<p>
							<?php echo gettext("Use this method (replace N with the number of commits that you made) and send the .patch files to the libreboot project, along with details on what branch and revision these were made on top of. Contact the libreboot project using the details on the home page."); ?>
						</p>
					
				<h2 id="gitbackup"><?php echo gettext("Backup repositories"); ?></h2>
					<p>
						<?php echo gettext("Generally speaking, you should use the main repositories. These repositories are provided as backups, in case the main repositories are down."); ?>
					</p>
					
					<h3><?php echo gettext("Firmware (coreboot distribution)"); ?></h3>
						<p>
<?php
	for ($server=0; $server<count($lbFirmwareBackupGitRepoAddress); $server++) {
?>
							$ <b>git clone <?php echo $lbFirmwareBackupGitRepoAddress[$server]; ?></b>
							<?php if ($server!=count($lbFirmwareBackupGitRepoAddress)-1) echo "<br/>"; ?>
<?php
	}
?>
						</p>

					<h3><?php echo gettext("Libreboot website"); ?></h3>
						<p>
<?php
	for ($server=0; $server<count($lbWebsiteBackupGitRepoAddress); $server++) {
?>
							$ <b>git clone <?php echo $lbWebsiteBackupGitRepoAddress[$server]; ?></b>
							<?php if ($server!=count($lbWebsiteBackupGitRepoAddress)-1) echo "<br/>"; ?>
<?php
	}
?>
						</p>
		
		</div>

		<div class="s" id="trisquel">

			<p>
				<?php echo gettext("Libreboot includes statically linked executables of utilities built from the libreboot source code. These are built on in Trisquel GNU/Linux. There were links to the Trisquel source ISO here, as a lazy way to provide CCS, but this was inefficient. Archives for only those dependencies that comprise the CCS will be added here later instead. If you need CCS, for now simply contact the libreboot project using the details on the home page, and the source for the version of Trisquel used to build that release (whichever version it is) will be provided. You can also get it on the Trisquel website."); ?>
			</p>

		</div>

<?php
	include "../footer.php";
?>
	
	</div>

</body>
</html>