src/include/pthread.h, branch release/4.1.0

Do not conditionalize function prototype definition for functions we

2000-02-20T07:40:25Z

implement. Noticed by: Thimble Smith Approved by: jkh

Make sched_param parameter a const to comply with POSIX and SUSv2 specs.

2000-01-10T04:14:08Z

This doesn't need to be applied to stable, because somehow -stable seems to have gotten it right. Reviewed by: jasone

Fix some minor POSIX/SUSv2 compliance nits.

1999-12-18T01:00:42Z

PR: kern/11982

Move POSIX feature constants from pthread.h to unistd.h, as required by

1999-12-16T21:53:39Z

1003.1c-1995. Undefine _POSIX_THREAD_SAFE_FUNCTIONS, since we do not implement all of the necessary interfaces. At least getgrgid_r(), getrnam_r(), getpwuid_r(), getpwnam_r(), getc_unlocked(), getchar_unlocked(), putc_unlocked(), and putchar_unlocked() are missing. Due to a likely typo in 1003.1c-1995, we are not technically allowed to define _POSIX_THREADS without defining _POSIX_THREAD_SAFE_FUNCTIONS, but either way we're non-compliant, so I'm leaving _POSIX_THREADS defined. PR: bin/8281

add pthread_cancel, obtained from OpenBSD.

1999-11-28T05:38:13Z

eischen (Daniel Eischen) added wrappers to protect against cancled threads orphaning internal resources. the cancelability code is still a bit fuzzy but works for test programs of my own, OpenBSD's and some examples from ORA's books. add readdir_r to both libc and libc_r add some 'const' attributes to function parameters Reviewed by: eischen, jasone

$Id$ -> $FreeBSD$

1999-08-27T23:45:13Z

Cleanups to the pthread header files.

1999-07-31T08:36:07Z

Submitted by: Ralf S. Engelschall Reviewed by: John Birrell

Hide pthread cancellation routines behind #ifdef NOT_YET. They are

1999-07-27T03:29:01Z

not currently supported. Also corrected the declaration for pthread_testcancel which incorrectly returned int when POSIX and SUSv2 both say it should be void. Submitted by: Ralf S. Engelschall Reviewed by: John Birrell

o Runnable threads are now maintained in priority queues. The

1999-03-23T05:11:30Z

implementation requires two things: 1.) The priority queues must be protected during insertion and removal of threads. Since the kernel scheduler must modify the priority queues, a spinlock for protection cannot be used. The functions _thread_kern_sched_defer() and _thread_kern_sched_undefer() were added to {un}defer kernel scheduler activation. 2.) A thread (active) priority change can be performed only when the thread is removed from the priority queue. The implementation uses a threads active priority when inserting it into the queue. A by-product is that thread switches are much faster. A separate queue is used for waiting and/or blocked threads, and it is searched at most 2 times in the kernel scheduler when there are active threads. It should be possible to reduce this to once by combining polling of threads waiting on I/O with the loop that looks for timed out threads and the minimum timeout value. o Functions to defer kernel scheduler activation were added. These are _thread_kern_sched_defer() and _thread_kern_sched_undefer() and may be called recursively. These routines do not block the scheduling signal, but latch its occurrence. The signal handler will not call the kernel scheduler when the running thread has deferred scheduling, but it will be called when running thread undefers scheduling. o Added support for _POSIX_THREAD_PRIORITY_SCHEDULING. All the POSIX routines required by this should now be implemented. One note, SCHED_OTHER, SCHED_FIFO, and SCHED_RR are required to be defined by including pthread.h. These defines are currently in sched.h. I modified pthread.h to include sched.h but don't know if this is the proper thing to do. o Added support for priority protection and inheritence mutexes. This allows definition of _POSIX_THREAD_PRIO_PROTECT and _POSIX_THREAD_PRIO_INHERIT. o Added additional error checks required by POSIX for mutexes and condition variables. o Provided a wrapper for sigpending which is marked as a hidden syscall. o Added a non-portable function as a debugging aid to allow an application to monitor thread context switches. An application can install a routine that gets called everytime a thread (explicitly created by the application) gets context switched. The routine gets passed the pthread IDs of the threads that are being switched in and out. I found this useful, but we can get rid of it if you want. Submitted by: Dan Eischen

Add support for pthread_mutexattr_settype(). As a side effect of

1998-11-28T23:52:58Z

testing this, fix MUTEX_TYPE_COUNTING_FAST. Recursive locks now work.