docs/htmldocs/cvs-access.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >HOWTO Access Samba source code via CVS</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
   9 "><LINK
  10 REL="HOME"
  11 TITLE="SAMBA Project Documentation"
  12 HREF="samba-howto-collection.html"><LINK
  13 REL="UP"
  14 TITLE="Optional configuration"
  15 HREF="optional.html"><LINK
  16 REL="PREVIOUS"
  17 TITLE="Storing Samba's User/Machine Account information in an LDAP Directory"
  18 HREF="samba-ldap-howto.html"><LINK
  19 REL="NEXT"
  20 TITLE="Group mapping HOWTO"
  21 HREF="groupmapping.html"></HEAD
  22 ><BODY
  23 CLASS="CHAPTER"
  24 BGCOLOR="#FFFFFF"
  25 TEXT="#000000"
  26 LINK="#0000FF"
  27 VLINK="#840084"
  28 ALINK="#0000FF"
  29 ><DIV
  30 CLASS="NAVHEADER"
  31 ><TABLE
  32 SUMMARY="Header navigation table"
  33 WIDTH="100%"
  34 BORDER="0"
  35 CELLPADDING="0"
  36 CELLSPACING="0"
  37 ><TR
  38 ><TH
  39 COLSPAN="3"
  40 ALIGN="center"
  41 >SAMBA Project Documentation</TH
  42 ></TR
  43 ><TR
  44 ><TD
  45 WIDTH="10%"
  46 ALIGN="left"
  47 VALIGN="bottom"
  48 ><A
  49 HREF="samba-ldap-howto.html"
  50 ACCESSKEY="P"
  51 >Prev</A
  52 ></TD
  53 ><TD
  54 WIDTH="80%"
  55 ALIGN="center"
  56 VALIGN="bottom"
  57 ></TD
  58 ><TD
  59 WIDTH="10%"
  60 ALIGN="right"
  61 VALIGN="bottom"
  62 ><A
  63 HREF="groupmapping.html"
  64 ACCESSKEY="N"
  65 >Next</A
  66 ></TD
  67 ></TR
  68 ></TABLE
  69 ><HR
  70 ALIGN="LEFT"
  71 WIDTH="100%"></DIV
  72 ><DIV
  73 CLASS="CHAPTER"
  74 ><H1
  75 ><A
  76 NAME="CVS-ACCESS">Chapter 20. HOWTO Access Samba source code via CVS</H1
  77 ><DIV
  78 CLASS="SECT1"
  79 ><H1
  80 CLASS="SECT1"
  81 ><A
  82 NAME="AEN2964">20.1. Introduction</H1
  83 ><P
  84 >Samba is developed in an open environment.  Developers use CVS
  85 (Concurrent Versioning System) to "checkin" (also known as
  86 "commit") new source code.  Samba's various CVS branches can
  87 be accessed via anonymous CVS using the instructions
  88 detailed in this chapter.</P
  89 ><P
  90 >This document is a modified version of the instructions found at
  91 <A
  92 HREF="http://samba.org/samba/cvs.html"
  93 TARGET="_top"
  94 >http://samba.org/samba/cvs.html</A
  95 ></P
  96 ></DIV
  97 ><DIV
  98 CLASS="SECT1"
  99 ><H1
 100 CLASS="SECT1"
 101 ><A
 102 NAME="AEN2969">20.2. CVS Access to samba.org</H1
 103 ><P
 104 >The machine samba.org runs a publicly accessible CVS
 105 repository for access to the source code of several packages,
 106 including samba, rsync and jitterbug. There are two main ways of
 107 accessing the CVS server on this host.</P
 108 ><DIV
 109 CLASS="SECT2"
 110 ><H2
 111 CLASS="SECT2"
 112 ><A
 113 NAME="AEN2972">20.2.1. Access via CVSweb</H2
 114 ><P
 115 >You can access the source code via your
 116 favourite WWW browser. This allows you to access the contents of
 117 individual files in the repository and also to look at the revision
 118 history and commit logs of individual files. You can also ask for a diff
 119 listing between any two versions on the repository.</P
 120 ><P
 121 >Use the URL : <A
 122 HREF="http://samba.org/cgi-bin/cvsweb"
 123 TARGET="_top"
 124 >http://samba.org/cgi-bin/cvsweb</A
 125 ></P
 126 ></DIV
 127 ><DIV
 128 CLASS="SECT2"
 129 ><H2
 130 CLASS="SECT2"
 131 ><A
 132 NAME="AEN2977">20.2.2. Access via cvs</H2
 133 ><P
 134 >You can also access the source code via a
 135 normal cvs client.  This gives you much more control over you can
 136 do with the repository and allows you to checkout whole source trees
 137 and keep them up to date via normal cvs commands. This is the
 138 preferred method of access if you are a developer and not
 139 just a casual browser.</P
 140 ><P
 141 >To download the latest cvs source code, point your
 142 browser at the URL : <A
 143 HREF="http://www.cyclic.com/"
 144 TARGET="_top"
 145 >http://www.cyclic.com/</A
 146 >.
 147 and click on the 'How to get cvs' link. CVS is free software under
 148 the GNU GPL (as is Samba).  Note that there are several graphical CVS clients
 149 which provide a graphical interface to the sometimes mundane CVS commands.
 150 Links to theses clients are also available from http://www.cyclic.com.</P
 151 ><P
 152 >To gain access via anonymous cvs use the following steps.
 153 For this example it is assumed that you want a copy of the
 154 samba source code. For the other source code repositories
 155 on this system just substitute the correct package name</P
 156 ><P
 157 ></P
 158 ><OL
 159 TYPE="1"
 160 ><LI
 161 ><P
 162 >       Install a recent copy of cvs. All you really need is a
 163         copy of the cvs client binary.
 164         </P
 165 ></LI
 166 ><LI
 167 ><P
 168 >       Run the command
 169         </P
 170 ><P
 171 >       <B
 172 CLASS="COMMAND"
 173 >cvs -d :pserver:cvs@samba.org:/cvsroot login</B
 174 >
 175         </P
 176 ><P
 177 >       When it asks you for a password type <TT
 178 CLASS="USERINPUT"
 179 ><B
 180 >cvs</B
 181 ></TT
 182 >.
 183         </P
 184 ></LI
 185 ><LI
 186 ><P
 187 >       Run the command
 188         </P
 189 ><P
 190 >       <B
 191 CLASS="COMMAND"
 192 >cvs -d :pserver:cvs@samba.org:/cvsroot co samba</B
 193 >
 194         </P
 195 ><P
 196 >       This will create a directory called samba containing the
 197         latest samba source code (i.e. the HEAD tagged cvs branch). This
 198         currently corresponds to the 3.0 development tree.
 199         </P
 200 ><P
 201 >       CVS branches other HEAD can be obtained by using the <TT
 202 CLASS="PARAMETER"
 203 ><I
 204 >-r</I
 205 ></TT
 206 >
 207         and defining a tag name.  A list of branch tag names can be found on the
 208         "Development" page of the samba web site.  A common request is to obtain the
 209         latest 2.2 release code.  This could be done by using the following command.
 210         </P
 211 ><P
 212 >       <B
 213 CLASS="COMMAND"
 214 >cvs -d :pserver:cvs@samba.org:/cvsroot co -r SAMBA_2_2 samba</B
 215 >
 216         </P
 217 ></LI
 218 ><LI
 219 ><P
 220 >       Whenever you want to merge in the latest code changes use
 221         the following command from within the samba directory:
 222         </P
 223 ><P
 224 >       <B
 225 CLASS="COMMAND"
 226 >cvs update -d -P</B
 227 >
 228         </P
 229 ></LI
 230 ></OL
 231 ></DIV
 232 ></DIV
 233 ></DIV
 234 ><DIV
 235 CLASS="NAVFOOTER"
 236 ><HR
 237 ALIGN="LEFT"
 238 WIDTH="100%"><TABLE
 239 SUMMARY="Footer navigation table"
 240 WIDTH="100%"
 241 BORDER="0"
 242 CELLPADDING="0"
 243 CELLSPACING="0"
 244 ><TR
 245 ><TD
 246 WIDTH="33%"
 247 ALIGN="left"
 248 VALIGN="top"
 249 ><A
 250 HREF="samba-ldap-howto.html"
 251 ACCESSKEY="P"
 252 >Prev</A
 253 ></TD
 254 ><TD
 255 WIDTH="34%"
 256 ALIGN="center"
 257 VALIGN="top"
 258 ><A
 259 HREF="samba-howto-collection.html"
 260 ACCESSKEY="H"
 261 >Home</A
 262 ></TD
 263 ><TD
 264 WIDTH="33%"
 265 ALIGN="right"
 266 VALIGN="top"
 267 ><A
 268 HREF="groupmapping.html"
 269 ACCESSKEY="N"
 270 >Next</A
 271 ></TD
 272 ></TR
 273 ><TR
 274 ><TD
 275 WIDTH="33%"
 276 ALIGN="left"
 277 VALIGN="top"
 278 >Storing Samba's User/Machine Account information in an LDAP Directory</TD
 279 ><TD
 280 WIDTH="34%"
 281 ALIGN="center"
 282 VALIGN="top"
 283 ><A
 284 HREF="optional.html"
 285 ACCESSKEY="U"
 286 >Up</A
 287 ></TD
 288 ><TD
 289 WIDTH="33%"
 290 ALIGN="right"
 291 VALIGN="top"
 292 >Group mapping HOWTO</TD
 293 ></TR
 294 ></TABLE
 295 ></DIV
 296 ></BODY
 297 ></HTML
 298 >