xref: /minix/external/lgpl3/gmp/README (revision 0a6a1f1d)
1$NetBSD: README,v 1.6 2013/12/04 11:43:52 mrg Exp $
2
3GMP in NetBSD.  We need GMP for GCC >= 4.2.
4
5
6Building GMP without configure - how to port GMP build to a new platform.
7
8The GMP build doesn't map very well to normal make.  The ./configure phase
9creates a bunch of symlinks and weeds out the sources lists, and there are
10files with the same name in different subdirectories linked into the same
11final product.  All of these issues need to be dealt with.
12
13There are a few steps to this:
14
15	- run ./configure, save the output.  you can use the makefile
16	  "Makefile.netbsd-gmp" in this directory to run this with the
17	  right options, etc.  run it with nbmake-$MACHINE.
18
19	- create src/external/gpl3/gmp/lib/libgmp/arch/${MACHINE_ARCH} dir,
20	  and copy these files into it:
21		config.h
22		config.m4
23		gmp-mparam.h
24		gmp.h
25		mp.h
26
27	  some of these files might have src/obj references.  in particular
28	  fix GMP_MPARAM_H_SUGGEST to start from ./mpn/... and make sure
29	  we #define __GMP_CC to "gcc -std=gnu99", and make sure that
30	  CONFIG_TOP_SRCDIR is not defined in config.m4
31
32	  XXX  make this automatic
33
34
35	- parse the ./configure output and note all created symlinks
36	  for mpn.  these need to be converted into a new Makefile.inc.
37	  there is a script in this subdir build-gmp-Makefile.inc.awk
38	  that can be used to do this.  it should just work to generate
39	  the first section of Makefile.inc if fed the entire configure
40	  output.
41
42	  assembler files generally want -DOPERATION_${foo} defined for
43	  each way they are compiled or pre-processed.  the pre-processor
44	  used is m4 to parse, and we and create .s files from the .asm
45	  files that we then we feed into $CC.
46
47The amd64 port is a good reference to compare.  The trialdivtab.h
48generation may need to be moved the into libgmp/Makefile itself.
49
50This mips64* ports need some minor hacks to the generated gmp*.h
51files to fix their library builds for compat issues.  See these
52files in:
53	http://mail-index.netbsd.org/source-changes/2011/07/10/msg024467.html
54
55
56This is still a work in progress and methods used to build may be
57changed at any time.
58
59
60mrg@netbsd.org
61- 2011/06/22
62