[deliverable/binutils-gdb.git] / INSTALL



			GNU Development Tools
		       A Cygnus Support Release


This is the procedure for installing the a29k cross compiler on a
sun4.


0. Load the tape.

	If you haven't already done so, load the tape with:

		tar xvf /dev/rst8

	It doesn't really matter where, so long as the hard disk space
	is available.  The source for the tools will be loaded into
	./devo.

	The installed portion of the tools will take about 4 Mbytes of
	disk space.  Simply loading the source from tape will require
	about 32 Mbytes.  Loading the source from tape, building, and
	installing the tools will need about 46 Mbytes.

	Once loaded:

		cd devo

1. Create destdir.

	The default location for all installed files and programs is
	/usr/local.  We refer to this directory as $(destdir).  You
	can change $(destdir) only at configuration time.  This is
	because some tools have hard coded pathnames.

	If you change destdir after the tools are built, you will need
	to "make clean" and then rebuild.  If you don't understand
	this, you should probably be using the defaults for now.

	User visible programs are installed in $(destdir)/bin.  All
	other files and programs are installed in $(destdir)/lib/gcc.

	If $(destdir) does not already exist, create it now.

2. Configure the source.

	If you use the default $(destdir):

		configure +host=sun4 a29k

	Otherwise:

		configure +host=sun4 a29k +destdir=yourdestdir

	where "yourdestdir" should be the name of the $(destdir) that
	you've chosen.

3. Build and install the tools.

	Use:
		make install

	This will take about 20 minutes on an otherwise unloaded
	SparcStation 2 with a quick, sync, SCSI hard disk.

That's it.  You're done.  If you don't plan to hack these sources in
the near future, you'll probably want to also:

4. Remove intermediate object files.

		make clean

	and perhaps even:

		cd .. ; rm -rf devo


To use these tools, you will probably want to add $(destdir)/bin to
your path.  The tools are named with the standard UNIX(tm) names with
"-a29k" appended so as to avoid conflict with native development
tools.  That is, nm-a29k, etc.

For more information on usage, please refer to {LOTS OF VERY PRETTY
HARD COPY} (sic) that you should have received with your tape.
Commit	Line	Data
	1
	2
	3	GNU Development Tools
	4	A Cygnus Support Release
	5
	6
	7	This is the procedure for installing the a29k cross compiler on a
	8	sun4.
	9
	10
	11	0. Load the tape.
	12
	13	If you haven't already done so, load the tape with:
	14
	15	tar xvf /dev/rst8
	16
	17	It doesn't really matter where, so long as the hard disk space
	18	is available. The source for the tools will be loaded into
	19	./devo.
	20
	21	The installed portion of the tools will take about 4 Mbytes of
	22	disk space. Simply loading the source from tape will require
	23	about 32 Mbytes. Loading the source from tape, building, and
	24	installing the tools will need about 46 Mbytes.
	25
	26	Once loaded:
	27
	28	cd devo
	29
	30	1. Create destdir.
	31
	32	The default location for all installed files and programs is
	33	/usr/local. We refer to this directory as $(destdir). You
	34	can change $(destdir) only at configuration time. This is
	35	because some tools have hard coded pathnames.
	36
	37	If you change destdir after the tools are built, you will need
	38	to "make clean" and then rebuild. If you don't understand
	39	this, you should probably be using the defaults for now.
	40
	41	User visible programs are installed in $(destdir)/bin. All
	42	other files and programs are installed in $(destdir)/lib/gcc.
	43
	44	If $(destdir) does not already exist, create it now.
	45
	46	2. Configure the source.
	47
	48	If you use the default $(destdir):
	49
	50	configure +host=sun4 a29k
	51
	52	Otherwise:
	53
	54	configure +host=sun4 a29k +destdir=yourdestdir
	55
	56	where "yourdestdir" should be the name of the $(destdir) that
	57	you've chosen.
	58
	59	3. Build and install the tools.
	60
	61	Use:
	62	make install
	63
	64	This will take about 20 minutes on an otherwise unloaded
	65	SparcStation 2 with a quick, sync, SCSI hard disk.
	66
	67	That's it. You're done. If you don't plan to hack these sources in
	68	the near future, you'll probably want to also:
	69
	70	4. Remove intermediate object files.
	71
	72	make clean
	73
	74	and perhaps even:
	75
	76	cd .. ; rm -rf devo
	77
	78
	79	To use these tools, you will probably want to add $(destdir)/bin to
	80	your path. The tools are named with the standard UNIX(tm) names with
	81	"-a29k" appended so as to avoid conflict with native development
	82	tools. That is, nm-a29k, etc.
	83
	84	For more information on usage, please refer to {LOTS OF VERY PRETTY
	85	HARD COPY} (sic) that you should have received with your tape.