home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / disks / misc / hdoff / hdoff.doc < prev    next >
PGP Signed Message  |  1997-07-20  |  11KB  |  262 lines
  1. -----BEGIN PGP SIGNED MESSAGE-----
  2.  
  3.  
  4. NAME
  5.         HDOff -- a program for the A600/A1200 and A4000 to stop the HD
  6.         motor.
  7.  
  8. SYNOPSIS
  9.         HDOff T=TIME/N,T2=TIME2/N,FORCE/S,OTHER/S,OTHER2/S,NOW/S,NOW2/S,
  10.         SET1200/S,SET4000/S,UPDATE/S,QUIET/S,STOP/S,STOP2/S
  11.  
  12. DESCRIPTION
  13.         HDOff  is  a program like NoiseSaver for the A1200 and A4000.  It stops
  14.         the HD motor x minutes after the last access.
  15.  
  16.         TIME, TIME2 :
  17.                 Time in minutes after the 1st/2nd HD will shut down.
  18.  
  19.         FORCE : 
  20.                 Forces  HDOff  to  quit.  Normaly HDOff doesn`t quit if another
  21.                 programm  (like  cachesoftware  ) patched the scsi.device after
  22.                 HDOff  did.   But if you are using SetFuncManager (or something
  23.                 similar), HDOff can nevertheless quit without danger.  ONLY USE
  24.                 THIS  OPTION  IF  YOU ARE USING SETFUNCMANAGER OR SOMTHING LIKE
  25.                 IT!
  26.  
  27.         OTHER, OTHER2 :
  28.                 This  option  makes  HDOff  to  use an alternative command ($94
  29.                 instead  of  $E0)  to  stop the HD`s motor.  If your HD doesn`t
  30.                 spin  down,  try  this  option.   Some drives, especially older
  31.                 ones,  don`t  support  the  `STANDBY`  (all newer drives should
  32.                 support  it,  at  least  the "green-PC" drives supporting power
  33.                 management).
  34.  
  35.         NOW, NOW2 :
  36.                 The  selected HD spins down immediately on startup, the program
  37.                 just does it`s normal job (usefull for seldom used HD`s).
  38.  
  39.         SET1200, SET4000:
  40.                 With  some odd HD`s, HDOff isn`t able to detect wich controller
  41.                 is  present  in  your  Amiga  (this happens, too, if you have a
  42.                 CD-Rom  connected  but no CD inserted).  If you start HDOff and
  43.                 get  a  "Incorrect  HD  controller!"  message, but are actually
  44.                 using  an  A600/A1200/A4000,  use  the  option  SET1200  for an
  45.                 A600/A1200 or SET4000 for an A4000.
  46.  
  47.         UPDATE:
  48.                 With this option you can adjust the shutdowntime online.
  49.  
  50.         QUIET:
  51.                 Using  this  option  HDOff won`t print anything out (similar to
  52.                 >NIL:).  Usefull e.g.  if you start it in the user-startup.
  53.  
  54.         STOP, STOP2:
  55.                 HDOff  will  just stop the 1st (STOP) or 2nd (STOP2) harddrive,
  56.                 but HDOff won`t be installed.
  57.  
  58. NOTE
  59.         Be shure not to set the "time" value too low (maximum are 65535 minutes
  60.         :)  as permanently spinning the drive up and down does shorten the life
  61.         expectancy of the drive (60 minutes is a good choice).
  62.  
  63.         You don`t need to start HDOff with run.
  64.  
  65.         To quit HDOff, simply restart it.
  66.  
  67.         If   a   requester   with   the   message  "Someone  else  has  patched
  68.         scsi.device!..."  pops  up,  someone  else (e.g.  caching software) has
  69.         latched  into  the  scsi.device.   For security reasons HDOff cannot be
  70.         terminated this time.
  71.  
  72.         This  program is 100% written in assembler (DevPac 3.14) and (as far as
  73.         its possible) systemconform.
  74.  
  75. EXAMPLES
  76.         1. HDOff 30
  77.         Stops the motor of the 1st HD 30 minutes after the last access.
  78.  
  79.         2. HDOff 30 15 OTHER2
  80.         Stops  the  motor  of the 1st HD 30 minutes, the motor of the 2nd HD 15
  81.         minutes  after the last access.  For the 2nd HD the alternative command
  82.         will be used to stop the motor
  83.  
  84.         3. HDOff T2=20
  85.         Stops the motor of the 2nd HD 30 minutes after the last access.
  86.  
  87.         4. HDOff 30 15 NOW2
  88.         Stops  the  motor  of  the  1st  HD 30 minutes, the motor of the 2nd HD
  89.         immediately.  If the 2nd HD was accessed and so spins up, the next spin
  90.         down will again happen after 15 mins.
  91.  
  92.         5. HDOff 50 10 UDPATE
  93.         If  you  already  started  HDOff,  the  timeout`s  for the HD`s will be
  94.         changed to the new values.
  95.  
  96.         6. HDOff STOP QUIET
  97.         This  will  just  and  only  stop  the 1st drive, there will not be any
  98.         timeout!  Additionally there will be no output.
  99.  
  100. TECHNICAL
  101.         How does it work? The essential things are:
  102.  
  103.         1. Test if ide controller is present (if not: quit)
  104.  
  105.         2.   Patch  scsi.device  (using  SetFunction,  of  course).   The patch
  106.         signals HD accesses to the main task.
  107.  
  108.         3.  Count the timer down and reinitialize it if a signal from the patch
  109.         occures.
  110.  
  111.         4.   If  timer  reaches 0:  Signal the patch to delay all commands (for
  112.         both  drives)  till  the  signal  is  retracted.  Security delay 1 sec.
  113.         Forbid(),     Wait_IDE_unbusy,     select     drive     (master/slave),
  114.         Wait_IDE_unbusy,  spin  down  HD, Permit().  Retract the signal for the
  115.         patch for the HD that was not stopped, for the other one after a 5 secs
  116.         security delay (spin up is done by the HD itself).
  117.  
  118.     5. Check, if there are any messages and process them.
  119.  
  120.         6.  Repeat step 3-4 until abort.
  121.  
  122.         For   more   information   about   the   messageport  have  a  look  in
  123.         Developers.doc!
  124.  
  125. DISCLAIMER & COPYRIGHT
  126.         This  software  is subject to the "Standard Amiga FD-Software Copyright
  127.         Note"  It is Freeware as defined in paragraph 4a.  For more information
  128.         please read "AFD-COPYRIGHT" (Version 1 or higher).
  129.  
  130. AUTHOR
  131.         Gideon Zenz
  132.         Giersbergstr. 41
  133.         53229 Bonn
  134.         GERMANY
  135.  
  136.         EMail: gzenz@ixc.net
  137.  
  138.         -Gideon Zenz, 20-Jul-97
  139.  
  140. BUGS
  141.         None known.
  142.  
  143. FUTURE
  144.         I  have  now a SCSI-only system, but this didn`t prevent me not to do a
  145.         SCSI  version  of  HDOff.  The reasons are that HDOff wasn`t planned to
  146.         support more than 2 drives, and not more then one device, so it will be
  147.         quite difficult to implement.  But we`ll see B-)
  148.  
  149. HISTORY
  150.         v1.0: (08-Mai-94)
  151.          - Initial release
  152.  
  153.         v1.1: (30-Jan-95)
  154.          - Timerloop in minutes and much more precisely
  155.          - No need to start with run any more
  156.          - At all more secure and more systemconform
  157.          - A4000 support
  158.  
  159.         v1.2: (20-Apr-95)
  160.          - docs completely rewritten
  161.          - Support of 2nd HD`s
  162.          - New args OTHER and OTHER2 and NOW and NOW2
  163.  
  164.         v1.33: (7-Jan-96)
  165.          - HDOff crashed if started on heavy diskaccess.
  166.          - new options SET1200 and SET4000
  167.          - Implementation of the onlineport. Have a look in
  168.            Developers.doc for usage.
  169.  
  170.         v1.34: (22-Feb-96)
  171.      - Fixed a bug in the onlineport: PortVer wasn`t set.
  172.          - Added GetStats&Source
  173.          - Completely reworked Developer.doc
  174.          - Now working 100% on A600
  175.          - New arg UPDATE (thx to Ingo Eickelkamp for suggestion)
  176.  
  177.         v1.35: (16-Mar-96)
  178.          - New option QUIET
  179.          - Bugfix in UPDATE, wrong values were taken
  180.          - Now there is again a check if you enter too big values
  181.          - MAJOR bug: HD spun only the 1st time down on a1200 [thx to Oli Lohr]
  182.          - System of timecounting changed, now 100% accurate
  183.          - NOW(2) working again [thx to Oli Lohr]
  184.          - New options STOP(2) [thx to A.BOERNER@bbrandes.berlinet.de]
  185.          - New, bugfixed and improed version of Getstats [Thx Matthias Andree!]
  186.  
  187.         v1.36: (26-Jun-96)
  188.          - Some bugfixes
  189.          - Message port expanded/changed (look at Developers.doc)
  190.          - Everything is now multi threaded, so msg`s etc are immediately
  191.            processed now.
  192.          - Included new, advanced GetStats
  193.  
  194.         v1.37 (1-Sep-96)
  195.          - Fixed Mungwallhit
  196.          - Optimized
  197.          - Msgport updated for GUI by M.Andree (look at Developers.doc)
  198.          - adapted GetStats
  199.  
  200.     v1.38 (20-Jul-97)
  201.          - some bugfixes (thx to Dave Jones, Oli Lohr)
  202.  
  203. THANKS
  204.         Many    thanks    to   heureka@bigben.dssd.sub.org   and   M.ZIELINSKI@
  205.         amtrash.comlink.de for their helps on A4000 and 2nd HD support, and all
  206.         other`s  who wrote me!  A special thank must go out to Matthias Andree,
  207.         who had a look at the docs, and who is now doing a nice GUI!
  208.  
  209. SECURITY
  210.         If  you  want  to be shure you have the original programs, check
  211.         with  "md5sum  -c  HDOff.doc".   (md5sum is part of the PGP package)
  212.  
  213. dfdf15f58f042ffa0f018ba8277124f7  AFD-COPYRIGHT
  214. f7da7a8653f2153aea03f73d664f2a40  AFD-COPYRIGHT.de
  215. 5be909723874ce17be7fc3c426025f98  Developers.doc
  216. 732fcce06b2f7c5e3e1abbaf8f9ab2d6 *GetStats
  217. eb56a33c57b9992656dcaf45cf3da761  GetStats.c
  218. 2b624ffa9e8fdac01ff101ab2a298dde *HDOff
  219. 96dc1c9138a28d041c5fd8e8406096dd  HDOff_1.38.readme
  220.  
  221. - -----BEGIN PGP PUBLIC KEY BLOCK-----
  222. Version: 2.6.3ia
  223.  
  224. mQCNAi3izr8AAAEEAMi+7o+iKDG26t8EuoX0NJ92iwhkviRC3GdJ1Uvef4+xJA3V
  225. ey20ZnzBg/OokPdo0a3VxhwyjD2auyFmp7DLupQTko7Wx2zLk19EzVBxI6NggUev
  226. ep+eaVvAi8V/YosYh0Xg4/dScOq391irO6k9+BPqkQPH+bRNCUBgnhXGkfElAAUR
  227. tBtHaWRlb24gWmVueiA8Z3plbnpAaXhjLm5ldD6JAJUDBRAzJLB9QGCeFcaR8SUB
  228. AYlyA/9vod8ZjMXVMG9dua5vHOS88m2dfg81A/c8X3u+PCoGmRS5i/V6zFKBu+43
  229. zBtjCw6g1bVwMMjEz+wBcGswfFflwV/5q7jqGi/ABBP1SP23jttBFVKoco8ZWNRQ
  230. Q/mNV8RDLqPzjZAnmEA0dCO+ZkBHR3Bo8nfmeon6HjXgpjuGrbQ6Tk9URTogPGd6
  231. ZW56QEVybmllLk1JLlVuaS1Lb2Vsbi5ERT4gaXMgbm90IHZhbGlkIGFueSBtb3Jl
  232. IYkAlQMFEDMksKpAYJ4VxpHxJQEBnykD/3JcoNyUEjHH8GIp3E1IMGBo0LmHIfII
  233. LaJkrT8XbM+6+6qSEIhAJ3MwUuwksWyVqaGNUMVlUpG2lIDe9uVaK+kzmfrK3iTG
  234. L5syQrctbaqvgIFbDdKuJKFPUGAaG4ttXhhxU0H88h4A4nhnza0vEtDO7Aqxg7E+
  235. QZJL+ZpLE4H4tClHaWRlb24gWmVueiA8Z3plbnpARXJuaWUuTUkuVW5pLUtvZWxu
  236. LkRFPokAlQIFEDKyDmW2+Q3cu22vgQEBUjgEAIb3vZjKei10f0wsNWhlnJ0jo0wR
  237. gX/+9/9tOf9AM30Nxb1V9Mc2FtywFuzhU6u+pf0PDDZ3/3W7f4dhoDdyvPTSY3m5
  238. WOQIT0Uwfe9A3KSsqYEydqMOmpjQT10kDJi7gLw1pgLPKkR4DqgbOuWVNNr772HZ
  239. WgYJNWtwIGDh9r0xiQEVAwUQMfa2uQBgAoLzpE8JAQGBNQf8DwpNz/00qL+ZvOQ8
  240. ZTLLAjeSun8eoYMBBU3z1AXKerk+1NK4rLlDgMCYnBDiCdr0YlDK2Z7VhtpcqM03
  241. EyLZvfdGF31qPkcpUfHptGC4nsumACi3PoW4jo3LvpXVxzBBCdvGujL4Qo5Ha46c
  242. 6H8avg1tXPVBNWqSxjKn9PmvAjV6yAmVMrGjDpj0EC63ILgzef1KdzqxWIZDBmwf
  243. 1fG2z1z2Z4jstGOV5aNIVyXsu5lXJ/osUW7Oj2NBBO34CTr3AJ43hCrmhPMslBr0
  244. rOBBrGPvSg/0vJM8GR1g9Ydr4lg8LGDIGiNjyKCrs+ZJGIyckqFaRDH65FBuem4M
  245. c+C+BIkAlQMFEDHR1zdAYJ4VxpHxJQEByIMD/ippEW/kpkaUhsB4amGVHff5oGMx
  246. kN/UyULVBwiTbI9j21MwiKzPTohyRnDs6r5FUGYk685m0kkm5UK65/IcpKDf4dGP
  247. pgTiVDv+iMJTvI9yt1+fLigsoSl6FEH8Xz0zNqftyPIsj2ofTsjbCrtr3ALA/gEO
  248. lrSXEwBB31ST5Q3q
  249. =JxHF
  250. - -----END PGP PUBLIC KEY BLOCK-----
  251.  
  252. -----BEGIN PGP SIGNATURE-----
  253. Version: 2.6.3ia
  254. Charset: latin1
  255.  
  256. iQCVAwUBM9J6D0BgnhXGkfElAQELRwP/R+h/N2X9jliCdVAqebe38v1kj3Up21QF
  257. FAgFvV83PuEGO8usF8/5EkTLrpVfy23AWfFRCKih9VmEc7nq6h78ytGuN1POzJOS
  258. KP1tnzt4h8H6qSXPyIbYRDtMtrQ/tkX208FhFiR5AwTIjGRUD2qgbi7vHUSY9kKh
  259. +NYvSDubPVo=
  260. =3o72
  261. -----END PGP SIGNATURE-----
  262.