home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD v1.2 / amidev_cd_12.iso / devcon / milan_1991 / devcon91.3 / debug / devel / syslock.doc < prev    next >
Text File  |  1992-09-01  |  4KB  |  95 lines
  1. SysLock version 1.4    Now with selectable hot keys and qualifiers.
  2.     by Michael Sinz    Copyright (c) 1989-91
  3.  
  4.  
  5. The Story of SysLock
  6.  
  7. SysLock got started after Carolyn was worried about our computers
  8. being open holes into CBMVAX and the Amiga source code.  So, with a
  9. bit of coding and thinking, SysLock 1.0 was born.  You would hit a
  10. hot-key and it would start grabbing all input events until you
  11. re-entered the passcode you entered when you locked it.  This was
  12. great stuff and took very little memory.  But, people liked it
  13. so it had to be changed.  (Axiom #2 of computerdom:  Any program
  14. that works well will have to be modified.)  Thus came SysLock 1.1
  15. and SysLock 1.2, each smaller than the previous, and each with
  16. more features.  (How was that done?!?)  Well, one more feature
  17. has now been added:  Selectable hot keys.  (CLI settable only)
  18.  
  19. 1.4 added support for 2.0 Cache calls in order to work with CopyBack
  20. mode on the 68040...
  21.  
  22.  
  23. Features and Usage:
  24.  
  25. SysLock is very simple to use.  Just type SYSLOCK from the CLI
  26. or double click on its icon.  It will then either install or
  27. deinstall itself and tell you what it did.
  28.  
  29. When it is installed, it does nothing until you press the hot key.
  30. (The default is LEFT-SHIFT/LEFT-AMIGA/SPACE)  It will then ask
  31. you for the locking code.  Type in any code you wish.  You should
  32. keep it under 60 or so characters as it would otherwise
  33. be difficult to re-enter correctly.  ( :-) )  Anyway, if, for some
  34. reason you wish to abort the entering of the locking code, press
  35. the HELP key.  To end the locking code, press the RETURN key.
  36. Note that SHIFTed, CTRLed, ALTed, AMIGAed, CAPSed, etc. codes
  37. are different from non-modified codes.  So, if you LEFT-SHIFT
  38. everything, including the return, you will have to LEFT-SHIFT it
  39. when you wish to unlock the system.
  40.  
  41. Once a locking code is entered, the screen will show the System
  42. Locked message.  The screen will fade out slowly, but any mouse
  43. or keyboard input will bring it back.  In the top left-hand corner,
  44. there will be a number (blank if ZERO) that tells of the number
  45. of failed attempts at accessing the system.
  46.  
  47. The CLI invocation of SysLock lets you pick the key code and
  48. qualifiers that should be used as the hot key.  This is done
  49. with the command parameters -cXX and -qXX  The XX stand for
  50. 2-digit HEX values.
  51.  
  52. SysLock is very small.  It is 2000 bytes in file size.  When
  53. installed, it takes a TOTAL of 2680 bytes of memory, including
  54. all structures and tables it needs but not including the small
  55. 320x50x1 screen that is opened when the system is locked.
  56.  
  57. SysLock will not uninstall itself if the installed SysLock is
  58. in the locked state, so you can not CRON a SysLock to unlock
  59. your system at some time.
  60.  
  61.  
  62.  
  63. Picking the keycode for the hot-key:
  64.  
  65. For the -cXX field, you would use the HEX raw key value for that
  66. key. SysLock does not check to see if that key exists, so please do
  67. not use keys such as 30 (-c30) since there is none on the keyboard.
  68. Also, it is best if you do not use the SHIFT/CTRL/ALT/AMIGA keys as
  69. your hot-key. It should work, but you will have to find the correct
  70. qualifier values for it.  The default of SPACE is -c40.
  71.  
  72.  
  73.  
  74. Picking the qualifier for the hot-key:
  75.  
  76. For the -qXX field, you would OR together the qualifiers you wish to
  77. have required for the hot-key.  If they key has anything but a
  78. perfect match, it will not be used as the hot key.  The values are:
  79.  
  80.         IEQUALIFIER_LSHIFT     0x0001
  81.         IEQUALIFIER_RSHIFT     0x0002
  82.         IEQUALIFIER_CAPSLOCK     0x0004
  83.         IEQUALIFIER_CONTROL     0x0008
  84.         IEQUALIFIER_LALT     0x0010
  85.         IEQUALIFIER_RALT     0x0020
  86.         IEQUALIFIER_LCOMMAND     0x0040    * Amiga key
  87.         IEQUALIFIER_RCOMMAND     0x0080    * Amiga key
  88.  
  89. For example:  If you wish to have LEFT-Shift, LEFT-Amiga, you would
  90. use a value of 41  (-q41)  This also is the default.
  91.  
  92. So, to set the key code and qualifiers you would do:
  93.  
  94. SysLock -c40 -q41  ; This just happens to be the default.
  95.