home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Disk&HD / RMD-E215.LHA / enigmaii_project / a-lock / a-lock.doc < prev    next >
Encoding:
Text File  |  1994-04-01  |  6.8 KB  |  175 lines
  1.                         ************************        
  2.                         *      A-Lock v1.3     *
  3.                         *    by Dario Rosati   *
  4.                         ************************
  5.  
  6. LEGAL STUFF
  7.  
  8. This program is absolutely freeware, you can do what you want with it,
  9. except gaining money by selling it to someone.
  10. However, I strongly raccomend to read this entire Doc file, because i
  11. take NO RESPONSABILITY if you lock your system and can't get back, thus
  12. loosing your day's work.
  13. If you want to contact me, for flames, bugs, chat or whatsoever, see the
  14. section AUTHOR.
  15.  
  16. INTRODUCTION
  17.  
  18. Do you have a young brother, who seems only to wait the moment you leave
  19. your Amy alone just for wreak havoc trough your harddisk or your system?
  20. Have you lost your 4000's keys?
  21. Are you using your Amy in a public place for a demonstration?
  22. You lucky have a local net of Amy, and simply want to descourage other
  23. peoples from using your machine while you are away for a while?
  24. If so, A-Lock is for you.
  25. It is based on a version of X-Lock running on Unix machines in my
  26. university lab.
  27.  
  28. REQUIREMENTS
  29.  
  30. You need the incredibile amount of 12k ram and OS 2.04 to run this program.
  31. CPU Doesn't matter.
  32. Ah, sorry, pearl.font also needed and included (I like them :)).
  33.  
  34. INSTRUCTIONS
  35.  
  36. It's not so difficult, I mean.
  37. First, and MOST IMPORTANT, take a look at the tooltypes in the program's
  38. icon.
  39. The first is PASSWORD, and you MUST fill it with a LOWERCASE password.
  40. The reason is explained in the technical section.
  41. The second is AUTOLOCK; setting it to YES will cause A-Lock to
  42. automatically lock when launched.
  43. This is *VERY* useful (thanks to Jochen Becher for the suggestion)
  44. because now you can place A-Lock in the WB-Startup drawer with the
  45. tooltypes DONOTWAIT and STARTPRI, and so the system will boot LOCKED!
  46. Thus, even toggling power will prevent stupid people to access your
  47. computer!
  48. If for example you have the opportunity to lock your drives, there is
  49. * NO WAY * to access your computer now.
  50. The only method is to boot from a floppy disk.
  51. Forgetting the password in autolock mode can now cause some troubles, so be 
  52. careful with it.
  53. The third optional tooltype is PUBSCREEN. This is new in 1.3.
  54. With it now you can open A-Lock on any public screen. This can be very
  55. useful for you guys who want to run demonstrations in public places, such
  56. slideshows, raytracings, and every kind of programs, because now you don't
  57. have to worry about webby persons who will try to hack you system during
  58. a temporary absence. No more 8 hours continuosly with your 1200 cause you
  59. can't leave it alone!!
  60. For example, I use this feature on TERM, leaving them calling BBS when I'm
  61. busy with my girlfriend, keeping the gnarlings hands of my brother away!!
  62.  
  63. Doubleclicking the icon a small window will appear.
  64. Now you may:
  65. -Quit in the usual way (Upper left gadget of the window...)
  66. -Lock the system by pressing the "Lock" gadget
  67. -Have a small info requester by pressing "About".
  68.  
  69. If you lock the system, you'll notice some small :) things to happen...
  70. The mouse will appear like a closed lock, and left mouse button will act
  71. like the right.
  72. Naaa, only? Yes, I threat you to do something different than typing your
  73. password, cause you'll soon realize (i hope :)) that you can't no longer
  74. interact with the system.
  75. After typing the password, you will hear an acknowledgment beep and then
  76. the situation will return as before.
  77.  
  78. Now you are probably thinking "Such programs still exists, so why...", and
  79. I answer that all I saw in the past had four drawbacks:
  80.  
  81. 1) Too complicated
  82. 2) Too big
  83. 3) Doesn't allow multitasking when locked
  84. 4) Doesn't work on my Amiga 4000/030. 
  85.  
  86. A-Lock is simple, allows running tasks to continue their works and runs
  87. on my 4000/30 :).
  88.  
  89. TECHNICAL SECTION
  90.  
  91. The initial program was a four-days work on my 4000/30 with SAS 6.5 and 
  92. DevPac 3.04. 
  93. Yes yes, I had to write a part in assembly (the most skilled of you 
  94. have probably still realised WHAT part... or not? ;)).
  95. I wrote this program mainly to learn how device handlers and events work.
  96. In fact, when the user locks, the program sets up a high-priority assembly
  97. handler in the input-handlers queue.
  98. This handler simply trashes all leftmouse events and all key-related
  99. qualifiers (such as IEQUALIFIER_RSHIFT --> this is the reason why you MUST
  100. specify a LOWERCASE PASSWORD in the PASSWORD tooltype...), preventing the
  101. user from accessing to other screens, other windows, menus, gadgets, icons,
  102. commodities and so on. As ulterior security the programs reacts to 
  103. IDCMP_INACTIVEWINDOW bringing the screen to front and making its own 
  104. window active; this is needed to prevent AUTOPOINT features of some 
  105. commodities. Using A-Lock when such feature is present  causes a hugly 
  106. effect on the pointer and the screen title, but the situation remains equally 
  107. under control, don't worry.
  108. I have not yet discovered any weak point, except the fact that the password
  109. stays in the icon (but you can change it when you want, and there is no way
  110. to read it when the program is locked).
  111. The handler is written in assembly because there can be many programs
  112. waiting for events and you must handle them as fast as possible to prevent
  113. the loss of someone.
  114. If you are interested in the source code, contact me in one of the ways
  115. described in the section below.
  116.  
  117. THE AUTHOR
  118.  
  119. I can be reached for bug reports, ideas, congratulations (:)), chats and all
  120. what you want in three ways:
  121.  
  122. - E-Mail at rosati@ghost.dsi.unimi.it
  123. - BBS: +39-[0]2-27201236 or 27200576
  124. - Normal Mail:
  125.  
  126.                         Dario Rosati
  127.                         Piazza Piola 11
  128.                         20133 Milano - Italy
  129.  
  130.  
  131. HISTORY
  132.  
  133. 10-Jan-94: First release
  134.  
  135. 04-Feb-94: Version 1.1
  136.  
  137.            - Forgot to release some memory
  138.            - Forgot to lower the priority after unlocking
  139.            
  140.            - Instead of raising the priority at the fixed value
  141.              of 21, now A-Lock checks the priority of the input.device
  142.              and then raises his priority to one unit more than them.
  143.              This allow A-Lock to run in almost any situation.
  144.  
  145. 07-Mar-94: Version 1.2
  146.  
  147.            - Added AUTOLOCK feature, making A-Lock more useful.
  148.              Now A-Lock can be placed into WBStartup drawer,
  149.              if the user wants to lock the system on startup.
  150.  
  151. 31-Mar-94: Version 1.3
  152.  
  153.            - Added PUBSCREEN tooltype, allowing A-Lock to open
  154.              it's window on the specified screen.
  155.  
  156.            - Some minor source improvements.
  157.  
  158.            - Now uses EasyRequests to notify user instead
  159.              of that ugly console window.
  160.  
  161. TO DO
  162.  
  163. - Password file encription
  164. - Timeout autolocking (also suggested by Jochen Becker)
  165.  
  166. GREETINGS
  167.  
  168. - Special greetings to Andrea Marenghi, without whom I probably
  169.   had never learned C language (Asm rulez ;))
  170. - Also greetings to Dario Maggiorini, who gave me the idea
  171. - Jochen Becher and Jason L. Tatum for the suggestions
  172. - And to Kichkaha & Willow of Skandal.
  173.  
  174. Have fun! And sorry for my scholastic english!
  175.