
========> [LT95A.GNUSOFTWARE]AAAREADME.TXT;4 <========



GNU Tools

These tools are from the FSF distribution site. Many build native on VMS
but many do not. Examine included documentation for further information.

AUTOCONF24.TAR-GZ;1             Help autoconfigure packages
[vms95a.gnusoftware]BASH-1_14_4.TAR-GZ;1 "Bourne Again SHell"...good unix command shell
BISON124.TAR-GZ;1               Yacc replacement; generates parser tables
CFENGINE-1_0_4.TAR-GZ;1         Config engine
CVS-1_5.TAR-GZ;1                Concurrent Versioning System. Extends RCS to
                                        large groups
DC.README;1        
[vms95a.gnusoftware]ELISP-MANUAL_19_2_4.TAR-GZ;1 Manuals for ELISP language
                                        that Gnu Emacs uses
EMACS1929.TAR-GZ;1              Gnu Emacs V19.2.4
FLEX252.TAR-GZ;1                LEX replacement. Generates lexical analysis pgms
FSF_OFFICE.TXT;1                New address of FSF office
G77-0_5_15.TAR-GZ;1             Gnu Fortran 77 compiler. (This vers. needs Gnu C
                                        2.6.3 (see F94 tapes))
GAWK-2_15_6.TAR-GZ;1            Gnu AWK pattern language utility
GCC2_7_0.TAR-GZ;1               Gnu C 2.7.0 release
[vms95a.gnusoftware]GDB4_14.TAR-GZ;1    Gnu debug 4.14 release (moved for
                                        reasons of space)
GETTEXT07.TAR-GZ;1 
GHOSTSCRIPT-2_6_2.TAR-GZ;1      Ghostscript Postscript interpreter
GIT-4_3_6.TAR-GZ;1 
GNUFIT12.TAR-GZ;1  
HACKED-XTERM.TAR-GZ;1
IRCII2_2_6.TAR-GZ;1             Internet Relay Chat
IRCII2_2_6HELP.TAR-GZ;1
JARG320.TXT-GZ;1                Computer Jargon dictionary. Much humor.
LESS-290.TAR-GZ;1               Sophisticated text viewer
LIBGPP_2_7_0A.TAR-GZ;1          LibG++ Gnu C++ library
LIBOBJECTS-0-13.TAR-GZ;1        Object library
MAKE374.TAR-GZ;1                Gnu MAKE system builder util
MC-2_1.TAR-GZ;1    
MXTERM.TAR_Z;1     
NCURSES-1_9_2D.TAR-GZ;1         New curses sources. Terminal control
OCTAVE111.DIR;1    
PERLREF5_000.TAR-GZ;1           Ref. on PERL language. See elsewhere on tape
                                        for Perl 5.0.1
PSTREE-1_4.TAR-GZ;1
RCS57.TAR-GZ;1                  Revision Control System. A source control 
                                        system used to coordinate changes
                                        to files by many people.
RTFTOHTML_2_7.TAR-GZ;1          Rich Text Format to HTML convert
SCREEN362.TAR-GZ;1              Multiple sessions in Unix. (For VMS see BOSS
                                        on earlier VMS SIG tapes.)
SUPEROPT25.TAR-GZ;2             Code optimizer
TAR-1-11-8.TAR-GZ;1             Latest Gnu TAR (very extended abilities over
                                        other tar versions.). Tape archiver.
TEXINFO36.TAR-GZ;1 
TEXTUTILS-1_12.TAR-GZ;1         Gnu text utilities
UNPOST.TAR-GZ;1                 Turn Postscript to something else
UNTEX-1_2.TAR-GZ;1 

                                                                Page 2


UTREE.TAR_Z;1      
WEBLINT-1_005.TAR-GZ;1
YGL.README;1       
YGL_2_9_5.TAR-GZ;1 

========> [LT95A.LINUX-ALPHA]AAAREADME.TXT;1 <========



Linux/Alpha is a port of Linux 1.0 to Digital's Alpha CPU architecture.
Version 1.2 (with 64 bit support) is present also.

Questions should be directed to:        paradis@sousa.amt.tay1.dec.com

