cvs.html

   1 <!--#include virtual="/samba/header.html" -->
   2
   3 <h2>CVS Access to pserver.samba.org</h2>
   4
   5
   6 <H1>samba development changed to subversion</H1>
   7
   8 In April Samba development changed from using CVS to Subversion for
   9 version control. Please see the <a href="/samba/subversion.html">subversion
  10 information</a> for details.
  11
  12 <H2>Overview</H2>
  13
  14 The machine pserver.samba.org runs a publicly accessible CVS
  15 repository for access to the source code of several packages.  This
  16 document describes how to get anonymous read-only access to this
  17 source code.
  18
  19
  20 <H3>Web access to the source</H3>
  21
  22 <H4>Build Farm - Recent Checkins</H4>
  23 The Samba <a href="http://build.samba.org">build farm</a> provides access to the recent checkins on the
  24 <a href="http://build.samba.org/?&tree=samba_2_2&function=Recent+Checkins">samba_2_2</a>,
  25 <a href="http://build.samba.org/?&tree=samba_3_0&function=Recent+Checkins">samba_3_0</a>
  26 and
  27 <a href="http://build.samba.org/?&tree=samba&function=Recent+Checkins">HEAD</a>
  28 branches..
  29
  30 <H4>CVSweb</H4>
  31 <p>You can access the source code via your favourite WWW browser. This
  32 allows you to access the contents of individual files in the
  33 repository and also to look at the revision history and commit logs of
  34 individual files. You can also ask for a diff listing between any two
  35 versions on the repository.</p>
  36
  37 To access CVS via cvsweb click <A HREF="http://cvs.samba.org/cgi-bin/cvsweb/">here</A>.
  38
  39 <H3>Access via cvs</H3>
  40
  41 You can also access the source code via a normal cvs client. This
  42 gives you much more control over you can do with the repository and
  43 allows you to checkout whole source trees and keep them uptodate via
  44 normal cvs commands. This is the preferred method of access if you are
  45 a developer and not just a casual browser.<p>
  46
  47 To gain access via anonymous cvs use the following steps. For this
  48 example I will assume that you want a copy of the samba source
  49 code. For the other source code repositories on this system just
  50 substitute the correct package name<p>
  51
  52 <OL>
  53
  54 <LI> Install a recent copy of cvs. All you really need is a copy
  55 of the cvs client binary.</LI>
  56
  57 <LI> run the command
  58 <blockquote><tt>
  59         cvs -d :pserver:cvs@pserver.samba.org:/cvsroot login
  60 </tt></blockquote></LI>
  61
  62 <LI> when it asks you for a password type <it>cvs</it> </LI>
  63
  64 <LI> run the command
  65 <blockquote><tt>
  66         cvs -z5 -d :pserver:cvs@pserver.samba.org:/cvsroot co samba
  67 </tt></blockquote>
  68
  69 This will create a directory called samba containing the latest samba
  70 source code.  This corresponds to the HEAD development branch.
  71 <p>
  72 If you want a different branch use the -r option to the co command to
  73 specify the branch. For example to checkout the SAMBA_2_2 branch run the
  74 command
  75
  76 <blockquote><tt>
  77         cvs -z5 -d :pserver:cvs@pserver.samba.org:/cvsroot co -r SAMBA_2_2 samba
  78           </tt></blockquote>
  79 If you want the latest 3.0 development code, use the SAMBA_3_0 tag.
  80 <blockquote><tt>
  81         cvs -z5 -d :pserver:cvs@pserver.samba.org:/cvsroot co -r SAMBA_3_0 samba
  82           </tt></blockquote>
  83
  84
  85 </LI>
  86
  87 <LI> Whenever you want to merge in the latest code changes use the following
  88 command from within the samba directory:
  89 <blockquote><tt>
  90         cvs update -d -P
  91           </tt></blockquote>
  92       </LI>
  93
  94 </OL>
  95
  96 NOTE: The Samba TNG project is now a separate development effort apart from
  97 the main Samba branch (not just another CVS code branch).  For the latest Samba
  98 TNG code, please refer to <a href="http://www.samba-tng.org/">http://www.samba-tng.org</a>.
  99
 100 <h3>Converting from cvs.samba.org</h2>
 101
 102 Anonymous access to the Samba cvs tree used to be via the host
 103 cvs.samba.org. That host is now reserved for developers with commit
 104 access and all anonymous access must be via pserver.samba.org.<p>
 105
 106 If you have an existing checkout from cvs.samba.org then you can run
 107 the following script to convert the tree to use pserver.samba.org.
 108 <blockquote><tt>
 109   find . -name Root -exec sh -c "sed 's/cvs\(.samba.org\)/pserver\1/g' &lt; {} &gt; {}. && mv {}. {}" \;
 110 </tt></blockquote>
 111 This command will change all occurances of cvs.samba.org to
 112 pserver.samba.org in the CVS/Root files in your tree.
 113
 114 <H3>Access via rsync and ftp</H3>
 115
 116 pserver.samba.org also exports unpacked copies of most parts of the CVS
 117 tree at <A
 118 HREF="ftp://pserver.samba.org/pub/unpacked">ftp://pserver.samba.org/pub/unpacked</A>
 119 and also via anonymous rsync at rsync://pserver.samba.org/ftp/unpacked/
 120
 121 I recommend using rsync rather than ftp. See <A
 122 HREF="http://rsync.samba.org/">http://rsync.samba.org/</A>
 123 for more info on rsync.<p>
 124
 125 The disadvantage of the unpacked trees is that they do not support
 126 automatic merging of local changes like CVS does. rsync access is
 127 most convenient for an initial install.
 128
 129 <h3>Available branches</h3>
 130
 131 <p>
 132 Please refer the <a href="/samba/devel/">Development and General Roadmap</a>
 133 page for information on the current cvs branches.
 134
 135 <H3>How it's done</H3>
 136
 137 If you are interested in how I have setup anonymous cvs access and
 138 want to set it up on your own system then you might like to checkout
 139 the pserver source code using the the command
 140 <blockquote><tt>
 141         cvs -d :pserver:cvs@pserver.samba.org:/cvsroot co pserver
 142       </tt></blockquote>
 143
 144 You really have to know what you are doing to do this. Please don't
 145 mail me with basic cvs or unix security questions.
 146
 147 <H2>Reporting problems</H2>
 148
 149 If you have any problems with this system please ask on the <a
 150 href="http://lists.samba.org/">Samba mailing list</a>.
 151
 152
 153 <!--#include virtual="/samba/footer.html" -->