cvs.html

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