=head1 NAME

Welcome2l - Linux ANSI boot logo.


=head1 SYNOPSIS

B<Welcome2L> [ B<-scr> ] [ B<-getty> ] [ B<-msg> ] [ B<-cpu> ] [ B<-lcol> ]  [ B<-nolf> ] [ B<-private> ]


=head1 DESCRIPTION

B<Welcome2L> is a little program that may run at login time to produce a BBS
like ANSI login logo. It's very similar to Linux_Logo. But where Linux_Logo
intends to be portable, Welcome2L intends to produce the best looking
ANSI screens by making full usage of PC graphic characters. Therefore
an architecture able to display those characters (i386, Alpha with TGA adapter,
... ) is required to use it. And, even if it will work on larger screens,
it will only produce 80 column ANSI screens. 



=head1 OPTIONS

=over 8

=item B<-getty>

Will display more accurate information when launched at boot time.


=item B<-nolf>

Will not add an empty line to the ansi screen produced.


=item B<-msg>

-msg"text of message" will show the message given as the distribution info.

=item B<-cpu>

-cpu"name" will show the  name given as the CPU name.


=item B<-scr>xx

Will display screen number xx. 


=item B<-scrrand>

Will display a random screen. 


=item B<-lcol>xx

Will change the prompt color to the color number xx. Type Welcome2L -help to see
what number is attributed to a color.


=item B<-private>

Display an "Unauthorized access is prohibited" line at the bottom 
of the ANSI screen

=item B<-help>

Will display usage information. 

=back


=head1 EXAMPLE

./Welcome2L -getty -msg"RedHat Linux" -lcol14
 


=head1 INSTALLATION


=head2 On RedHat systems 

cd to /etc/rc.d/
edit rc.local, near the end find these lines (may be not exactly the same) :

    echo "" > /etc/issue
    echo "Red Hat Linux $R" >> /etc/issue
    echo "Kernel $(uname r) on $a $(uname m)" >> /etc/issue

comment them out and add this one (change the version numbers to yours) :

    /usr/local/bin/Welcome2L -msg"Red Hat 5.0 (Hurricane)" > /etc/issue



=head2 On Debian systems 

[ From: Gerd Bavendiek <bav@rw.sni.de> ]
   I put a script in
   lulu:/etc/rc.boot> ls
   0setserial  1netenv     2hdparm  3Welcome2L
    
    It's contents is just:    
   #!/bin/sh
    /usr/local/bin/Welcome2L -getty -msg"Debian GNU/Linux 2.0" > /etc/issue


=head2 On Slackware systems

[ From: Joe X <obliteration@hotmail.com> ]
  add these lines in /etc/rc.d/rc.S
  /usr/local/bin/Welcome2L > /etc/issue
  /usr/local/bin/Welcome2L > /etc/issue.net


=head2 On SUSE 5.3 system:

[ From: Ronny Ziegler <ronny.ziegler@usa.net> ]

 1) Put the following script called logo into /sbin/init.d

 #! /bin/sh
 #
 #Author: Ronny Ziegler <ronny.ziegler@usa.net>, 1998
 #
 # /sbin/init.d/logo
 #
 case "$1" in
     start)
         echo "Starting  logo"
         /usr/local/bin/Welcome2L
         /bin/sleep 1
         ;;
     stop)
         ;;
     reload|restart)
         ;;
     *)
         echo "Usage: $0 {start|stop|reload|restart}"
         exit 1
 esac
 exit 0

 2) cd /sbin/init.d/rc2.d
 3) mv S99zzreached S98zzreached
 4) ln -s ../logo S99logo
    Now the logo will be executed as last before login-prompt
 5) You don't need the old Login-Text any more:
     mv /etc/issue /etc/issue.orig
     touch /etc/issue


=head2 On SUSE 6.0 system:

[ From: Ronny Ziegler <ronny.ziegler@usa.net> ]

You should have an error-free bootprocess before installing Welcome2L.
 
 1) Add the following in your /sbin/init.d/rc file as 
    the line before last (thatīs the one with exit 0)  
        /usr/local/bin/Welcome2L
    where this is the path to your Welcome2L-executeable

 1b)Optional: If you dontīt like Welcome2L to overwrite your 
    boot-messages, add 
        echo -e \\v\\v\\v\\v\\v\\v
    (or some more \\v īs) in you rc before starting Welcome2L.  

 2) Now you donīt need the old Login-Text any more:
    mv /etc/issue /etc/issue.orig
    touch /etc/issue


=head1 RESTRICTIONS

Welcome2L is not intended to run in a xterm.

=head1 CAVEAT

Because "A 'welcome' page has been proven to be an invitation 
to come your system, thus making it legal to hack into your box." 
you may want to use the "-private" arg when running Welcome2L
to display an "Unauthorized access is prohibited" line at the bottom 
of the ANSI screen. 


=head1 COPYRIGHT

B<Welcome2L Copyright (C)1998-1999 Little Igloo Org> is freely distributable 
under the B<GNU Public License>, a copy of which you should have received 
with this software (in a file called F<COPYING>).


=head1 AVAILABILITY

You can get the last Welcome2L version, sources, binaries distribution
or RedHat Packages, at : F<http://www.LittleIgloo.org>


=head1 AUTHOR

Jean-Marc Jacquet <jm@littleigloo.org>
