This incarnation of the pthreads library is ancient and not useful, and
should have been mothballed some time ago...

Delete special rules for syscall.S; they are not needed, and one of them
is wrong anyway.

branches: 1.1.1;
Initial revision

Remove unused code that's confusing when using cscope/opengrok.

branches: 1.9.8;
Remove clause 3 and 4 from TNF licenses

branches: 1.8.4;
- Remove libpthread's atomic ops.
- Remove the old spinlock-based mutex and rwlock implementations.
- Use the atomic ops from libc.

Mutexes:

- Play scrooge again and chop more cycles off acquire/release.
- Spin while the lock holder is running on another CPU (adaptive mutexes).
- Do non-atomic release.

Threadreg:

- Add the necessary hooks to use a thread register.
- Add the code for i386, using %gs.
- Leave i386 code disabled until xen and COMPAT_NETBSD32 have the changes.

For PR bin/37347:

- Override __libc_thr_init() instead of using our own constructor.
- Add pthread__getenv() and use instead of getenv(). This is used before
we are up and running and unfortunatley getenv() takes locks.

Other changes:

- Cache the spinlock vectors in pthread__st. Internal spinlock operations
now take 1 function call instead of 3 (i386).
- Use pthread__self() internally, not pthread_self().
- Use __attribute__ ((visibility("hidden"))) in some places.
- Kill PTHREAD_MAIN_DEBUG.

- Get rid of self->pt_mutexhint and use pthread__mutex_owned() instead.
- Update some comments and fix minor bugs. Minor cosmetic changes.
- Replace some spinlocks with mutexes and rwlocks.
- Change the process private semaphores to use mutexes and condition
variables instead of doing the synchronization directly. Spinlocks
are no longer used by the semaphore code.

- Don't take the mutex's spinlock (ptr_interlock) in pthread_cond_wait().
Instead, make the deferred wakeup list a per-thread array and pass down
the lwpid_t's that way.

- In pthread_cond_wait(), take the mutex before dealing with early wakeup.
In this way there should never be contention on the CV's spinlock if
the app follows POSIX rules (there should only be contention on the
user-provided mutex).

- Add a port of the kernel's rwlocks. The rwlock's spinlock is only taken if
there is contention. This is enabled where atomic ops are available. Right
now that is only i386 and amd64 because I don't have other hardware to
test with. It's trivial to add stubs for other architectures as long as
they have compare-and-swap. When we have proper atomic ops the old rwlock
code can be removed.

- Add a new mutex implementation that's similar to the kernel's mutexes, but
uses compare-and-swap to maintain the waiters list, so no spinlocks are
involved. Same caveats apply as for the rwlocks.

Add: pthread__atomic_cas_ptr, pthread__atomic_swap_ptr, pthread__membar_full
This is a stopgap until the thorpej-atomic branch is complete.

branches: 1.2.20; 1.2.24;
Merge the nathanw_sa branch.

branches: 1.1.2;
file _context_u.S was initially added on branch nathanw_sa.

Remove unused code that's confusing when using cscope/opengrok.

branches: 1.8.6;
Selector registers are 16-bit and binutils 2.18 insists that only 16-bit
accesses are permitted on them. Therefore, change movl to movw. No change to
machine code generated.

branches: 1.7.2;
Remove clause 3 and 4 from TNF licenses

branches: 1.6.12;
fix warning about indirect call without *

Punt to setcontext() system call if the PSL_T bit (single-step trap)
is set, so that the single-step trap happens in the thread's context
and not in the middle of _setcontext_u.

XXX might be able to do something here with iret, too, but it needs
more testing.

save&restore %fs and %gs registers for USER_LDT applications.
PR#26900

branches: 1.3.2;
use explicit "l" suffixes. (eg. lea -> leal)

Merge the nathanw_sa branch.

branches: 1.1.2;
file _getsetc.S was initially added on branch nathanw_sa.

Remove unused code that's confusing when using cscope/opengrok.

branches: 1.7.8;
Remove clause 3 and 4 from TNF licenses

branches: 1.6.12;
Remove the PTHREAD_SA option. If M:N threads is reimplemented it's
better off done with a seperate library.

Remove possible race condition in upcall recycling.

Adapt to structure name changes.

Remove PT_SLEEPUC and add PT_TRAPUC.

Merge the nathanw_sa branch.

branches: 1.1.2;
file genassym.cf was initially added on branch nathanw_sa.

