                        xLogin - Remote Session Manager
                        ===============================
                     Copyright (C) Karim Kaschani 1995-1999



INTRODUCTION

   'xLogin' is a simple Motif based tool to run multiple different sessions on
   various remote hosts and in the same time to control the access of the local
   X server, too. It was originally written for users, who frequently have to
   run X11 applications remotely without thinking much about 'xhost' settings.
   In addition to almost automatically set the DISPLAY of the remote host when
   logging in, the tool 'xDisplay' is provided, which tries to evaluate the
   correct hostname:displaynumber struct of the local Xserver.


DISCLAIMER

   'xLogin' with a capital 'L' has nothing to do with 'xlogin' (with a small
   'l') written by Markus Stumpf from Technical University Munich, Germany.


LEGAL STUFF

   PERMISSION IS HEREBY GRANTED, FREE OF CHARGE, TO ANY PERSON OBTAINING A
   COPY OF THIS SOFTWARE AND ASSOCIATED DOCUMENTATION FILES (THE "SOFTWARE"),
   TO DEAL IN THE SOFTWARE WITHOUT RESTRICTION, INCLUDING WITHOUT LIMITATION
   TO RIGHTS TO USE, COPY, MODIFY, MERGE, PUBLISH, DISTRIBUTE, SUBLICENSE,
   AND/OR SELL COPIES OF THE SOFTWARE, AND TO PERMIT PERSONS TO WHOM THE
   SOFTWARE IS FURNISHED TO DO SO, SUBJECT TO THE FOLLOWING CONDITIONS:

   THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN
   ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE.
 
   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
   THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
   IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
   CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 


INSTALLATION

   To compile 'xLogin' first adjust the Makefile, which is included with
   'xLogin' for your needs. Currently this Makefile supports Solaris 2.4 and
   2.5, HPUX 9.x, AIX 4.1.4 and Linux (provided Motif is installed), but I am
   quite confident, that only minor changes are needed to adjust it for other
   platforms (hopefully).

   If your system is SYSV you should define -DSYSV. If your system is SVR4
   please define -DSVR4. Actually these defines are only needed by 'xDisplay'
   but not by 'xLogin' yet.

   If UTMP_FILE, UTMPX_FILE, WTMP_FILE or WTMPX_FILE are not defined in your
   utmp.h or utmpx.h header files you should add -DUTMP_FILE, -DUTMPX_FILE,
   -DWTMP_FILE or -DWTMPX_FILE respectively.

   By means of -DSUN, -DHPUX and -DAIX different default terminals in addition
   to the very default 'xterm' are specified, so be sure to choose the right
   one.

       -DSUN  = {xterm, shelltool, cmdtool}
       -DHPUX = {xterm, hpterm}
       -DAIX  = {xterm, aixterm}

   Anyhow, if most of your system's terminals are not included, you may simply
   add them by specification in 'xLogin''s resource file.

   Having adjusted the Makefile simply run

        make
     
   After compilation you can immediatly run it, since 'xLogin' does not
   necessarily need special options or resource files (a properly configured
   /etc/hosts will act as a simple resource file).

   At its first run 'xLogin' creates a directory '~/.xLogin' as well as a
   sample resource file '~/xLogin/xLoginrc.ex'. In order to provide a more
   sophisticated resource file, please copy 'xLoginrc.ex' to 'xLoginrc' and
   adjust 'xLoginrc' according to your needs. If 'xLogin' crashes without any
   warning at your first run, have a look at its logging file '~/.xLogin/log'.
   If everything worked fine and BINDIR, MANDIR, PIXMAPDIR and XAPPDEFAULTS
   are specified correctly you may install 'xLogin' with

        make install
   
   and finally clean up everything with

        make clean

   For deinstallation simply run

        make deinstall
   
   When using 'xDisplay' in order to set the DISPLAY of the remote host, make
   sure to install 'xDisplay' at the REMOTE host and insert some proper code in 
   your remote '~/.login' or '~/.profile'. E.g. insert:
   
        setenv DISPLAY `xDisplay -i`

   in '~/.login' or
   
        DISPLAY=`xDisplay -i` ; export DISPLAY

   in '~/.profile'.
           
   Please send any bug reports (and fixes), code for new features, comments,
   questions, etc. to:

        karim.kaschani@arcormail.de

   Enjoy.

        Karim Kaschani
