# Alliance VLSI CAD System
# Copyright (C) 1990, 2000 ASIM/LIP6/UPMC
#
# Home page : http://www-asim.lip6.fr/alliance/
# E-mail support : mailto:alliance-support@asim.lip6.fr
# ftp site : ftp://ftp-asim.lip6.fr/pub/alliance/
#
# $Id: README,v 1.9 2000/03/24 15:22:53 czo Exp $
# 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/
# 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
other gnu tools (gmake, gawk ...), X11R6.4 libraries (http://www.x.org/), Motif
1.2 libraries (You can find a free Motif clone at http://www.lesstif.org/) Rpms
for linux RedHat 6 of lesstif-0.88 are available at
ftp://ftp-asim.lip6.fr/pub/alliance/redist/
Gziped tar format ( for Linux, SunOS, Solaris and FreeBSD ) :
---------------------------------------------------------
You will have to download at least two files : one for the common files of
Alliance (like cells library) and another containing binaries for your specific
platform.
In the fowlowing filenames X.XX is the Alliance version number
(e.g.: 3.2 for Alliance 3.2) and Y.YY is the OS version number
(e.g.: 4.1.4 for SunOS 4.1.4)
- 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
( 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
( pre-compiled on a FreeBSD 3.4 with Lesstif 0.88 )
- alliance-X.XX-sparc-sunos-Y.YY.tar.gz : binary package for SunOS
( pre-compiled on a SunOS 4.1.4 with Motif 1.2 and X11R6.4 )
- 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 ) :
-------------------------------------------
Pre-compiled on a Linux RedHat 6.0 with Lesstif 0.88, it works on
Linux RedHat 6.0 and 6.1 (the common package is included)
- alliance-X.XX-i386-asimYY.rpm
Windows setup format ( for Windows 95/98/NT4 ) :
------------------------------------------------
Available for Windows 95/98/NT4 (the common package is included)
- alliance-X.XX-cygwin-b20.exe
# Installation of binary distribution
# ===================================================================
Gziped tar format :
-------------------
You *don't* need to be root to install Alliance in a directory you *own*
In the example above I assume you have logged as root
1/ cd to the directory where you want to install Alliance
> cd /usr/local
2/ Unpack the common package
> gunzip -c alliance-X.XX-common.tgz | tar -xf -
3/ Unpack one of the platform specific package
> 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.
Linux Rpm :
-----------
Note that the Linux RedHat 6 rpm installs Alliance in "/usr/local/alliance"
> rpm -Uvh alliance-X.XX-i386-asimYY.rpm
Windows setup format :
---------------------
Alliance is designed to run on a Unix workstation, not in a
Windows environment, but you can install third party software
to let your Windows Workstation be more like a Unix one.
You'll find theese at
ftp://ftp-asim.lip6.fr/pub/alliance/redist/windows/
Please read
ftp://ftp-asim.lip6.fr/pub/alliance/redist/windows/README
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
# Usage :
# ===================================================================
Each user has to source alc_env.[c]sh to set Alliance environment
variables to be able to run the Alliance tools.
in sh > . [where you have installed Alliance]/alliance/share/etc/alc_env.sh
in csh > source [where you have installed Alliance]/alliance/share/etc/alc_env.csh
This sets various default environment variables which could be changed by user
later (Like MBK_OUT_LO to set the netlist output file format).
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
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 :-)
# EOF
67e297faf2