summaryrefslogtreecommitdiffstats
path: root/dev/ports/core-linux-eglibc/bootstrap.mdwn
blob: e556d349be0de1a929bc536f03e4d9321807fd44 (plain)
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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
[[!meta title="core-linux-eglibc Port Bootstrap"]]

This port was renamed to `amd64-linux-glibc` and, along with `i686-linux-glibc`,
bootstrapped and uploaded on 2014-03-19.

**The rest of this page is kept only for reference and historical purposes.**

---

`core-linux-eglibc` is the first architecture port of ProteanOS 1.0.
([[ProteanOS_0.x|/dev/releases/0]] had a `cortexa8-linux-eglibc` architecture,
but `core-linux-eglibc` is being built from scratch.)

This port is being bootstrapped from a Debian GNU/Linux system.

Operating systems are often bootstrapped with GCC by building a cross compiling
GCC with a sysroot then using that to build the system.  This port is instead
being bootstrapped natively in two stages.  This is possible because care is
taken to ensure that the resulting ELF binaries are compatible with the
ProteanOS ABI (including the value of the ELF INTERP field and the file system
hierarchy).

The first stage involves building base system and toolchain packages and
unpacking them into a bootstrap system directory.

The second stage involves changing the file system root (with **chroot**(8)) to
the bootstrap directory and building source packages.

The bootstrap is automated using the [initial port bootstrap scripts][scripts].
See the included `README` file for instructions to perform an automatic
bootstrap of this first ProteanOS port.

**The rest of this page is kept only for reference and historical purposes.  The
instructions below are incomplete and should not be used to bootstrap
ProteanOS.**

[scripts]: http://git.proteanos.com/porting/initial-bootstrap.git/


Stage 1
=======

These instructions are tested on a Debian wheezy amd64 GNU/Linux system.

The following directory structure is assumed:

    <work-root>/
     +- bootstrap_core-linux-eglibc/
         +- etc/
         +- lib/
         +- [...]
     +- pkg/
         +- binutils/
         +- eglibc/
         +- gcc-4.7/
         +- [...]
         +- zlib/

Preparation
-----------

Build and install [opkbuild 3.0.0-alpha4][opkbuild-3.0.0-alpha4] and
[opkhelper 3.0.0-beta2][opkhelper-3.0.0-beta2].

The build system needs to be made to look a little more like ProteanOS.

To install `/etc/proteanos_arch` and `/etc/proteanos_plat` files on the build
system for **opkbuild**(1), run opkbuild's `mksysconf` makefile with `ARCH` and
`PLAT` macros, e.g.:

    # ./mksysconf ARCH=core-linux-eglibc PLAT=dev

The `gcc-4.7` package will look for a symbolic link to the ELF interpreter
(dynamic linker) at `/usr/lib/core-linux-eglibc/ld.so`.

    # mkdir /lib/core-linux-eglibc /usr/lib/core-linux-eglibc
    # ln -sf /lib64/ld-linux-x86-64.so.2 /lib/core-linux-eglibc/ld-linux-x86-64.so.2
    # ln -sf /lib/core-linux-eglibc/ld-linux-x86-64.so.2 /usr/lib/core-linux-eglibc/ld.so

Make a directory for the bootstrap ProteanOS system.

    $ mkdir bootstrap_core-linux-eglibc

ProteanOS's ELF interpreter is not installed in the location described in the
ELF INTERP field of binaries built with the build system's GCC.  Make a symbolic
link in the bootstrap system directory to direct Linux to the correct location
when it executes the stage 1 binaries.

    $ mkdir bootstrap_core-linux-eglibc/lib64
    $ ln -sf /lib/core-linux-eglibc/ld-linux-x86-64.so.2 bootstrap_core-linux-eglibc/lib64/ld-linux-x86-64.so.2

For most packages, this can be made unnecessary using GNU ld's
`--dynamic-linker` option, e.g. by setting `LDFLAGS` to
`-Wl,--dynamic-linker=/lib/core-linux-eglibc/ld-linux-x86-64.so.2`.  Doing this
when building GCC, however, makes executables like `gcc`, `cpp`, and `cc1`
declare superfluous ELF NEEDED dependencies on `libstdc++.so.6` and
`libgcc_s.so.1`.

[opkbuild-3.0.0-alpha4]: http://files.proteanos.com/pub/opkbuild/3.0.0-alpha4/
[opkhelper-3.0.0-beta2]: http://lists.proteanos.com/proteanos-dev/2013/05/msg00001.html

Building EGLIBC
---------------

Run the following commands in a copy of the `eglibc` source package to build
EGLIBC for the bootstrap system.

    $ opkbuild -b -c

Building zlib
-------------

Run the following commands in a copy of the `zlib` source package to build zlib
for the bootstrap system.

    $ opkbuild -b -c

Building, Installing, and Testing GNU Binutils
----------------------------------------------

Run the following commands in a copy of the `binutils` source package to build
GNU Binutils for the bootstrap system.

    $ ./config clean
    $ PKG_TARGETS='core-linux-eglibc' ./config
    $ opkbuild -b -c

Run the following commands in the bootstrap system directory to unpack the
`binutils` packages and their dependencies:

    $ tar -xzOf ../pkg/libc.6_2.17~r22751+sip1-1_core-linux-eglibc_all.opk data.tar.gz | tar -xz
    $ tar -xzOf ../pkg/libz.1_1.2.7+sip1-1_core-linux-eglibc_all.opk data.tar.gz | tar -xz
    $ tar -xzOf ../pkg/binutils-common_2.22-1_all_all.opk data.tar.gz | tar -xz
    $ tar -xzOf ../pkg/binutils-core-linux-eglibc_2.22-1_core-linux-eglibc_all.opk data.tar.gz | tar -xz

Now test some Binutils programs.

    # chroot . as --version
    GNU assembler (GNU Binutils for ProteanOS) 2.22
    Copyright 2011 Free Software Foundation, Inc.
    This program is free software; you may redistribute it under the terms of
    the GNU General Public License version 3 or later.
    This program has absolutely no warranty.
    This assembler was configured for a target of `x86_64-unknown-linux-gnu'.
    # chroot . readelf -hl /usr/bin/readelf
    [...]
    # chroot . objdump -p /usr/bin/objdump
    [...]

Building the Multiple Precision Libraries
-----------------------------------------

TODO.

Building, Installing, and Testing GCC
-------------------------------------

Run the following commands in a copy of the `gcc-4.7` source package to build
GCC for the bootstrap system.

    $ ./config clean
    $ PKG_TARGETS='core-linux-eglibc' ./config
    $ opkbuild -b -c

Run the following commands in the bootstrap system directory to unpack the
`gcc-4.7` packages and their dependencies.

    $ tar -xzOf ../pkg/libc.6-dev_2.17~r22751+sip1-1_core-linux-eglibc_all.opk data.tar.gz | tar -xz
    $ tar -xzOf ../pkg/libgcc.1_4.7.3+sip1-1_core-linux-eglibc_all.opk data.tar.gz | tar -xz
    $ tar -xzOf ../pkg/libgomp.1_4.7.3+sip1-1_core-linux-eglibc_all.opk data.tar.gz | tar -xz
    $ tar -xzOf ../pkg/libitm.1_4.7.3+sip1-1_core-linux-eglibc_all.opk data.tar.gz | tar -xz
    $ tar -xzOf ../pkg/libgmp.10_5.0.5-1_core-linux-eglibc_all.opk data.tar.gz | tar -xz
    $ tar -xzOf ../pkg/libmpc.3_1.0.1-1_core-linux-eglibc_all.opk data.tar.gz | tar -xz
    $ tar -xzOf ../pkg/libmpfr.4_3.1.1-1_core-linux-eglibc_all.opk data.tar.gz | tar -xz
    $ tar -xzOf ../pkg/cpp-4.7-core-linux-eglibc_4.7.3+sip1-1_core-linux-eglibc_all.opk data.tar.gz | tar -xz
    $ tar -xzOf ../pkg/gcc-4.7-common_4.7.3+sip1-1_all_all.opk data.tar.gz | tar -xz
    $ tar -xzOf ../pkg/gcc-4.7-core-linux-eglibc_4.7.3+sip1-1_core-linux-eglibc_all.opk data.tar.gz | tar -xz

Now try compiling, linking, and running an example program (the `fitblk.c`
example from zlib).

    $ tar -xzOf ../pkg/libz.1-dev_1.2.7+sip1-1_core-linux-eglibc_all.opk data.tar.gz | tar -xz
    $ cp ../pkg/zlib/tmp/src/examples/fitblk.c .
    # chroot . core-linux-eglibc-gcc-4.7 -lz -o /fitblk /fitblk.c
    # chroot . /fitblk
    fitblk abort: need one argument: size of output block

Building and Installing GNU Make
--------------------------------

Run the following commands in a copy of the `gmake` source package to build GNU
Make for the bootstrap system.

    $ opkbuild -b -c

Run the following commands in the bootstrap system directory to unpack the
`gmake` package:

    $ tar -xzOf ../pkg/gmake_3.82-1_core-linux-eglibc_all.opk data.tar.gz | tar -xz

TODO
----

To be built and installed are busybox, linux-libre (headers), gcc-defaults,
opkbuild, and opkhelper-3.0.


Stage 2
=======

TODO.