Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 6 Dec 2001 21:04:52 +0300 (MSK)
From:      maxim@macomnet.ru
To:        FreeBSD-gnats-submit@freebsd.org
Subject:   docs/32561: missed functions in pthread(3)
Message-ID:  <200112061804.fB6I4q550011@news1.macomnet.ru>

next in thread | raw e-mail | index | archive | help

>Number:         32561
>Category:       docs
>Synopsis:       missed functions in pthread(3)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Dec 06 10:10:01 PST 2001
>Closed-Date:
>Last-Modified:
>Originator:     Maxim Konovalov, maxim@macomnet.ru
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
n/a
>Environment:

	FreeBSD 5.0-CURRENT i386

>Description:

	pthread(3) does not mention about

		pthread_kill()
		pthread_setcancelstate()
		pthread_setcanceltype()
		pthread_testcancel()
		pthread_yield()

>How-To-Repeat:

	n/a

>Fix:

Index: pthread.3
===================================================================
RCS file: /home/ncvs/src/share/man/man3/pthread.3,v
retrieving revision 1.20
diff -u -r1.20 pthread.3
--- pthread.3	1 Oct 2001 16:09:20 -0000	1.20
+++ pthread.3	2 Dec 2001 12:13:47 -0000
@@ -73,6 +73,11 @@
 Creates a new thread of execution.
 .It Xo
 .Ft int
+.Fn pthread_cancel "pthread_t thread"
+.Xc
+Cancels execution of a thread.
+.It Xo
+.Ft int
 .Fn pthread_detach "pthread_t thread"
 .Xc
 Marks a thread for deletion.
@@ -93,9 +98,9 @@
 Causes the calling thread to wait for the termination of the specified thread.
 .It Xo
 .Ft int
-.Fn pthread_cancel "pthread_t thread"
+.Fn pthread_kill "pthread_t thread" "int sig"
 .Xc
-Cancels execution of a thread.
+Delivers a signal to a specified thread.
 .It Xo
 .Ft int
 .Fn pthread_once "pthread_once_t *once_control" "void (*init_routine)(void)"
@@ -106,6 +111,26 @@
 .Fn pthread_self void
 .Xc
 Returns the thread ID of the calling thread.
+.It Xo
+.Ft int
+.Fn pthread_setcancelstate "int state" "int *oldstate"
+.Xc
+Sets the current thread's cancelability state.
+.It Xo
+.Ft int
+.Fn pthread_setcanceltype "int type" "int *oldtype"
+.Xc
+Sets the current thread's cancelability type.
+.It Xo
+.Ft void
+.Fn pthread_testcancel void
+.Xc
+Creates a cancellation point in the calling thread.
+.It Xo
+.Ft void
+.Fn pthread_yield void
+.Xc
+Allows the scheduler to run another thread instead of the current one.
 .El
 .Sh ATTRIBUTE OBJECT ROUTINES
 .Bl -tag -width Er
@@ -415,6 +440,7 @@
 .Xr pthread_getspecific 3 ,
 .Xr pthread_join 3 ,
 .Xr pthread_key_delete 3 ,
+.Xr pthread_kill 3 ,
 .Xr pthread_mutex_destroy 3 ,
 .Xr pthread_mutex_init 3 ,
 .Xr pthread_mutex_lock 3 ,
@@ -431,7 +457,10 @@
 .Xr pthread_rwlock_unlock 3 ,
 .Xr pthread_rwlock_wrlock 3 ,
 .Xr pthread_self 3 ,
-.Xr pthread_setspecific 3
+.Xr pthread_setspecific 3 ,
+.Xr pthread_setcancelstate 3 ,
+.Xr pthread_setcanceltype 3 ,
+.Xr pthread_testcancel 3
 .Sh STANDARDS
 The functions in
 .Fa libc_r

--
Maxim Konovalov, MAcomnet, Internet-Intranet Dept., system engineer
phone: +7 (095) 796-9079, mailto: maxim@macomnet.ru
>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200112061804.fB6I4q550011>