This is an old revision of the document!
EXTREMELY IMPORTANT: Do not upload non-Open Source software without special prior permission. This includes binaries of software intended to be Open Source for which source code isn't actually available yet. IN PARTICULAR, do not upload non-Open Source cryptographic software, or cryptographic binaries from source not available on the Internet, under any circumstances. This is absolutely essential.
You should have received a tarball containing the SSH private key to use for accessing your kernel.org account. Place that private key into your ~/.ssh
directory, e.g.:
cp korg-username ~/.ssh/id_rsa_korg
Add the following entry into your .ssh/config:
Host gitolite.kernel.org User git IdentityFile ~/.ssh/id_rsa_korg IdentitiesOnly yes
You can change this passphrase using ssh-keygen -p
. ALWAYS KEEP YOUR SSH KEY PROTECTED WITH A PASSPHRASE!
You can find the upstream documentation for gitolite at their website:
But you probably want to read their user doc section:
The basics however are straightforward. You have been automatically granted a wildcard space under pub/scm/linux/kernel/git/[username]/
To create a repository under there either push to the path you want or perform a git clone. Either of these will create the repository for you.
Example using "git clone":
git clone git@gitolite.kernel.org:pub/scm/linux/kernel/git/[username]/foobar
When cloning a tree that already exists on kernel.org, you will use the gitolite built in cloning system:
ssh git@gitolite.kernel.org fork pub/scm/from-repo pub/scm/to-repo
This will take care of the git clone, and uses Shared (-s), and Linked (-l) git options.
E.g. for Linux kernel you should start by forking Linus's repository:
ssh git@gitolite.kernel.org fork \ pub/scm/linux/kernel/git/torvalds/linux \ pub/scm/linux/kernel/git/[username]/linux
Some commands may be forgiving and work anyway, but many will not.
Note: This list may be incomplete. You can find out more up-to-date info about available commands if you run ssh git@gitolite.kernel.org help
.
Delete a repository. You will need to run D unlock
first, and then D rm
. E.g.:
ssh git@gitolite.kernel.org D unlock pub/scm/linux/kernel/git/[username]/linux ssh git@gitolite.kernel.org D rm pub/scm/linux/kernel/git/[username]/linux
Sets the repository description. E.g.:
ssh git@gitolite.kernel.org desc pub/scm/linux/kernel/git/[username]/linux "[username] kernel tree"
Note that the desc command does not like special characters such as quotes, ampersands, brackets, etc.
Clone a repository that is already hosted by kernel.org, E.g.:
ssh git@gitolite.kernel.org fork pub/scm/repo1 pub/scm/repo2
Displays a help message for what commands are enabled
displays the permissions you have to various repos (warning: wall of text)
Sets up a random password you can use to authenticate against mail.kernel.org in order to send outgoing mail. The command output will also give you some configuration examples for mutt and git.