home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / sysutl / passwrd5.arc / PASSWRD5.DOC < prev    next >
Text File  |  1988-09-20  |  5KB  |  134 lines
  1. | Brief documentation on PWORD.ASM (also called PASSWRD5.ASM)
  2. by ... P. L. Olympia, Sysop SUGI SIG/M RBBS  301-963-5249
  3.  
  4. Thanks to John R. Petrocelli for sending me this program whose
  5. original author I don't know. Thanks, Mr. Anonymous.
  6.  
  7.    (*** SEE UPDATE AT END OF TEXT       02/05/85  CHANGES  J.R.P. ***)
  8. |                    880919    Changes  Toad Hall
  9.  
  10. PURPOSE:
  11.  
  12. |PASSWRD5.ASM is intended to produce a device driver (PASSWRD.SYS) that
  13. that you include in your CONFIG.SYS file. This driver will ask the user
  14. on machine startup to provide a password. The user is repeatedly asked
  15. for the password until the correct one is given.  The user cannot get
  16. out of this with CTRL-C or CTRL-BREAK, but may warmboot with CTRL-ALT-DEL.
  17.  
  18.  
  19. INSTALLATION:
  20.  
  21. |    Edit the file PASSWRD5.ASM and change the password  (set  in  the
  22. distribution program as 'plan') to something else that you can  easily
  23. remember.   I suggest that you do NOT use your wife's name as everyone
  24. else in the industry does that (don't know why but 45% of my BBS users
  25. do that for some reason). The line that needs changing is this:
  26.  
  27. |    PASSWORD_STORE DB 4    This is the # of chars in the password
  28. |            db 'plan'    This is the password
  29.  
  30. If  you don't use ANSI.SYS as a device driver,  you may also  want  to
  31. | set the constant ANSI to 0.  This will tell your compiler NOT to use
  32. | the messages with ANSI sequences at MSG_1, MSG_2, etc.
  33.  
  34.      Next, compile the program with ASM or MASM.
  35. |    MASM passwrd5;
  36.  
  37.      Then LINK it: (ignore the "no stack" message)
  38. |    LINK passwrd5;
  39.  
  40.      Then use EXE2BIN to convert it to a SYS file:
  41. |    EXE2BIN passwrd5 passwrd.sys
  42. |    (Or just use one of the public domain converters like EXE2COM,
  43. |    which will automatically sense the ORG 0 and make a .SYS file.
  44. |    EXE2COM passwrd5.exe passwrd.sys
  45.  
  46. |    Delete the excess files:
  47. |    DEL passwrd5.obj
  48. |    DEL passwrd5.exe
  49.  
  50.      Add this line to your CONFIG.SYS file:
  51. |    DEVICE=passwrd.sys
  52.  
  53. |If you use ANSI.SYS, it should come before PASSWRD.SYS.
  54.  
  55. That's it. Reboot and watch the fun.  Enjoy ...
  56.  
  57.  
  58. P.S. For all you budding programmers, the program is a handy tool for
  59.      learning how to set up a device driver.
  60.  
  61.  
  62.  
  63. *** UPDATE   02/05/85    JOHN R. PETROCELLI  **************************
  64.  
  65.     The driver program has been revised to allow the user to "lock"
  66. the PC via a call into the device driver's code. The address of the
  67. call is placed at interupt 66h in the table of interupt vectors.
  68.  
  69.     An routine called "LOCK.COM" may be invoked to call the password
  70. routine. This will prompt the user for the password after disabling
  71. ctrl-break. The user must enter the correct password (same as on
  72. boot up) before he may access the PC.
  73.  
  74.     The reason that the call is made into the device driver's code
  75. is so that if a password change is necessary then only the device
  76. driver must be recompiled and relinked.
  77.  
  78. |   In order to prepare "LOCK.COM" ---------
  79.  
  80.      Compile the program:
  81. |    MASM LOCK13;
  82.  
  83.      Then LINK it: (ignore the "no stack" message)
  84. |    LINK LOCK13;
  85.  
  86.      Then use EXE2BIN to convert it to a .COM file:
  87. |    EXE2BIN lock13 lock.com
  88. |    (or use one of the public domain converters like EXE2COM:)
  89. |    EXE2COM lock13.exe lock.com
  90.  
  91.  
  92. |    Then delete the excess files:
  93. |    DEL lock13.exe
  94. |    DEL lock13.obj
  95.  
  96. | v1.5 Notes:  PASSWRD5.ARC now includes the compiled PASSWRD5.SYS
  97. | driver and LOCK13.COM enable/disable utility.
  98. | They have both been compiled with "flashy" ANSI display lines,
  99. | so you'll need to recompile if you don't want ANSI or NANSI drivers
  100. | installed in your system.
  101. |
  102. | PASSWRD5.SYS has a "default" password hardcoded ('plan').
  103. | You can change that with DEBUG or a binary file editor like FM.COM
  104. | Just look for the characters right after 'PWORD15' in the PASSWRD5.SYS
  105. | file (starting at byte 17).  Password structure:
  106. |  byte 17    - nr characters in password
  107. |  byte 18..21    - password itself (case and spaces matter!)
  108. |          Padded on the end with spaces (which don't count).
  109. | Remember, there's a maximum of 16 characters allowed in the password
  110. | itself, plus the initial length byte.
  111.  
  112.     I would appreciate any comments or suggestions. Send them to:
  113.         JOHN R. PETROCLLI
  114.         3090 CARMAN RD.
  115.         SCHENECTADY, N.Y. 12303
  116.  
  117. v1.5, 19 Sep 88
  118. PASSWRD5.DOC    - renamed, v1.5 update
  119. PASSWRD5.ASM    - Cleaned up comments, renamed
  120. PASSWRD5.SYS    - Compiled for ANSI.SYS display and 'plan' password
  121. LOCK13.ASM    - Cleaned up comments, renamed
  122. LOCK13.COM    - Compiled for ANSI.SYS display
  123.  
  124. Toad Hall Changes, 7 Aug 88
  125. PASSWRD4.DOC    - Indicated by "|" lines above.
  126. PASSWRD3.ASM    - Basically the same, just tweaked.
  127. PASSWRD4.ASM    - Extensive rewrite, tightening.
  128. LOCK.ASM    - Just tweaked.
  129.  
  130. All now compile with MASM 5.0 (but not using any of the fancy stuff).
  131. David Kirschbaum
  132. Toad Hall
  133. kirsch@braggvax.ARPA
  134.