www/anoncvs.html - diff

Return to anoncvs.html CVS log

Up to [local] / www

Diff for /www/anoncvs.html between version 1.35 and 1.36

version 1.35, 1997/11/24 18:26:45

version 1.36, 1997/11/30 14:42:38

Line 20

Anonymous CVS is a method of keeping your local copy of the OpenBSD source

tree up to date with respect to changes made to current OpenBSD sources.

The major advantage of Anonymous CVS over other source code update

techniques is that it works directly against a central source code

Line 28

Line 27

commands available to control merging and updating your changes with

other source changes and for performing diff's, change histories

and other queries against the central repository.

You can use anoncvs to access our three main source repositories:

src, ports, and www.

<a href=why-cvs.html>CVS is the source code control system used to manage the OpenBSD source tree.</a>

CVS is the source code control system used to manage the OpenBSD source tree.</a>

It implements a central repository for all officially released source code

and changes, while permitting developers to maintain local copies of the

source code with their working changes. Developers with "write access"

can commit changes directly to the OpenBSD source tree, while "Anonymous

CVS" users have "read access" and can keep their local copies of the source

up to date and issue queries against the central depository.

The major strength of CVS is that it has the ability to perform intelligent

merges of changes to the central repository with changes that you make to

Line 45

Line 47

perform an update, your changes are not "blown away", rather CVS makes

best efforts to merge the changes made to the central sources with changes

you've made to your local copy.

In the event that the changes can't be completely merged, CVS provides a

"soft fallback", in terms of providing you with annotated changes to your

local copy, preeserving an unmodified copy of your version and continuing

to update any other source modules you requested.

People who own an OpenBSD CD may have seen the CVS/ dirs on it.

Actually there is a reason, the CD has a checkout of the OpenBSD src/ module

Line 72

</ul>

After this, /usr/src will be a nice checkout area where all cvs(1) commands

will work OK.

<h4>CVS COMMAND SUMMARY</h4>

<dt> cvs [cvs args] [cvs command] [cvs command args]

<dd> below is a listing of commonly used cvs commands.

Line 103

Line 102

"best efforts" to update your entire source tree, rather than

leaving you a list of arcane problems that have to be resolved before

continuing.

<h3>Using Anonymous CVS:</h3>

Line 111

Line 109

<a href=ftp://ftp.cyclic.com/pub/cvs/>Cyclic</a>.

Versions earlier than 1.6 are not recommended, and may not work.

If you already have OpenBSD installed, CVS is included.

There are two levels of source tree access:

<dl>

<dt>Read-write access for developers:

Line 208

Line 204

Problems with a server should be reported to the maintainer of the

server in question.

</dl>

IMPORTANT NOTE:

There are a few issues relating to cryptographic software that everyone

Line 230

Line 225

<li>src/kerberosIV/*

<li>src/lib/libc/crypt/crypt.c

<li>src/lib/libc/crypt/morecrypt.c

<li>src/sys/netinet

</ul>

Because of the USA ITAR munitions list,

crypto software may only be exported to Canada from the USA.

Line 237

Line 233

<li>The OpenBSD project is looking for more anoncvs servers -- read

on to find out how you can help.

</ul>

A sample use of an anoncvs CVS server would be:

Line 253

Line 248

[shows the changes between revisions 1.1 and rev 1.5]

</pre>

</ul>

<a name=pserver>In order to use a cvs ``pserver'' (a direct tcp connection instead of using ssh or rsh) you must login once:</a>

Line 272

Line 266

[allows you to retrieve ONLY that necessary to rebuild an i386 kernel ]

[ -z9 allows gzip -9 compression, GOOD medicine for slow links ]

</pre>

Here is how someone using anoncvs regularily would update his

Line 303

Line 296

In the above example, '-q' is optional, only intended to minimize

cvs's output. For those who like to see screenfulls of output, it

can be omitted.

or to make a diff of a locally patched module (here cd.c) to include with

Line 312

Line 304

# cd /usr

# cvs diff -u src/sys/scsi/cd.c > /tmp/patch

</pre>

The CVS man page (included with the CVS sources) has much more

information about how CVS can be used.

Warning:

Line 325

Line 315

the root of the tree you're referencing or in a separate place such as /tmp.

Some commands such as "get" can create an arbitrary sub-tree in the current

directory, and a subsequent update will recursively flesh out this sub-tree.

The anoncvs service gives fledgling developers a chance to learn CVS

Line 334

Line 323

skills and high quality results they will naturally later be given

developer access. As well, people providing patches can create

their "diff"s relative to the CVS tree, which will ease integration.

Anoncvs: rsh vs. ssh

Line 350

Line 338

installed under OpenBSD. You can download the unix version from

<a href=http://www.cs.hut.fi/ssh>http://www.cs.hut.fi/ssh</a> or one of

the mirrors listed there.

In this case, one sets the environment variable

CVS_RSH to point to ssh (typically

/usr/local/bin/ssh). If your local site prevents you

from connecting out to port 22 (which ssh defaults to using) use port

2022.

Do not be tempted to turn on compression since CVS already compresses.

Line 366

Line 352

port 2022. Also note that most anoncvs servers no longer accept

the none cipher as it is disabled in recent

versions of ssh for security reasons.

<pre>

Host anoncvs.usa.openbsd.org

Port 2022

Line 378

Line 363

<pre>

setenv CVS_CLIENT_PORT -1

</pre>

If you wish to change from one CVS server to another (say your normal one is

Line 387

Line 371

<pre>

setenv CVS_IGNORE_REMOTE_ROOT

</pre>

If you wish to be a new anoncvs mirror site, please contact the anoncvs

Line 399

Line 382

network connectivity for the area they are expected to serve. A

<a href=anoncvs.shar>document</a>

which describes the setup of anoncvs servers is available.

</dl>