summaryrefslogtreecommitdiff
path: root/hurd/debugging/glibc.mdwn
blob: f0fe8b61445fde1734f647db65e733b3e938deba (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
[[meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]]

[[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
id="license" text="Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no Invariant
Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
is included in the section entitled
[[GNU_Free_Documentation_License|/fdl]]."]]"""]]

Here are some hints about how to approach testing after nontrivial changes to
glibc have been done.

---

First step is having the build a glibc complete.  This is actually more
difficult than one might expect, as it involves (towards the end of the build
process; unless you are cross-building, of course), that the newly created
libraries and loader actually work: they're used to run the `rpcgen`
program.  If that step doesn't succeed, it'll look similar to this:

    [...]
    CPP='gcc -E -x c-header' [...]/build/elf/ld.so.1 --library-path [...] [...]/build/sunrpc/rpcgen [...]
    Segmentation fault

---

If building glibc succeeds, the next thing to try is running the test suite, or
parts of it.

Here is a list of known failures:

[TODO].

---

Make sure static linking is working OK at all.  The `elf/sln` program (a
stripped-down `ln` that is statically linked) in the glibc build ought to test
that.  Also, static linking under various conditions will already have been
tested when running the test suite, especially in `elf/` and `dlfcn/`.

Make sure static linking with cthreads is working.  If you can get an
`ext2fs.static` compiled and linked against the new glibc, that is good.

[TODO].

Then debug its startup as a normal program on your working hurd.

    $ [...]/ext2fs.static --help
    [...]

Then try its full server startup.

    $ settrans -ca node [...]/ext2fs.static <BACKEND>
    $ cd node/
    [...]

Make sure dynamic linking for servers is working.  If you haven't broken the
ABI, you can just use an existing `/hurd/foobar` binary, started the way
glibc's `testrun.sh` does it.

[TODO]: Is this the correct way to do that?

    $ settrans -ca node [glibc]/build/testrun.sh /hurd/ext2fs <BACKEND>
    $ cd node/
    [...]

---

Test it in a [[subhurd]].

---

Test it on a real system.

---

Sources:

* <http://lists.gnu.org/archive/html/bug-hurd/2007-02/msg00038.html>
* [[Thomas_Schwinge|tschwinge]]'s mind