[Bug 480649] Re: glibc-doc: Advanced features of pthread mutexes are not documented in the man-pages

[Rolf Leggewie]

*** This bug is a duplicate of bug 538577 ***
    https://bugs.launchpad.net/bugs/538577

** This bug has been marked a duplicate of bug 538577
   pthread_create man page has gone missing

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to eglibc in Ubuntu.
https://bugs.launchpad.net/bugs/480649

Title:
  glibc-doc: Advanced features of pthread mutexes are not documented in
  the man-pages

Status in “eglibc” package in Ubuntu:
  New

Bug description:
  Glibc has included standards-based process-shared pthread mutexes and
  robust pthread mutexes for quite some time. (Process-shared meaning
  that they can be used across different processes, and robust meaning
  that they can automatically handle the unexpected death/exit/crash of
  a process that has them locked.) However, neither facility is
  documented in the man pages of glibc-doc. The functions lacking
  documentation include the following:

  pthread_mutexattr_setpshared
  pthread_mutexattr_getpshared
  pthread_mutexattr_setrobust
  pthread_mutexattr_getrobust
  pthread_mutex_consistent

  These especially need documentation because they are the best process-
  shared mutex API available on Linux. Because of the lack of
  documentation, I didn't even know about them until a glibc developer
  pointed them out to me!

  Here is one sample page for the setpshared family of functions:

  http://linux.die.net/man/3/pthread_mutexattr_setpshared

  Also, this site lists some more pthread functions that are lacking man
  pages:

  http://www.kernel.org/doc/man-pages/missing_pages.html

  $ lsb_release -rd
  Description:	Ubuntu 9.10
  Release:	9.10
  $ apt-cache policy glibc-doc
  glibc-doc:
    Installed: 2.10.1-0ubuntu15
    Candidate: 2.10.1-0ubuntu15
    Version table:
   *** 2.10.1-0ubuntu15 0
          400 http://us.archive.ubuntu.com karmic/main Packages
          100 /var/lib/dpkg/status
  $

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/eglibc/+bug/480649/+subscriptions