Download coreboot: Difference between revisions

From coreboot
Jump to navigation Jump to search
(Replaced content with "{{#externalredirect: https://doc.coreboot.org/distributions.html}}")
 
(87 intermediate revisions by 16 users not shown)
Line 1: Line 1:
= GNU Arch Repository =
{{#externalredirect: https://doc.coreboot.org/distributions.html}}
 
LinuxBIOS keeps its development tree in a [http://www.gnuarch.org/ GNU arch] repository. You may need to install GNU arch to be able to download the latest tree. You can find a tar of GNU arch at ftp://ftp.gnu.org/pub/gnu/gnu-arch/.
 
If you do not want to use GNU arch, please have a look at the Snapshots section
 
== Anonymous access ==
 
You can check it out as follows (instead of tla you can also use baz):
 
<code><pre>
  % # get gpg key for checking signed archives
  % wget \
      http://wiki.linuxbios.org/data/arch/linuxbios-developers-keyring.gpg
  % gpg --import < linuxbios-developers-keyring.gpg
  % # now do some one time registrations
  % tla my-id "John Doe <doe@example.com>" # Add your email address here
  % tla register-archive \
        ftp://openbios.org/pub/arch/linuxbios@linuxbios.org--devel
  % # now check out the archive
  % tla get linuxbios@linuxbios.org--devel/freebios--devel--2.0 freebios2
</pre></code>
 
== Developer Access ==
 
=== Prerequisites ===
If you want to get write access to the LinuxBIOS repository, you need the following:
 
* GnuPG key (can be created with gpg --gen-key)
* SSH v2 key (can be created with ssh-keygen -t dsa)
 
=== Gentoo users ===
 
If you are running Gentoo you are going to need to `emerge tla`
 
=== Preparation ===
 
* Get the arch key I created for the import from CVS.
 
  $ wget 'http://wiki.linuxbios.org/data/arch/linuxbios-developers-keyring.gpg'
  $ gpg --import linuxbios-developers-keyring.gpg
 
*  Prepare GNU arch for LinuxBIOS
 
  # Set your default id:
  $ tla my-id "John Doe <doe@example.com>"
 
  # similar to cvs login, tell gnuarch where to find the archive:
  $ tla register-archive sftp://lxbios@openbios.org/srv/arch/linuxbios@linuxbios.org--devel
 
  # prepare gnupg signature checking:
  $ mkdir -p ~/.arch-params/signing
  $ echo "gpg --clearsign" > ~/.arch-params/signing/\=default
  $ echo "gpg --verify-files -" > ~/.arch-params/signing/\=default.check
 
=== Check out ===
 
  $ tla get linuxbios@linuxbios.org--devel/freebios--devel--2.0 freebios2
 
=== Working on the tree ===
 
Now you can start editing the files. The following applies for symlinks and directories as well.
 
*  New files are added with
  $ tla add filename
 
* files can also be renamed using:
  $ tla mv fileA fileB
 
* files can also be renamed using:
  $ tla mv fileA fileB
 
* files can be deleted:
  $ tla rm file
 
When you're done editing/patching:
 
* Look at your changes:
  $ tla changes
or
  $ tla changes --diffs
 
* Check the tree:
 
You can do consistency checks on your tree with:
  $ tla tree-lint
  $ tla inventory -Bu
 
Check if your tree is current:
  $ tla missing
 
This will output a list of missing changesets in your local tree, ie:
 
  patch-15
  patch-16
  patch-17
  patch-18
 
In which case you should do a
  $ tla update
before you commit.
 
=== Commiting ===
 
Write a changelog. PLEASE DO NOT CREATE EMPTY CHANGELOG MESSAGES:
  $ $EDITOR $( tla make-log )
 
Commit your local tree
  $ tla commit
 
This will ask you for your gpg passphrase (and possibly your ssh key
password if you set one). Then it will create a new revision in the
repository.
 
== Source code browsing ==
 
You can also [http://www.openbios.org/cgi-bin/viewarch.cgi/linuxbios@linuxbios.org--devel browse the LinuxBIOS arch repository online].
 
See more repositories at http://www.openbios.org/cgi-bin/viewarch.cgi
 
== Snapshots ==
 
There is an archive of snapshots available at snapshots.linuxbios.org. There is a .bz2 tar file that gets updated when the repository changes. Older snapshots are maintained as well.
 
* [http://snapshots.linuxbios.org/ Download snapshots]
 
 
 
== Mirroring the repository ==
 
This is very simple. Do:
 
  wget -m ftp://ftp.openbios.org/pub/arch
 
Which gives you a snapshot in time of the archive.
To create a mirror usable by arch:
 
  tla register-archive linuxbios@linxubios.org--devel-SOURCE ftp://openbios.org/pub/arch/linuxbios@linuxbios.org--devel                                                         
  tla register-archive linuxbios@linuxbios.org--devel ~/{archives}/linuxbios@linuxbios.org--devel
                                                                                                                                                                                                                                                                                                                                                           
  echo gpg --clearsign > ~/.arch-params/signing/=default
  echo gpg --verify-files - > ~/.arch-params/signing/=default.check
  echo linuxbios@linuxbios.org--devel--SOURCE > ~/.arch-params/signing/linuxbios@linuxbios.org--devel
 
To update the mirror with the most recent contents:
  tla archive-mirror linuxbios@linuxbios.org --devel
 
Just don't do this in an account where you plan to commit to the upstream
archive.
 
== Creating a branch you can edit in local archive ==
 
  tla tag -S linuxbios@linuxbios.org--devel/freebios--devel--2.0 you@yourarchive/freebios--devel--2.0
 
== More on tla ==
 
* http://www.openbios.org/experience/gnuarch.html
* http://wiki.gnuarch.org/

Latest revision as of 12:10, 8 February 2019

This page redirects to an external site: https://doc.coreboot.org/distributions.html