diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-05-24 04:52:22 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-05-24 04:52:22 +0000 |
commit | 7f3caba522f4d24764f29d83aa2de9198bb7f01c (patch) | |
tree | 66b798ea74302325d6a5c11df044cbe4bb845af1 /man3/pthread_setconcurrency.3 | |
parent | Adding upstream version 6.7. (diff) | |
download | manpages-upstream.tar.xz manpages-upstream.zip |
Adding upstream version 6.8.upstream/6.8upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man3/pthread_setconcurrency.3')
-rw-r--r-- | man3/pthread_setconcurrency.3 | 100 |
1 files changed, 0 insertions, 100 deletions
diff --git a/man3/pthread_setconcurrency.3 b/man3/pthread_setconcurrency.3 deleted file mode 100644 index 0c2ffd0..0000000 --- a/man3/pthread_setconcurrency.3 +++ /dev/null @@ -1,100 +0,0 @@ -'\" t -.\" Copyright (c) 2009 Michael Kerrisk, <mtk.manpages@gmail.com> -.\" -.\" SPDX-License-Identifier: Linux-man-pages-copyleft -.\" -.TH pthread_setconcurrency 3 2023-10-31 "Linux man-pages 6.7" -.SH NAME -pthread_setconcurrency, pthread_getconcurrency \- set/get -the concurrency level -.SH LIBRARY -POSIX threads library -.RI ( libpthread ", " \-lpthread ) -.SH SYNOPSIS -.nf -.B #include <pthread.h> -.P -.BI "int pthread_setconcurrency(int " new_level ); -.BI "int pthread_getconcurrency(" void ); -.fi -.SH DESCRIPTION -The -.BR pthread_setconcurrency () -function informs the implementation of the application's -desired concurrency level, specified in -.IR new_level . -The implementation takes this only as a hint: -POSIX.1 does not specify the level of concurrency that -should be provided as a result of calling -.BR pthread_setconcurrency (). -.P -Specifying -.I new_level -as 0 instructs the implementation to manage the concurrency level -as it deems appropriate. -.P -.BR pthread_getconcurrency () -returns the current value of the concurrency level for this process. -.SH RETURN VALUE -On success, -.BR pthread_setconcurrency () -returns 0; -on error, it returns a nonzero error number. -.P -.BR pthread_getconcurrency () -always succeeds, returning the concurrency level set by a previous call to -.BR pthread_setconcurrency (), -or 0, if -.BR pthread_setconcurrency () -has not previously been called. -.SH ERRORS -.BR pthread_setconcurrency () -can fail with the following error: -.TP -.B EINVAL -.I new_level -is negative. -.P -POSIX.1 also documents an -.B EAGAIN -error ("the value specified by -.I new_level -would cause a system resource to be exceeded"). -.SH ATTRIBUTES -For an explanation of the terms used in this section, see -.BR attributes (7). -.TS -allbox; -lbx lb lb -l l l. -Interface Attribute Value -T{ -.na -.nh -.BR pthread_setconcurrency (), -.BR pthread_getconcurrency () -T} Thread safety MT-Safe -.TE -.SH STANDARDS -POSIX.1-2008. -.SH HISTORY -glibc 2.1. -POSIX.1-2001. -.SH NOTES -The default concurrency level is 0. -.P -Concurrency levels are meaningful only for M:N threading implementations, -where at any moment a subset of a process's set of user-level threads -may be bound to a smaller number of kernel-scheduling entities. -Setting the concurrency level allows the application to -give the system a hint as to the number of kernel-scheduling entities -that should be provided for efficient execution of the application. -.P -Both LinuxThreads and NPTL are 1:1 threading implementations, -so setting the concurrency level has no meaning. -In other words, -on Linux these functions merely exist for compatibility with other systems, -and they have no effect on the execution of a program. -.SH SEE ALSO -.BR pthread_attr_setscope (3), -.BR pthreads (7) |