<?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"> <link rel="stylesheet" type="text/css" href="../css/main.css" /> <title>Download <?php echo $lbProjectName; ?></title> </head> <body> <div class="contain"> <div id="libreboot" class="section intro"> <h1>Download <?php echo $lbProjectName; ?></h1> <p>Links to HTTP mirrors, rsync mirrors and git repositories. Download libreboot here.</p> <ul class="ulnav"> <li><a href="#http">HTTP mirrors</a></li> <li><a href="#mirror">Rsync mirrors</a></li> <li><a href="#git">Git repositories (development)</a></li> </ul> <p> <a href="../">Back to home page</a> </p> </div> <div class="section" id="gpg"> <h1 id="gpg">GPG signing key</h1> <p> <?php echo $lbProjectGpgKeyInfo; ?> </p> <p> Download the key:<br/> $ <b>gpg --recv-keys <?php echo $lbProjectGpgKeyID; ?></b> </p> <p> Download the SHA512 manifest and it's corresponding GPG signature for the release that you are using, and put them in a directory. Put the src, util and docs archives in the root of that directory, alongside the SHA512 manifest file. Put your ROM image archives under <i>rom/</i> in that directory. Put your crossgcc tarballs under <i>crossgcc/</i> in that directory. </p> <p> After you've done this, verify the SHA512 checksums:<br/> $ <b>sha512sum -c sha512sum.txt</b> </p> <p> You can verify the downloaded SHA512 manifest as follows:<br/> $ <b>gpg --verify sha512sum.txt.sig</b> </p> </div> <div class="section" id="http"> <h1>HTTP mirrors (releases)</h1> <p> These releases are more rigorously tested. However, they might be out of date compared to the current development snapshots. </p> <p> These archives are not updated very often, and will not receive any further changes. </p> <p> Download <?php echo $lbProjectName; ?> from one of these mirrors. </p> <p> <b> The latest release has a version number of <?php echo $lbRelease[0][0][0]; ?>, and was released on <?php echo $lbRelease[0][0][1]; ?>. </b> </p> <?php /* show HTTP mirrors */ echo list_items($lbHttpMirror,"HTTP mirrors not added yet.",0,count($lbHttpMirror)); ?> <h2 id="ftp">FTP mirrors</h2> <?php /* show HTTP mirrors */ echo list_items($lbFtpMirror,"FTP mirrors not added yet.",0,count($lbFtpMirror)); ?> <h2 id="mirror">Rsync mirrors (for mirroring <?php echo $lbProjectName; ?>)</h2> <p> Create a directory in your web server document root (e.g. <?php echo $lbProjectName; ?>/), and add one of these to your crontab: </p> <?php if (count($lbRsyncServer)>0) { ?> <h3>Main rsync mirror:</h3> <p> $ <b>rsync -avxP --delete --stats <?php echo $lbRsyncServer[0]; ?> /path/to/docroot/<?php echo $lbProjectName; ?>/</b> </p> <?php if(count($lbRsyncServer)>1) { ?> <h3>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/<?php echo $lbProjectName; ?>/</b><br/> <?php } ?> </p> <?php } } else { ?> <p> <b>No mirrors available yet.</b> </p> <?php } ?> <p> Are you running a mirror? Contact the <?php echo $lbProjectName; ?> project (details are on the <a href="../">home page</a>), and the link will be added here. </p> </div> <div class="section" id="git"> <h1>Git repositories (development)</h1> <p> The git repositories are intended for developing <?php echo $lbProjectName; ?>. For a list of current tasks in <?php echo $lbProjectName; ?>, see <a href="../docs/tasks.html">../docs/tasks.html</a>. </p> <p> Maintenance guides for <?php echo $lbProjectName; ?></php></php> 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>How to download</h2> <p> 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 $lbProjectNameCapitalized ?> 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> You might not see a progress bar; it's still cloning, so just be patient. </p> <ul class="ulnav"> <li><b><a href="../github/">Please do not use GitHub!</a></b></li> <li><b><a href="../gitorious/">Please do not use Gitorious/GitLab!</a></b></li> <li><a href="http://projects.mtjm.eu/projects/libreboot">Bug tracker</a></li> </ul> <h2 id="contrib">Submitting patches to <?php echo $lbProjectName; ?></h3> <p> The <a href="http://git-scm.com/doc">git documentation</a> describes how to use git. </p> <p> 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 "Your Name"</b><br/> $ <b>git config --global user.email your@emailaddress.com</b> </p> <p> 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> Clone the git repository, and make your desired changes. You can make one or several commits (as many as you like). Generally speaking, you should create separate commits on top of each other, for each kind of change. </p> <p> Once you have made your change(s), you can use this to check the status:<br/> $ <b>git status</b> </p> <div class="subsection"> <p> 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/> Example: <i>Copyright (C) 20XX John Doe <john@doe.com></i> </p> <p> Generally speaking, using the same license as the file that you are modifying is much simpler. If you are submitting new files, please make sure that they are under a free license (copyleft preferred). 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> The <?php echo $lbProjectName; ?> 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> <p> 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/> (instead of <b>git commit</b>) </p> <p> If you need to make a change to the current commit, you can do so with:<br/> $ <b>git commit --amend</b><br/> or:<br/> $ <b>git commit -a --amend</b> </p> <p> In your local git tree, you can use this to check your commits:<br/> $ <b>git log</b> </p> <p> 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 "log --graph --decorate --pretty=oneline --abbrev-commit --all"</b><br/> From then on, you can use:<br/> $ <b>git lol</b><br/> This is like <b>git log</b>, but on steroids. </p> <h3>Method 1: host a repository</h3> <p> One way of contribiting a patch for review is to host a repository containing your modified branch. Give the checkout details to the <?php echo $lbProjectName; ?> project, along with information on which commits in what branch contain your changes. Contact the <?php echo $lbProjectName; ?> project using the details on the <a href="../">home page</a>. </p> <h3>Method 2: git format-patch -N</h3> <p> Use this method (replace N with the number of commits that you made) and send the .patch files to the <?php echo $lbProjectName; ?> project, along with details on what branch and revision these were made on top of. Contact the <?php echo $lbProjectName; ?> project using the details on the <a href="../">home page</a>. </p> <h2 id="gitbackup">Backup repositories</h2> <p> Generally speaking, you should use the main repositories. These repositories are provided as backups, in case the main repositories are down. </p> <h3>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 $lbProjectNameCapitalized; ?> 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="section" id="trisquel"> <p> Libreboot includes statically linked executables of utilities built from the libreboot source code. These are built on in <a href="https://trisquel.info/">Trisquel GNU/Linux</a>. 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> <div class="section footer"> <?php include "../footer.php"; ?> </div> </div> </body> </html>