----------------
AwesomeLogin 2.0
----------------

AwesomeLogin is a front end for Novell's LOGIN.EXE.
It allows you to brighten up your login screen by displaying a BMP file
during the login prompt.

AwesomeLogin will work with any version of NetWare.

AwesomeLogin also helps to discourage intruders/password stealers by allowing
you to provide a unique login interface.  Since LOGIN.EXE is a text screen
mode program, it would be easy for an intruder to substitute a phony login
program and steal passwords.

After AwesomeLogin verifies a correct login, it then runs Novell's LOGIN.EXE.
Therefore, it is not necessary to rewrite any login scripts.

AwesomeLogin logs out of all file servers when first loaded.

AwesomeLogin prevents login/logout while Microsoft Windows is active.

-------------------------
What's New in version 2.0
-------------------------

AwesomeLogin has been made to work with the VLM DOS Requestor.  

--------------------
The Graphics Display
--------------------

AwesomeLogin supports the following screen modes:

80x25 Mono/Color Text
640x350x16 (EGA)
640x480x16 (VGA)
320x200x256 (VGA)
640x480x256 (SVGA)

AwesomeLogin will only display BMP files.  BMP is the standard MS Windows
bitmap file format.  You may create them in a paint program such as
Paintbrush, which is included with Windows, or convert existing images
from other formats into BMP using your favorite graphics/paint/image
processor.  AwesomeLogin cannot read BMP files which are RLE compressed.

AwesomeLogin can randomly select a BMP from a list if desired.

***********************************************************************
!!!!!!!!!!!!!!!!!!!!!     IMPORTANT NOTE      !!!!!!!!!!!!!!!!!!!!!!!!!
***********************************************************************

AwesomeLogin determines the screen mode from the attributes of the BMP file.
AwesomeLogin can only use BMPs which have the same attributes as the screen
modes listed above.  AwesomeLogin does not scale or tile images.  If a
requested BMP does not satisfy this requirement, then AwesomeLogin will
display a text screen.  Therefore, if you wish to display scanned images
on your screen, you need to resample/convert them to BMPs with THE SAME
DIMENSIONS and NUMBER OF COLORS as the screen modes listed above.

--------------------------------------------------------------
Problems with Graphics Modes - The ALOGIN Environment Variable
--------------------------------------------------------------

If you have display problems with SVGAs, you can force ALOGIN to use a
standard VGA mode by putting SET ALOGIN=VGA in AUTOEXEC.BAT.  Likewise,
you can force ALOGIN into text mode by using SET ALOGIN=MONO or
SET ALOGIN=TEXT.

-----------------
The Login Process
-----------------

AwesomeLogin is similar to LOGIN.EXE, except that AwesomeLogin includes the
default file server name in the login prompt, and a '*' for each password
character.  So if your file server's name is Lollapalooza, AwesomeLogin
will display:

LOLLAPALOOZA login: perry
Password: *******

If a user's password expires, AwesomeLogin will prompt for a new one before
allowing the user to login.

A user may also specify FileServer/User at the login prompt, for example:
"lollapalooza/perry".

AwesomeLogin logs out from all servers before issuing the login prompt.

CTRL-END exits AwesomeLogin.

--------------
IMPORTANT NOTE
--------------

AwesomeLogin sends the password through to LOGIN.EXE by stuffing the keyboard
buffer.  However:

1. This limits the length of a usable password to 14 characters.
   If a password is longer than that, AwesomeLogin will prompt for a new one.

2. A user will actually be logging in twice in a row.  If accounting is
   installed on the file server,  then 2 logins will be recorded.

3. If for some reason AwesomeLogin cannot run LOGIN.EXE, then it will clear
   the keyboard buffer before exiting to prevent the password from being
   displayed.

4. Therefore, AwesomeLogin might be incompatible with resident keyboard buffer
   expanders.

-----------------------
Setting Up AwesomeLogin
-----------------------

When setting up AwesomeLogin for testing:
-----------------------------------------
1. Copy ALOGIN.EXE and LOGIN.INI to SYS:LOGIN
2. In LOGIN.INI, set ChildProg=LOGIN.EXE.
3. Modify LOGIN.INI to indicate where the BMPs are located.

For a permanent installation:
-----------------------------
1. Rename SYS:LOGIN\LOGIN.EXE and SYS:PUBLIC\LOGIN.EXE to something else
   (the example LOGIN.INI uses LOGIN.OLD).
