home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / CPROG / LOGIN.ZIP / README < prev    next >
Text File  |  1991-02-03  |  6KB  |  190 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.            ###                               ##
  8.         ##                     ##
  9.         ##         ######    ########         ## #####
  10.         ##        ########  ##########    ###     ##########
  11.         ##       ##       ## ##      ##     ##     ###     ##
  12.         ##       ##       ## ##########     ##     ##        ##
  13.         ##       ##       ##  #########     ##     ##        ##
  14.         ##       ##       ##          ##     ##     ##        ##
  15.         ## #    ########  ##########     ## #   ##        ##
  16.         ###      ######    ########      ###    ##        ##
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.         Inspired by the simple "login" program in the Feb. C Users
  27.     Journal, I have written another version of "login" for the
  28.     IBM PC and compatibles.
  29.  
  30.     This version of login implements the following features:
  31.  
  32.                 1. Validate a user name and password.
  33.         2. Change to a specific disk drive.
  34.         3. Change to a specific directory.
  35.         4. Execute a program, batch file,
  36.            or "command.com" (shell)
  37.         5. Update a master user activity log file.
  38.         6. Display a "message of the day".
  39.         7. A utility program to add users.
  40.            (no change, delete, list yet...)
  41.         8. Encrypted passwords.
  42.  
  43.         CUSTOMIZATION
  44.     =============
  45.         Login may be customized by changing the following file names
  46.     or paths.  These file names and paths may be changed by editing
  47.     the file "login.h" and changing the values for the MNEMONIC
  48.     defines, or by setting the MNEMONIC equal to another path or
  49.     name in the autoexec.bat file.
  50.  
  51.     MNEMONIC    DEFAULT VALUE        DESCRIPTION
  52.     -------------------------------------------------------------
  53.     PASSWD        "C:\etc\passwd"         default password file
  54.     LOGFILE     "C:\etc\logfile"        default activity log
  55.     MOTD        "C:\etc\motd"           default daily message file
  56.     ROOT        "root"                  default root user name
  57.  
  58.  
  59.         COMMAND LINE OPTIONS
  60.     ====================
  61.     Login supports the following command line options:
  62.  
  63.     OPTION      OPTION FUNCTION
  64.     ------------------------------------------
  65.     'd'       enable debugging output
  66.     'v'       enable verbose output mode
  67.     'l'       enable user activity logging mode
  68.     'm'       enable display of "message of the day"
  69.  
  70.  
  71.     Any error in command line usage will elicit:
  72.     "usage: login [-dvlm]"
  73.  
  74.  
  75.     PASSWORD FILE MAINTENANCE PROGRAM
  76.     =================================
  77.     The "user" program is provided to add users to the password
  78.     file.  The user program is an interactive program, and prompts
  79.     for the proper information. The command line to use "user" is:
  80.  
  81.  
  82.         user -a<CR> (The "-a" is mandatory)
  83.  
  84.         Data validation is done on the informations entered.  When
  85.     the last of the information has been entered, the info will
  86.     be shown, with the prompt: "Is This OK?". If the answer is
  87.     affirmative, then this user will be added to the password file.
  88.  
  89.     Note that the password will be encrypted in the password file,
  90.     so that users who are given shell access may not view another
  91.     users password.  This is a SIMPLE encryption based on the
  92.     public domain "uuencode" programs. (DES seemed like overkill
  93.     when a user could simply place a bootable diskette in drive A.)
  94.  
  95.  
  96.     PASSWORD FILE FORMAT:
  97.     =====================
  98.     A sample login password file follows:
  99.  
  100.         ############################################################
  101.     #           PASSWORD FILE FORMAT            #
  102.     #  name:id number:drive:home directory:command or "shell"  #
  103.     #                               #
  104.     #             NOTES                   #
  105.     # 1. id 0 is reserved for root                   #
  106.     # 2. colons are mandatory separators               #
  107.     # 3. leading and trailing white space is significant       #
  108.     # 4. '#' indicates a comment line                          #
  109.     ############################################################
  110.     root:0::C:\usr\tmp:shell
  111.     games:1:%9V%M97, :D:\games:shell
  112.     qedit:2:%<65D70 :C:\usr\tmp:q
  113.     bat:3:&8F%T8F%T:C:\usr\tmp:foo.bat
  114.  
  115.  
  116.         DEFINITIONS:
  117.     ------------
  118.     NAME        User name <= 14 characters    (required)
  119.  
  120.         ID NUMBER       3 digit number                  (required)
  121.             (NOTE: 0 is reserved for "root" name)
  122.  
  123.         DRIVE           Disk drive letter. (If omitted, defaults to
  124.             the current drive.)
  125.  
  126.     HOME        Directory path for user. (defaults to
  127.             current directory if omitted.)
  128.  
  129.     COMMAND     Command to execute. (If omitted, defaults to
  130.             command.com.)
  131.             NOTE: If a batch file is specified as the
  132.             command to run, the ".bat" extension MUST
  133.             be provided.
  134.  
  135.     The passwords for the demo login IDs are:
  136.         games:    "games"
  137.         qedit:    "qedit"
  138.         bat:    "batbat"
  139.  
  140.  
  141.     ACTIVITY LOG FILE FORMAT:
  142.     =========================
  143.     A sample activity log file follows:
  144.  
  145.     T|  Date     Time  | User Name |ID#|D| User Home Dir | Command/Shell
  146.     -+-----------------+-----------+---+-+---------------+--------------
  147.     I|02/03/91 17:20:35|games      |  1|D|\games         |C:\COMMAND.COM
  148.     O|02/03/91 17:20:38|games      |  1|D|\games         |C:\COMMAND.COM
  149.  
  150.     The headings for the columns are defined as follows:
  151.  
  152.     T        The 'T'ype of activity recorded by this entry.
  153.             'I' indicates user logged Into the system.
  154.             'O' indicates user logged Out of the system.
  155.  
  156.     Date & Time    The Date and Time of the activity.
  157.  
  158.     User Name    User name from the password file.
  159.  
  160.     ID#        User ID Number from the password file.
  161.  
  162.     D        User Default Disk Drive from the password file.
  163.  
  164.     User Home dir    User Default Directory from the password file.
  165.  
  166.     Command/Shell    User Default Command from the password file, or
  167.             the word "shell" to indicate that a "command.com"
  168.             command processor should be given to this user.
  169.  
  170.  
  171.         COMPILING LOGIN
  172.     ===============
  173.  
  174.     Login was written in Microsoft 'C' Version 6.0.
  175.     To compile login, edit the file "login.h" and make
  176.     any changes regarding path names, and default ID's, etc.
  177.     The makefile may be edited to change any compile time
  178.     switches.
  179.  
  180.     Then, type "make".
  181.  
  182.     Off you go......
  183.  
  184.     Have fun...
  185.  
  186.                 Michael Lavett
  187.                 Birmingham, Alabama
  188.                 205-991-5920
  189.  
  190.