Changes between Version 3 and Version 4 of SourceCodeGit

Timestamp:

Jul 20, 2012, 4:48:42 AM (13 years ago)

Author:

brevilo

Comment:

--

SourceCodeGit

@@ -50 +50 @@
   * Recommended free GUIs: [http://www.sourcetreeapp.com SourceTree], [http://gitx.laullon.com GitX] ([https://github.com/laullon/gitx latest])
 
-=== Cloning (checkout code) ===
+=== Read-only access (cloning / checkout code) ===
 
 In a shell/terminal, use the the following commands to clone the repository:
@@ -61 +61 @@
 Right-click on the parent directory, select 'Git Clone...',
 and fill in the dialog with one of the above URLs. There is no need to add 'git clone' in front of it. 
+
+=== Direct write access ===
+
+Note: you don't need direct write access to contribute code to BOINC. Given the [http://git-scm.com/about/distributed distributed nature] of git you can also publish your contributions elsewhere (e.g. on [https://github.com GitHub]) or send your patches via mail (using {{{git format-patch}}}).
+
+Direct write access to the official repositories in currently available via the SSH protocol (with public-key authentication). If you think you need direct write you should contact David Anderson and/or Rom Walton. They'll ask you for your public-key. Here's how you can create one and use it after you've been grated access to the repository:
+
+==== Windows users ====
+
+Please see [http://boinc.berkeley.edu/trac/wiki/SourceCodeGit/Windows this page] for details.
+
+==== !Linux/Mac OS X users ====
+
+ * General note: before you start, please check whether you already have an existing key at {{{~/.ssh/id_rsa}}}. If so, please choose a different key filename for the commands below! Alternatively, you could also reuse the existing key and continue with the final step.
+ * Note to Mac OS X users: if you prefer "Finder" over "Terminal" hit CMD+SHIFT+G in "Finder", then enter {{{~/.ssh}}} to go to that hidden folder.
+
+The following shell/terminal command will create a key pair that gets stored in your {{{~/.ssh}}} directory:
+ * Public key: {{{~/.ssh/id_rsa.pub}}}
+ * Private key: {{{~/.ssh/id_rsa}}}
+{{{
+ssh-keygen -t rsa 4096 -f ~/.ssh/id_rsa
+}}}
+
+If you had to use a different key filename because of an existing key that you don't want to overwrite or reuse, you can define a so called ssh host alias that allows you to specify which key to use when accessing the BOINC repo. In order to do so, add the following to {{{~/.ssh/config}}} (create the file if necessary), assuming that you created the ssh key as {{{~/.ssh/boinc-key}}}:
+{{{
+host boinc-git
+       Hostname isaac.ssl.berkeley.edu
+       Port 22
+       IdentityFile ~/.ssh/boinc-key
+       User gitolite
+}}}
+
+Now that you have the host alias defined you may access the repo using the alias in the clone URL (instead of the full user/hostname information):
+
+{{{
+git clone boinc-git:boinc.git
+}}}
+
+Finally, send the public key to David or Rom. Important: the private key should never leave your system! Keep it safe!
 
 === Windows build dependencies ===