threads/158815: pthread_set_name_np is no longer just a debugging interface

[Garrett Wollman]

>Number:         158815
>Category:       threads
>Synopsis:       pthread_set_name_np is no longer just a debugging interface
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-threads
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jul 11 19:30:07 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator:     Garrett Wollman
>Release:        FreeBSD 8.2-RELEASE-p1 amd64
>Organization:
None
>Environment:
System: FreeBSD khavrinen.csail.mit.edu 8.2-RELEASE-p1 FreeBSD 8.2-RELEASE-p1 #9 r221316: Tue May 3 17:32:39 EDT 2011 wollman at khavrinen.csail.mit.edu:/usr/obj/usr/src/sys/KHAVRINEN amd64

>Description:

The manual page for pthread_set_name_np(3) says:

     This is a debugging interface and using it on a day-by-day basis makes no
     sense.

It is no more a debugging interface than setproctitle(3), and has not
been since the name started getting stuffed into the kernel.  This
statement may have made sense when the name was only visible in thread
state dumps and the debugger.

(I'll note in passing that some implementations provide a
corresponding accessor function.  There are also some implementations
that spell it pthread_setname_np instead.)

>How-To-Repeat:

man pthread_set_name_np

>Fix:

Delete lines 47-49 from the documentation.


>Release-Note:
>Audit-Trail:
>Unformatted: