un debut...

This commit is contained in:
Olivier Sirol 2002-10-17 10:04:09 +00:00
parent 761c3858b5
commit 2ee85917e1
6 changed files with 117 additions and 519 deletions

View File

@ -5,13 +5,28 @@
# E-mail : mailto:alliance-users@asim.lip6.fr # E-mail : mailto:alliance-users@asim.lip6.fr
# ftp site : ftp://asim.lip6.fr/pub/alliance/ # ftp site : ftp://asim.lip6.fr/pub/alliance/
# #
# NOTE: You can find the latest revision of this file at: # NOTE: You can find the latest revision of this document at:
# http://asim.lip6.fr/pub/alliance/unstable/cvstree/alliance/ # http://asim.lip6.fr/pub/alliance/latest-checkout/alliance/src
# #
# $Id: CHANGES,v 1.2 2002/09/30 16:19:34 czo Exp $ # $Id: CHANGES,v 1.3 2002/10/17 10:04:09 czo Exp $
This document lists the main differences between each Alliance's revisions. This document lists the main differences between each Alliance's revisions.
--------------------------------------------------------------------------------
ALLIANCE revision 5.0 (2002/05/03)
1/ Large changes in the sources
- Alliance now build with gnu autoconf/automake
- Alliance's C Libraries aren't numbered anymore
(ie libMut.a rather than libMut315.a...)
2/ New tools
- nero replaces ocr.
- dpgen is now integrated into genlib.
-------------------------------------------------------------------------------- --------------------------------------------------------------------------------
ALLIANCE revision 4.9.0 (2002/02/14) ALLIANCE revision 4.9.0 (2002/02/14)

View File