There's also a mailing list for Linux/Alpha discussions.  To subscribe
to the list, send a message of the form:

        subscribe alpha-linux [your-email-address]

to:
        majordomo@sousa.amt.tay1.dec.com


This directory contains the sources and tools needed to build Linux/Alpha.

Currently, Linux/Alpha is in a state that only a kernel hacker could love:
        - The kernel itself is fragile
        - The compilers are not yet self-hosting, so all
          compilation must be done on another system.
        - Very few device drivers are supported.
        - The C runtime library has not been 100% tested.
        - Very few utilities have been ported and tested.

If you're willing and able to contribute to rectifying any of the above
limitations, however, then this kit is for you. 8-)

Documentation, such as it is, is in the file "doc.tar-gz".  This file
will be updated as necessary.  I strongly suggest you download it, as
it contains valuable information on how to use the other components
of the SDK.

We have tested cross-compilation on Intel Linux, DEC OSF/1 Alpha, and
DEC RISC/ULTRIX, and we have provided binary kits of the cross-development
tools on those platforms for your convenience.  If you wish to attempt
cross-development on a different platform, we also provide the 
cross-development tools in source form.  Do not attempt this, though, 
unless you have at least 300Mb of free disk space and many compute cycles
to spare!

You do NOT need to download every file in this directory in order to
do development for Linux/Alpha.  Read the file SDK_CONTENTS for a complete
description of every file in the archive.  In the meantime, here are some
suggestions to allow you to make your selection:

All of the archives are compressed with gzip.  If you do not have gzip on 
your system, download the appropriate gzip binary:

[note: not all cross-tools suites are here due to space problems.]

        intel_linux_gzip.tar            Linux 386/486
        alpha_osf_gzip.tar              DEC OSF/1 Alpha
        risc_ultrix_gzip.tar            DEC ULTRIX for MIPS
        sparc_sunos_gzip.tar            SunOS on Sparc


                                                                Page 2


You should only download the cross-tools file(s) for whatever platform(s)
you intend to do cross-development on:

        File                                    Platform
        ----                                    --------
        intel_linux_cross_tools.tar.gz          Linux on 386/486
        alpha_osf_cross_tools.tar.gz            DEC OSF/1 on Alpha
        risc_ultrix_cross_tools.tar.gz          DEC ULTRIX on MIPS
        sparc_sunos_cross_tools.tar.gz          SunOS on Sparc

If you wish to use a platform other than the above, then you will need to
build the cross-tools from source for your platform.  To do this, you will
need to download cross_tools_src.tar.gz.  Note that you will need 250-300Mb
of disk space to build the cross tools, so only do so if you have no other
choice.  If you do build the cross tools for a new platform, it would
be much appreciated if you could package up a binary-only kit and make it
available to others so that we can expand the above list of pre-built kits.

For kernel development alone, all you need is kernel_src.tar.gz.

To do utility or library development, you need util_lib_src.tar.gz and
linux_root_tree.tar.gz.

In order to boot a Linux/Alpha system, you need a root filesystem.  There
are two ways to acquire one:

        (1) Create a blank ext2 filesystem and populate it.  You can do
        this is you have already downloaded linux_root_tree.tar.gz.  If you
        do not have access to a Linux system, you will have to download
        fs_templates.tar and uncompress one of the enclosed templates.
        Then, you can use the "make_fs_image" script in the linux root
        tree to populate the filesystem you created.

        (2) Download the pre-populated ext2 filesystem in 
        linux_root_fs_image.gz, uncompress it onto a device accessible
        from the Alpha system, and go.


If you do not have access to an Alpha system but you wish to build and test
a kernel or utility anyway, you will need the ISP Alpha CPU simulator.
This is NOT provided in source form; you will have to download the binary
appropriate for your system.  Currently two versions are provided: 
        - isp_linux.tar.gz for Linux 386/486 systems
        - isp_osf.tar.gz for DEC OSF/1 Alpha systems

If you wish to run isp on a different platform, contact me and I'll see
what I can do about building a binary version for your platform.  Don't
bother contacting me for source; it's not mine to give out.

