README file for the VMSCD utility version 1.0, Jan 1st 2000
-----------------------------------------------------------


OVERVIEW
--------
The vmscd utility reads the contents of any OpenVMS CD-ROM or more generally
any ODS-2 disk volume. Using vmscd, the user can navigate on the CD-ROM, list
the content of directories, extract files, view the content of OpenVMS text
files or convert them into UNIX text format.


TYPICAL USAGE
-------------
You have a PC running Linux on your desk. You have OpenVMS CD-ROM's in your
drawers (Digital/Compaq distribution kits or on-line documentation for 
instance). Your OpenVMS systems and their CD-ROM drives are in a remote
location or simply next floor but you are too lazy to get there.
There is some kind of network between your Linux PC and the OpenVMS
systems.

Then, vmscd is for you !


GETTING VMSCD
-------------
Source files: http://perso.club-internet.fr/lelegard/vmscd/vmscd-1.0.tar.gz
Author: Thierry Lelegard <lelegard@club-internet.fr>

Although you can do everything from the source files, you may find
convenient to get the following files.

Man page (PostScript): http://perso.club-internet.fr/lelegard/vmscd/vmscd.ps
Man page (PDF): http://perso.club-internet.fr/lelegard/vmscd/vmscd.pdf
Source RPM: http://perso.club-internet.fr/lelegard/vmscd/vmscd-1.0-1.src.rpm
Binary RPM: http://perso.club-internet.fr/lelegard/vmscd/vmscd-1.0-1.i386.rpm


BUILDING AND INSTALLING VMSCD
-----------------------------
If you got the binary rpm for vmscd, simply install it using:
    rpm -U vmscd-1.0-1.i386.rpm

If you got the source files, use these instructions:
- Unpack the source file:          tar xvfz vmscd-1.0.tar.gz
- Move to the source directory:    cd vmscd-1.0
- Build vmscd:                     make
- Install vmscd (must be root):    make install

If you want to rebuild vmscd from the sources, be aware that the current
version of vmscd can work on little-endian systems (Intel, Alpha) *only*.
Moreover, vmscd has currenlty been tested only on Intel systems running
RedHat Linux 6.1.

In case of problem and for bug report, send an e-mail to the author.


COPYRIGHT
---------
Copyright is held by the author. The vmscd utility is covered by the
"GNU GENERAL PUBLIC LICENSE" (GPL) and may be used and duplicated under
the terms of the GPL.
