Downloading from CVS

Downloading
PWLib, OpenH323 or OPAL, from CVS
Craig Southeren
Last updated 21 June 2006

	Introduction
	Modules
	Extracting code
	Versions
	Software
	Change history

Introduction

This document describes how to extract any version of PWLib, OpenH323 or OPAL from the CVS repository on SourceForge. It is not intended as a tutorial in using CVS - if you don't know what CVS is, or what it is used for, then you probably should not be using it

The CVS repository for OpenH323 contains every version of the source code that has been created since PWLib was started in 1991. Most working versions are identified by appropriate tags, and there are several useful top-level modules that can be used to get direct access to the commonly used progrsms

Modules

The following modules are available within the CVS repository:

CVS Module	Description	Directory
ptlib_unix	PWLib components needed for Unix	pwlib
ptlib_win32	PWLib components needed for Windows	pwlib
openh323	The OpenH323 library	openh323
opal	The OPAL library	opal
ohphone	The ohphone command line softphone program	ohphone
openam	The openam simple answering machine	openam
openmcu	The openmcu H.323 MCU program	openmcu

Extracting code

The OpenH323 CVS is hosted by SourceForge, which has excellent documentation on how to access the OpenH323 CVS. In short, you can check-out all of the source required for compiling OpenH323 on Unix using the following two commands:

For Unix:

cvs -d:pserver:anonymous@openh323.cvs.sourceforge.net:/cvsroot/openh323 login cvs -z3 -d:pserver:anonymous@openh323.cvs.sourceforge.net:/cvsroot/openh323 co ptlib_unixcvs -z3 -d:pserver:anonymous@openh323.cvs.sourceforge.net:/cvsroot/openh323 co openh323

For Windows:

cvs -d:pserver:anonymous@openh323.cvs.sourceforge.net:/cvsroot/openh323 login cvs -z3 -d:pserver:anonymous@openh323.cvs.sourceforge.net:/cvsroot/openh323 co ptlib_win32 cvs -z3 -d:pserver:anonymous@openh323.cvs.sourceforge.net:/cvsroot/openh323 co openh323

If you have OpenH323 developer status, then you can use your SourceForge username and password. Note that you will require SSH access to the SourceForge CVS server to perform checkins.

Versions

There are five different versions you can checkout from the CVS, which can be selected using various CVS tags:

Tag	Description
(no tag)	The CVS "head" revision. This is always the latest and greatest code, but may not always work correctly or even compile. Use at your own risk
CURRENT	The last compilable version used by the core developers. This will normally compile, but some features may be broken or some platforms may not compile
PREVIOUS	The last version of the CURRENT tag
DEVEL	The current development code. This will always be associated with a released "snapshot" version
STABLE	The current stable code This will always be associated with a stable release baseline

In addition, any specific of version of PWLib, OpenH323 or OPAL can be retrieved by converting the version number to a CVS tag using the following algorithm:

Convert all "." to "_"
Prefix a "v" (lower case vee)

For example, PWLib 1.7.4 can be retrieved using the CVS tag "v1_7_4".

Stable releases, or special development versions, may also be associated with non-numeric tags. For example, the Janus Patch level 3 release can be extracted using the tag "Janus_patch3". An example of a checkout using a version specification is shown below:

cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/openh323 co -rPluginBranch openh323

The "cvs log" command can be used to determine what tags are available on any specific file

Software

The command line version of CVS is available on all platforms (including Windows) and is the client of choice for Unix.

For Windows, we recommend TortoiseCVS for it's excellent functionality and integration with Windows GUI. WinCVS is a suitable alternative, and is also available for MacOS and Unix

Finally, note that the entire repository can be viewed online via the SourceForge WebCVS

Change History