home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / CDROM / Contents / READMEs / Peanuts-2 / Unix / disk / rawdisk.README < prev    next >
Encoding:
Text File  |  1996-11-09  |  3.7 KB  |  105 lines
  1.  
  2.    RAWDISK
  3.   =========
  4.   
  5.   Overview
  6.   
  7.     Rawdisk is a program which enables you to write to the raw media of
  8.     a floppy disk (or a series of floppies if need be). It makes most
  9.     sence to put rawdisk at the start or end of a command pipeline.
  10.       
  11.   Licence & Warranty Information    
  12.  
  13.     This program is free software; you can redistribute it and/or modify
  14.     it under the terms of the GNU General Public License as published by
  15.     the Free Software Foundation; either version 1, or (at your option)
  16.     any later version.
  17.  
  18.     This program is distributed in the hope that it will be useful,
  19.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  20.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21.     GNU General Public License for more details.
  22.  
  23.     You should have received a copy of the GNU General Public License
  24.     along with this program; if not, write to the Free Software
  25.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  26.  
  27.   Installation Instructions
  28.     
  29.     Rawdisk needs to be able to open the /dev/rfd?a devices to read and
  30.     write to raw floppies. You can do this by either installing it
  31.     as setuid root or set-gid operator and modifying the /dev/rfd?a devices
  32.     to be writable (as well as readable which they should be already) by 
  33.     operator. Being of a nervous disposition, I did the latter, something
  34.     like:
  35.        su
  36.          mkdirs /usr/local/bin
  37.      mv rawdisk /usr/local/bin
  38.      chown root.operator /usr/local/bin/rawdisk
  39.      chmod g+s /usr/local/bin/rawdisk
  40.      chmod g+w /dev/rfd?a
  41.        exit
  42.        rehash
  43.   
  44.   Using rawdisk
  45.   
  46.     Rawdisk spews directly to the raw media, hence its name. Doing this
  47.     *destroys any filesystem on the disk* SO BEWARE. Do not try
  48.     to put the disk in before running the program, when rawdisk wants
  49.     a disk, it will ask for it. If outside of rawdisk you insert a disk with
  50.     raw data on it, auto-mounter will think it's a damaged disk and offer
  51.     to repair it. If there is already a disk in the drive when rawdisk runs
  52.     it will be ejected (but not unmounted!).
  53.     
  54.     When spewing to multiple disks it writes *NO* markers for first, second,
  55.     third disk etc. THIS IS UPTO YOU! Thus when reading disks, giving the
  56.     disks out of sequence will happily shuffle your data in disk sized chunks.
  57.     
  58.     Rawdisk does not write end of file markers. When reading disks, it will
  59.     read until it is killed or its output pipe is broken or cancel is clicked
  60.     in the disk request dialog box. This is fine for use with programs like
  61.     tar which know when they have reached the end.
  62.     
  63.     Example usage:
  64.     
  65.       Backing up
  66.     
  67.         tar cf - myfiles | compress -c | rawdisk -w        # write archive
  68.     rawdisk -w | uncompress -c | tar tvf -        # verify archive
  69.     rawdisk -w | uncompress -c | tar xvf -        # read archive
  70.     
  71.       Copying a disk
  72.         - this seems to work, but don't use it for something vital!
  73.       
  74.     rawdisk -r > disk-image
  75.         (click CANCEL when it asks for a second disk)
  76.     rawdisk -w < disk-image
  77.     rm disk-image
  78.     
  79.   Source Code
  80.   
  81.     I don't usually write C, so sorry if the code is a little strange. I wrote
  82.     a wierd sort of exception handler (I didn't know about NX_RAISE) to 
  83.     handle OS call errors and ensure that if a disk is in the drive it is
  84.     ejected before the program terminates. It should have more comments,
  85.     but I wrote it for me.
  86.     
  87.   Finally
  88.   
  89.     I hope you like it. It could do with a few tune-ups. If you make any 
  90.     changes or find any bugs I'd like to hear from you. If you'd like to
  91.     help me out, but don't want to hack code, write me a man page! 
  92.  
  93.     REMEMBER, RAWDISK MAY HAVE BUGS IN IT SO USE IT AT YOUR OWN RISK.
  94.     
  95.     
  96.         Richard O'Neill
  97.     Computing Science Dept.
  98.     Simon Fraser University
  99.     Burnaby BC
  100.     V5A 1S6        CANADA
  101.  
  102.     oneill@cs.sfu.ca
  103.  
  104.  
  105.