home *** CD-ROM | disk | FTP | other *** search
/ Amiga Magazin: Amiga-CD 2000 April & May / AMIGA_2000_04.iso / patches / identcdr / identcdr.doc < prev    next >
Text File  |  1999-12-16  |  5KB  |  138 lines
  1. IdentCDR - Documentation
  2.  
  3. 1. Purpose
  4.  
  5. This small tool gives you some information about CD-R media; the main feature is
  6. the brand recognition, done through ATIP (Absolute Time In Pre-groove).
  7. It also gets some additional data, like maximum capacity of the CD-R and maximum
  8. allowed recording capacity (which is always a bit less than the first one).
  9.  
  10.  
  11. 2. Requirements
  12.  
  13. First of all, a SCSI CD-R burner. IdentCDR can work with CD-ROMs, but will give
  14. you very little information compared to a full blown CD-R burner. CD-R burners
  15. know much more about a CD-R media than a reader.
  16. Reqtools.library and a 68020 or better are mandatory since version 1.2 .
  17. Last but least, a SCSI host adapter which can correctly process SCSI-Direct
  18. commands (you should already have it, because otherwise you wouldn't be able to
  19. use your CD-R for burning).
  20.  
  21. 2. Installation
  22.  
  23. Smash the executable and the its icon anyware you want.
  24.  
  25.  
  26. 3. Configuration - using it.
  27.  
  28. - From Workbench:
  29.  
  30. You can specify your CD-R using tooltypes: either
  31. DOSVOLUME=xxx:
  32. like
  33.  
  34. DOSVOLUME=CDR: 
  35.  
  36. in case you mounted your CD-R with a filesystem. Otherwise you must specify
  37. both the exec device name and unit number.
  38.  
  39. DEVICE=xxxx.device
  40. UNIT=nnn
  41.  
  42. like
  43.  
  44. DEVICE=gvpscsi.device 
  45. UNIT=2
  46.  
  47. IdentCDR also supports some switches: DEBUG, DUMP and INFOS.
  48.  
  49. DEBUG:
  50.     prints some more information about the values read from the CD-R. Only
  51.     for experts.
  52. DUMP:
  53.     will make IdentCDR also print all its output to a text window.
  54. INFOS (new in 1.4!):
  55.     prints all burning information about a data-CD, like volume name,
  56.     creator, program used for burning, etc... (hi Andrzej !). This way
  57.     you'll see that MakeCD places your registration number (not the key!)
  58.     in every CD created with it. Keep in mind that all this informations
  59.     belong to the *first session* only !!!
  60.  
  61. All these options will be used for the first identification run each time
  62. IdentCDR is launched. After this first one, you can change the device name
  63. through a reqtools requester (the other options will stay like first specified).
  64.  
  65.  
  66. - From Shell: pretty much the same:
  67.  
  68. IdentCDR CD1:
  69.  
  70. -or-
  71.  
  72. IdentCDR gvpscsi.device 4
  73.  
  74. The actual template is: NAME/A,U=UNIT/N,DEBUG/S,DUMP/S,INFOS/S .
  75.  
  76. IdentCDR requires a minimum stack of 16384 bytes (16K) !
  77.  
  78. See the WB section for explanation of each switch.
  79.  
  80.  
  81. 4. Some tech tips.
  82.  
  83. One of the information displayed by IdentCDR is the 'Disk capacity
  84. (overburn ?)'. I don't really know if this value is to be considered as the
  85. maximum capacity; the MMC standard says it's the "last possible start time of
  86. lead-out", whatever this means. Opposite to this, there's the 'true recordable
  87. free space', that is the common value read by a CD burning software (like
  88. MakeCD).
  89.  
  90. 5. Acks.
  91.  
  92. Thanks to all those who contacted me asking for improvements. You know who you
  93. are!
  94. The NewIcon is taken from an unknown author, it was originally for OptyCDPlayer.
  95.  
  96.  
  97. 6.
  98.  
  99. Version history:
  100.  
  101. 1.4    Now prints some information about the volume name, creator and such.
  102.     Thanks to Andrzej Boreczko for some help and encouraging me.
  103.     Can (and will) correctly disinguish between CD-R and CD-RW; thanks to 
  104.     Stephen White for hinting this. This feature will work on CD burners
  105.     only, no CD-ROM.
  106.     Added display on the titlewindow of how many slots are available.
  107.     Added new entries: 60 slots, about 56-58 entries (= different brands),
  108.     Fixed a typo in the entries database.
  109.  
  110. 1.3    Some more entries: 54 slots, about 50 entries (TDK and Mitsubishi have
  111.     two slots) .
  112.     Reworked command-line interface.
  113.     New commands (both from CLI and Workbench): DUMP and DEBUG.
  114.     (actually, DEBUG was already there in 1.2, but it was hidden).
  115.  
  116. 1.2    Added a small reqtools GUI.
  117.     Added reading tooltypes from icon.
  118.     Added recording length discovery/display.
  119.     Now checks for 'prohibited' values. See the URL found in the .readme
  120.     for explanations.
  121.     Finally found out how to get exec device informations from a volume
  122.     specification (like CD1:). BPCL sucks!!!
  123.     No longer displays obtained values on the Shell. Is this a problem for
  124.     anyone ?
  125.     Executable is indeed shorter than 1.1, because in 1.1 I linked some
  126.     useless math libraries; IdentCDR is long about a tenth of the Windoze
  127.     counterpart. But if anybody wants it, I can supply with a 300K version
  128.     (18K of code and 282K of useless junk, just to make you happy).
  129.     Really knows 41 brands, because FUJI uses two slots.
  130.  
  131. 1.1    Fixed memory leak (46 bytes not freed).
  132.     New method for those drives who can't use READ_TOC_PMA_ATIP.
  133.     Some more sanity checks to ensure returned data is valid.
  134.     Currently knows 42 brands (are these all ?). 
  135.  
  136. 1.0     Initial release
  137.  
  138.