summaryrefslogtreecommitdiff
path: root/libpthread.mdwn
blob: fc5c097409f7803bd005f4940ff27a4a4b258b7b (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
[[!meta copyright="Copyright © 2010, 2012, 2013 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]]."]]"""]]

[[!meta title="POSIX Threading Library"]]


# Sources

<http://git.savannah.gnu.org/cgit/hurd/libpthread.git/>


# Specifics

Porting libpthread to a specific architecture is non-trivial.

Our libpthread is currently used by/ported to the [[Hurd]] on [[GNU
Mach|microkernel/mach/gnumach]], and [[microkernel/Viengoos]].


# History

There has been a libpthread port for Hurd on L4 use (working directly on L4: no
further OS personality support required), which was dead and has been removed
in commit a0bca9895bca67591127680860077b2658830e96.  This had been superseded
by a [[microkernel/Viengoos]] port, which has its own branches:
`master-viengoos` (an implementation of Viengoos that runs on L4) and its
successor, `master-viengoos-on-bare-metal` (runs directly on x86-64 (and it a
bit more advanced) and provides everything that `master-viengoos` does and
more).

There has also been an incomplete and unmaintained PowerPC port which has been
removed in commit a5387f6a45d6b3f2b381d861f5c288b79da6204f.


## Threading Model

libpthread has a 1:1 threading model.


## Threads' Death

A thread's death doesn't actually free the thread's stack (and maybe not the
associated Mach ports either).  That's because there's no way to free the stack
after the thread dies (because the thread of control is gone); the stack needs
to be freed by something else, and there's nothing convenient to do it.  There
are many ways to make it work.

However, it isn't really a leak, because the unfreed resources do get used for
the next thread.  So the issue is that the shrinkage of resource consumption
never happens, but it doesn't grow without bounds; it just stays at the maximum
even if the current number of threads is lower.

The same issue exists in [[hurd/libthreads]].

The current implementation in libpthread is
[[buggy|libpthread/t/fix_have_kernel_resources]].


# Open Issues

[[!inline pages=tag/open_issue_libpthread raw=yes feeds=no]]