2. Copy ALOGIN.EXE to SYS:LOGIN\LOGIN.EXE and SYS:PUBLIC\LOGIN.EXE.
3. If you want AwesomeLogin to automatically run after a logout, rename
   SYS:PUBLIC\LOGOUT.EXE to LOGOUT.OLD (just for safe keeping) and copy
   ALOGIN.EXE to SYS:PUBLIC\LOGOUT.EXE.
4. Customize LOGIN.INI to suit your neeeds.
5. Place LOGIN.INI in the SYS:LOGIN directory.
6. Repeat steps 1-5 for each file server you login to directly.

Here is a sample LOGIN.INI.
Lines preceded by ; are comments.

; LOGIN.INI
; Keep this in the same directory as ALOGIN.EXE
; You might want to rename LOGIN.EXE ==> LOGIN.OLD
; and ALOGIN.EXE ==> LOGIN.EXE

[Options]
; Set EscExit=1 if you want to allow the Esc key to exit the program.
EscExit=0
;
; ChildProg is the Novell login program.  Did you rename it?
; If ChildProg is in a different directory than ALOGIN.EXE,
; then make sure that you state the full path.
ChildProg=LOGIN.OLD
;
[Text]
; BackgroundChar is the character used to paint the screen (in decimal).
; for example, 177= , 206= (default)
BackgroundChar=206

; The graphics syntax is Image=PATH\FILENAME.BMP,PromptLocation
;
; Remember that users are logged out and the current directory
; becomes wherever you place ALOGIN.EXE. (SYS:LOGIN is a good place!)
; So if the image directory is SYS:LOGIN\IMAGES, then IMAGES\ is sufficient
; for PATH.  If you want each station on your network to display a
; different image, then keep the images on a local drive.
; 
; If PromptLocation=Top, the login prompt will be at the top of the image.
; Otherwise it will be at the bottom of the image.  Default is top.
;
; If more than one image is listed under a graphics category, then
; one image will be randomly selected.
;
; About the images included here:
; EGASPACE.BMP = 640x350x16 w/standard palette
; VGASPACE.BMP = 640x480x16 w/programmed palette
; 320SPACE.BMP = 320x200x256 w/programmed palette
; 640SPACE.BMP = 640x480x256 w/programmed palette
;
[EGA]
Image=IMAGES\EGASPACE.BMP,bottom

[VGA]
Image=IMAGES\EGASPACE.BMP,bottom
Image=IMAGES\VGASPACE.BMP,top
Image=IMAGES\320SPACE.BMP,bottom

[SVGA]
Image=IMAGES\EGASPACE.BMP,bottom
Image=IMAGES\VGASPACE.BMP,top
Image=IMAGES\320SPACE.BMP,bottom
Image=IMAGES\640SPACE.BMP,top

;End LOGIN.INI

---------------------------------
Giving Credit Where Credit is Due
---------------------------------

The graphics routines are utilizing Jordan Hargrave's SuperVGA BGI drivers,
which he was so kind to grant usage for this project.  They are available
at many ftp sites.  The Tweaked VGA drivers are not used.

Jordan's supported SVGA list:

Acumos, Ahead, Avance Logic 2101, ATI, Chips & Tech, Cirrus Logic, Compaq, 
Everex, Genoa, MXIC68000, NCR, Oak, Primus 2000, Paradise, Realtek, S3
Trident (both 8800 and 8900, 9000), Tseng (both ET3000 and ET4000) and Video7.
These drivers will also work on video cards with VESA capability.

---------
Licensing
---------

AwesomeLogin is free.  You may use it as much as you desire.
AwesomeLogin may not be sold, except to cover distribution costs.
However, no warranty is provided, and no responsibility is assumed by 
A.N.D. Technologies for your usage of AwesomeLogin.

-------
Contact
-------

A.N.D. Technologies
P.O. Box 64811
Los Angeles, CA 90064
USA
(213) 782-6923

  Internet: andtech@netcom.com
CompuServe: INTERNET:andtech@netcom.com
            71011,3570

-------------------------------
Software by A.N.D. Technologies
-------------------------------
PCOUNTER 3.0 - A Page counting print server for Novell (PCNT30xx.ZIP)
PSPS 3.0 - PostScript PrintScreen (PSPS30.ZIP)
T2PS 1.0 - TSR Text to Postscript Converter (T2PS10.ZIP)

Check the A.N.D. ftp site: 
ftp.netcom.com, in the pub/an/andtech directory.
