New Project Participants

From Embedded Xinu
Revision as of 00:13, 21 September 2007 by Agember (talk | contribs) (Linked to wikipedia article on Subversion)
Jump to navigation Jump to search

This page contains details for newcomers to the XINU project who want to get started working in the lab and coding with XINU.

Subversion

The code for XINU is stored in a Subversion code repository.

In order to access the code you need to have your ssh public key registered with the 'svn' user. Please email or link to your public key to be added. If you do not yet have an ssh keypair, here is a document that explains the why and the how pretty well:

http://kb.iu.edu/data/aews.html

Once your key has been registered, you can do a test checkout with the following command:

svn co svn+ssh://svn@mulug.mscs.mu.edu/xinu-mips/trunk xinu

You can also switch an existing working copy with the following from your working copy's directory:

FROM=`svn info | grep ^URL | awk '{ print $2 }'`
svn switch --relocate $FROM svn+ssh://svn@mulug.mscs.mu.edu/xinu-mips/trunk
unset FROM

You will be asked for the passphrase that you specified for your private key every time you perform a svn command that needs the server. This is because svn is not locally caching your password in plaintext as it was before (no plaintext cache = better). I highly recommend using a memory-caching tool like ssh-agent to prevent having to repeatedly enter your passphrase.

Trac

Trac has several nice ways of visualizing activity in the Subversion repository, including a source code browser and a timeline. It also has a wiki, which I assume we'll mostly skip, and at it's center is an issue tracking system, which I suggest we consider as a way to consolidate our various and sundry todo lists.

http://xinu.mscs.mu.edu/trac/

As for user accounts on this guy, I have it set up to do mod_auth_digest right now, which means if you run the following command and email me the password file I can add you to the list of users:

htdigest -c <mypassfile> "Embedded XINU Trac Login" <username>

Then you go to /trac/login which will authenticate you, after which the site will recognize you as a logged-in user. Then you can edit wiki pages and create tickets and such.