This incarnation of the pthreads library is ancient and not useful, and
should have been mothballed some time ago...

More wrapper functions, and some hacks for machine independent sleep
mechanisms.

Copyrights added to each file.

branches: 1.1.1;
Initial revision

This incarnation of the pthreads library is ancient and not useful, and
should have been mothballed some time ago...

Copyrights added to each file.

OK one more try at getting it right ...

branches: 1.1.1;
Initial revision

Remove unused code that's confusing when using cscope/opengrok.

- Make the threadreg code use _lwp_setprivate() instead of MD hooks.

XXX This must not be enabled by default because the LWP private mechanism
is reserved for TLS. It is provided only as a test/demo.

XXX Since ucontext_t does not contain the thread private variable, for a
short time after threads are created their thread specific data is unset.
If a signal arrives during that time we are screwed.

- No longer need pthread__osrev.

- Rearrange _lwp_ctl() calls slightly.

branches: 1.5.8; 1.5.10;
Remove clause 3 and 4 from TNF licenses

branches: 1.4.6;
Mutexes:

- Play scrooge again and chop more cycles off acquire/release.
- Spin while the lock holder is running on another CPU (adaptive mutexes).
- Do non-atomic release.

Threadreg:

- Add the necessary hooks to use a thread register.
- Add the code for i386, using %gs.
- Leave i386 code disabled until xen and COMPAT_NETBSD32 have the changes.

branches: 1.3.24;
add __RCSID()

Merge the nathanw_sa branch.

branches: 1.1.2;
file pthread_md.c was initially added on branch nathanw_sa.

libpthread: New pthread__smt_wait to put CPU in low power for spin.

This is now distinct from pthread__smt_pause, which is for spin lock
backoff with no paired wakeup.

On Arm, there is a single-bit event register per CPU, and there are two
instructions to manage it:

- wfe, wait for event -- if event register is clear, enter low power
mode and wait until event register is set; then exit low power mode
and clear event register

- sev, signal event -- sets event register on all CPUs (other
circumstances like interrupts also set the event register and cause
wfe to wake)

These can be used to reduce the power consumption of spinning for a
lock, but only if they are actually paired -- if there's no sev, wfe
might hang indefinitely. Currently only pthread_spin(3) actually
pairs them; the other lock primitives (internal lock, mutex, rwlock)
do not -- they have spin lock backoff loops, but no corresponding
wakeup to cancel a wfe.

It may be worthwhile to teach the other lock primitives to pair
wfe/sev, but that requires some performance measurement to verify
it's actually worthwhile. So for now, we just make sure not to use
wfe when there's no sev, and keep everything else the same -- this
should fix severe performance degredation in libpthread on Arm
without hurting anything else.

No change in the generated code on amd64 and i386. No change in the
generated code for pthread_spin.c on arm and aarch64 -- changes only
the generated code for pthread_lock.c, pthread_mutex.c, and
pthread_rwlock.c, as intended.

PR port-arm/57437

XXX pullup-10

branches: 1.20.24; 1.20.34; 1.20.42;
Avoid getcontext() as it triggers clobbering warnings. Use inline
assembler to get the fields directly. Saves a system call as side
effect.

branches: 1.19.4;
Allow storing and receiving the LWP private pointer via ucontext_t
on all platforms except VAX and IA64. Add fast access via register for
AMD64, i386 and SH3 ports. Use this fast access in libpthread to replace
the stack based pthread_self(). Implement skeleton support for Alpha,
HPPA, PowerPC, SPARC and SPARC64, but leave it disabled.

Ports that support this feature provide __HAVE____LWP_GETPRIVATE_FAST in
machine/types.h and a corresponding __lwp_getprivate_fast in
machine/mcontext.h.

This material is based upon work partially supported by
The NetBSD Foundation under a contract with Joerg Sonnenberger.

make pthread__sp unsigned long.

branches: 1.17.2;
Remove unused code that's confusing when using cscope/opengrok.

- Make the threadreg code use _lwp_setprivate() instead of MD hooks.

XXX This must not be enabled by default because the LWP private mechanism
is reserved for TLS. It is provided only as a test/demo.

XXX Since ucontext_t does not contain the thread private variable, for a
short time after threads are created their thread specific data is unset.
If a signal arrives during that time we are screwed.

- No longer need pthread__osrev.

- Rearrange _lwp_ctl() calls slightly.

