diff options
Diffstat (limited to 'static/freebsd/man3/pthread_key_create.3 3.html')
| -rw-r--r-- | static/freebsd/man3/pthread_key_create.3 3.html | 96 |
1 files changed, 0 insertions, 96 deletions
diff --git a/static/freebsd/man3/pthread_key_create.3 3.html b/static/freebsd/man3/pthread_key_create.3 3.html deleted file mode 100644 index 58110c8d..00000000 --- a/static/freebsd/man3/pthread_key_create.3 3.html +++ /dev/null @@ -1,96 +0,0 @@ -<table class="head"> - <tr> - <td class="head-ltitle">PTHREAD_KEY_CREATE(3)</td> - <td class="head-vol">Library Functions Manual</td> - <td class="head-rtitle">PTHREAD_KEY_CREATE(3)</td> - </tr> -</table> -<div class="manual-text"> -<section class="Sh"> -<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1> -<p class="Pp"><code class="Nm">pthread_key_create</code> — - <span class="Nd">thread-specific data key creation</span></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="LIBRARY"><a class="permalink" href="#LIBRARY">LIBRARY</a></h1> -<p class="Pp"><span class="Lb">POSIX Threads Library (libpthread, - -lpthread)</span></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1> -<p class="Pp"><code class="In">#include - <<a class="In">pthread.h</a>></code></p> -<p class="Pp"><var class="Ft">int</var> - <br/> - <code class="Fn">pthread_key_create</code>(<var class="Fa" style="white-space: nowrap;">pthread_key_t - *key</var>, <var class="Fa" style="white-space: nowrap;">void - (*destructor)(void *)</var>);</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1> -<p class="Pp">The - <a class="permalink" href="#pthread_key_create"><code class="Fn" id="pthread_key_create">pthread_key_create</code></a>() - function creates a thread-specific data key visible to all threads in the - process. Key values provided by <code class="Fn">pthread_key_create</code>() - are opaque objects used to locate thread-specific data. Although the same - key value may be used by different threads, the values bound to the key by - <a class="permalink" href="#pthread_setspecific"><code class="Fn" id="pthread_setspecific">pthread_setspecific</code></a>() - are maintained on a per-thread basis and persist for the life of the calling - thread.</p> -<p class="Pp">Upon key creation, the value NULL is associated with the new key - in all active threads. Upon thread creation, the value NULL is associated - with all defined keys in the new thread.</p> -<p class="Pp">An optional destructor function may be associated with each key - value. At thread exit, if a key value has a non-NULL destructor pointer, and - the thread has a non-NULL value associated with the key, the function - pointed to is called with the current associated value as its sole argument. - The order of destructor calls is unspecified if more than one destructor - exists for a thread when it exits.</p> -<p class="Pp">If, after all the destructors have been called for all non-NULL - values with associated destructors, there are still some non-NULL values - with associated destructors, then the process is repeated. If, after at - least [PTHREAD_DESTRUCTOR_ITERATIONS] iterations of destructor calls for - outstanding non-NULL values, there are still some non-NULL values with - associated destructors, the implementation stops calling destructors.</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN - VALUES</a></h1> -<p class="Pp">If successful, the <code class="Fn">pthread_key_create</code>() - function will store the newly created key value at the location specified by - <var class="Fa">key</var> and returns zero. Otherwise an error number will - be returned to indicate the error.</p> -</section> -<section class="Sh"> -<h1 class="Sh" id="ERRORS"><a class="permalink" href="#ERRORS">ERRORS</a></h1> -<p class="Pp">The <code class="Fn">pthread_key_create</code>() function will - fail if:</p> -<dl class="Bl-tag"> - <dt id="EAGAIN">[<a class="permalink" href="#EAGAIN"><code class="Er">EAGAIN</code></a>]</dt> - <dd>The system lacked the necessary resources to create another - thread-specific data key, or the system-imposed limit on the total number - of keys per process [PTHREAD_KEYS_MAX] would be exceeded.</dd> - <dt id="ENOMEM">[<a class="permalink" href="#ENOMEM"><code class="Er">ENOMEM</code></a>]</dt> - <dd>Insufficient memory exists to create the key.</dd> -</dl> -</section> -<section class="Sh"> -<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE - ALSO</a></h1> -<p class="Pp"><a class="Xr">pthread_getspecific(3)</a>, - <a class="Xr">pthread_key_delete(3)</a>, - <a class="Xr">pthread_setspecific(3)</a></p> -</section> -<section class="Sh"> -<h1 class="Sh" id="STANDARDS"><a class="permalink" href="#STANDARDS">STANDARDS</a></h1> -<p class="Pp">The <code class="Fn">pthread_key_create</code>() function conforms - to <span class="St">ISO/IEC 9945-1:1996 - (“POSIX.1”)</span>.</p> -</section> -</div> -<table class="foot"> - <tr> - <td class="foot-date">April 4, 1996</td> - <td class="foot-os">FreeBSD 15.0</td> - </tr> -</table> |