@ -5,14 +5,10 @@
# E-mail : mailto:alliance-users@asim.lip6.fr # E-mail : mailto:alliance-users@asim.lip6.fr
# ftp site : ftp://asim.lip6.fr/pub/alliance/ # ftp site : ftp://asim.lip6.fr/pub/alliance/
# #
# NOTE: You can find the latest revision of this file at: # NOTE: You can find the latest revision of this document at:
# http://asim.lip6.fr/pub/alliance/unstable/cvstree/alliance/ # http://asim.lip6.fr/pub/alliance/latest-checkout/alliance/src
# #
# $Id: FAQ,v 1.2 2002/09/30 16:19:34 czo Exp $ # $Id: FAQ,v 1.3 2002/10/17 10:04:09 czo Exp $
##########################################################
# WARNING: This file needs to rewritten for Alliance 5.0
##########################################################
-------------------------------------------------------------------------------- --------------------------------------------------------------------------------
@ -29,7 +25,6 @@ Question 4: How to get started ?
Question 5: What are the differences with the previous releases ? Question 5: What are the differences with the previous releases ?
Question 6: What is the supported VHDL subset ? Question 6: What is the supported VHDL subset ?
Question 7: What is the available online documentation ? Question 7: What is the available online documentation ?
Question 8: How can I get more complete documentation ?
Question 9: Where are defined the symbolic layout rules ? Question 9: Where are defined the symbolic layout rules ?
Question 10: How is performed the mapping to a target process ? Question 10: How is performed the mapping to a target process ?
Question 11: What are the supported file formats ?/ Question 11: What are the supported file formats ?/
@ -40,93 +35,35 @@ Question 14: How can I get Alliance ?
Question 1: What is ALLIANCE ? Question 1: What is ALLIANCE ?
------------------------------ ------------------------------
Alliance is a free VLSI CAD System. Alliance is a complete set of free CAD tools and portable libraries for VLSI design. It includes a VHDL compiler and simulator, logic synthesis tools, and automatic place and route tools. A complete set of portable CMOS libraries is provided. Alliance is the result of a twelve year effort spent at ASIM department of LIP6 laboratory of the Pierre et Marie Curie University (Paris VI, France). Alliance has been used for research projects such as the 875 000 transistors StaCS superscalar microprocessor and 400 000 transistors IEEE Gigabit HSL Router.
You can read a general description of the ALLIANCE tools and libraries
in share/doc/overview.pdf or by printing the PostScript file overview.ps
located in the doc directory:
> lpr share/doc/overview.ps
Question 2: What is ALLIANCE general copyright policy ? Question 2: What is ALLIANCE general copyright policy ?
------------------------------------------------------- -------------------------------------------------------
"Alliance VLSI CAD System" is free Software. Alliance VLSI CAD System is free software. Binaries, source code and cells libraries are freely available under the GNU General Public License (GPL). You are welcome to use the software package even for commercial designs without any fee. You are kindly requested to mention : "Designed with Alliance © LIP6, Université Pierre et Marie Curie"
Alliance is available under the terms of the GNU General Public License See LICENCE
GPL (http://www.gnu.org/copyleft/gpl.html). Please read the files
COPYING-2.0 and COPYING.LIB-2.0
You are welcome to use the software package even for commercial
designs without any fee. You are just required to mention :
" Designed with Alliance CAD system,
Copyright (C) 1991, 2000 Université Pierre et Marie Curie"
> more LICENCE
Question 3: How to install ALLIANCE ? Question 3: How to install ALLIANCE ?
------------------------------------- -------------------------------------
You can compile the sources or use precompiled binary package. You can compile the sources or use precompiled binary package.
Binary packages are available for : See README
- i386 Linux
- sparc SunOS 4.1.1
- sparc Solaris 5.7
- i386 FreeBSD 3.3
- i386 Windows NT/95
To install Alliance follow the steps written in README
> more README
Question 4: How to get started ? Question 4: How to get started ?
-------------------------------- --------------------------------
You will find 5 separate tutorials in share/tutorials/ directory : You can download a beta version of the Alliance 5.0 tutorials from cvs.
(Please read overview.ps before) ftp://asim.lip6.fr/pub/alliance/latest-checkout/alliance/src/tutorials.tgz
WARNING : These tutorials are not fully working and must be modified to
work with Alliance 4.0 (especially the dlx), but we have
decided to release them even though they are not fully
functional. They will be upgraded as soon as we have time.
1/ ADDACCU
The design of a very simple chip (adder/accumulator) to get started
with the ALLIANCE tools.
>cd tutorials/addaccu
2/ AMD2901
The design of the 4 bits AMD2901 processor, from the VHDL specification to
the CIF layout, using the ALLIANCE portable standard cells library.
>cd tutorials/amd2901
4/ Synthesis
Building simple door code using the Finite State Machine synthesizer (syf).
>cd tutorials/synth
4/ Data Path
Building simple data paths using on a procedural data path generator
(fpgen) and a data path place and route tool (dpr).
>cd tutorials/fitpath
5/ DlxM
A complete tutorial based on the design of the 32 bit microprocessor DLX.
Question 5: What are the differences with the previous releases ? Question 5: What are the differences with the previous releases ?
---------------------------------------------------------------- ----------------------------------------------------------------
The new features of this release are described in the CHANGES file: The new features of this release are described in the CHANGES file:
> more CHANGES See CHANGES
Question 6: What is the supported VHDL subset ? Question 6: What is the supported VHDL subset ?
----------------------------------------------- -----------------------------------------------
@ -147,7 +84,7 @@ This gives you the VHDL subset supported for structural descriptions.
> man vbe > man vbe
This gives you the data-flow behavioral subset supported by the simulator This gives you the data-flow behavioral subset supported by the simulator
ASIMUT, the logic synthesis tools BOP and SCMAP and the formal proffer PROOF. ASIMUT, the logic synthesis tools BOOM and BOOG and the formal proffer PROOF.
> man fsm > man fsm
@ -162,77 +99,6 @@ All the tools rely on the use of environment variables: all the relevant
variables are listed in the `ENVIRONMENT VARIABLES' section of the manual variables are listed in the `ENVIRONMENT VARIABLES' section of the manual
page. page.
1) tools
--------
> man asimut # VHDL simulator
> man bbr # channel router
> man dpr # data-path place & route
> man dreal # real layout viewer
> man druc # design rule checker
> man fpgen # procedural data-path generation language
> man fpmap # logic synthesis tool for FPGA
> man genlib # procedural net-list generation language
> man genpat # procedural pattern generation language
> man genview # interactive block generator debugger
> man graal # graphic layout editor
> man l2p # layout to PostScript translation tool
> man bop # Boolean optimizer
> man lvx # net-list comparator
> man lynx # layout extractor
> man glop # net-list optimizer
> man proof # VHDL description's formal proffer
> man ring # router between core & pads
> man s2r # symbolic layout to real mask expander
> man scmap # standard cell mapping
> man scr # standard cells place & route
> man syf # finite state machine synthesis tool
> man tas # static timing analyzer
> man yagle # functional abstractor
2) cell libraries
-----------------
> man sxlib # new standard cells library (multi layer/overcell routing)
> man sclib # old standard cells library
> man dplib # data path cells library
> man fplib # data path cells library
> man padlib # pad library
> man rsa # fast adder generator
> man bsg # barrel shifter generator
> man amg # multiplier generator
> man rfg # register file generator
> man grog # high speed ROM generator
> man rage # static RAM generator
3) ALLIANCE file formats
------------------------
> man vhdl # VHDL overview
> man vst # VHDL subset for net-list
> man vbe # VHDL subset for data-flow
> man fsm # VHDL subset for finite-state-machine
> man al # internal ALLIANCE netlist
> man ap # internal ALLIANCE symbolic layout
> man pat # internal ALLIANCE pattern description
4) miscellaneous
----------------
> man catal # use of the catalog file
> man prol # technology file
> man mbkenv # main environment variables
Question 8: How can I get more complete documentation ?
-----------------------------------------------------------
All the available documentation for Alliance can be found
at Alliance's web site :
http://www-asim.lip6.fr/alliance/doc/
You can download a copy of this site at
ftp://ftp-asim.lip6.fr/pub/alliance/distribution/doc/
Question 9: Where are defined the symbolic layout rules ? Question 9: Where are defined the symbolic layout rules ?
---------------------------------------------------------- ----------------------------------------------------------
@ -249,12 +115,6 @@ The actual conversion is performed by the s2r tool:
> man s2r > man s2r
If you want to parameterize the S2R tool to a new target technology,
you must write a technology file. The method is described in the
postscript file doc/process_mapping.ps (also available in pdf)
> lpr doc/process_mapping.ps
Question 11: What are the supported file formats ? Question 11: What are the supported file formats ?
-------------------------------------------------- --------------------------------------------------
@ -305,7 +165,7 @@ Question 13: How can I get in touch with the ALLIANCE team ?
Web: Web:
---- ----
at http://www-asim.lip6.fr/alliance/support/ at http://www-asim.lip6.fr/alliance/
E-mail: E-mail:
------- -------
@ -314,7 +174,6 @@ mailto:alliance-users@asim.lip6.fr
Postal Mail: Postal Mail:
----------- -----------
Alliance Support Alliance Support
Couloir 55-65, 2ème étage
ASIM / LIP6 ASIM / LIP6
Université Pierre et Marie Curie Université Pierre et Marie Curie
4, Place Jussieu 75252 Paris Cedex 05, 4, Place Jussieu 75252 Paris Cedex 05,
@ -336,11 +195,10 @@ or by HTTP
http://www-asim.lip6.fr/pub/alliance/ http://www-asim.lip6.fr/pub/alliance/
If you can not access to Internet you can also send us a blank CD-ROM If you can not access to Internet you can also send us a blank CD-ROM.
or ZIP100. We will copy it for you. We will copy it for you.
Alliance Support Alliance Support
Couloir 55-65, 2ème étage
ASIM / LIP6 ASIM / LIP6
Université Pierre et Marie Curie Université Pierre et Marie Curie
4, Place Jussieu 75252 Paris Cedex 05, 4, Place Jussieu 75252 Paris Cedex 05,

