File: INSTALL

package info (click to toggle)
gputils 0.10.0-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 4,072 kB
  • ctags: 2,868
  • sloc: pascal: 14,250; ansic: 13,049; sh: 2,744; lex: 833; yacc: 683; makefile: 423
file content (115 lines) | stat: -rw-r--r-- 3,158 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
GPUTILS Installation
====================

1.  Requirements
================

To build gputils, you'll need both "flex" and "bison".  These are tools
that gputils uses to handle user input. If you're running Linux, you'll
almost certainly have these already. If not, you can get them from any
site that carries a GNU distribution.

2.  System Install
==================

Quick steps:

./configure
make
su
make install

Untar the gputils source into a directory and type:

	./configure
	make

Everything should just build and produce the executables.

Install it by becoming root and type "make install".  This copies
the executables into /usr/local/bin and the shared data into 
/usr/local/share/gputils.

You should now be ready to assemble some PIC code by typing "gpasm".

3.  User Install
================

If you don't have root privleges on the system:

  ./configure --prefix=/home/<username>/local
  make
  make install

This will copy the executables into /home/<username>/local/bin and the shared 
data into /home/<username>/local/share/gputils.  

It is also a good idea to place /home/<username>/local/bin in your path.

4.  Configure Options
=====================

The configuration script has many options available.  The options are listed
by commanding "./configure --help".  At the end of the list are gputils 
specific options.  The options are explained in detail below. 

--enable-debug

  Enabling this option configures gputils to use some of its debug features.  
  These features typically write internal gputils data to standard output.

--disable-gplink

  Adding this option prevents gplink from being compiled or installed.  

--disable-gputils

  Adding this option prevents the utilities, such as gpvo, from being compiled 
  or installed.  

--disable-path

  The option prevents the addition of the header path to the gpasm include 
  paths.


5.  CFLAGS Options
==================

Extra cc flags may be passed to the configure script by setting the 
XTRA_CFLAGS environmental variable:

XTRA_CFLAGS="add cc flags here" ./configure

For example, to produce debug information in COFF format do the following:

XTRA_CFLAGS=-gcoff ./configure

6.  Win32 Support
=================

Although gputils was primarily intended for GNU systems, it can be compiled
on a win32 system (Win98, WinNT, ...).  This has been performed using the 
Borland C Compiler and Microsoft Visual C.

The gputils supported win32 compiler is MinGW32.  It is available at:

http://www.mingw.org/

MinGW32 was selected because it is based on the GNU C compiler.  Additionally, 
it can easily be used as a cross compiler on GNU systems.

A native win32 version of MinGW32 is available.  However, the process for 
compiling on a win32 system has not been developed.  This will be provided 
some time in the future.

Until then, offical gputils ports to win32 will be generated using a cross 
compiler on a Linux system.  The following scripts will configure gputils to 
cross compile to win32 using a Linux system:

mkdir cross && \
cd cross && \
CC=i386-mingw32msvc-gcc ../configure \
  --srcdir=.. \
  --build=i586-pc-linux-gnu \
  --host=i386-mingw32msvc