How to set up a shared repository

Hi,

I installed a shared git repository in the last few days and this is the 
result. May it be useful!

Ciao,
Dscho

---

[Note: this text assumes you have applied the core.umask patch]

So, there you are. You know CVS (or at least its concepts), and you want 
to set up a shared repository.

A. Setting up the umask

1. Separate repository box

If you are lucky enough that you can afford a separate machine for the 
shared repository: Good. Just make sure that the umask is set group 
friendly, either by ensuring that (assuming the login shell is bash) 
$HOME/.bash_profile contains the line

	umask 0002

or by using git-shell, which you have modified by inserting

	umask(0002);

at the start of main().

2. Some server accessible by ssh

If there are valid reasons not to set umask (maybe you want to allow other 
uses of that machine), or if you just do not want to go through the hassle 
to find out which scripts your login shell executes at startup, you just 
have to

	git-repo-config core.umask 0002


B. Making sure the index is not corrupted by a push

1. No checkout!

You can use the shared repository just like you use CVS: no working 
directory. To disallow a checkout, just do

	touch .git/index
	chmod a-rwx .git/index

Every attempt to modify the index (which is invalid), will now result in 
an error.

2. Ensure index and working directory consistency (no locking)

If you want to be able to work on the project in the shared repository, 
create hooks, as follows:

	test -d .git/hooks || mkdir .git/hooks

	cat > .git/hooks/update << EOF
	#!/bin/sh
	
	# if the working directory contains modifications, do not allow push
	HEAD=$(git-symbolic-ref HEAD)
	case "$1" in
	$HEAD)
	        unset GIT_DIR
	        cd .. && test -z "$(git-diff-index --name-only HEAD)";;
	esac
	EOF

	chmod a+x .git/hooks/update

	cat > .git/hooks/post-update << EOF
	#!/bin/sh
	
	# checkout HEAD, and build
	HEAD=$(git-symbolic-ref HEAD)
	case "$1" in
	$HEAD)
	        unset GIT_DIR
		umask 0002
		cd .. && git checkout -f HEAD && make;;
	esac
	EOF

	chmod a+x .git/hooks/post-update

This assumes that your project contains a Makefile, and that the tools
necessary to build are installed on the repository server.

Note that I did not check if a push locks another push.