branches: 1.15.6; 1.15.8;
pthread__threadreg_get: mark it const.

branches: 1.14.2;
Remove clause 3 and 4 from TNF licenses

branches: 1.13.2;
Cheat and add inlines for _atomic_cas_ptr() to work around gcc emitting
unneeded PIC stuff in mutex_lock() and mutex_unlock(), when a thread
register is used.

- Remove libpthread's atomic ops.
- Remove the old spinlock-based mutex and rwlock implementations.
- Use the atomic ops from libc.

Mutexes:

- Play scrooge again and chop more cycles off acquire/release.
- Spin while the lock holder is running on another CPU (adaptive mutexes).
- Do non-atomic release.

Threadreg:

- Add the necessary hooks to use a thread register.
- Add the code for i386, using %gs.
- Leave i386 code disabled until xen and COMPAT_NETBSD32 have the changes.

Resurrect the function pointers for lock operations and allow each
architecture to provide asm versions of the RAS operations.

We do this because relying on the compiler to get the RAS right is not
sensible. (It gets alpha wrong and hppa is suboptimal)

Provide asm RAS ops for hppa.

(A slightly different version) reviewed by Andrew Doran.

- Get rid of self->pt_mutexhint and use pthread__mutex_owned() instead.
- Update some comments and fix minor bugs. Minor cosmetic changes.
- Replace some spinlocks with mutexes and rwlocks.
- Change the process private semaphores to use mutexes and condition
variables instead of doing the synchronization directly. Spinlocks
are no longer used by the semaphore code.

Add: pthread__atomic_cas_ptr, pthread__atomic_swap_ptr, pthread__membar_full
This is a stopgap until the thorpej-atomic branch is complete.

branches: 1.7.8; 1.7.12;
Instead of using hard-coded values for various registers, get them from the
current context. Valid values can change depending on how the kernel is
setup. i386 and amd64 happen to be setup differently.

Remove leading __ from __(const|inline|signed|volatile) -- it is obsolete.

branches: 1.5.4; 1.5.6;
Add ucontext conversion macros for an "extra" register set.

delint

de-lint

Merge the nathanw_sa branch.

branches: 1.1.2;
file pthread_md.h was initially added on branch nathanw_sa.

Remove the PTHREAD_SA option. If M:N threads is reimplemented it's
better off done with a seperate library.

A couple of fixes to make libpthread really shared, i.e. not have text re-
locations:

- Don't declare pthread__switch_away global
- Do the PIC dance for pthread__switch_return_point and
pthread__locked_switch. Ideally these (and other) symbols would
be hidden.

Thanks to uwe@, dyoung@ and elad@ for help.

XXX sh3 is still to be done.
XXX vax does strange things.

branches: 1.8.2;
s/the the/the/ (only in sources that aren't regularly imported from
elsewhere).

use explicit "l" suffixes. (eg. lea -> leal)

Remove possible race condition in upcall recycling.

Adapt to pt_trapuc: change STACK_SWITCH to check for a value in pt_trapuc
and use it preferentially to a value in pt_uc, clearing it once on the new
stack. Move stores into pt_uc back to before the stack switch; storing
after the stack switch opened a one-instruction race condition where an upcall
that had just started a chain could be preempted again, and would bomb when
restarted due to its pt_uc not yet having been updated. Now that pt_trapuc
is what the upcall code writes to, it is safe to store to pt_uc before
switching stacks.

Remove obsolete pt_sleepuc code.

Two fixes:
* In switch-away cases, write PT_SWITCHTO last (after PT_SWITCHTOUC), so
that pthread__resolve_locks() doesn't see an empty SWITCHTOUC value. This
also permits pthread__resolve_locks() to use the presence of PT_SWITCHTO
as a sign that the thread has done all of its necessary chain work.

* Make the return-point of pthread__switch global and visible, so that its
address can be compared to the PC of a thread, again as a sign that its
chain-work is done.

(other architectures in progress, after they get the *previous* asm fix...)

Continue at the plain switch return point in pthread__switch, not the
locked one, in the !PIC case. From Tor Egge via Havard Eidnes.

Merge the nathanw_sa branch.

branches: 1.1.2;
file pthread_switch.S was initially added on branch nathanw_sa.

This incarnation of the pthreads library is ancient and not useful, and
should have been mothballed some time ago...

More wrapper functions, and some hacks for machine independent sleep
mechanisms.

Stylistic change.

branches: 1.1.1;
Initial revision