home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / disk / copy_utils / copyc_demo / copy-c.doc < prev    next >
Text File  |  1995-02-27  |  18KB  |  461 lines
  1. ******************************************************************************
  2.          _______    ____    ______  __     __       _______
  3.         /  _____|  / __ \   |  _  \ \ \   / /      /  _____|
  4.         | /       | /  \ |  | |_| |  \ \_/ /  ___  | /
  5.   THE   | |       | |  | |  | ____/   \   /  |___| | |              MANUAL
  6.         | |       | |  | |  | |        | |         | |
  7.         | \_____  | \__/ |  | |        | |         | \_____
  8.         \_______|  \____/   |_|        |_|         \_______| V1.0
  9.  
  10.  
  11. ******************************************************************************
  12. THE DISK: The Copy-C disk must contain the following files:
  13.  
  14.      s (dir)
  15.        Copy-C.config                    startup-sequence
  16.      libs (dir)
  17.        powerpacker.library              
  18.      mods (dir)
  19.        mod.copy-c_song.pp               
  20.   Copy-C.doc                       Copy-C.doc.info
  21.   Copy-C_DEMO                      Copy-C_DEMO.info
  22.   Disk.info                        
  23.  
  24.  
  25.  
  26. RIGHTS: The docs and the program mustn't be changed by anyone who has not the
  27.         permission of the programmer.
  28.  
  29.         The demo versions of Copy-C(VX.XD)may freely be copied and
  30.         distributed in every way as long as the docs are with the program.
  31.  
  32.         The full version of Copy-C(VX.X)mustn't be copied.Anyone who has
  33.         bought it from me may of course do some copies for himself.The
  34.         Copyright of Copy-C has the author,Ludwig Huber.If you want to
  35.         distribute the full version of Copy-C in some way,you must contact
  36.         the author first.     
  37.  
  38. ******************************************************************************
  39.  
  40.                         How to get the full version?
  41. ------------------------------------------------------------------------------
  42. To get the full version send 20DM or $13 to:
  43.  
  44.                                 Ludwig Huber
  45.                             Wilhelm-Busch-Weg 14
  46.                                8900 Augsburg
  47.                                  W.Germany
  48.  
  49. from 1.7.1993 on,use
  50.                                 Ludwig Huber
  51.                             Wilhelm-Busch-Weg 14
  52.                                86161 Augsburg
  53.                                   Germany
  54.  
  55.          Tell me if you want your name to be shown in the program!
  56.  
  57. ******************************************************************************
  58. BUG REPORT: If you find bugs or things that worry you in my programs,if they
  59.             don't run at all,also if you have new ideas to improve Copy-C 
  60.             write me an E-mail or a letter.Don't forget to tell me the
  61.             conditions,under which it happened(AXXXX,HD?,68xxx...).
  62.  
  63.  
  64. ******************************************************************************
  65. REQUIREMENTS:   OS 1.2 or higher,
  66.                 1MB RAM or more,
  67.                 min. one 3½"disk drive.         
  68. ******************************************************************************
  69.  
  70.         WARNING:THE AUTHOR TAKES NO RESPONSIBILITY
  71.                 FOR DAMAGES CAUSED BY COPY-C!
  72.  
  73.  
  74.                            WHAT IS Copy-C ?
  75. ------------------------------------------------------------------------------
  76. Copy-C is a Disk Tool for making SECURITY-COPYS of your disks or FORMATTING,
  77. CHECKING...them.It was fully written in Assembler language and I think it's
  78. pretty fast.
  79. ------------------------------------------------------------------------------
  80.  
  81.  
  82.  
  83.                            HOW TO START IT
  84. ------------------------------------------------------------------------------
  85. When you start Copy-C,no other disk activities(except loading it) should run.
  86. To start Copy-C,you have to load the file "Copy-C" from the CLI or click on
  87. the ICON when using the WORKBENCH.If there'll be some requestors like
  88. "NOT A DOS DISK IN DFX" ,just CANCEL them.If nothing happens after you've
  89. tried to start it,the reason could be that there is not enough (CHIP) Ram
  90. available.
  91. ------------------------------------------------------------------------------
  92.  
  93.  
  94.          NOTE:  IF YOU JUST WANT TO USE THE STANDART OPERATIONS,YOU DON'T
  95.                 HAVE TO READ THE EXPLANATIONS ON SYNCWORDS AND
  96.                 START/END/TARGET TRACKS.
  97.  
  98.  
  99.              HOW TO USE ALL THESE GADGETS AND DISPLAYS ?
  100. ------------------------------------------------------------------------------
  101. After you've succeeded in starting Copy-C,you'll face a new SCREEN with a
  102. lot of gadgets.Here you see the functions and the use of them:
  103.  
  104. QUIT
  105.  
  106. To quit,click the point at the top and full left.
  107.  
  108.  
  109. SOURCE/TARGET DRIVES
  110.  
  111. At the disk symbols,you see the drives you have and can select them to be
  112. the SOURCE or (one of) the TARGET DRIVE(s).All symbols are grey when they
  113. are unselected.A selected SOURCE symbol is yellow,a selected TARGET symbol
  114. is VIOLET (means VERIFY ON) when clicked once and BLUE(means VERIFY OFF)
  115. when clicked again.VERIFY means that,after write operations,the data is
  116. tested to be on disk as expected(if it isn't,a WRITE ERROR is displayed).
  117. VERIFY MODE should always be turned on when you don't test a disk afterwards
  118. anyway.If you copy a disk when a drive is SOURCE and TARGET the program will
  119. copy using the ram.
  120.  
  121.  
  122. MODE
  123.  
  124. THE "MODE" GADGET is used to choose the different ACTIONS that Copy-C offers.
  125. (clicking on it with the LEFT MOUSEBUTTON changes to the next MODE in the list
  126. ,using the RIGHT MOUSEBUTTON changes to the previous MODE)
  127.  
  128.  
  129. START/END/TARGET BLOCK/TRACK
  130.  
  131. Above and Below these numbers,there are arrows that you can click on to change
  132. the values.The '1's or '0's(click on it to change them)behind the track values
  133. show the side of the track to start/end or to copy to.The BEGIN/END TRACK(!)
  134. values can also be changed by just clicking in the TRACKDISPLAY(it's the GRID
  135.  with numbers at the edge).The functions may differ at the different MODEs ,
  136. so see the explanation at "MODES".You can select tracks up to track 81,but not
  137. all disk-drives can use this.If you go to a track that a drive can't reach
  138. ,this could cause big problems(=>damaged copies,NAME MODE shows errors on
  139. correct disks...).So if you don't know sure if your drive(s) can go up to
  140. track 81/80,select only tracks up to track 79.
  141.  
  142.  
  143. SOURCE/TARGET SYNC
  144.  
  145. Here,you can change(as above) the values of the SOURCE/TARGET SYNCWORD.These
  146. can be used to work with disks of different syncwords or to change the
  147. syncword of a disk.They have no meaning during the DIRECTORY MODE.There's a
  148. button left of the two syncword displays that can be used to reset the
  149. SOURCE/TARGET SYNCs to normal.
  150.  
  151.  
  152. USE
  153.  
  154. Here,you can choose between "DSK" and "RAM".When "RAM" is selected,the program
  155. is forced to COPY DISKs by loading them in the ram and then writing them out
  156. of the ram on another disk.The advantage in "RAM" mode is that you're asked
  157. to repeat the writing(if you want to copy something to several disks).In "DSK"
  158. mode,copying without using ram is prefered(it's faster).
  159.  
  160.  
  161. START/STOP/REPEAT
  162.  
  163. Using "START",you start the ACTION that you've chosen.During an ACTION,you
  164. can ABORT using the STOP gadget.Whenever a disk is copied using RAM,you'll
  165. have the possibility to "REPEAT".If you then click on the REPEAT gadget,the
  166. data in RAM will be written again to the TARGET drive(s).
  167.  
  168.  
  169. NAME/CHECK
  170.  
  171. These are two MODEs that you can start quickly by clicking on their gadgets.
  172. If you click on "CHECK" using the LEFT MOUSEBUTTON, the MODE "CHECKDISK" is
  173. started,if you use the RIGHT MOUSEBUTTON, the MODE "BAMCHECK" is started.
  174. By clicking on the NAME gadget using the RIGHT MOUSEBUTTON,you can enter the
  175. NAME-MENU.IN this menu,you can choose if DISKNAMES are to be recorded before
  176. copy operations(and displayed in this menu) or not.You also can clear the
  177. NAMESLIST there.
  178.  
  179.  
  180. BACK
  181.  
  182. Whenever you use this,all values are set to normal.
  183.  
  184.  
  185. HELP
  186.  
  187. If you click on this gadget or hit the HELP-KEY of your keyboard,you'll
  188. get a short information on the READ ERRORS displayed in the TRACKDISPLAY.
  189.  
  190.  
  191. TIME
  192.  
  193. At this place,you can see how much time has gone since you started the last
  194. ACTION.The time stops to count when an ACTION is canceled or has finished.
  195.  
  196.  
  197. PREFS
  198.  
  199. Clicking on this one,you enter the PREFERENCES MENU.There,you can save all
  200. parameters(to "S:Copy-C.config") so that they remain the same when you start
  201. the program again.In this menu,you can also choose if VERIFY should be done in
  202. DIRECTORY MODE(it's called "FILEVERIFY").Changing the "RETRYS" value,you can
  203. specify how often the program should try again when READ/WRITE ERRORS occur.
  204. If you want a Noise/Protracker Module to be played during Copy-C runs,enter
  205. the filename in this menu and select "SONG:ON".The switches about DIRSORT and
  206. ARROWS can be used to change the DIR-DISPLAY in DIRECTORY MODE.
  207.  
  208.  
  209. TRACKDISPLAY
  210.  
  211. During ACTIONS,you can watch here the tracks that are read or written.READ
  212. ERRORS are displayed in red numbers(use HELP gadget/key),WRITE ERRORS(ONLY
  213. DISPLAYED WHEN using VERIFY) are displayed in blue numbers(the number is the
  214. drive's).IF NO ERROR has happened,a brown "0" is displayed.
  215.  
  216.  
  217. TEXTFRAME
  218.  
  219. Here, all (ERROR)MESSAGES and QUESTIONS for the user are displayed.If you have
  220. to input a Disk-Name or something like that,you do it here.
  221.  
  222. ------------------------------------------------------------------------------
  223.  
  224.  
  225.  
  226.                    WHAT DO THESE DIFFERENT MODES DO ?
  227. ------------------------------------------------------------------------------
  228. Here you see the functions and the parameters of the different ACTIONS.
  229.  
  230. ******************************************************************************
  231. But first ,some little remarks about...
  232.  
  233. TRACKS:
  234. All DISKS are divided in tracks.Every track has two sides(you can see this in
  235. the TRACKDISPLAY).
  236.  
  237. SYNCWORDS:
  238. In all modes,except DIRECTORY MODE,tracks are read using the SOURCE SYNC,
  239. and written using the TARGET SYNC.In DIRECTORY MODE,the normal syncwords
  240. (READS & WRITES $4489) are used.
  241.  
  242. DISK ERRORS:
  243. If WRITE ERRORS are shown in the grid after an operation,something went wrong.
  244. Then, you should try (an)other TARGET DISK(s).But if the SOURCE disk already
  245. had READ ERRORS,this can be the reason for the data not to be able to be
  246. copied!
  247.  
  248. DISKS:
  249. Normal AmigaDOS disks only use the tracks from 0 to 79,so for a standart
  250. copy/check/... operation,only these tracks need to be selected.
  251. ******************************************************************************
  252.  
  253.  
  254. NAME
  255.  
  256. This gives you some information about the SOURCE DISK.It shows the name of the
  257. SOURCE and shows if it is bootable
  258.  
  259.  
  260. CHECK
  261.  
  262. It checks the SOURCE TRACKS beginning at the STARTTRACK and ending at the
  263. ENDTRACK.Using it,you can see if READ ERRORS are on a disk.
  264.  
  265.  
  266. BAMCHECK
  267.  
  268. BAMCHECK works just like CHECK,but only the tracks used by Files are tested.
  269. This is useful,when a disk was copied with BITM.COPY,and you want to check
  270. only the tracks that were copied.
  271.  
  272.  
  273. DOSCOPY
  274.  
  275. DOSCOPY is used to copy disks.
  276. DOSCOPY copys the tracks beginning at STARTTRACK and ending at ENDTRACK
  277. from the SOURCE to the tracks of the TARGET(s) beginning at TARGETTRACK.
  278.  
  279.  
  280. FORMAT
  281.  
  282. FORMAT formats (a) disk(s) so that it/they can be used by AmigaDOS.
  283. FORMAT formats the tracks of the TARGET(s) beginning at STARTTRACK(!) and
  284. ending at ENDTRACK.
  285. During the tracks are formatted,you'll be asked a few questions about the
  286. filesystem and the bootblock of the disk to be made.You "answer" them by
  287. pressing the corresponding key shown in brackets.
  288. The possibilities are:
  289.  
  290.         OFS             normal FileSystem
  291.         FFS             FastFileSystem          (only OS2.0 or higher)
  292.         CLEAR           no INITIALIZING(no FileSystem)
  293.  
  294.         INTER.          International MODE      (only OS2.0 or higher)
  295.         DirCache        DirectoryCache          (only OS3.0 or higher)
  296.         NORM            no International MODE/DirCache
  297.  
  298.  
  299.         BOOTABLE        create bootable disk
  300.         DATA            create non-bootbable disk
  301.  
  302.  
  303. After this,you will have to enter the disk name.If you just hit return,the
  304. disk name will be "CLR $XXXX",where "XXXX" counts upwards after every format.
  305. If you have selected several TARGETs,you'll have to enter all this again for
  306. the other disks.
  307.  
  308.  
  309. FORMATQ
  310.  
  311. FORMATQ works just like FORMAT,but it doesn't format the TARGET tracks,but
  312. just initializes the TARGET DISK(s).For this reason,you will of course not be
  313. asked the "CLEAR" option.
  314.  
  315.  
  316. CODE+COPY
  317.  
  318. This MODE copies a disk like DOSCOPY,but codes the tracks before writing.
  319. At the beginning of this ACTION,a CODE of 4 Letters(an 'A' is not an 'a'!)
  320. has to be entered.As the chosen CODE is not shown too long after hitting
  321. return,you should remember it in some way.To DECODE a CODED disk,you use the
  322. same MODE with the same CODE again (only the former TARGET is now the SOURCE).
  323.  
  324. In this way,you can make sure,that only the person who knows the code(I hope
  325. that's you!) can get the data of the disk back.
  326.  
  327.  
  328. KILLDISK
  329.  
  330. KILLDISK destroys the data of TARGET tracks beginning at STARTTRACK(!) and
  331. ending at ENDTRACK.
  332.  
  333.  
  334. COMPDISKS
  335.  
  336. This MODE can be used to COMPARE TWO(or more) DISKs.
  337. "COMDISKS" works nearly like DOSCOPY,only,nothing is written on the TARGET
  338. disk and the data of the SOURCE is compared to that of the TARGET(s).Therefore
  339. ,in the program,the TARGET will be called the "2.SOURCE".If the data of the
  340. SOURCE track is not equal to the data of the TARGET track,this will be shown
  341. BLUE in the TRACKDISPLAY,just like at WRITE ERRORS.
  342.  
  343.  
  344. RELABEL
  345.  
  346. You can rename the TARGET disk(s) with this.All you have to do is to start it
  347. and enter the new diskname(s).
  348.  
  349.  
  350. INSTALL
  351.  
  352. After you've started it,you'll be asked the type of bootblock((non)bootable)
  353. to be installed on the TARGET disk(s).
  354.  
  355.  
  356. BLOCKCOPY
  357.  
  358. BLOCKCOPY can be used to copy blocks to different places on disks.
  359. This copys the SOURCE BLOCKs beginning at STARTBLOCK and ending at ENDBLOCK to
  360. the TARGET BLOCKs beginning at TARGETBLOCK.
  361.  
  362.  
  363. BITM.COPY
  364.  
  365. BITMAPCOPY nearly works like DOSCOPY,the difference is that BITM.COPY only
  366. copies the tracks that are used by Files.But be careful:if there were already
  367. READ ERRORS on the TARGET disk(s),they might be still on it after such a copy.
  368. (if this occurs,the TARGET can only be used to READ files from it)
  369.  
  370.  
  371. ADD DFX
  372.  
  373. Using this option,you have the possibility to activate drives that YOU turned
  374. on after Copy-C was started.(these are not activated for AmigaDOS)
  375.  
  376.  
  377. DIRECTORY
  378.  
  379. To start this,you need enough RAM.If you succeeded in starting it, a new
  380. screen opens and you see some more gadgets.Things you should know are shown
  381. to you in a special window.When you click ,using the RIGHT MOUSEBUTTON,the
  382. gadget left at the top ,you'll be able to choose the drive to read the dir
  383. from.You cancel this and most other operations by clicking "CANCEL".When a
  384. dir has been read,you can see it on the screen.Clicking on a file using the
  385. LEFT MOUSEBUTTON,you select it,using the RIGHT MOUSEBUTTON,you see the subdir
  386. (if it is a dir) or a display of the file.The filedisplay shows the following
  387. filetypes:
  388.  
  389. ******************************************************************************
  390. BINARY files,ASCII texts,IFF/ILBM pictures,NOISE/PROTRACKER MODULES;
  391.  
  392. All these files are decrunched if they are POWERPACKED files and the
  393. "powerpacker.library" was in the "LIBS:" directory while starting Copy-C.
  394. You can find the powerpacker.library on your Copy-C disk.
  395. The powerpacker.library is (C) by Nico François.
  396.  
  397. During the display of ASCII texts or BINARY files,you can choose some options
  398. that should help you to read a text.Here you see a short explanation:
  399.  
  400.  
  401.    GADGET    |            explanation                | corresponding keys
  402. ------------------------------------------------------------------------------
  403. "EXIT"       | you quit the filedisplay with this    |  Esc
  404. "<"          | lets you go up in the text            |  cursor up
  405. ">"          | lets you go down in the text          |  cursor down
  406. "<<"         | lets you go down one page in the text |  shift + cursor up
  407. ">>"         | lets you go down one page in the text |  shift + cursor down
  408. "T"          | lets you go to the top of the text    |  LEFTAmiga + T
  409. "B"          | lets you go to the bottom of the text |  LEFTAmiga + B
  410. "PRINT"      | prints the ascii/hex file             |          -----
  411. "SEARCH"     | enables you to search for a string    |  LEFTAmiga + S
  412.              | in the menu use:                      |
  413.              | "CANCEL" = LEFTAmiga + C              |
  414.              | "HEX"    = LEFTAmiga + H              |
  415.              | "ASCII"  = LEFTAmiga + A              |
  416.              | and do what you're told.              |
  417. "REPRINT"    | clears the result of the last search  |  SPACE
  418. ------------------------------------------------------------------------------
  419.  
  420. All other display-modes can be quitted by just clicking the LEFT MOUSEBUTTON.
  421. ******************************************************************************
  422.  
  423. Clicking on the "A/C" gadget using the LEFT MOUSEBUTTON selects all files,
  424. using the RIGHT MOUSEBUTTON unselects all files.The "PARENT" gadget starts
  425. loading the parent directory if the actual directory is a subdir.
  426. You can enter the FILETOOL-MENU using the RIGHT MOUSEBUTTON on "-MENU-".
  427.  
  428. Now some short explanations on the actions in the FILETOOL-MENU:
  429. ******************************************************************************
  430. (The writing operations here are all influenced by "FILEVERIFY ON/OFF" in
  431.  the prefs menu)
  432.  
  433. REMARK: As there's no possibility to copy files to some kind of ram disk in
  434.         my program,the filecopy-mode "COPY>T" only finds use if you have more
  435.         than 1 drive.
  436.  
  437.  
  438.  ACTION |              explanation
  439. ------------------------------------------------------------------------------
  440. SET->T  |  sets the actual directory to be the TARGET DIRECTORY
  441. COPY>T  |  copys the selected files to the TARGET DIRECTORY
  442. MOVE    |  shifts the selected files on a disk between subdirs
  443. DELETE  |  deletes all selected files
  444. RENAME  |  gives you the possibility to rename the selected files
  445. MDIR    |  creates a subdir in the actual directory
  446. ------------------------------------------------------------------------------
  447. ******************************************************************************
  448.  
  449. You quit the DIRECTORY MODE by clicking on the "EXIT" gadget.
  450.  
  451.  
  452.  
  453. ##############################################################################
  454. last changes in manual done on 24.5.1993
  455.  _         _   _
  456. ( )       ( )_( )
  457. ( )_   _  (  _  )  _   UUCP: midas@tomtec.abg.sub.org
  458. (___) (_) (_) (_) (_)
  459. The manual was written and Copy-C was programmed by Ludwig Huber.
  460. ##############################################################################
  461.