[metze/test/web/.git] / cvs.html

<!--#include virtual="/samba/header.html" -->

<h2 align="center">CVS Access to pserver.samba.org</h2>


<H1>samba development changed to subversion</H1>

In April Samba development changed from using CVS to Subversion for
version control. Please see the <a href="/samba/subversion.html">subversion
information</a> for details.

<H2>Overview</H2>

The machine pserver.samba.org runs a publicly accessible CVS
repository for access to the source code of several packages.  This
document describes how to get anonymous read-only access to this
source code.


<H3>Web access to the source</H3>

<H4>Doxygen</H4>
    <p>
      <a href="http://samba.org/doxygen/">Hyperlinked cross reference
        of Samba source</a>.</p> This is automatically generated every
        night from the anoncvs tree.
    
    <p>
      This autogenerated repository not only cross-references most of
      the Samba source, it also extracts function definitions and (most
      importantly) the internal API documentation.
    </p>
    
<H4>Build Farm - Recent Checkins</H4>
The Samba <a href="http://build.samba.org">build farm</a> provides access to the recent checkins on the
<a href="http://build.samba.org/?&tree=samba_2_2&function=Recent+Checkins">samba_2_2</a>,  
<a href="http://build.samba.org/?&tree=samba_3_0&function=Recent+Checkins">samba_3_0</a>
and 
<a href="http://build.samba.org/?&tree=samba&function=Recent+Checkins">HEAD</a>
branches.. 

<H4>CVSweb</H4>
<p>You can access the source code via your favourite WWW browser. This
allows you to access the contents of individual files in the
repository and also to look at the revision history and commit logs of
individual files. You can also ask for a diff listing between any two
versions on the repository.</p>

To access CVS via cvsweb click <A HREF="http://cvs.samba.org/cgi-bin/cvsweb/">here</A>.

<H3>Access via cvs</H3>

You can also access the source code via a normal cvs client. This
gives you much more control over you can do with the repository and
allows you to checkout whole source trees and keep them uptodate via
normal cvs commands. This is the preferred method of access if you are
a developer and not just a casual browser.<p>

To gain access via anonymous cvs use the following steps. For this
example I will assume that you want a copy of the samba source
code. For the other source code repositories on this system just
substitute the correct package name<p>

<OL> 

<LI> Install a recent copy of cvs. All you really need is a copy
of the cvs client binary.</LI>

<LI> run the command
<blockquote><tt>
        cvs -d :pserver:cvs@pserver.samba.org:/cvsroot login
</tt></blockquote></LI>

<LI> when it asks you for a password type <it>cvs</it> </LI>

<LI> run the command 
<blockquote><tt>
        cvs -z5 -d :pserver:cvs@pserver.samba.org:/cvsroot co samba
</tt></blockquote>

This will create a directory called samba containing the latest samba
source code.  This corresponds to the HEAD development branch.
<p>
If you want a different branch use the -r option to the co command to
specify the branch. For example to checkout the SAMBA_2_2 branch run the
command

<blockquote><tt>
        cvs -z5 -d :pserver:cvs@pserver.samba.org:/cvsroot co -r SAMBA_2_2 samba
          </tt></blockquote>
If you want the latest 3.0 development code, use the SAMBA_3_0 tag.
<blockquote><tt>
        cvs -z5 -d :pserver:cvs@pserver.samba.org:/cvsroot co -r SAMBA_3_0 samba
          </tt></blockquote>


</LI>

<LI> Whenever you want to merge in the latest code changes use the following
command from within the samba directory:
<blockquote><tt>
        cvs update -d -P
          </tt></blockquote>
      </LI>

</OL>

NOTE: The Samba TNG project is now a separate development effort apart from
the main Samba branch (not just another CVS code branch).  For the latest Samba
TNG code, please refer to <a href="http://www.samba-tng.org/">http://www.samba-tng.org</a>.

<h3>Converting from cvs.samba.org</h2>

Anonymous access to the Samba cvs tree used to be via the host
cvs.samba.org. That host is now reserved for developers with commit
access and all anonymous access must be via pserver.samba.org.<p>

If you have an existing checkout from cvs.samba.org then you can run
the following script to convert the tree to use pserver.samba.org.
<blockquote><tt>
  find . -name Root -exec sh -c "sed 's/cvs\(.samba.org\)/pserver\1/g' &lt; {} &gt; {}. && mv {}. {}" \;
</tt></blockquote>
This command will change all occurances of cvs.samba.org to
pserver.samba.org in the CVS/Root files in your tree.

<H3>Access via rsync and ftp</H3>

pserver.samba.org also exports unpacked copies of most parts of the CVS
tree at <A
HREF="ftp://pserver.samba.org/pub/unpacked">ftp://pserver.samba.org/pub/unpacked</A>
and also via anonymous rsync at rsync://pserver.samba.org/ftp/unpacked/

I recommend using rsync rather than ftp. See <A
HREF="http://rsync.samba.org/">http://rsync.samba.org/</A>
for more info on rsync.<p>

The disadvantage of the unpacked trees is that they do not support
automatic merging of local changes like CVS does. rsync access is
most convenient for an initial install.

<h3>Available branches</h3>

<p>
Please refer the <a href="/samba/devel/">Development and General Roadmap</a>
page for information on the current cvs branches.

<H3>How it's done</H3>

If you are interested in how I have setup anonymous cvs access and
want to set it up on your own system then you might like to checkout
the pserver source code using the the command 
<blockquote><tt>
        cvs -d :pserver:cvs@pserver.samba.org:/cvsroot co pserver
      </tt></blockquote>
    
You really have to know what you are doing to do this. Please don't
mail me with basic cvs or unix security questions.

<H2>Reporting problems</H2>

If you have any problems with this system please ask on the <a
href="http://lists.samba.org/">Samba mailing list</a>.


<!--#include virtual="/samba/footer.html" -->