global change from samba.anu.edu.au to samba.org
[samba.git] / docs / textdocs / CVS_ACCESS.txt
1 !==
2 !== CVS_ACCESS.txt for Samba release 2.0.0-beta1 13 Nov 1998
3 !==
4 Contributor:    Modified from the Web pages by Jeremy Allison.
5 Date:           23 Dec 1997
6 Status:         Current
7
8 How to get access to Samba source code via cvs.
9 ===============================================
10
11 CVS Access to samba.org
12 ------------------------------
13
14 The machine samba.org runs a publicly accessible CVS 
15 repository for access to the source code of several packages, 
16 including samba, rsync and jitterbug. This document describes 
17 how to get anonymous read-only access to this source code. 
18
19 Access via cvsweb
20 -----------------
21
22 You can access the source code via your favourite WWW browser. 
23 This allows you to access the contents of individual files in 
24 the repository and also to look at the revision history and 
25 commit logs of individual files. You can also ask for a diff 
26 listing between any two versions on the repository.
27
28 Use the URL : http://samba.org/cgi-bin/cvsweb
29
30 Access via cvs
31 --------------
32
33 You can also access the source code via a normal cvs client. 
34 This gives you much more control over you can do with the 
35 repository and allows you to checkout whole source trees 
36 and keep them uptodate via normal cvs commands. This is the 
37 preferred method of access if you are a developer and not
38 just a casual browser.
39
40 To download the latest cvs source code, point your
41 browser at the URL :
42
43 http://www.cyclic.com/
44
45 and click on the 'How to get cvs' link. CVS is free
46 software under the GNU GPL (as is Samba).
47
48 To gain access via anonymous cvs use the following steps. 
49 For this example it is assumed that you want a copy of the 
50 samba source code. For the other source code repositories 
51 on this system just substitute the correct package name
52
53 1. Install a recent copy of cvs. All you really need is a 
54   copy of the cvs client binary. 
55
56 2. Run the command 
57
58   cvs -d :pserver:cvs@samba.org:/cvsroot login
59
60 When it asks you for a password type 'cvs' (not including
61 the quotes).
62
63 3. Run the command 
64
65   cvs -d :pserver:cvs@samba.org:/cvsroot co samba
66
67 This will create a directory called samba containing the 
68 latest samba source code. This currently corresponds to the 
69 1.9.18alpha development tree. 
70
71 4. Whenever you want to merge in the latest code changes use 
72 the following command from within the samba directory: 
73
74   cvs update -d -P
75
76 NOTE: If you instead want the latest source code for the 
77 1.9.17 stable tree then replace step 4 with the command: 
78
79   cvs -d :pserver:cvs@samba.org:/cvsroot co -r BRANCH_1_9_17 samba
80
81 Access to the NT DOMAIN Controller code
82 ---------------------------------------
83
84 The Samba PDC code is being separately developed on a
85 branch named BRANCH_NTDOM. To gain access to the latest
86 source code (this changes daily) do the following:
87
88 1). Log onto cvs 
89
90   cvs -d :pserver:cvs@samba.org:/cvsroot login          
91   
92 When it asks you for a password type 'cvs' (not including
93 the quotes).
94
95 2). Check out the BRANCH_NTDOM by typing :
96
97   cvs -d :pserver:cvs@samba.org:/cvsroot co -r BRANCH_NTDOM samba
98
99 This will create a directory called samba containing the
100 latest snapshot of the domain controller code.
101
102 3). To keep this code up to date after it has been
103 changed in the cvs repository, cd into the samba
104 directory you created above and type :
105
106   cvs update -d -P
107
108 How it's done.
109 --------------
110
111 If you are interested in how anonymous cvs access is set up and 
112 want to set it up on your own system then you might like to checkout 
113 the pserver source code using the the command :
114
115  cvs -d :pserver:cvs@samba.org:/cvsroot co pserver
116
117 You really have to know what you are doing to do this. Please don't 
118 email samba-bugs with basic cvs or unix security questions. 
119
120 Reporting problems.
121 -------------------
122
123 If you have any problems with this system please email 
124 samba-bugs@samba.org.