View File

@ -5,10 +5,10 @@
# E-mail : mailto:alliance-users@asim.lip6.fr # E-mail : mailto:alliance-users@asim.lip6.fr
# ftp site : ftp://asim.lip6.fr/pub/alliance/ # ftp site : ftp://asim.lip6.fr/pub/alliance/
# #
# NOTE: You can find the latest revision of this file at: # NOTE: You can find the latest revision of this document at:
# http://asim.lip6.fr/pub/alliance/unstable/cvstree/alliance/ # http://asim.lip6.fr/pub/alliance/latest-checkout/alliance/src
# #
# $Id: LICENCE,v 1.2 2002/09/30 16:19:35 czo Exp $ # $Id: LICENCE,v 1.3 2002/10/17 10:04:09 czo Exp $
"Alliance VLSI CAD System" is free Software. "Alliance VLSI CAD System" is free Software.
@ -28,10 +28,8 @@ libraries, documentation and source code are covered by GPL, except some
Alliance's base libraries which are LGPL. Alliance's base libraries which are LGPL.
You are welcome to use the software package even for commercial designs You are welcome to use the software package even for commercial designs
without any fee. You are just required to mention : without any fee. You are kindly requested to mention : "Designed with
Alliance © LIP6, Université Pierre et Marie Curie"
"Designed with Alliance CAD system, Copyright (C) 1991, 2000 Université
Pierre et Marie Curie"
Contents copyrighted by Contents copyrighted by

