home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 10 / amigaformatcd10.iso / -in_the_mag- / emulation / abeeb_beta / bbcim / doc / bbcim.doc
Text File  |  1996-06-29  |  7KB  |  162 lines
  1.  
  2. bbcim
  3. FDC & FDCDEMO
  4. bbc80
  5.  
  6.  
  7. DISKIMAGE MANIPULATION AND MORE:
  8. bbcim.cc: Acorn DFS diskimage manipulation + various.
  9. currently v0.83
  10.  
  11. >    bbcim  option file [{filelist}]  (any extension is allowed for diskimages)
  12.  
  13.        options:
  14.            -e[d/b,i,#,r] diskimage : extract files
  15.            without d or b option -e gives filenames like 'imagefile.$.!BOOT'.
  16.          sub options:
  17.                d : extract files in directory: ex. 'imagefile/$.ELITE'.
  18.                b : extract bare : as -d but in current directory.
  19.                i : produces also an info file (archive format)
  20.                # : remove bbc_root_dir $ and glue other dirs to filename
  21.                     (name clash is possible but unlikely, eg. E.E and EE,
  22.                      in that case you will be asked whether to rename,
  23.                      overwrite, etc.)
  24.                r : remove the diskimage after extracting files.
  25.          They all produce a catalogue file 'imagefile.cat'.
  26.  
  27.            -c   disk : show catalogue (files in image).
  28.            -40  disk : expand to 40 track disk.
  29.            -80  disk : expand to 80 track disk.
  30.            -max disk : expand to 256 K.
  31.            -min disk : minimize diskimage (equal to *COMPACT and cutting off
  32.                         after last used sector).
  33.            -crc disk : calculates crc's for all the files in an image.
  34.  
  35.            -new disk : make new (empty) diskimage (512 bytes, bootoption EXEC)
  36.  
  37.            -a[r] diskimage {list} : add files (in archive format) to the diskimage:
  38.                         Automatically skips '.inf' files so bbcim -a disk.bbc *
  39.                         (unix) gives no problems. If the diskimage didn't exist
  40.                         a new one will be created.
  41.                         The option 'r' removes the archive files after adding
  42.                         them to the diskimage.
  43.  
  44.  
  45.  
  46.            -d diskimage {list} : delete the list of files from the
  47.                         diskimage. NOTE: files without a bbcdir are assumed to
  48.                         have the root dir, eg. ELITE is assumed to be $.ELITE
  49.  
  50.  
  51.            -interss (sd,dd) file0 file1 file2 : interleaves 2 diskimages.
  52.            -splitds (sd,dd) file.2 : splits interleaved diskimage file.2 to file.0 & file.1
  53.            -ddos2dfs file.dd : splits a single sided DDOS diskdump into
  54.                         several DFS diskimages.
  55.                         Eg. myfiles.dd > myfilesA.bbc,..., myfilesH.bbc.
  56.  
  57.            -x {list} : xbeeb conversion of archive files in the list.
  58.            -s[#] file : splits a catalogue file into .inf files. The option #
  59.                         removes the BBC directory $ and glues others to the file
  60.                         name. THIS CAN BE USED TO MAKE ARCHIVE FILES FROM AN
  61.                         XBEEB DIRECTORY (without CRC, first change filenames if
  62.                         necessary, then use the unmess option. This can also be
  63.                         achieved by putting files in a diskimage and extracting)
  64.            -y {list} : archive/info file rename, add's crc's if not found,
  65.                         checks crc's if found.
  66.  
  67.            -icrc {list} :check crc's of given archive files.
  68.            -xcrc        :guess.
  69.  
  70.            -V         : print version no.
  71.            -H         : help (command overview). (DUTCH)
  72.  
  73. NOTE: options and files can in most cases be entered after starting the programs.
  74. NOTE: for option -d : 1. wildcards are not possible
  75.                       2. names are case sensitive.
  76.  
  77.  
  78. TO BE ADDED:
  79. *) iostream omzetting (v0.90)
  80. *) -e {lijst} zonder catalogus. (0.90?), of -f[d/b,i,r] disk {lijst}?
  81. *) echte mkdir ipv system(mkdir)
  82. *) -id : identificeer diskformaat (enkel/dubbelzijdig, dfs/ddos)
  83.  
  84.  PERHAPS -ren rename, -sect nn: custom disksize (for DDOS)
  85.  PERHAPS :adding/deleting files without a command line list.
  86.  
  87.  
  88.  
  89. __________________
  90. NEW ARCHIVE FORMAT:
  91. $.ELITE  : bare file
  92. $.ELITE.inf : info text file containing
  93.  
  94.      '$.ELITE   FF0E00 FF8023 Locked CRC=XXXX NEXT $.ELITE2'
  95.      The $.ELITE is optional but if present the files may be renamed
  96.      to say a and a.inf. $.ELITE is then the real filename.
  97.  
  98.      A CRC is included for various reasons (to check fileconversion
  99.      software, serial- or disk- file transfer to/from a bbc, etc.)
  100.      The CRC is calculated with the algorithm from the BBC user guide p. 399
  101.      (The same algorithm as used in the cassettte and rom filing system).
  102.  
  103.      'Locked' may be abbreviated to 'L'.
  104.  
  105.      NEXT may be used for CHAIN"" or *RUN as used on cassette systems.
  106.  
  107.      file length may be included (after the execution address) but is
  108.      unnecessary.
  109.  
  110. _______
  111. FDCDEMO: Issue the command B: (or A: depending on the system) LAST,
  112.               just before a 'READ file' command.
  113.  
  114. ___
  115. FDC:  (my improved version of FDCDEMO):
  116. A 40 track PC drive is now default (Yep, I have one of those). If using a 1.2 MB drive enter DDINHD (or not??), CYL 80. You can now read 80 track discs. To read 40 tracks also enter DOUBLESTEP.
  117. FORMAT now works for all formats with MINSECTOR<>1.
  118.  
  119.  
  120. ___________________________________________
  121. FOR ANADISK INFO READ THROUGH THE FOLLOWING:
  122.  
  123. ANADISK: dumping a BBC disk
  124. In anadisk goto dump, select the 5 1/4 drive, select the side(s) to dump.
  125. give a name  e.g elite.0/elite.1 (for bbc0 (the .0 file must be the dump of
  126.  side 0)) or elite.2 (or elite.bbc) if you need neither.
  127. (don't worry about the error messages, except when anadisk says it is adding
  128. sectors, in that case redo the dump)
  129.  
  130. OLD PROGRAMS:
  131. If anadisk skips odd tracks (see below) use:
  132. bbc0.cc    : combines the images of anadisk diskdump of side 0 and side 1.
  133.               useful if you only have a single sided BBC discdrive.
  134.  
  135.  
  136. On the BBC: Take an empty single density disc.
  137.             copy the wanted files to DRIVE 0 (side 0)
  138.             Change to DRIVE 2 (side 1)
  139.             *SAVE EMPTY 1000 19FF
  140.             copy the files to dr.2 in the same order as on side 0
  141. This is only necessary if anadisk skips the odd tracks. For me this is the case
  142. with a 360K disc drive reading any disk that has been formatted in the usual way
  143. on my CHALLENGER 1.01 diskdrive even if I tell it format to 40tracks.
  144. On this drive it is possible to get a REAL 40 track disk by issueing the
  145. command *OPT8,1 (*4080 ON for DDOS). Test with your system and see if anadisk
  146.  skips the odd tracks. 
  147.  
  148. N.B. this technique is NECESSARY to read BBC disks with only a 360K PC drive
  149. (40tracks) and a 80 track (non switchable) BBC drive!
  150.  
  151. _______________________________________
  152. For this you need the following program:
  153. bbc80.cc: make 80track single or double density image using only a 40 track
  154.               PC drive
  155.  
  156. >    bbc80 [option] imagefile (no extension!) for a file 'imagefile.dsk'
  157.        options:
  158.            none: single density
  159.            -dd : double density
  160.  
  161.  
  162.