home *** CD-ROM | disk | FTP | other *** search
/ Shareware Supreme Volume 6 #1 / swsii.zip / swsii / 126 / 1PASS21.ZIP / ONEPASS.DOC < prev   
Text File  |  1993-05-23  |  14KB  |  362 lines
  1.                                                           ISBN 1-878830-03-1
  2.  
  3.    ▓▓▓▓▓                  ░░░░░░
  4.   ▓▓   ▓▓                  ░░  ░░
  5.   ▓▓   ▓▓ ▓▓▓▓▓▓   ▓▓▓▓▓   ░░  ░░  ░░░░░   ░░░░░   ░░░░░    
  6.   ▓▓   ▓▓ ▓▓   ▓▓ ▓▓   ▓▓  ░░░░░       ░░ ░░      ░░        The Single-Pass
  7.   ▓▓   ▓▓ ▓▓   ▓▓ ▓▓▓▓▓▓▓  ░░      ░░░░░░  ░░░░░   ░░░░░    Diskette Copier
  8.   ▓▓   ▓▓ ▓▓   ▓▓ ▓▓       ░░      ░░   ░░      ░░      ░░     v1.60
  9.    ▓▓▓▓▓  ▓▓   ▓▓  ▓▓▓▓▓  ░░░░     ░░░░░░  ░░░░░   ░░░░░
  10.  
  11.  
  12.                      copyright 1990, 1992 by Mike Gaskill
  13.           specification and documentation by Dave Williams
  14.  
  15.  OnePass is a replacement for DOS' "diskcopy" command.  Unlike diskcopy, 
  16. OnePass is not limited to available memory and does not require you to
  17. swap disks.
  18.  
  19.  Features of OnePass are:
  20.  
  21.      ■  Single-pass copying of any standard floppy disk, including 720k,
  22.         1.2Mb, 1.44Mb, and the new 2.88Mb diskettes.
  23.  
  24.      ■  Make multiple copies of the same disk without rereading original.
  25.  
  26.      ■  Save the swap file, archive it, or transfer it over the modem, then
  27.         build an exact copy of the original diskette.
  28.  
  29.      ■  Can swap to hard disk or RAMdisk.
  30.  
  31.      ■  Tested for compatibility under PC-DOS and MS-DOS versions 2.0
  32.         through 5.0, PC-MOS/386 versions 3.2 through 4.12, Digital Research
  33.         DR-DOS 3.40 through 5.01, and JP Software's 4DOS.
  34.  
  35.      ■  Automatic formatting of destination disk. (only if needed)
  36.  
  37.      ■  Suppress head track counter, 'another copy' prompt, completion tone.
  38.  
  39.      ■  New 'another copy' prompt: 'Would you like to make another copy of
  40.         this disk? Y/N' followed by, 'Would you like to make a copy of a
  41.         different disk? Y/N'.
  42.  
  43.  Besides making quick diskcopies without playing the floppy shuffle, OnePass 
  44. is also useful for duplicating software disks.  Diskettes created by OnePass
  45. are identical to the original - boot disks actually boot, etc.
  46.  
  47. Requirements:
  48.  
  49.  OnePass needs 64k of memory, one floppy drive, and a swap drive with enough
  50. space for the swap file plus 2k for additional information stored by OnePass.
  51.  
  52. How OnePass works:
  53.  
  54.  OnePass reads the source diskette at a low level, then builds an exact image 
  55. on the swap drive.  You may save the file or write it back to diskette 
  56. immediately.
  57.  
  58.  PAGE 2    ===========================ONEPASS.DOC===========================
  59.  
  60. Syntax:
  61.         onepass d: [/options]
  62.  
  63. where:  d:         drive to be copied. A or B.
  64.  
  65. options:
  66.        /[d:]       swap drive. This can be any valid DOS drive letter.
  67.                    colon is optional.
  68.  
  69.        /type       force drive to 360, 720, 1.2, or 1.44
  70.                    example: onepass A:/720      (force 720KB disk ID)
  71.                    You won't need this unless your machine's BIOS doesn't
  72.                    properly support drives over 360K.  Valid switches are
  73.                    /360, /720, /1.2, and /1.44.
  74.  
  75.     /!:image.dsk   use this name for OUTPUT image file. Any valid DOS pathname.
  76.  
  77.     /#:image.dsk   use this name for INPUT image file. Any valid DOS pathname.
  78.  
  79.     /&             quiet mode, turns off completion tone
  80.  
  81.     /?             help screen
  82.  
  83. *   /$             skips another copy prompt
  84.  
  85. *   /0:            writes zeros to temporary or saved image file
  86.                    example: onepass a: /0        (zero temp file before delete)
  87.                             onepass /0:infile    (zero a file saved earlier)
  88.  
  89. *   /^             suppress display of head track counter during format.
  90.  
  91. *   /v:            view file contents of a OnePass image file.
  92.                    example: onepass /v:c:\copies\copy1.dsk
  93.                            (displays as a directory, the contents of
  94.                            the OnePass image file 'copy1.dsk',
  95.                            located in the subdirectory 'copies'.
  96.                            If original disk had a label name, the label    
  97.                            is the first entry in the displayed directory.)
  98.  
  99. note:  to allow use of all 26 drive letters for swapping, OnePass uses !, #, 0,
  100.        $, ^  and & to enable other command line parameters.
  101.        OnePass now provides auto formatting. (only when needed)
  102.  
  103.        * Registered version only.
  104.  
  105.  PAGE 3    ===========================ONEPASS.DOC===========================
  106.  
  107. Running OnePass:
  108.  
  109.  Here are some examples of OnePass at work:
  110.  
  111. ONEPASS  A:
  112.         
  113.        copy drive          swap drive     ║  copy A: drive using defaults
  114.        ┌─────────┐         ┌─────────┐    ║
  115.        ╞═══███═══╡   ──>   │hard disk│    ║
  116.        └─────────┘         └─────────┘    ║
  117.         A: 1.44Mb         C: hard disk    ║
  118.  
  119.  
  120. ONEPASS  A:  /E:
  121.  
  122.        copy drive          swap drive     ║  copy A: drive using hard drive E:
  123.        ┌─────────┐         ┌─────────┐    ║  for swapping
  124.        ╞═══███═══╡   ──>   │hard disk│    ║
  125.        └─────────┘         └─────────┘    ║
  126.         A: 1.44Mb         E: hard disk    ║
  127.  
  128. ONEPASS  A:    /720
  129.  
  130.        copy drive          swap drive     ║  forces OnePass to treat A: drive
  131.        ┌─────────┐         ┌─────────┐    ║  as a 720k device. Some clone BIOS
  132.        ╞═══███═══╡   ──>   │hard disk│    ║  have trouble with diskette sizes
  133.        └─────────┘         └─────────┘    ║  larger than 360k. Use only if
  134.         A: 1.2Mb          C: hard disk    ║  needed.
  135.  
  136.  
  137. ONEPASS  B:  /Q:
  138.  
  139.        copy drive          swap drive     ║  copy B: using network drive Q:
  140.        ┌─────────┐         ╔═════════╗    ║  for swapping
  141.        ╞═══███═══╡   ──>   ║ network ║    ║
  142.        └─────────┘         ╚═════════╝    ║
  143.         B: 1.2Mb         Q: network drive ║
  144.  
  145. ONEPASS  A: /B:
  146.  
  147.        copy drive          swap drive     ║  copy 1.2 floppy using 1.44 floppy
  148.        ┌─────────┐         ┌─────────┐    ║  for swapping
  149.        ╞═══███═══╡   ──>   ╞═══███═══╡    ║
  150.        └─────────┘         └─────────┘    ║
  151.         A: 1.2Mb            B: 1.44Mb     ║
  152.  
  153.  
  154.  PAGE 4    ===========================ONEPASS.DOC===========================
  155.  
  156. ONEPASS  A: /F:
  157.  
  158.        copy drive          swap drive     ║  copy 1.2 floppy using RAMdisk
  159.        ┌─────────┐         ╔═════════╗    ║  for swapping
  160.        ╞═══███═══╡   ──>   ║ RAMdisk ║    ║
  161.        └─────────┘         ╚═════════╝    ║
  162.           720k             F: RAMdisk     ║
  163.  
  164.  
  165. ONEPASS  A:   /!:D:\PROGS\DISK.1
  166.  
  167.        copy drive          swap drive     ║  copy A: drive, save swap file as
  168.        ┌─────────┐         ┌─────────┐    ║  DISK.1 in D:\PROGS
  169.        ╞═══███═══╡   ──>   │hard disk│    ║
  170.        └─────────┘         └─────────┘    ║
  171.         A: 1.44Mb         D: hard disk    ║
  172.  
  173.  
  174. ONEPASS  B:   /#:C:\DISK.1
  175.  
  176.        copy drive          swap drive     ║  copy A: drive, use existing swap
  177.        ┌─────────┐         ┌─────────┐    ║  file DISK.1 in default directory
  178.        ╞═══███═══╡   ──>   │hard disk│    ║  of C:
  179.        └─────────┘         └─────────┘    ║
  180.         B: 1.2Mb          C: hard disk    ║
  181.  
  182. ONEPASS  A:   /!:D:\PROGS\DISK.1 /&
  183.  
  184.        copy drive          swap drive     ║  copy A: drive, save swap file as
  185.        ┌─────────┐         ┌─────────┐    ║  DISK.1 in D:\PROGS and turn off
  186.        ╞═══███═══╡   ──>   │hard disk│    ║  tone
  187.        └─────────┘         └─────────┘    ║
  188.         A: 1.44Mb         D: hard disk    ║
  189.  
  190.  
  191. ONEPASS  B:   /#:C:\DISK.1 /$
  192.  
  193.        copy drive          swap drive     ║  copy A: drive, use existing swap
  194.        ┌─────────┐         ┌─────────┐    ║  file DISK.1 in default directory
  195.        ╞═══███═══╡   ──>   │hard disk│    ║  of C: and turn off another copy
  196.        └─────────┘         └─────────┘    ║  prompt.
  197.         B: 1.2Mb          C: hard disk    ║
  198.  
  199. ONEPASS  B:   /#:C:\DISK.1 /^
  200.  
  201.        copy drive          swap drive     ║  copy A: drive, use existing swap
  202.        ┌─────────┐         ┌─────────┐    ║  file DISK.1 in default directory
  203.        ╞═══███═══╡   ──>   │hard disk│    ║  of C: and turn off head track
  204.        └─────────┘         └─────────┘    ║  counter during format.
  205.         B: 1.2Mb          C: hard disk    ║
  206.  
  207.  
  208.  PAGE 5    ===========================ONEPASS.DOC===========================
  209.  
  210. Registering OnePass:
  211.  
  212.                              What's in it for me?
  213.  
  214.         If you use OnePass regularly, we'd like you to register. Now,
  215.         we're realistic people and realize some people take a while to
  216.         get a "round tuit", so we'll sweeten the deal a bit.
  217.  
  218.     Send in our puny $15 fee, and you'll get:
  219.  
  220.         1) The very latest revision of 1PASS.EXE on 5 1/4 or 3 1/2 media.
  221.  
  222.         2) /$ Toggle to turn off "another?" prompt.
  223.  
  224.         3) /0 Security erase of OnePass swap files.
  225.  
  226.         4) Automatic formatting of destination disk.
  227.            (Onepass formats only when necessary.)
  228.  
  229.         5) Bad sector checking of destination disks.
  230.            Because OnePass duplicates the entire disk (including the fat)
  231.            bad sectors are not allowable on the destination disk. OnePass
  232.            verifies the format or examines the fat of a preformatted disk
  233.            for bad sectors, informs the user then prompts for a new disk
  234.            and retry. (not available before v1.50)
  235.  
  236.         6) /^ Supress OnePass' head track counter during format.
  237.            This helps to speed the formatting process by eliminating a
  238.            procedure in the OnePass code. The enhanced speed is much more
  239.            obvious on 25 mhz or greater.
  240.  
  241.         7) /v: View contents of a OnePass image file as if it were the
  242.            directory of a disk. (If original disk had a label name, the
  243.            label is the first entry in the displayed directory.)
  244.         
  245.         8) Support for the new 2.88Mb floppy disks.
  246.            note: 2.88Mb support will be added when
  247.            tecnical information is released.
  248.  
  249.         9) Access to the OnePass support BBS.
  250.  
  251.        10) Our handy upgrade policy - just send a stamped, self addressed
  252.            mailer and disk and we'll return the latest version of OnePass
  253.            for no extra charge.
  254.  
  255.        11) Printed manual.
  256.  
  257. PAGE 6    ===========================ONEPASS.DOC===========================
  258.  
  259.   To make life easier, we've included a handy instant mailer - just print,
  260. fold, and stamp.  For business users, we've also included an invoice you
  261. can print and send to your accounting department. Such a deal!
  262.  
  263.  
  264.                              COMMING SOON!
  265.  
  266.                             ONEPASS TOOLBOX
  267.                                including:
  268.  
  269.     OnePass command line execution tutor:  Learn what OnePass can really do,
  270. and see exactly how to do it. OnePass switch options are displayed and the
  271. user is prompted for switch selections from a simple menu. OnePass displays
  272. your input on a simulated command line using the syntax required for execution
  273. from the DOS command line. Then, at the user's request, OnePass executes your
  274. selected options. (late 1992)
  275.  
  276.    OnePass utilities:  Examine a OnePass image file disk copy and extract
  277. any desired file to diskette or nonremovable media. Archive your OnePass
  278. image file for easy storage and dispersion. Search the webwork of your
  279. harddisk directories for the lost or escaped OnePass image file. Examine
  280. the fat of any propesctive OnePass destination disk for bad sectors before
  281. you attempt a OnePass copy. (early to mid 1993)
  282.  
  283.  
  284. note from the author:
  285.  
  286.         I would like to thank Dave Williams whose DOS Technical
  287.         Reference was absolutely indispensable as was the man. OnePass
  288.         could very easily be nonexistent. In case I haven't said it
  289.         enough Dave, THANKS A MILLION!
  290.  
  291.         I would also like to thank Gerry Ryan of DB Solutions Pty. Ltd.
  292.         in far away Australia for his suggestion and improvement on
  293.         my 'another copy' prompt. Thanks man.
  294.  
  295.         And a special thanks to all my beloved registered users. You'll
  296.         be hearing from me............later.................m.g.            
  297.         
  298.  
  299. ******************************DISCLAIMER*************************************
  300.  
  301.  
  302.         Sorry folks. I do the best I can but I can't promise that OnePass
  303.         won't make a machine out there do crazy stuff, or even damage a 
  304.         piece of hardware. I do promise to try and fix any bugs that are
  305.         severe enough to merit the work..............
  306.         
  307.  
  308.  
  309. PAGE 7    ===========================ONEPASS.DOC===========================
  310.    
  311. About Shareware:
  312.    
  313.    Shareware (also known as user supported software and other names) is a
  314.    concept not understood by everyone.  The authors of Shareware retain all
  315.    rights to the software under the copyright laws while still allowing
  316.    free distribution.  This gives the user the chance to freely obtain and
  317.    try out software to see if it fits his needs.  Shareware should not be
  318.    confused with Public Domain software even though they are often obtained
  319.    from the same sources.
  320.    
  321.    If you continue to use Shareware after trying it out, you are expected
  322.    to register your copy with the author and pay a fee. In exchange you get
  323.    the latest version, updates, and support.
  324.    
  325.  
  326.                          Thank you for your support!
  327.  
  328.  
  329.    Use the information in INVOICE.ONE or MAILER, or send your check or money 
  330. order (US funds) to:
  331.  
  332.  
  333.                 Mike Gaskill                      P.H.# (501)-982-8273
  334.                    OnePass
  335.         1310 Smithwick #238
  336.                 Jacksonville AR 72076-0181 USA
  337.  
  338.  
  339.   If you have questions or comments, address them to me at the above 
  340. address, or at The Courts of Chaos BBS, (501)982-0059.
  341.  
  342.  
  343. History:
  344.  
  345. 12/22/90  v1.0   original release
  346. 12/26/90  v1.01  changed help screen, updated documentation
  347. 02/05/91  v1.02  altered several display strings
  348.                  updated documentation for registerd version
  349. 01/12/92  v1.50  installed auto formatting.
  350. 01/19/92  v1.50  installed bad sector checking of destination disk.
  351. 01/29/92  v1.51  installed new 'another copy' prompt.
  352. 04/02/92  v1.53  added message scrolling.
  353. 04/11/92  v1.55  now copies bad sectored disks.
  354. 09/12/92  v1.60  makes multiple copies
  355.  
  356.  
  357.         OnePass is coded in 100% assembly language by Michael Gaskill.
  358.                Specification and documentation by Dave Williams.
  359.  
  360.         Special or corporate branded versions available at extra cost.
  361.               Enquire for business or government site licensing.
  362.