home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
High Voltage Shareware
/
high1.zip
/
high1
/
DIR4
/
TCPY202.ZIP
/
TCMANUAL.DOC
< prev
next >
Wrap
Text File
|
1993-10-15
|
30KB
|
594 lines
TTTTT U U RRRR BBBB OOO CCC OOO PPPP Y Y
T U U R R B B O O C C O O P P Y Y
T U U RRRR BBBB O O C O O PPPP YYYY
T U U R R B B O O C C O O P Y
T UUU R R BBBB OOO CCC OOO P YYYY
version 2.02
by Pierre J. le Riche 1991-93
A Speedy Multi-Volume File Transfer Program
General User's Manual
***************
*Introduction:*
***************
First of all, thank you for downloading TurboCopy. I hope you will find
it fast*, useful and easy to use. To cut a long story short: TurboCopy
is a copy program much like XCopy but with many extra features (which we
will come to later), the most remarkable being it's built in floppy disk
cache (which provides for some ultra fast copying), it's capability to
process multiple volumes and the ability to slice big files.
*I am yet to find a copy program that is faster than TurboCopy!
**********************
*System Requirements:*
**********************
Any IBM compatible computer with BIOS version later than 1/1/1986
(otherwise the cache will automatically be disabled). DOS version above
3.00 (5.00 or higher recommended). 384K conventional memory required for
floppy cache, 196K absolute minimum. Will utilise extended and expanded
memory if available. TC runs in any text mode from 80x25 to 132x60 or
higher resolution (TC will autodetect your screen configuration).
****************
*Why TurboCopy?*
****************
Have you ever become fed up with DOS's slow copy command, or XCOPY's
cryptic display, or the fact that when you want to backup a big program
you have to pick the files manually and copy them onto floppy disk one
by one? Your troubles are over with the new release of TurboCopy.
TurboCopy copies files lightning fast, offers a very informative
display, and prompts for new disks as they are filled, all the time
sorting the files so that the minimum amount of disk space is wasted.
And the best news of all, you get all this for the lowly registration
fee of R20 ($10 outside R.S.A.)!
******************
*How to register:*
******************
If you use TurboCopy frequently, you MUST register. TurboCopy is NOT
free software. From time to time new versions of TurboCopy will be
released. To make sure that you get it as soon as possible you can send
the MINISCULE amount of R20 ($10 US overseas) to the address below and
you will receive the latest version as soon as it becomes available.
Please specify whether you want it on a 5¼ or 3½ inch disk. (Hints and
suggestions for future versions are also welcome.) The order form is in
the file TCORDER.FRM included in the package. Send all queries to:
Pierre J. le Riche
P.O. Box 209
Kuils River
7580
Rep. of South Africa
Or one of the following E-Mail addresses:
mostert@cs.sun.ac.za
mostert@itu.sun.ac.za
******************
*Getting started:*
******************
TurboCopy's command line is almost completely compatible with that of
XCopy, so if you know your DOS, you shouldn't have any trouble with
TurboCopy. To get acquainted with TurboCopy, run TC with no command
line. You should get the following display:
TurboCopy V2.02 ---------- Pierre J. le Riche ---------- 10 October 1993.
A speedy multi-volume file transfer program. Unregistered evaluation version.
TC source[;includefiles][,excludefiles] [destination] [/options]
B Manually select source files to be included in copy.
D[D]:d-m-y Only files modified on or after [before] date will be copied.
F[F]:size Only files equal or larger [smaller] than size will be copied.
H[H] Include hidden and system files in copy [remove attributes].
J,G Sort files as for option B/Set file date and time to current.
K:xxx,L:yyy Mirror output to file xxx/Read source filespecs from file yyy.
M,A Copy archives only, reset/don't reset archive attribute.
N,O,E,I Overwrite if newer/Overwrite all/Append/Skip existing files.
Q[Q][:lbl] Quickformat target diskettes [unconditional] [set label].
S[P][C] Include subdirectories [prompt] [disable subdir creation].
T:level Specify a text output verbosity level of 0 to 9.
U,V,W,Z Update settings/Verify files/Wait for keypress/Enable cache.
X[R] Move files to destination [remove empty source dirs].
Y[:disks] Specify multiple source disks [number of disks].
?[option] Detailed help [help on option] (registered version only).
If you use TurboCopy for more than 21 days, you should register. P.O. Box 209
As a registered user you will be entitled to the latest version Kuils River
of the program. Please send your cheque for R20 ($10 U.S) to the 7580
address on the right and state 5¼ or 3½ inch diskette. South Africa
Above is TurboCopy's cryptic help screen. Options are mostly grouped
together by function. E.g. N,O,E and I options all have to do with file
inclusion or exclusion from the copy process. Options are not case
sensitive, so you can type them in either lower- or uppercase.
************************************
*Rough overview of TC command line:*
************************************
You must always supply TC with a source path. (The current path is
assumed to be the destination if none is given.) A source path consists
of some kind of drive/directory identification and optionally file
specifications (*.* is assumed if none is given). Therefore "."
identifies as all files in the current directory, ".." all the files in
the previous directory, "A:" all the files in the current directory on
drive A:, and so on. File specifications ("filespecs") can be very
diverse. The following rules apply to TurboCopy filespecs:
1) Unlike DOS the following is completely legal: "*foo*.*", this will
match all files with "foo" somewhere in it's name, e.g. "kfoobar.xyz"
2) You may use Grep style search characters, i.e. "[","]" and "^". For
example "[a-c]*.*" is functionally the same as "a*.*", "b*.*" and
"c*.*". The filespec "[afq]*.*" will copy all files starting with the
letters a, f or q. You may also precede the characters with a "^"
sign which means "everything except". You may also wrap through z
back to a, e.g. "*[^x-b].*" will match all files that doesn't end
with an x,y,z,a or b.
3) You may specify more than one filespec by separating them with an
";", i.e. "*.txt;*.doc" will match all files with .doc or .txt
extensions.
4) You may also specify filespecs to exclude from the copy by preceding
them with a ",", i.e. "*.?oc,myfile.*,sam?.voc" will copy all files
with an extension matching .?oc, except "myfile.*" and "sam?.voc".
5) If you start a source filespec with "," or ";" it would indicate that
all files is included before the expression after the ";" or "," is
evaluated. Don't end the filespec list with a ";" since this will
also include all files.
You may specify a directory that does not exist on the destination
drive, TC will create it automatically. You may also specify a general
rename filespec in the destination, just like with copy and xcopy. If
you specify a destination of "NUL", TurboCopy will only verify the
source files; nice if you want to check if your disks are OK (/X,/M and
/R options will be ignored). After the source and destination filespecs
(or before, if you prefer) you may specify certain options, which will
be discussed in detail below.
********************
*TurboCopy options:*
********************
You do not have to start each option with a forward slash (/), instead a
slash is used to identify the start of the options list. If an option
letter is followed with a "-" the option will be disabled (if the
default was on; refer to "setting up TC"), "+" will enable the option
(same as specifying nothing), and "=" will toggle the current setting.
The options list must follow directly after the destination filespec or
must precede the source filespec, but not in between. The following is
an example of a completely valid TC command line:
tc c:\asm\tc.*,tc.asm;tcbench.doc;file[1-3].doc a:\/xvo
It will move tc.* (except tc.asm), tcbench.doc, file1.doc, file2.doc and
file3.doc to a:\. It will do a complete read after write verify of the
data, and it will overwrite the files if they already exist.
*******************************
*Alphabetical list of options:*
*******************************
/A
The /A option will copy ONLY files with their archive attribute set. It
is similar to /M, but it does not reset the source file's archive
attribute after the copy. It is of limited usefulness, but is implemented
in TurboCopy to ensure compatibility with xcopy.
/B
The /B option allows you to manually include and exclude files from the
copy. TC will list all files matching the source filespec(s) and you may
then select the files with the arrow keys and space. If only one file
matched the source filespec, TC will ignore the /B option and copy the
file without prompting. (Please refer to the section 'Manually selecting
files'.)
/C
The /C option is ignored if used without the /S option. The /C option
instructs TC not to create subdirectories on the destination (except the
base destination directory specified in the destination filespec). It is
useful if you want to search your hard drive for specific files and copy
them to floppy without their respective directories, e.g.
tc *.asm a:\asm\/sc
Assuming your current drive is your hard drive, TC will search the
entire drive and copy all .ASM files onto the \ASM directory on the
floppy disk in drive A:, creating the directory if necessary. TC will
warn you if two source files with the same name exists, and ask for an
appropriate action.
/D[D]:date
The /D option allows you to copy only files modified after or before a
certain date. The date must be in the format specified by the 'country='
setting in your config.sys file. The semicolon is not required and you
must use a "-" separator between numbers. The second (optional) D is to
specify that you want to copy only files modified before that date and
not after (or on) that date.
/E
This option instructs TC to assume that you want the source file to be
added to the end of the destination file, if the destination file
already exists. It is useful when adding together files that have been
sliced with TurboCopy (refer to section on file slicing/splitting) or
some other program. The following command will add four files together
into one big file: TC file0;file1;file2;file3 bigfile/e. It is
functionally the same as typing COPY /B file0+file1+file2+file3 bigfile.
/F[F]:filesize
This option works in much the same way as /D, except that you specify
the file size and not date. TC will only copy files larger or equal to
"filesize", unless you specify the second F in which case only smaller
files will be copied. You may specify that the size you typed is in K by
appending a "K" to the end of "filesize", e.g. TC *.txt a:/FF128k will
copy all .txt files smaller than 128k to drive a:.
/G
Usually TC preserves the source file's date and time when you copy
files, however you may specify (with this option) to use the current
date and time for the destination file.
/H[H]
The /H option instructs TC copy hidden and system files as well as
normal or read-only files. The default may be changed, please refer to
"Setting up TC". To disable the option if the default is "on", use /H-.
The second (optional) H is to tell TC to drop the hidden and system
attributes from the destination file.
/I
This option instructs TC not to overwrite files that already exist on
the destination drive. TC's default is to prompt the user when a file
already exists. TC will skip all existing files if /I is specified. The
source file will not be deleted if /X was specified and the archive
attribute bit will not be reset if the file is skipped.
/J
Normally TurboCopy sorts the files to be copied from large to small
before the copy process actually starts. The reason is that this causes
TC to waste the minimum amount of floppy disk space with multiple
diskette transfers. TC usually starts with the largest file first and
goes down the list until it finds a file that will fit, and then copies
it. If you specify /J, TC will rather copy the files sorted in the same
order as it would be for the /B option (have a look at the 'setting up
TC' section). Unless the default for /B is 'Sort by filesize' you would
probably waste more floppy disk space. However if it is more important
to you to have the files sorted alphabetically, use this option.
/K:outfile
Since TurboCopy uses direct screen access (for speed considerations),
the standard redirection commands < and > will not work properly.
However you can mirror TC's display output to a file using this option.
For example TC .doc a:\backup\ /K:"c:tcout.txt" will copy all .doc files
to the \backup\ directory on drive a: and mirror all display output to
the file tcout.txt in the default directory on drive c:. This option
reduces the available memory by 64K for it's display buffer which is
saved to disk when the program exits. If the output file exists, output
will be appended to it. Do not specify a output file in the source
directory or the file will be copied as well. Due to the nature of this
function (print intercept), TC will not display any error messages if it
fails to write the display output to the specified file.
/L:listfile
"/L:listfile" forces TC to read a file list from "listfile" and copy
only those files. Any source filespec specified on the command line is
ignored. You must still specify the source path and destination path,
since no directory or drive names are allowed in the list file. All the
standard wildcards are allowable though. The following command will read
the filenames to copy from mylist.txt:
TC c:\asm\ a:\backup\/l:mylist.txt
Where "mylist.txt" might contain something like this:
*.asm,tc.asm
*.doc,pogo.doc;*[1-9].dat
,file7.dat
Note that exclusions should generally follow inclusions, since TC scans
the whole list for each file, and decides the fate of each file on the
last positive match. Therefore ,tc.doc;*.doc will copy tc.doc, whereas
*.doc,tc.doc will not. To avoid confusion with other command line
options, you may put the filename in quotation marks (") or you may end
it with a forward slash (/). The colon following /L is not required.
/M
The /M option copies only files with their archive attribute set (like
/A), but unlike /A the source file's archive attribute is reset after
the copy. It is a most useful way of keeping track of files that have
been copied when doing an incremental backup.
/N
The /N option is much the same as the /O option (being that it will
overwrite the destination file if it exists), but it will only overwrite
the destination if the source file's date and time is later than the
destination's.
/O
The /O option will force TC to overwrite all destination files that
already exist.
/P
The /P option is ignored unless used with the /S option. When this
option is used with /S, TC will ask you whether it should copy each
subdirectory, one by one. It is useful when you want to do a complete
backup of your hard drive, but want to exclude one or two directories.
Example: TC c:\ a:/sp will ask which subdirectories it should copy.
/Q
The /Q[Q]:label option is most useful when you want to clear the
contents of your destination floppies if they already contain files. The
Q stands for Quickformat, so use this option with the necessary care.
The optional second Q is to force TC to quickformat the disk, otherwise
TC will prompt you if the disk already contains data. You may also
(optionally) specify a volume label for the disk. To avoid confusion
with other command line options, you may put the label name in quotation
marks (") or you may end it with a forward slash (/). You can optionally
number your disks by inserting an asterisk (*) in your volume label,
which TC will replace with the current disk number. Example:
tc . a:/qq"mydisk #*"
Will quickformat all destination floppies (unconditionally) and label
them mydisk #1, mydisk #2, mydisk #3 and so on. If you follow the Q's
with a colon, but don't specify a volume label, the current label will
be deleted. The /Q command will be ignored if the destination drive is
not a floppy drive or if the source and destination drives are the same.
Note that this comand does not actually reformat a floppy disk, it just
deletes all the files; therefore you should still be able to undelete
your files if you accidentally used this option.
/R
The /R option is most useful when used together with the /S and /X
options. After all files have been copied, TC will check all source
subdirectories and remove them if they are empty. For example:
tc d:\games c:\games\/srx
Will move your complete games directory (including subdirectories) from
drive D: to drive C:.
/S
The /S option forces TC to include all source subdirectories in the
copy. The subdirectories will be created on the destination unless /C
was specified. /P forces TC to prompt before each directory.
/T
This option allows you to specify a verbosity level. What it boils down
to is that you can tell TurboCopy how much useless information you want
displayed on the screen. /T9 is the most verbose while /T0 displays
nothing except error messages and prompts. TC ships with the maximum
setting (9) as default, but you may change it with the TC/U setup
option.
/U
The /U option allows you to configure TurboCopy for your personal needs.
It will pop up a menu box in which you can, for instance, set the
display colours. Use the up,down,left and right arrow keys to change
default selections. Pressing ENTER will prompt you whether you want to
save the changes or not. *NOTE* It is completely safe to compress TC
with executable file compressors like LZexe and PKLite, since TC
rewrites itself completely every time the configuration is saved. Please
refer to "Setting up TurboCopy".
/V
The /V option forces TC to verify all new files created on the
destination. If the destination is a floppy drive, and the floppy cache
is enabled TC will do a complete read after write verify, which is as
thorough a verify as you can get.
/W
/W forces TC to wait for a keypress before commencing operation. Useful
if you want to load TurboCopy from floppy and then want to switch disks
before the program starts copying.
/X
The /X option forces TC to move files to the destination, which means
that the source files will be deleted. If the source and destination
files are on the same disk TC uses the DOS rename function which speeds
the process considerably.
/Y[:source disks]
The /Y option allows you to specify that you want to copy from more than
one source diskette. TurboCopy will ask for the next source disk as they
are copied. You may optionally specify exactly how many floppies to ask
for (from 2 to 99). By default TurboCopy will go on until the user opts
to quit. If the source is not a floppy drive this option will be
ignored.
/Z
You may enable/disable the internal floppy writeback cache with /Z and
/Z-. You can also set the default fromout the setup menu (Refer to
"Setting up TC"). It is recommended that you keep the cache enabled
unless you experience compatibility problems with other packages. TC's
cache has been tested with Vadim Vlasov's Combi-Disk, Smartdrive and
Norton Cache and works fine (some systems have given problems with
Norton's delayed floppy writeback, but it is pointless to use two
writeback caches on the same drive at the same time in any case). Please
inform me if you experience problems with other cache programs.
*****************
*During the Copy*
*****************
While TurboCopy is busy copying files you may press Ctrl-Break to stop
the process completely or Escape to be prompted whether you want to skip
the current file. The amount of information TC displays while copying is
directly proportional to your /T setting. (Refer to setting up TC.)
****************************************
*What happens if a file already exists?*
****************************************
If a file already exists on the destination drive and you have not
specified how to handle the situation (with the N,O,I,E options), TC
will display the following message:
xxxxxxxx.xxx exists. AppEnd, SkIp all, Overwrite all or Rename?
where xxxxxxxx.xxx is the filename of the existing file. You may now
specify whether you want to overwrite the file, append it or change it's
name. Note that if you change the file's name it will only be valid for
the current disk. So if there is still not enough space for the file on
the disk containing the file with the same name, the file will be copied
onto the next disk with the original name (to prevent unnecessary
changing of filenames).
***************************************
*Manually selecting files to TurboCopy*
***************************************
If you are a fan of the popular Norton Commander package, I am sure you
will appreciate TC's manual file selection option. To be prompted to
select files manually, specify the /B option on the command line. TC
will then pop up the list of files matching the source filespec(s). You
may now select files either with a mouse (only in 80x25 mode) or with
the keyboard. The following are valid keystrokes:
'+' Allows you to type a wildcarded file selection string (like on
the command line).
'-' Same as '+', except files are unselected.
'*' The asterisk key will toggle all file selections.
'/' The forward slash key will unselect all files.
'ALT-S' Toggles the way in which the files are sorted. Files are
sorted either by extension, filename or filesize.
'ALT-F' Toggles all files in the same directory as the current file.
'ALT-A' Toggles 'keep directories together' setting. With this option
enabled TurboCopy will keep different directories separate in
the list.
'ALT-D' Deletes the currently highlighted file. (TC will ask for
confirmation.)
'ALT-R' Renames the currently highlighted file. (TC will ask for
a new name.)
'F8' Deletes all selected files, or the currently highlighted file
if no files are selected. (TC will ask for confirmation.)
'INS' The insert key will toggle the current file and move the cursor
down to the next file.
'SPACE' The spacebar will toggle the current file.
arrows You may use the arrows, the page up/down keys and home and end
to position the highlight (the blue marker with standard
colours).
'ENTER' Proceed to copy the marked files.
(You may also press Break or Escape at any time to abort the copy.)
*******************
*Slicing big files*
*******************
If TC detects that certain files are too big to fit on the destination
media type it will prompt you whether you want to slice the file into
smaller bits so it does fit. If you do decide to slice the file you will
be asked whether you want to change the file's extension or time or
whether you want to change nothing. If you opt to change the file's
extension, the first file's extension will remain intact, but from there
on the last two characters will be replaced with a 01, 02, 03 and so on,
depending on the number of disks required to hold the file. If you opted
to change the file time, the minutes part of the file's time will be set
in the same way as above. An easy way to add the files together again is
to use TurboCopy's /E option.
**********************
*Setting up Turbocopy*
**********************
If you want to personalize your copy of TC, you may do this with the /U
option. The following screen will pop up, and if you are in 80x25 text
mode, mouse support will be enabled:
|---------------------------------------------------------------------|
| TurboCopy V2.02 - Update Default Settings: |
| |
| [√] Copy hidden & system files (/H- disables) |
| [ ] Include subdirs in copy (/S- disables) |
| [ ] Verify destination files (/V- disables) |
| [√] Enable the floppy cache (/Z- disables) |
| [√] Enable FDRead floppy disk R/W emulation |
| [ ] /B defaults to all source files selected |
| [√] /SX options imply /R (/R- disables) |
| [√] Display cache status during writeback |
| [√] Assume ambiguous destination is a file |
| [ ] Keep directories separate in file list |
| {S} Dialogue box style (Single or Double) |
| {N} Sort filter (Name, fileSize or Extension) |
| {Standard} TurboCopy colour set selection |
| (1) Beep between multiple volumes (0 = none) |
| (9) Default text output verbosity level |
| (7 ) Attribute for normal text |
| (15 ) Attribute for highlighted text |
| |
| Change settings with the arrows and <SPACE>. <ENTER> to continue. |
|---------------------------------------------------------------------|
You can move the highlight with the arrow keys and you can change fields
with the left and right arrow keys (or space). ENTER ends the setup. Most
options are self-explanatory. I will briefly describe the others:
*I strongly recommended that you keep the floppy cache enabled unless you
want to use some other floppy writeback cache.
*The option to enable FDRead emulation allows TurboCopy to read and
write diskettes formatted to nonstandard capacity (e.g. 360K floppies
formatted to 720K capacity in a 1.2M drive). In the unlikely event that
your diskette drive is incompatible with this emulation, or if you
already have FDRead installed: disable it.
*The cache status box is the box with the stripe that TC pops up while
it is doing it's cache writeback. (Only displayed if amount of data to
be flushed is more than 8k.)
*The option to assume that an ambiguous destination is a file means that
TC will assume that the destination is a file if the destination has an
extension (few people give their directory names extensions) and it
cannot determine otherwise whether it is a file or directory.
*The dialogue box style is there so you can choose double line or single
line borders for all the popup boxes in TC.
*The file sort filter specifies how files should be sorted in the "Manual
file selection" box. If you specify file size, files will be sorted
into size groups (512 byte multiples - the standard floppy cluster
size) which in turn is sorted alphabetically.
*The beep between multiple diskette volumes is the beep that TC produces
when it prompts the user for the next disk in a multi-volume copy.
*The attributes are the colours that TC uses for the display.
******************
*Acknowledgements*
******************
I wish to thank everybody who encouraged me during the time it took me
to write TurboCopy, and also for everybody who gave their insights and
helped with the testing of the program. I would also like to thank
Christoph H. Hochstätter for so graciously putting the source for his
FDRead program in the public domain, which enabled me to make TC
compatible with his programs.
************
*Disclaimer*
************
I take no responsibility for damages arising from the use or the
inability to use this product. I have tried my utmost to make this
program as reliable as can be, but cannot be held responsible if
anything goes wrong. TurboCopy does not cache anything other than floppy
drives, and uses only standard DOS and BIOS function calls, so the
chances that you lose data due to a fault in the program is absolutely
minimal (if existent at all).
***************
*Compatibility*
***************
TurboCopy has been extensively tested on many machines, with excellent
results. It runs fine under DOS versions 3.00 through 6.00 and has been
tested under OS/2 and Microsoft Windows. So far I have only encountered
one machine that is incompatible with TC's built-in cache. Please inform
me if you have any problems.
*********
*License*
*********
The unregistered version of TurboCopy is not crippled in any way, it is
also not infested by nasty little advertisements, time delays, etc. like
many other programs. I assume that people have the decency to
acknowledge my hard work and make a contribution if they use this
program frequently. The registration is a ridiculously low fee of R20
($10 U.S. outside of the R.S.A) which means that nobody can afford not
to register.
******************************
*Messages & Technical support*
******************************
You may contact me by mail or, for the time being, through A. Mostert at
one of the E-Mail addresses given below:
mostert@cs.sun.ac.za
mostert@itu.sun.ac.za
-Pierre J. le Riche, October 1993