summaryrefslogtreecommitdiffstats
path: root/lib/libc
diff options
context:
space:
mode:
authormarcel <marcel@FreeBSD.org>2003-12-10 02:38:51 +0000
committermarcel <marcel@FreeBSD.org>2003-12-10 02:38:51 +0000
commiteb521e2e92b64b11cd6e54bab0fa48804b99f694 (patch)
tree42ac79ddf454d6ee148e0eceaa7bec17dbc735ae /lib/libc
parentb6631c500b60af6940dbcee6a8ac4439d2491f07 (diff)
downloadFreeBSD-src-eb521e2e92b64b11cd6e54bab0fa48804b99f694.zip
FreeBSD-src-eb521e2e92b64b11cd6e54bab0fa48804b99f694.tar.gz
Add a short description of the kse_switchin(2) syscall to the kse
manpage and add a kse_switchin link. While here, list kse_thr_interrupt before kse_wakeup in the MLINKS variable and the synopsis.
Diffstat (limited to 'lib/libc')
-rw-r--r--lib/libc/sys/Makefile.inc2
-rw-r--r--lib/libc/sys/kse.214
2 files changed, 14 insertions, 2 deletions
diff --git a/lib/libc/sys/Makefile.inc b/lib/libc/sys/Makefile.inc
index 49ac92c..cc4b45ca 100644
--- a/lib/libc/sys/Makefile.inc
+++ b/lib/libc/sys/Makefile.inc
@@ -118,7 +118,7 @@ MLINKS+=intro.2 errno.2
MLINKS+=jail.2 jail_attach.2
MLINKS+=kqueue.2 kevent.2
MLINKS+=kse.2 kse_create.2 kse.2 kse_exit.2 kse.2 kse_release.2 \
- kse.2 kse_wakeup.2 kse.2 kse_thr_interrupt.2
+ kse.2 kse_switchin.2 kse.2 kse_thr_interrupt.2 kse.2 kse_wakeup.2
MLINKS+=madvise.2 posix_madvise.2
MLINKS+=mlock.2 munlock.2
MLINKS+=mlockall.2 munlockall.2
diff --git a/lib/libc/sys/kse.2 b/lib/libc/sys/kse.2
index be81f7f..a1151dc 100644
--- a/lib/libc/sys/kse.2
+++ b/lib/libc/sys/kse.2
@@ -53,9 +53,11 @@
.Ft int
.Fn kse_release "struct timespec *timeout"
.Ft int
-.Fn kse_wakeup "struct kse_mailbox *mbx"
+.Fn kse_switchin "mcontext_t *mcp" "long val" "long *loc"
.Ft int
.Fn kse_thr_interrupt "struct kse_thr_mailbox *tmbx"
+.Ft int
+.Fn kse_wakeup "struct kse_mailbox *mbx"
.Sh DESCRIPTION
These system calls implement kernel support for multi-threaded processes.
.\"
@@ -286,6 +288,16 @@ If successful,
does not return to the caller.
.Pp
The
+.Fn kse_switchin
+system call can be used by the UTS, when it has selected a new thread,
+to switch to the context of that thread.
+The use of
+.Fn kse_switchin
+is machine dependent.
+Some platforms do not need a system call to switch to a new context,
+while others require its use in particular cases.
+.Pp
+The
.Fn kse_wakeup
system call
is the opposite of
OpenPOWER on IntegriCloud