View File

@ -5,156 +5,90 @@
# E-mail : mailto:alliance-users@asim.lip6.fr # E-mail : mailto:alliance-users@asim.lip6.fr
# ftp site : ftp://asim.lip6.fr/pub/alliance/ # ftp site : ftp://asim.lip6.fr/pub/alliance/
# #
# NOTE: You can find the latest revision of this file at: # NOTE: You can find the latest revision of this document at:
# http://asim.lip6.fr/pub/alliance/unstable/cvstree/alliance/ # http://asim.lip6.fr/pub/alliance/latest-checkout/alliance/src
# #
# $Id: README,v 1.2 2002/09/30 16:19:35 czo Exp $ # $Id: README,v 1.3 2002/10/17 10:04:09 czo Exp $
##########################################################
# WARNING: This file needs to rewritten for Alliance 5.0
##########################################################
This file discuss about installation of Alliance on UNIX machines. This file discuss about installation of Alliance on UNIX machines.
If you are interrested in intalling Alliance under Windows please
read README.win32 and if you are interrested in rebuilding Alliance
from sources please read sources/README.sources
# Alliance
# Downloading and installing binary distribution :
# =================================================================== # ===================================================================
Alliance VLSI CAD System If you don't find the exact precompiled package for your system, or if you
Copyright (C) Laboratoire LIP6 - Département ASIM have trouble with a package, please consider downloading the sources
Universite Pierre et Marie Curie and build them.
4, place Jussieu
75252 Paris Cedex 05
France
"Alliance VLSI CAD System" is free Software.
Alliance is available under the terms of the GNU General Public License
GPL (http://www.gnu.org/copyleft/gpl.html).
You are welcome to use the software package even for commercial designs
without any fee. You are just required to mention :
"Designed with Alliance CAD system, Copyright (C) 1991, 2000 Université
Pierre et Marie Curie"
You can get Alliance via anonymous FTP from ftp.lip6.fr
ftp://ftp-asim.lip6.fr/pub/alliance/
# Downloading binary distribution :
# ===================================================================
If you don't find the exact precompiled package for your system, please
consider downloading the sources and recompile them. Please read
sources/README
Note that for running some precompiled Alliance binaries you will need gcc and Note that for running some precompiled Alliance binaries you will need gcc and
other gnu tools (gmake, gawk ...), X11R6.4 libraries (http://www.x.org/), Motif other gnu tools (gmake, gcc ...), X11R6.4 libraries (http://www.x.org/), Motif
1.2 libraries (You can find a free Motif clone at http://www.lesstif.org/) Rpms 1.2 libraries. You can find a semi free Motif distribution at
for linux RedHat 6 of lesstif-0.88 are available at http://www.motifzone.net/ and a free clone at http://www.lesstif.org/
ftp://ftp-asim.lip6.fr/pub/alliance/redist/
Gziped tar format ( for Linux, SunOS, Solaris and FreeBSD ) : Alliance naming scheme:
--------------------------------------------------------- =======================
You will have to download at least two files : one for the common files of - sources: alliance-XXX-YYY.tar.gz
Alliance (like cells library) and another containing binaries for your specific where:
platform. XXX = Alliance version number. eg 5.0
YYY = Alliance release number, wich is the date of the build. eg 20020624
In the fowlowing filenames X.XX is the Alliance version number - binaries: alliance-XXX-YYY-ZZZ.KKK
(e.g.: 3.2 for Alliance 3.2) and Y.YY is the OS version number where:
(e.g.: 4.1.4 for SunOS 4.1.4) XXX, YYY = same as above.
ZZZ = indicate the platform target
KKK = archive type (gzipped tar or rpm)
- alliance-X.XX-common.tar.gz : Files common to each platform *required*
- alliance-X.XX-i386-linux-Y.YY.tar.gz : binary package for Linux To install a tar.gz package (*nix)
( pre-compiled on a Linux RedHat 6.0 with Lesstif 0.88 ) ----------------------------------
- alliance-X.XX-i386-freebsd-Y.YY.tar.gz : binary package for FreeBSD Get the latest binary package for your platform,
( pre-compiled on a FreeBSD 3.4 with Lesstif 0.88 ) log as root then type :
- alliance-X.XX-sparc-sunos-Y.YY.tar.gz : binary package for SunOS > cd /usr/local
( pre-compiled on a SunOS 4.1.4 with Motif 1.2 and X11R6.4 ) > tar -xzf /mnt/cdrom/alliance-5.0-XXX-YYY.tar.gz
> ln -s /usr/local/alliance/share/etc/alc_env.csh /etc/profile.d/
> ln -s /usr/local/alliance/share/etc/alc_env.sh /etc/profile.d/
- alliance-X.XX-sparc-solaris-Y.YY.tar.gz : binary package for Solaris
( pre-compiled on a Solaris 2.7 with dt/Motif 1.2 and X11R6.4 )
Rpm format ( for Linux RedHat 6.0 / 6.1 ) : To install a .rpm package (Linux redHat 7+)
------------------------------------------- -------------------------------------------
Pre-compiled on a Linux RedHat 6.0 with Lesstif 0.88, it works on This rpm has been build on a modified RedHat 7.1 and requires: ld-linux.so.2 libICE.so.6 libSM.so.6 libX11.so.6 libXext.so.6 libXm.so.2 libXp.so.6 libXpm.so.4 libXt.so.6 libc.so.6 libm.so.6 libstdc++-libc6.2-2.so.3 /bin/sh libc.so.6(GLIBC_2.0) libc.so.6(GLIBC_2.1) libc.so.6(GLIBC_2.1.3) libm.so.6(GLIBC_2.0). (You can generate the rpm for your platform by issuing : rpm -ta alliance-5.0-XXX.tar.gz)
Linux RedHat 6.0 and 6.1 (the common package is included)
- alliance-X.XX-i386-asimYY.rpm Get the latest rpm package,
log as root then type :
> rpm -Uvh alliance-5.0-YYY.rpm
# Installation of binary distribution # Building from the sources :
# =================================================================== # ===================================================================
Gziped tar format : Alliance's sources are now conforming to GNU's automake/autoconf.
-------------------
You *don't* need to be root to install Alliance in a directory you *own* 1/ Get the latest alliance-5.0-YYY.tar.gz archive.
In the example above I assume you have logged as root 2/ Unarchive it
1/ cd to the directory where you want to install Alliance > tar xzf alliance-5.0-XXX.tar.gz
> cd /usr/local 3/ The install stage has to be done at the same time
as the make itself : the way the configure and Makefiles
are written implies that you do a "make install" in one
step rather than a "make" followed by a "make install"
2/ Unpack the common package To avoid make problems, please use gnu make (gmake)
The fowllowing commands builds the full package from scratch.
> gunzip -c alliance-X.XX-common.tgz | tar -xf - > export ALLIANCE_TOP=/usr/local/alliance
> ./configure --prefix=$ALLIANCE_TOP
> gmake install
3/ Unpack one of the platform specific package All this is done by a script called ./build in the alliance directory.
> gunzip -c alliance-X.XX-linux-Y.YY.tgz | tar -xf -
4/ cd to alliance/share/etc and run the 'configure' script
(This is the *only* script you need to run)
> cd alliance/share/etc
> ./configure
If your OS is recognized as "Unknown", you will need to edit
configure.in alc_env.sh.in and alc_env.csh.in and run autoconf
for that those script use a good $ALLIANCE_OS name. If
libraries (X11, Motif/LessTiff, readline ...) or tools (sed,
gawk, ...) are missing, you will have to install them.
If you install Alliance on different platforms you'll
need to run the 'configure' script on each of them.
configure options:
* Architecture dependant
--enable-system64 for a 64-bit compilation (only to be used
on a 64-bit system)
* Libraries
Default is static libraries. But you can also generate dynamic libraries:
--enable-shared --disable-static for shared libraries only
--enable-shared for shared and static libraries
For more options, type ./configure --help
Linux Rpm :
-----------
Note that the Linux RedHat 6 rpm installs Alliance in "/usr/local/alliance"
> rpm -Uvh alliance-X.XX-i386-asimYY.rpm
# Usage : # Usage :
@ -174,19 +108,6 @@ If you are a SysAdmin, you should consider linking these scripts in
the system's profile (e.g.: /etc/profile.d/ on Linux) so that configuration the system's profile (e.g.: /etc/profile.d/ on Linux) so that configuration
would be done at user login. would be done at user login.
If you encounter problems, check the value of these variables in alc_env.[c]sh
$ALLIANCE_OS : actually Linux
or SunOS
or Solaris
$ALLIANCE_TOP : actually [where you have installed Alliance]/alliance/archi/Linux
or [where you have installed Alliance]/alliance/archi/SunOS
or [where you have installed Alliance]/alliance/archi/Solaris
That's all :-)
To start, you can read the files README, README.win32 and FAQ
# EOF # EOF

View File

@ -1,37 +1,19 @@
# Alliance VLSI CAD System # # Alliance VLSI CAD System
# Copyright (C) 1990, 2002 ASIM/LIP6/UPMC # # Copyright (C) 1990, 2002 ASIM/LIP6/UPMC
# # #
# Home page : http://asim.lip6.fr/alliance/ # # Home page : http://asim.lip6.fr/alliance/
# E-mail : mailto:alliance-users@asim.lip6.fr # # E-mail : mailto:alliance-users@asim.lip6.fr
# ftp site : ftp://asim.lip6.fr/pub/alliance/ # # ftp site : ftp://asim.lip6.fr/pub/alliance/
# # #
# $Id: README.IRIX,v 1.3 2002/09/30 16:19:35 czo Exp $ # # NOTE: You can find the latest revision of this document at:
# http://asim.lip6.fr/pub/alliance/latest-checkout/alliance/src
#
# $Id: README.IRIX,v 1.4 2002/10/17 10:04:09 czo Exp $
This file discuss about installation of Alliance on IRIX machines. This file discuss about installation of Alliance on IRIX machines.
=================================================================== ===================================================================
Alliance VLSI CAD System
Copyright (C) Laboratoire LIP6 - Département ASIM
Universite Pierre et Marie Curie
4, place Jussieu
75252 Paris Cedex 05
France
"Alliance VLSI CAD System" is free Software.
Alliance is available under the terms of the GNU General Public License
GPL (http://www.gnu.org/copyleft/gpl.html).
You are welcome to use the software package even for commercial designs
without any fee. You are just required to mention :
"Designed with Alliance CAD system, Copyright (C) 1991, 2002 Université
Pierre et Marie Curie"
IRIX notes IRIX notes
========== ==========

View File

@ -5,205 +5,29 @@
# E-mail : mailto:alliance-users@asim.lip6.fr # E-mail : mailto:alliance-users@asim.lip6.fr
# ftp site : ftp://asim.lip6.fr/pub/alliance/ # ftp site : ftp://asim.lip6.fr/pub/alliance/
# #
# NOTE: You can find the latest revision of this file at: # NOTE: You can find the latest revision of this document at:
# http://asim.lip6.fr/pub/alliance/unstable/cvstree/alliance/ # http://asim.lip6.fr/pub/alliance/latest-checkout/alliance/src
# #
# $Id: README.win32,v 1.2 2002/09/30 16:19:35 czo Exp $ # $Id: README.win32,v 1.3 2002/10/17 10:04:09 czo Exp $
##########################################################
# WARNING: This file needs to rewritten for Alliance 5.0
##########################################################
This file discuss about installation of Alliance on WINDOWS machines. This file discuss about installation of Alliance on WINDOWS machines.
If you are interrested in intalling Alliance under Unix please
read README.
# Alliance
# ===================================================================
Alliance VLSI CAD System
Copyright (C) Laboratoire LIP6 - Département ASIM
Universite Pierre et Marie Curie
4, place Jussieu
75252 Paris Cedex 05
France
"Alliance VLSI CAD System" is free Software. ===================================================================
Alliance is available under the terms of the GNU General Public License
GPL (http://www.gnu.org/copyleft/gpl.html).
You are welcome to use the software package even for commercial designs
without any fee. You are just required to mention :
"Designed with Alliance CAD system, Copyright (C) 1991, 2000 Université
Pierre et Marie Curie"
You can get Alliance via anonymous FTP from ftp.lip6.fr
ftp://ftp-asim.lip6.fr/pub/alliance/
# Step 1 : Prerequisite
# ===================================================================
Alliance is designed to run on a Unix workstation, not in a Alliance is designed to run on a Unix workstation, not in a
Windows environment, but you can install third party software Windows environment, but you can install Cygwin to let your
to let your Windows Workstation be more like a Unix one. Windows Workstation be more posix one.
You'll find theese at Alliance works under Windows NT 4, 5, 5.1 (NT4/2000/XP). If you
ftp://ftp-asim.lip6.fr/pub/alliance/redist/windows/ use Windows 95 98 or Me, please consider upgrading to Linux.
If you have Windows 95 please consider upgrading to W95-OSR2 Before unpacking the alliance package, you have to install cygwin
(Second edition) or later. on your computer (http://www.cygwin.com)
If you have Windows 98 please consider upgrading to W98-SE
(Second edition) or later.
If you have Windows NT 4.0 please consider upgrading to
Service Pack 5 ( NT4 SP5 ) or later.
In the same manner if you have Windows, please consider
upgrading to Linux :-)
Run cygwin's setup (http://www.cygwin.com/setup.exe) and be sure
to install all develloppment packages (C, X11, lesstif) in doubt
install every thing... its worth the disk space...
# Step 2 : Install Third Party Software Then follow the same instructions as for a Unix workstation.
# ===================================================================
cygwin-b20-full.exe :
====================
The Cygwin tools are ports of the popular GNU development tools and
utilities for Windows 95, 98, and NT.
It adds a decent shell (bash), a C compiler used in "genlib" (gcc),
and many other tools (make, awk, ls, find...)
Install cygwin-b20 in "C:\App\Cygwin" then add
"C:\App\Cygwin\cygwin-b20\H-i586-cygwin32\bin" to your path.
Origin : http://sourceware.cygnus.com/cygwin/
x11r6.4-cygwin-b20.exe :
=======================
Pre-compiled X11R6.4 Libraries/Clients for CYGWIN B20 build and patch
by Arlindo da Silva (dasilva@alum.mit.edu) and Sergey Okhapkin
(sos@prospect.com.ru), packaged by Czo (Olivier.Sirol@lip6.fr).
Needed by "graal" and other X11 apps
Install x11r6.4 in "C:\usr" then add "C:\usr\X11R6.4\bin" to your path.
Origin : http://dao.gsfc.nasa.gov/software/grads/win32/X11R6.4/
x-win411.exe : Non Free
=======================
X-Win32 is X terminal application for Windows 95, 98, NT4.0
This is the X server we use ht ASIM labs.
It is IMHO (Czo) the best X server under windows and licenses
are not very expensive.
Needed by "graal" and other X11 apps. Remember you'll have to set your
DISPLAY to something :
cmd.exe > set DISPLAY=:0
bash.exe > export DISPLAY=:0
tcsh.exe > setenv DISPLAY :0
Install anywhere and start x-win32 before graal. You must authorize
connection to your display.
See : http://www.starnet.com/
# Step 3 : Install Alliance
# ===================================================================
alliance-X.XX-cygwin-b20.exe :
============================
Available for Windows 95/98/NT4 (the common package is included)
To install alliance, just run alliance-X.XX-cygwin-YY.exe
> start alliance-X.XX-cygwin-YY.exe
It is strongly recommanded to install alliance in :
c:\usr\local\alliance
The install program will choose default path for you.
It is recommanded to use the "bash" shell instead of the default
Windows shell ("command.com" on Windows 95/98 and "cmd.exe" on NT)
(bash comes with cygwin-b20-full.exe)
In a Cygwin environment, paths are written like in unix
use '/' instead of '\'. ie : use bash as you would do on unix
# Step 4 : Post-install
# ===================================================================
1- Defaults Location :
=====================
Run Cygwin b20 : Start> Programs > Cygnus Solution > Cygwin B20
There are two thing you should do from this prompt.
- First, /tmp should exist to ensure that a directory for
temporary files exists for programs that expect to find one there.
> mkdir -p /tmp
- Second, you will need to be able to find `/bin/sh'.
> mkdir -p /bin
> cp /App/Cygwin/cygwin-b20/H-i586-cygwin32/bin/sh.exe /bin
2- Path :
=========
Modifying Path under Win NT :
-----------------------------
Right click "My Computer" > Property > Environment
Choose Path in "system variables"
Add
C:\App\Cygwin\cygwin-b20\H-i586-cygwin32\bin;C:\usr\X11R6.4\bin
to its value
Click "Fix Value"
Click "Apply"
Click "Ok"
Modifying Path under Win 95/98 :
--------------------------------
You can use "notepad" to edit files.
If you are running Windows 95 or 98 and are faced with the error message "Out
of environment space", you need to increase the amount of environment space in
your config.sys and try again.
- Edit c:\config.sys
Add or modifify the line containing SHELL like this:
shell=C:\command.com /e:8192 /p
- Edit Autoexec.bat
Add or modifify the line containing PATH like this :
PATH=C:\WINDOWS;C:\WINDOWS\COMMAND;C:\App\Cygwin\cygwin-b20\H-i586-cygwin32\bin;C:\usr\X11R6.4\bin
Reboot your computer....
This is done... ouf :-)
# Step 4 : Run Alliance
# ===================================================================
You can now run an alliance console by clicking Start>Programs>Alliance>Alliance Console
To start, you can read the files README, README.win32 and FAQ
# Known BUG
# ===================================================================
On Windows 95/98 the %COMSPEC% variable (used to locate "command.com" in
the "Alliance console" program link is sometimes not set. If clicking on
"Alliance console" produce nothing, please modify by hand the "Alliance console"
command line (property>program>command line) to
'C:\WINDOWS\COMMAND.COM /K c:\usr\local\alliance\share\etc\alc_env.bat'