.\" @(#)cd←copy.1 1.00 91/04/05 Copyright 1990, 1991 By Young Minds, Incorporated
.TH CD←COPY 1  "5 April 1991"
cd←copy \- Copy files from a CD←ROM to a UNIX filesystem
.B cd←copy
.B \-rR
.IB cdrom←directory
.IB target←directory

.B cd←copy
copies files/directories stored on a CD-ROM created by Young Minds'
CD-ROM Publishing Software.  The program uses the
.IB cdrom←directory
to search for a
translation file (normally
If found, the program uses the file to get the original UNIX names
for the files it will copy to the
.IB target←directory.
If the
.IB target←directory
is not specified on the command line, the files
are copied to the current working directory.

The names given to the copied files in the
.IB target←directory
are the original UNIX\(dg
names that the files on the CD-ROM had before they were formatted
to conform to the
.B ISO9660
specification.  This gives you the ability to use
the files on the CD-ROM as they were originally intended to be used
under a UNIX\(dg
filesystem.  For example, if you had a source distribution on CD-ROM,
you could use
.B cd←copy
to copy the files with their original UNIX\(dg
names to a writable partition in order to make the executables.

Since it is often desirable to have the original UNIX\(dg
names in a writable partition, 
.B cd←copy
will also copy files from a
.B Rock Ridge

.B \-r
Recursively descend the subdirectory rooted at
.IB cdrom←directory.
.B \-R
Copy files from a disc mounted with a
.B Rock Ridge
filesystem driver.


The example below shows how to copy the files from a CD-ROM
subdirectory to your hard disk.  The CD-ROM is mounted on
/cd-rom←disc.  The subdirectory is /cd-rom←disc/x11r2/gnuplot.

my←prompt% cd ~my←account
my←prompt% mkdir gnuplot
my←prompt% cd←copy -r /cd-rom←disc/x11r2/gnuplot gnuplot

Because we wish our CD-ROM publications to be usefull on as
many platforms as possible, 
.B cd←copy
is distributed in source form.  To make the executables you will
need a
.B C
compiler (which is a standard part of most UNIX systems).  First, copy
.B cd←copy.c
from the CD-ROM onto a hard disk.  On most systems this will look
somehthing like this:

% cp /cd-rom/ym←utils/"cd←copy.c;1" cd←copy.c

The quotes around
.B cd←copy.c;1
above are necessary to prevent the shell from interfering with
the operation.  Note that on some platforms the ";1" will not be needed
because the CD-ROM filesystem driver may automatically strip it off.

After you have a copy of 
.B cd←copy.c
on your hard disk, you need to compile it.  Type:

% cc -o cd←copy cd←copy.c

This will create an executable file named
.B cd←copy.
On some platforms it may be necessary to link in a BSD compatibility
library.  HP-UX machines are in this catagory.  In this case you should
instead type:

% cc -o cd←copy cd←copy.c /usr/lib/libBSD.a

Once you have successfully created the executable you may want to
install it in a commonly accessible location like /usr/local/bin.

While all filenames on CD-ROM discs from Young Minds are stored using
upper case letters, the CD-ROM filesystem driver for the Sun workstation
automatically translates all upper case filename characters to lower case.
.B cd←copy 
automatically detects several types of translations that
are commonly performed by CD-ROM filesystem drivers, so this
should cause no problems.
The directory
.IB cdrom←directory
need not reside on a CD-ROM disc, as long as it contains a copy of all
files from a directory on a CD-ROM disc (and that directory's
sub-directories, if you wish to use the
.B -r

While the current version of Young Minds' CD-ROM Publishing Software
generates translation tables entries for block device nodes, character
device nodes, pipes, and sockets (denoted B, C, P, and S), the current
version of 
.B cd←copy
ignores these entries as there is not yet a well defined, machine
independent mapping for these entries.

While there is no reason why the program could not be useful in
copying directory trees to arbitrary directories, the
required translation file only allows the program to be used on directory
(or directory trees) that contain correct translation files.
\(dg \s-1UNIX\s0 is a trademark of Bell Laboratories.