From d3cfc668a3988168ccd9342e46cd884da511367b Mon Sep 17 00:00:00 2001 From: Siddhesh Poyarekar Date: Tue, 19 Mar 2013 14:28:03 +0530 Subject: Rename nptl.texi to threads.texi The manual and its file names are about interfaces and not the implementation details. --- manual/Makefile | 2 +- manual/nptl.texi | 44 -------------------------------------------- manual/threads.texi | 44 ++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 45 insertions(+), 45 deletions(-) delete mode 100644 manual/nptl.texi create mode 100644 manual/threads.texi (limited to 'manual') diff --git a/manual/Makefile b/manual/Makefile index 10314a9624..44c0fd4f68 100644 --- a/manual/Makefile +++ b/manual/Makefile @@ -42,7 +42,7 @@ chapters = $(addsuffix .texi, \ message search pattern io stdio llio filesys \ pipe socket terminal syslog math arith time \ resource setjmp signal startup process job nss \ - users sysinfo conf crypt debug nptl) + users sysinfo conf crypt debug threads) add-chapters = $(wildcard $(foreach d, $(add-ons), ../$d/$d.texi)) appendices = lang.texi header.texi install.texi maint.texi platform.texi \ contrib.texi diff --git a/manual/nptl.texi b/manual/nptl.texi deleted file mode 100644 index 9a1df1a862..0000000000 --- a/manual/nptl.texi +++ /dev/null @@ -1,44 +0,0 @@ -@node POSIX Threads -@c @node POSIX Threads, , Cryptographic Functions, Top -@chapter POSIX Threads -@c %MENU% POSIX Threads -@cindex pthreads - -This chapter describes the @glibcadj{} POSIX Thread implementation. - -@menu -* Thread-specific Data:: Support for creating and - managing thread-specific data -@end menu - -@node Thread-specific Data -@section Thread-specific Data - -The @glibcadj{} implements functions to allow users to create and manage -data specific to a thread. Such data may be destroyed at thread exit, -if a destructor is provided. The following functions are defined: - -@table @code - -@item int pthread_key_create (pthread_key_t *@var{key}, void (*@var{destructor})(void*)) -Create a thread-specific data key for the calling thread, referenced by -@var{key}. - -Objects declared with the C++11 @code{thread_local} keyword are destroyed -before thread-specific data, so they should not be used in thread-specific -data destructors or even as members of the thread-specific data, since the -latter is passed as an argument to the destructor function. - -@item int pthread_key_delete (pthread_key_t @var{key}) -Destroy the thread-specific data @var{key} in the calling thread. The -destructor for the thread-specific data is not called during destruction, nor -is it called during thread exit. - -@item void *pthread_getspecific (pthread_key_t @var{key}) -Return the thread-specific data associated with @var{key} in the calling -thread. - -@item int pthread_setspecific (pthread_key_t @var{key}, const void *@var{value}) -Associate the thread-specific @var{value} with @var{key} in the calling thread. - -@end table diff --git a/manual/threads.texi b/manual/threads.texi new file mode 100644 index 0000000000..9a1df1a862 --- /dev/null +++ b/manual/threads.texi @@ -0,0 +1,44 @@ +@node POSIX Threads +@c @node POSIX Threads, , Cryptographic Functions, Top +@chapter POSIX Threads +@c %MENU% POSIX Threads +@cindex pthreads + +This chapter describes the @glibcadj{} POSIX Thread implementation. + +@menu +* Thread-specific Data:: Support for creating and + managing thread-specific data +@end menu + +@node Thread-specific Data +@section Thread-specific Data + +The @glibcadj{} implements functions to allow users to create and manage +data specific to a thread. Such data may be destroyed at thread exit, +if a destructor is provided. The following functions are defined: + +@table @code + +@item int pthread_key_create (pthread_key_t *@var{key}, void (*@var{destructor})(void*)) +Create a thread-specific data key for the calling thread, referenced by +@var{key}. + +Objects declared with the C++11 @code{thread_local} keyword are destroyed +before thread-specific data, so they should not be used in thread-specific +data destructors or even as members of the thread-specific data, since the +latter is passed as an argument to the destructor function. + +@item int pthread_key_delete (pthread_key_t @var{key}) +Destroy the thread-specific data @var{key} in the calling thread. The +destructor for the thread-specific data is not called during destruction, nor +is it called during thread exit. + +@item void *pthread_getspecific (pthread_key_t @var{key}) +Return the thread-specific data associated with @var{key} in the calling +thread. + +@item int pthread_setspecific (pthread_key_t @var{key}, const void *@var{value}) +Associate the thread-specific @var{value} with @var{key} in the calling thread. + +@end table -- cgit 1.4.1