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.03C by Pierre J. le Riche 1991-95 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. (I have found that many people feel writing out cheques is a hassle. Simply pop a $10 banknote, or it's equivalent, in the envelope if you prefer - I doubt whether $10 is worth the risk of trying to snitch it!) 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: 9231498@firga.sun.ac.za s9231498@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.03C ---------- Pierre J. le Riche ---------- 25 August 1995. 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. 6) From version 2.03B onwards, TC allows the specification of multiple destination filespecs. Instead of typing a single destination, you may specify something like 'tc . d:\mydir\dest[1][2]\*.*'. This will effectively copy all the files in the current directory to 'd:\mydir\dest1\' as well as 'd:\mydir\dest2\'. You may specify as many destinations as you like. 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[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. The second (optional) L forces TC to treat the listfile quite differently. Files are copied in the order they appear in the listfile. Leave one or more lines open to indicate the next destination disk, for which TC will prompt (TC will only keep track of the first 32 destination disks). The /Y option will be disabled with the /LL option active. Listfile size is limited to 8k. /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[Q]:label 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.03 - 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 . 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.22 (including shells like 4DOS and NDOS), 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, at one of the E-Mail addresses given below: 9231498@firga.sun.ac.za s9231498@itu.sun.ac.za -Pierre J. le Riche, August 1995