git.maemo.org Git - samba/blob - docs/htmldocs/using_samba/appd.html

   1 <html>
   2 <body bgcolor="#ffffff">
   3
   4 <img src="samba2_xs.gif" border="0" alt=" " height="100" width="76"
   5 hspace="10" align="left" />
   6
   7 <h1 class="head0">Appendix D. Downloading Samba with CVS</h1>
   8
   9
  10 <p>In <a href="ch02.html">Chapter 2</a> we showed you how to download the
  11 latest stable version of Samba published by the Samba developers. For
  12 most purposes (including virtually all production servers) this
  13 procedure will meet your needs. However, sometimes you might want to
  14 run a version of Samba that includes the latest bug fixes and
  15 features, maybe for research and testing purposes, or just to see
  16 what the Samba developers have been up to lately.</p>
  17
  18 <p>The Samba team keeps the latest updates of the Samba source code in a
  19 <a name="INDEX-1"/><a name="INDEX-2"/>Concurrent Versions System
  20 (CVS) repository. CVS is a freely available
  21 <a name="INDEX-3"/>configuration management tool
  22 and is distributed under the GNU General Public License. You can
  23 download the latest copy from <a href="http://www.cvshome.org/">http://www.cvshome.org/</a>. The Samba team
  24 describes various ways to access its CVS repository at <a href="http://www.samba.org/samba/cvs.html">http://www.samba.org/samba/cvs.html</a>.</p>
  25
  26 <a name="samba2-APP-D-NOTE-162"/><blockquote class="note"><h4 class="objtitle">WARNING</h4>
  27 <p>Although the CVS code contains the latest features, it also contains
  28 the latest bugs and sometimes won't even compile
  29 properly! If you prefer a less &quot;bleeding
  30 edge&quot; release, try looking in the
  31 <em class="filename">alpha</em> and <em class="filename">pre</em> directories
  32 on the Samba FTP server. The <em class="filename">alpha</em> directory
  33 contains alpha releases, and the <em class="emphasis">pre</em> directory
  34 contains (usually more stable) prerelease versions. (See <a href="ch02.html">Chapter 2</a> for information on downloading via FTP.) Alpha
  35 releases might be a little behind the latest CVS code, but are less
  36 buggy and usually compile properly on the more common Unix versions.</p>
  37 </blockquote>
  38
  39 <p>One of the nicest things about CVS is its ability to handle remote
  40 logins. This means that people across the globe on the Internet can
  41 download and update various source files for any project that uses a
  42 CVS repository. Such is the case with Samba. Once you have CVS
  43 installed on your system, you must first log in to the Samba source
  44 server with the following command:</p>
  45
  46 <blockquote><pre class="code">$ <tt class="userinput"><b>cvs -d :pserver:cvs@pserver.samba.org:/cvsroot login</b></tt></pre></blockquote>
  47
  48 <p>When you are prompted for a password, enter <tt class="literal">cvs</tt>.
  49 You are connected to the CVS server at
  50 <tt class="literal">pserver.samba.org</tt>. Once you are connected, you can
  51 download the latest source tree with the following command:<a name="FNPTR-1"/><a href="#FOOTNOTE-1">[1]</a></p>
  52
  53 <blockquote><pre class="code">$ <tt class="userinput"><b>cvs -z5 -d :pserver:pserver@pserver.samba.org:/cvsroot co samba</b></tt></pre></blockquote>
  54
  55 <p>This downloads the entire Samba distribution (file by file) into a
  56 directory called <em class="filename">samba</em>, created in your current
  57 directory. The <em class="filename">samba</em> directory has the same
  58 structure as the Samba source distribution described in <a href="ch02.html">Chapter 2</a>, except that it has additional directories
  59 named <em class="filename">CVS</em> throughout the source tree. These
  60 directories are used by CVS to store information about each file in
  61 the source tree and how to update them. After the download is
  62 completed, you can follow the instructions in <a href="ch02.html">Chapter 2</a> to configure, compile, and install your new
  63 Samba release.</p>
  64
  65 <p>The Samba developers typically update the Samba source code one or
  66 more times per day. Whenever you want to catch up to the latest
  67 changes, simply <em class="emphasis">cd</em> to the
  68 <em class="filename">samba</em> directory and run the following command:</p>
  69
  70 <blockquote><pre class="code">$ <tt class="userinput"><b>cvs update -d -P</b></tt></pre></blockquote>
  71
  72 <p>Each time you do this, you will need to reconfigure, recompile, and
  73 reinstall to update your installation as we showed you in <a href="ch02.html">Chapter 2</a>.</p>
  74
  75 <hr/><h4 class="head4">Footnotes</h4><blockquote><a name="FOOTNOTE-1"/>
  76 <p><a href="#FNPTR-1">[1]</a> The <tt class="literal">-z</tt> option causes the transfer to be made
  77 in GNU gzip compressed format and requires the
  78 <em class="filename">gzip</em> program to be installed on your system to
  79 work. If you do not have <em class="filename">gzip</em>, omit the
  80 <tt class="literal">-z</tt> option.</p> </blockquote><hr/><h4 class="head4"><a href="toc.html">TOC</a></h4>
  81
  82 </body></html>