This is ClearCase for Dummies, aka CCFD, a program for retrofitting
ClearCase-awareness into any dynamically-linked program. See the
ccfd(1) man page included in this package for details and usage.

INSTALLATION

Installation consists of copying two or three files to your preferred
locations.  This is so easy I let you do it by hand. Extract the
package and find the appropriate platform subdirectories, for example
"SunOS_sparc" or "Linux_i386", under the "bin" and "lib" directories.
Each should have an executable program named "ccfd" and a library named
"libccfd.so" within it (the SunOS_sparc platform has an additional
"64/libccfd.so" for 64-bit executables).

The ccfd program may be placed wherever you like on your PATH. The
libccfd.so library MUST go in the location at "../lib" from that. E.g.
assuming the executable went to

    <install-base>/bin/ccfd

then the library must be in

    <install-base>/lib/libccfd.so

There is also a platform-independent "ccfd.1" man page which should be
copied to a man-page area (i.e. somewhere on MANPATH).

To test the installation, make sure you're in a dynamic view context
and try something like this:

    % ls -l foo        
    -r--r--r--   1 dsb      ccusers      476 Apr  2 11:36 foo
    % ccfd -- ls -l foo
    -rw-r--r--   1 dsb      ccusers      476 Apr  2 11:36 foo

Note that the file appears (and is) writeable under ccfd.

DOCUMENTATION

A man page "ccfd.1" is supplied under the "doc" subdirectory, along
with an HTML-formatted version of the same document ("ccfd.html"). Both
of these are derived from the CCFD.pod files so if all else fails you
can read that in any plain-text reader.

There's also a doc/CCFD-DEMO.html file which walks through some of
the usage modes.

STATUS

This is the second release. It is considered Alpha quality and no
formal support is available. This release does pass the "Perl test":
download Perl and build it such that the install area is within a VOB.
Then run "ccfd -mi make install"; the result will be a full install of
Perl as versioned elements. This functions as the primary stress test
and regression test.

PLATFORMS

CCFD is currently available for Solaris 8 (and above) for Sparc,
Slackware Linux 8.1 (and subsequent Linux versions based on glibc 2.2.5
and up) for i386, FreeBSD 5.2.1 (and up) for i386, and Solaris 9 (and
up) for i386.

To the best of my knowledge it should be portable to any Unix platform,
rev level, bit-ness and endian-ness supported by ClearCase(*) but at
time of writing only the above two ports have been done.

(*) Early research implies that AIX is the one Unix-like platform which
would not support CCFD. This may still be proven wrong.

CCFD is not "portable" to Windows in the usual sense of the word.
Research indicates that there is very likely an equivalent way of doing
the same thing on Windows but it would be more of a separate
implementation than a "port".

HOME PAGE

Latest versions and documentation are at http://www.cleartool.com/ccfd.