Attachment 228157 Details for Bug 197299 – pthread(3) patch

[patch] pthread(3) patch

pthread.3.patch (text/plain), 7.40 KB, created by Felix Johnson on 2021-09-25 03:10:01 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Felix Johnson

Created: 2021-09-25 03:10:01 UTC

Size: 7.40 KB

patch

obsolete

>diff --git a/share/man/man3/pthread.3 b/share/man/man3/pthread.3
>index 8a437b1cedb..3c5f107198a 100644
>--- a/share/man/man3/pthread.3
>+++ b/share/man/man3/pthread.3
>@@ -30,7 +30,7 @@
> .\"
> .\" $FreeBSD$
> .\"
>-.Dd August 17, 2018
>+.Dd September 23, 2021
> .Dt PTHREAD 3
> .Os
> .Sh NAME
>@@ -40,6 +40,9 @@
> .Lb libpthread
> .Sh SYNOPSIS
> .In pthread.h
>+.Pp
>+When using functions ending in _np:
>+.In pthread_np.h
> .Sh DESCRIPTION
> POSIX threads are a set of functions that support applications with
> requirements for multiple flows of control, called
>@@ -99,6 +102,26 @@ Compares two thread IDs.
> Terminates the calling thread.
> .It Xo
> .Ft int
>+.Fn pthread_getaffinity_np "pthread_t td" "size_t cpusetsize" "cpuset_t *cpusetp"
>+.Xc
>+Get CPU affinity of a specified thread.
>+.It Xo
>+.Ft int
>+.Fn pthread_get_name_np "pthread_t thread" "char *name" "size_t len"
>+.Xc
>+Get the name of a specified thread.
>+.It Xo
>+.Ft int
>+.Fn pthread_getname_np "pthread_t thread" "char *name" "size_t len"
>+.Xc
>+Get the name of a specified thread.
>+.It Xo
>+.Ft int
>+.Fn pthread_getthreadid_np void
>+.Xc
>+Get the calling thread's integral ID.
>+.It Xo
>+.Ft int
> .Fn pthread_join "pthread_t thread" "void **value_ptr"
> .Xc
> Causes the calling thread to wait for the termination of the specified thread.
>@@ -109,16 +132,41 @@ Causes the calling thread to wait for the termination of the specified thread.
> Delivers a signal to a specified thread.
> .It Xo
> .Ft int
>+.Fn pthread_main_np void
>+.Xc
>+Identify the initial thread.
>+.It Xo
>+.Ft int
>+.Fn pthread_multi_np void
>+.Xc
>+Sets the thread's scheduling mode to multi-threaded.
>+.It Xo
>+.Ft int
> .Fn pthread_once "pthread_once_t *once_control" "void \*[lp]*init_routine\*[rp]\*[lp]void\*[rp]"
> .Xc
> Calls an initialization routine once.
> .It Xo
>+.Ft int
>+.Fn pthread_peekjoin_np "pthread_t thread" "void **value_ptr"
>+.Xc
>+Peek into the exit status of a specified thread.
>+.It Xo
>+.Ft int
>+.Fn pthread_resume_all_np void
>+.Xc
>+Resume all suspended threads.
>+.It Xo
> .Ft pthread_t
> .Fn pthread_self void
> .Xc
> Returns the thread ID of the calling thread.
> .It Xo
> .Ft int
>+.Fn pthread_setaffinity_np "pthread_t td" "size_t cpusetsize" "const cpuset_t *cpusetp"
>+.Xc
>+Attempt to set the CPU affinity of a specified thread.
>+.It Xo
>+.Ft int
> .Fn pthread_setcancelstate "int state" "int *oldstate"
> .Xc
> Sets the current thread's cancelability state.
>@@ -128,11 +176,57 @@ Sets the current thread's cancelability state.
> .Xc
> Sets the current thread's cancelability type.
> .It Xo
>+.Ft int
>+.Fn pthread_set_name_np "pthread_t thread" "char *name"
>+.Xc
>+Sets the specified thread's name.
>+.It Xo
>+.Ft int
>+.Fn pthread_setname_np "pthread_t thread" "char *name"
>+.Xc
>+Sets the specified thread's name.
>+.It Xo
>+.Ft int
>+.Fn pthread_single_np void
>+.Xc
>+Sets the thread's scheduling mode to single-threaded.
>+.It Xo
>+.Ft int
>+.Fn pthread_suspend_np "pthread_t tid"
>+.Xc
>+Suspend the specified thread.
>+.It Xo
>+.Ft int
>+.Fn pthread_suspend_all_np void
>+.Xc
>+Suspend all active threads.
>+.It Xo
>+.Ft int
>+.Fn pthread_switch_add_np "pthread_switch_routine_t routine"
>+.Xc
>+Install a routine to get called every time a thread
>+gets the context switched.
>+.It Xo
>+.Ft int
>+.Fn pthread_switch_delete_np "pthread_switch_routine_t routine"
>+.Xc
>+Remove a routine to get called every time a thread
>+gets the context switched.
>+.It Xo
> .Ft void
> .Fn pthread_testcancel void
> .Xc
> Creates a cancellation point in the calling thread.
> .It Xo
>+.Ft int
>+.Fn pthread_timedjoin_np "pthread_t thread" "void **value_ptr" "const struct timespec *abstime)
>+.Xc
>+Equivalent to
>+.Fn pthread_join
>+except it will return if the specified thread does not exit before
>+.Fa abstime
>+passes.
>+.It Xo
> .Ft void
> .Fn pthread_yield void
> .Xc
>@@ -147,6 +241,20 @@ Allows the scheduler to run another thread instead of the current one.
> Destroy a thread attributes object.
> .It Xo
> .Ft int
>+.Fo pthread_attr_get_np
>+.Fa "pthread_t pid" "pthread_attr_t *dst"
>+.Fc
>+.Xc
>+Get the attributes of an existent thread.
>+.It Xo
>+.Ft int
>+.Fo pthread_attr_getaffinity_np
>+.Fa "const pthread_attr_t *pattr" "size_t cpusetsize" "cpuset_t *cpusetp"
>+.Fc
>+.Xc
>+Get the CPU affinity mask from the thread attribute object.
>+.It Xo
>+.Ft int
> .Fo pthread_attr_getinheritsched
> .Fa "const pthread_attr_t *attr" "int *inheritsched"
> .Fc
>@@ -191,11 +299,21 @@ Get the detach state attribute from a thread attributes object.
> Initialize a thread attributes object with default values.
> .It Xo
> .Ft int
>+.Fn pthread_attr_setaffinity_np "pthread_attr_t *pattr" "size_t cpusetsize" "const cpuset_t *cpusetp"
>+.Xc
>+Set the CPU affinity mask for the thread attribute object.
>+.It Xo
>+.Ft int
> .Fn pthread_attr_setinheritsched "pthread_attr_t *attr" "int inheritsched"
> .Xc
> Set the inherit scheduling attribute in a thread attributes object.
> .It Xo
> .Ft int
>+.Fn pthread_attr_setcreatesuspend_np "pthread_attr_t *attr"
>+.Xc
>+Prepare thread attribute object for creation of suspended thread.
>+.It Xo
>+.Ft int
> .Fo pthread_attr_setschedparam
> .Fa "pthread_attr_t *attr" "const struct sched_param *param"
> .Fc
>@@ -236,6 +354,13 @@ Set the detach state in a thread attributes object.
> Destroy a mutex attributes object.
> .It Xo
> .Ft int
>+.Fn pthread_mutexattr_getkind_np "pthread_mutexattr_t attr"
>+.Xc
>+Deprecated, use
>+.Xr pthread_mutexattr_gettype 3
>+instead.
>+.It Xo
>+.Ft int
> .Fn pthread_mutexattr_getprioceiling "const pthread_mutexattr_t *restrict attr" "int *restrict ceiling"
> .Xc
> Obtain priority ceiling attribute of mutex attribute object.
>@@ -256,6 +381,13 @@ Obtain the mutex type attribute in the specified mutex attributes object.
> Initialize a mutex attributes object with default values.
> .It Xo
> .Ft int
>+.Fn pthread_mutexattr_setkind_np "pthread_mutexattr_t *attr"
>+.Xc
>+Deprecated, use
>+.Xr pthread_mutexattr_settype 3
>+instead.
>+.It Xo
>+.Ft int
> .Fn pthread_mutexattr_setprioceiling "pthread_mutexattr_t *attr" "int ceiling"
> .Xc
> Set priority ceiling attribute of mutex attribute object.
>@@ -481,6 +613,8 @@ Threaded applications are linked with this library.
> .Xr pthread_affinity_np 3 ,
> .Xr pthread_atfork 3 ,
> .Xr pthread_attr 3 ,
>+.Xr pthread_attr_get_np 3 ,
>+.Xr pthread_attr_setcreatesuspend_np 3 ,
> .Xr pthread_cancel 3 ,
> .Xr pthread_cleanup_pop 3 ,
> .Xr pthread_cleanup_push 3 ,
>@@ -497,9 +631,12 @@ Threaded applications are linked with this library.
> .Xr pthread_equal 3 ,
> .Xr pthread_exit 3 ,
> .Xr pthread_getspecific 3 ,
>+.Xr pthread_getthreadid_np 3 ,
> .Xr pthread_join 3 ,
> .Xr pthread_key_delete 3 ,
> .Xr pthread_kill 3 ,
>+.Xr pthread_main_np 3 ,
>+.Xr pthread_multi_np 3 ,
> .Xr pthread_mutex_destroy 3 ,
> .Xr pthread_mutex_init 3 ,
> .Xr pthread_mutex_lock 3 ,
>@@ -508,12 +645,14 @@ Threaded applications are linked with this library.
> .Xr pthread_mutexattr_destroy 3 ,
> .Xr pthread_mutexattr_getprioceiling 3 ,
> .Xr pthread_mutexattr_getprotocol 3 ,
>+.Xr pthread_mutexattr_getkind_np 3 ,
> .Xr pthread_mutexattr_gettype 3 ,
> .Xr pthread_mutexattr_init 3 ,
> .Xr pthread_mutexattr_setprioceiling 3 ,
> .Xr pthread_mutexattr_setprotocol 3 ,
> .Xr pthread_mutexattr_settype 3 ,
> .Xr pthread_once 3 ,
>+.Xr pthread_resume_all_np 3 ,
> .Xr pthread_rwlock_destroy 3 ,
> .Xr pthread_rwlock_init 3 ,
> .Xr pthread_rwlock_rdlock 3 ,
>@@ -526,7 +665,11 @@ Threaded applications are linked with this library.
> .Xr pthread_self 3 ,
> .Xr pthread_setcancelstate 3 ,
> .Xr pthread_setcanceltype 3 ,
>+.Xr pthread_set_name_np 3 ,
> .Xr pthread_setspecific 3 ,
>+.Xr pthread_suspend_np 3 ,
>+.Xr pthread_suspend_all_np 3 ,
>+.Xr pthread_switch_add_np 3 ,
> .Xr pthread_testcancel 3
> .Sh STANDARDS
> The functions with the

Actions: View | Diff

Attachments on bug 197299: 228157 | 228224 | 228225 | 228615