6 git-cvsserver - A CVS server emulator for git
12 export CVS_SERVER=git-cvsserver
13 'cvs' -d :ext:user@server/path/repo.git co <HEAD_name>
19 This application is a CVS emulation layer for git.
21 It is highly functional. However, not all methods are implemented,
22 and for those methods that are implemented,
23 not all switches are implemented.
25 Testing has been done using both the CLI CVS client, and the Eclipse CVS
26 plugin. Most functionality works fine with both of these clients.
30 Currently gitcvs only works over ssh connections.
35 1. Put server.pl somewhere useful on the same machine that is hosting your git repos
37 2. For each repo that you want accessible from CVS you need to edit config in
38 the repo and add the following section.
42 logfile=/path/to/logfile
44 n.b. you need to ensure each user that is going to invoke server.pl has
45 write access to the log file.
47 5. On each client machine you need to set the following variables.
48 CVSROOT should be set as per normal, but the directory should point at the
50 CVS_SERVER should be set to the server.pl script that has been put on the
53 6. Clients should now be able to check out modules (where modules are the names
55 $ cvs co -d mylocaldir master
60 All the operations required for normal use are supported, including
61 checkout, diff, status, update, log, add, remove, commit.
62 Legacy monitoring operations are not supported (edit, watch and related).
63 Exports and tagging (tags and branches) are not supported at this stage.
65 The server will set the -k mode to binary when relevant. In proper GIT
66 tradition, the contents of the files are always respected.
67 No keyword expansion or newline munging is supported.
72 git-cvsserver depends on DBD::SQLite.
77 This program is copyright The Open University UK - 2006.
79 Authors: Martyn Smith <martyn@catalyst.net.nz>
80 Martin Langhoff <martin@catalyst.net.nz>
81 with ideas and patches from participants of the git-list <git@vger.kernel.org>.
85 Documentation by Martyn Smith <martyn@catalyst.net.nz> and Martin Langhoff <martin@catalyst.net.nz>Matthias Urlichs <smurf@smurf.noris.de>.
89 Part of the gitlink:git[7] suite