home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-3.iso / Tools / disk / sdformat.1.3.README < prev   
Encoding:
Text File  |  1995-04-01  |  7.2 KB  |  166 lines
  1. sdformat
  2. --------
  3.  
  4. INTRO
  5. -----
  6.  
  7. sdformat is an enhanced replacement for the sdform utility shipped with
  8. NEXTSTEP.  It allows selection of the SCSI device's block size for improved
  9. performance - both in access speed and available free space.
  10.  
  11.  
  12. REVISION HISTORY
  13. ----------------
  14.  
  15. This is the third major release version of sdformat (Version 1.3), and the
  16. first to support NEXTSTEP on NeXT/Motorola, Intel, HP-PA RISC and Sparc
  17. processors.
  18.  
  19. There was only one reported problem with Version 0.9, so version 1.1 was
  20. released to address problems with very large hard drives (about 3 GB or more).
  21. It has since been proven to work with drives as large as 9 GB (The Seagate
  22. ELITE), even though NeXT's sdform would not work on that drive.  Version 1.2
  23. added more verbose error message text from the ANSI SCSI specification, in
  24. addition to HP-PA support.  Now, version 1.3 is friendlier to other SCSI
  25. programs and has improved error reporting.
  26.  
  27.  
  28. BACKGROUND
  29. ----------
  30.  
  31. One of the most popular performance enhancements for NEXTSTEP workstations is
  32. to do a low-level format of all capable SCSI drives at a block size of 1024
  33. bytes.  If you have a new drive, or if you have backed up all data on your
  34. current drive, then you might consider wiping the slate clean and starting over
  35. with a faster, larger drive (for free!)
  36.  
  37.  
  38. sdformat does what you cannot do with the utilities supplied by NeXT.  I
  39. believe it is easier to use than the "formatter" utility on the archives - and
  40. compatible with more drives.
  41.  
  42. For some strange reason, the formatting utilities included in NEXTSTEP are not
  43. orthogonal in features.  Specifically, fdform allows specification of the block
  44. size as 512 or 1024 bytes, but sdform has no such option.  sdform is also
  45. limited to working with SCSI devices which were attached when the system was
  46. started, simply because it takes a raw device name instead of a SCSI id.
  47.  
  48. Hence the need for sdformat.
  49.  
  50. sdformat, which is available as a FAT binary, is capable of formatting any SCSI
  51. device selected by its target ID (and logical unit number, if applicable).  The
  52. utility can also be used to examine the current settings for a particular
  53. device's block size.  You will only need root access for drives which were
  54. attached and powered up when NEXTSTEP was booted, otherwise any user can just
  55. power up a new drive, format, and reboot to initialize the drive with the file
  56. system of your choice (sdformat does not handle the step of file system
  57. initialization, but neither does sdform or fdform).  Drive cables should only
  58. be attached while the computer is halted or powered off, but the drive may be
  59. powered up and down while NEXTSTEP is running so long as you do not power off
  60. a mounted drive.
  61.  
  62.  
  63. Need further convincing?
  64.  
  65. If you aren't already convinced that you want to back up your drive and execute
  66. a low-level reformat, read on!
  67.  
  68. For space increase, you can expect numbers like the following:
  69.  
  70. Original    Reformat    Increase    Drive
  71. 406.5 MB    419.9 MB    13.39 MB    Seagate ST1480N (NeXT supplied 400 MB)
  72. 1.156 GB    1.227 GB    73.30 MB    Maxtor MXT-1240S
  73.                         5.407%      Seagate ST41650N (Wren VIII)
  74.  
  75. I have not personally measured the inherent increases in throughput
  76. performance, but figures ranging from 20% to 25% have been reported by users of
  77. sdformat.
  78.  
  79.  
  80. LEGAL STUFF
  81. -----------
  82.  
  83. I am tired of legalese, so I will word the following in plain english.  The
  84. language should be precise enough to avoid misunderstanding in the event that
  85. legal action is necessary.
  86.  
  87. I cannot be responsible for data loss.  This program is designed to do a
  88. low-level format of a SCSI device under user control.  "Format" implies data
  89. loss by definition.  If you ask for this operation with the right options, you
  90. WILL erase your drive.  I can say that I highly doubt that there is any way to
  91. permanently damage a SCSI device when using sdformat, other than data loss.
  92. Note: There was one report from the Internet by someone who knew of an IBM
  93. drive which would destroy its factory formatting if the SCSI format command was
  94. issued, but I would consider that a firmware bug.
  95.  
  96. Please do not charge money for this utility or for any service you provide
  97. using this utility.  Please do not remove my name from this README, the
  98. accompanying man page, or the executable.  Please do not distribute modified
  99. versions of these files.  I hold the copyrights for this utility and do not
  100. give permission for it to be distributed on CD-ROM without my prior written
  101. permission.  For those of you who are compiling CD-ROM archives of software
  102. available freely via ftp, these restrictions are aimed directly at you -
  103. especially if you are planning to charge for the CD-ROM, but even if you are
  104. not.  For those of you who make a living formatting SCSI drives for others, you
  105. will have to find some other program if the standard NEXTSTEP tools are not
  106. sufficient.  Exceptions will be made only for those who contact me for
  107. licensing information.  I would suggest keeping a copy of this README around to
  108. remind you not to forget about the restrictions I have placed on this free
  109. software.  Future versions are not guaranteed to be free.
  110.  
  111. Apart from the explicit warnings about inherent data loss, there are no other
  112. guarantees or warranties associated with this free software.  You must accept
  113. it as is or do without.
  114.  
  115.  
  116. INSTALLATION INSTRUCTIONS
  117. -------------------------
  118.  
  119. Two packages are available:
  120.  
  121. 1) sdformat.FAT.tar.gz  is FAT (as the name implies), and includes a man page.
  122. Anyone who can execute FAT binaries should have gzip available in their version
  123. of NEXTSTEP in order to uncompress this package using the following commands:
  124.  
  125. 3.2> gnutar zxf sdformat_1.3.MIHS.tar.gz
  126. 3.1> gzcat sdformat_1.3.MIHS.tar.gz | gnutar xvf -
  127.  
  128. 2) sdformat.tar.Z  is for Motorola (true Black NeXT hardware) systems, and also
  129. includes the same man page.  It has not been tested under 3.0 or earlier, but
  130. it should work.  Note: At this time, only the beta version, 0.9, is available
  131. for 3.0 or earlier.  Use the following command to uncompress:
  132.  
  133. zcat sdformat.tar.Z | tar xf -
  134.  
  135.  
  136. Both packages have the following recommended installation points:
  137.  
  138. /usr/local/bin/sdformat
  139. /usr/local/man/man8/sdformat.8
  140.  
  141. or you can use ~/Unix/bin and ~/Unix/man/man8
  142.  
  143.  
  144. As an exercise for the reader, I leave the process for adding new man page
  145. directories (hint, take a look in /etc/login.std and /etc/cshrc.std after
  146. searching for MANPATH in the ManPages target of Digital Librarian).
  147.  
  148.  
  149. PARTING NOTE
  150. ------------
  151.  
  152. sdformat does not Initialize the SCSI device.  In this respect it is just like
  153. NeXT's own sdform.  When sdformat is finished, you must decide whether to
  154. create a BFFS, DOS (not very useful), or Macintosh (probably impossible)
  155. volume.  I usually just let Workspace.app handle the Initialization, since it
  156. tends to want to do so automatically.  Please do not contact me for help in
  157. initializing your disk, and especially not if you need to partition your large
  158. (greater than 2 GB) disk.  For these tasks, I would suggest becoming an expert
  159. on the /etc/disk utility shipped with NEXTSTEP - or perhaps you can consult the
  160. NEXTSTEP FAQ as posted to comp.sys.next.announce
  161.  
  162.  
  163.     Brian Willoughby    Software Design Engineer, BSEE from NCSU
  164. NeXTmail welcome        Sound Consulting: Software Design and Development
  165. BrianW@SoundS.WA.com    Bellevue, WA
  166.