home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / MM1 / UTIL / rsdsk.lzh / RSDSK / DOCS / rsdsk.doc
Text File  |  1997-03-06  |  4KB  |  108 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                       RSDSK                           
  8.                         copyright (c) 1997 by Bob Devries             
  9.                             may be freely distributed                 
  10.           
  11.               RSDSK  is to Jeff Vavasour's emulator .DSK  files,  what
  12.           RSDOS  is  to  Disk  Extended  Basic disks in an OS-9 drive,
  13.           except  there's  no options to delete files or copy files TO
  14.           the emulator .DSK file.
  15.           
  16.              So what does it do?
  17.           
  18.              RSDSK -h
  19.              RSDSK -?
  20.              RSDSK -help
  21.           
  22.              All these produce a cryptic help display.
  23.           
  24.              RSDSK -dir filename
  25.           
  26.              This produces a directory of the .DSK  files  just  as if
  27.           you  did  DIR  from  DECB. 'filename' is the pathname of the
  28.           emulator .DSK file WITH the .DSK extenion.
  29.           
  30.              RSDSK -get filename emulator_file os9_file
  31.           
  32.              This  copie  the  file  'emulator_file' from the emulator
  33.           .DSK  file   'filename'   to   the   file   'os9_file'.  The
  34.           'emulator_file'   must  be  the  complete  filename  on  the
  35.           emulator .DSK file, with two exceptions;:
  36.           
  37.                  1. It does NOT have to be capitalised, and
  38.                  2. the  spaces  between  the  end of the filename and
  39.           the  extension  don't have to be inserted. However, if there
  40.           are spaces inside  the filename, they must be typed, and, to
  41.           stop  OS-9  from  eing confused, quote are used  around  the
  42.           name. For example, the entry:
  43.           
  44.                  LEVEL 1  BIN 2 B 10
  45.           
  46.                  would be entered as:
  47.           
  48.                  "level 1.bin"
  49.           
  50.                  on the above command line. The OS-9 filename  may  be
  51.           any valid OS-9 pathname.
  52.           
  53.              Now here's a difference from RSDOS:
  54.           
  55.              RSDSK -proc filename
  56.           
  57.              This will produce  a procedure file (to stdout, so it may
  58.           be re-directed, or piped) to copy  ALL  the  files  from the
  59.           emulator .DSK  file  to the OS-9 path. The output looks like
  60.           this (for OS-9/68000):
  61.           
  62.              -nx
  63.              -np
  64.              tmode -w=1 nopause
  65.              load rsdsk
  66.              rsdsk -get /h0/dsk/caves.dsk "3DVIEW.BIN" 3DVIEW.BIN
  67.              rsdsk -get /h0/dsk/caves.dsk "CHAR.DAT" CHAR.DAT
  68.              rsdsk -get /h0/dsk/caves.dsk "CHARGEN.BAS" CHARGEN.BAS
  69.              rsdsk -get /h0/dsk/caves.dsk "DRAGON.BIN" DRAGON.BIN
  70.              unlink rsdsk
  71.              tmode -w=1 pause
  72.              -p
  73.              -x
  74.           
  75.              So you can output this to a  file  for  editing purposes,
  76.           like this:
  77.           
  78.              RSDSK -proc filename.dsk >procedure.file
  79.           
  80.              Or you can pipe to the shell, like this:
  81.           
  82.              RSDSK -proc filename.dsk ! shell
  83.           
  84.               This way all the files on the emulator .DSK file will be
  85.           copied to your current directory.
  86.           
  87.                        ___________________________________            
  88.           
  89.              This is  the  first  'cut'  of  this programme, so it may
  90.           still have  some  bugs.  If  so, please let me know. At this
  91.           stage,  I  have  only tested this on an MM/1  computer,  and
  92.           only  (so  far)  with  one .DSK file. It should compile on a
  93.           COCO, but it would  require  Carl  Kreider's  C  library for
  94.           some of the OSK functions I used.
  95.           
  96.              I am reachable by email a: bdevries@gil.com.au
  97.              or by regular mail at:
  98.           
  99.              Bob Devries
  100.              21 Virgo Street
  101.              INALA, Qld, 4077
  102.              AUSTRALIA
  103.           
  104.              PH: +61 7 32787209
  105.           
  106.              Date: Thursday, March 6th, 1997.
  107.  
  108.