d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
d9cf291382
freebsd-dev/share/man/man3/pthread_set_name_np.3

54 lines
2.0 KiB
Groff
Raw Normal View History

Finally! Document all undocumented functions in libc_r. Add manual pages for following functions: . pthread_attr_setcreatesuspend_np(3) . pthread_main_np(3) . pthread_multi_np(3) . pthread_single_np(3) . pthread_mutexattr_getkind_np(3) . pthread_mutexattr_setkind_np(3) . pthread_resume_all_np(3) . pthread_resume_np(3) . pthread_set_name_np(3) . pthread_suspend_all_np(3) . pthread_suspend_np(3) . pthread_switch_add_np(3) . pthread_switch_delete_np(3) MFC after: 3 days
2003-02-13 22:10:10 +00:00
.\" Copyright (c) 2003 Alexey Zelkin <phantom@FreeBSD.org>
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" $FreeBSD$
.\"
thr_set_name(): silently truncate the given name as needed Instead of failing with ENAMETOOLONG, which is swallowed by pthread_set_name_np() anyway, truncate the given name to MAXCOMLEN+1 bytes. This is more likely what the user wants, and saves the caller from truncating it before the call (which was the only recourse). Polish pthread_set_name_np(3) and add a .Xr to thr_set_name(2) so the user might find the documentation for this behavior. Reviewed by: jilles MFC after: 3 days Sponsored by: Dell EMC
2016-12-03 01:14:21 +00:00
.Dd December 2, 2016
Finally! Document all undocumented functions in libc_r. Add manual pages for following functions: . pthread_attr_setcreatesuspend_np(3) . pthread_main_np(3) . pthread_multi_np(3) . pthread_single_np(3) . pthread_mutexattr_getkind_np(3) . pthread_mutexattr_setkind_np(3) . pthread_resume_all_np(3) . pthread_resume_np(3) . pthread_set_name_np(3) . pthread_suspend_all_np(3) . pthread_suspend_np(3) . pthread_switch_add_np(3) . pthread_switch_delete_np(3) MFC after: 3 days
2003-02-13 22:10:10 +00:00
.Dt PTHREAD_SET_NAME_NP 3
.Os
.Sh NAME
.Nm pthread_set_name_np
.Nd set the thread name
.Sh LIBRARY
Have a single set of POSIX threads man pages. The LIBRARY section of each manpage lists libraries that have corresponding interfaces implemented. Prodded by: threads Reviewed by: deischen
2004-01-14 21:44:26 +00:00
.Lb libpthread
Finally! Document all undocumented functions in libc_r. Add manual pages for following functions: . pthread_attr_setcreatesuspend_np(3) . pthread_main_np(3) . pthread_multi_np(3) . pthread_single_np(3) . pthread_mutexattr_getkind_np(3) . pthread_mutexattr_setkind_np(3) . pthread_resume_all_np(3) . pthread_resume_np(3) . pthread_set_name_np(3) . pthread_suspend_all_np(3) . pthread_suspend_np(3) . pthread_switch_add_np(3) . pthread_switch_delete_np(3) MFC after: 3 days
2003-02-13 22:10:10 +00:00
.Sh SYNOPSIS
.In pthread_np.h
.Ft void
thr_set_name(): silently truncate the given name as needed Instead of failing with ENAMETOOLONG, which is swallowed by pthread_set_name_np() anyway, truncate the given name to MAXCOMLEN+1 bytes. This is more likely what the user wants, and saves the caller from truncating it before the call (which was the only recourse). Polish pthread_set_name_np(3) and add a .Xr to thr_set_name(2) so the user might find the documentation for this behavior. Reviewed by: jilles MFC after: 3 days Sponsored by: Dell EMC
2016-12-03 01:14:21 +00:00
.Fn pthread_set_name_np "pthread_t thread" "const char *name"
Finally! Document all undocumented functions in libc_r. Add manual pages for following functions: . pthread_attr_setcreatesuspend_np(3) . pthread_main_np(3) . pthread_multi_np(3) . pthread_single_np(3) . pthread_mutexattr_getkind_np(3) . pthread_mutexattr_setkind_np(3) . pthread_resume_all_np(3) . pthread_resume_np(3) . pthread_set_name_np(3) . pthread_suspend_all_np(3) . pthread_suspend_np(3) . pthread_switch_add_np(3) . pthread_switch_delete_np(3) MFC after: 3 days
2003-02-13 22:10:10 +00:00
.Sh DESCRIPTION
The
.Fn pthread_set_name_np
thr_set_name(): silently truncate the given name as needed Instead of failing with ENAMETOOLONG, which is swallowed by pthread_set_name_np() anyway, truncate the given name to MAXCOMLEN+1 bytes. This is more likely what the user wants, and saves the caller from truncating it before the call (which was the only recourse). Polish pthread_set_name_np(3) and add a .Xr to thr_set_name(2) so the user might find the documentation for this behavior. Reviewed by: jilles MFC after: 3 days Sponsored by: Dell EMC
2016-12-03 01:14:21 +00:00
function applies a copy of the given
Finally! Document all undocumented functions in libc_r. Add manual pages for following functions: . pthread_attr_setcreatesuspend_np(3) . pthread_main_np(3) . pthread_multi_np(3) . pthread_single_np(3) . pthread_mutexattr_getkind_np(3) . pthread_mutexattr_setkind_np(3) . pthread_resume_all_np(3) . pthread_resume_np(3) . pthread_set_name_np(3) . pthread_suspend_all_np(3) . pthread_suspend_np(3) . pthread_switch_add_np(3) . pthread_switch_delete_np(3) MFC after: 3 days
2003-02-13 22:10:10 +00:00
.Fa name
thr_set_name(): silently truncate the given name as needed Instead of failing with ENAMETOOLONG, which is swallowed by pthread_set_name_np() anyway, truncate the given name to MAXCOMLEN+1 bytes. This is more likely what the user wants, and saves the caller from truncating it before the call (which was the only recourse). Polish pthread_set_name_np(3) and add a .Xr to thr_set_name(2) so the user might find the documentation for this behavior. Reviewed by: jilles MFC after: 3 days Sponsored by: Dell EMC
2016-12-03 01:14:21 +00:00
to the given
.Fa thread .
Finally! Document all undocumented functions in libc_r. Add manual pages for following functions: . pthread_attr_setcreatesuspend_np(3) . pthread_main_np(3) . pthread_multi_np(3) . pthread_single_np(3) . pthread_mutexattr_getkind_np(3) . pthread_mutexattr_setkind_np(3) . pthread_resume_all_np(3) . pthread_resume_np(3) . pthread_set_name_np(3) . pthread_suspend_all_np(3) . pthread_suspend_np(3) . pthread_switch_add_np(3) . pthread_switch_delete_np(3) MFC after: 3 days
2003-02-13 22:10:10 +00:00
.Sh ERRORS
mdoc(7) police: Scheduled sweep.
2003-02-24 22:53:26 +00:00
Because of the debugging nature of this function, all errors that may
appear inside are silently ignored.
thr_set_name(): silently truncate the given name as needed Instead of failing with ENAMETOOLONG, which is swallowed by pthread_set_name_np() anyway, truncate the given name to MAXCOMLEN+1 bytes. This is more likely what the user wants, and saves the caller from truncating it before the call (which was the only recourse). Polish pthread_set_name_np(3) and add a .Xr to thr_set_name(2) so the user might find the documentation for this behavior. Reviewed by: jilles MFC after: 3 days Sponsored by: Dell EMC
2016-12-03 01:14:21 +00:00
.Sh SEE ALSO
.Xr thr_set_name 2
Finally! Document all undocumented functions in libc_r. Add manual pages for following functions: . pthread_attr_setcreatesuspend_np(3) . pthread_main_np(3) . pthread_multi_np(3) . pthread_single_np(3) . pthread_mutexattr_getkind_np(3) . pthread_mutexattr_setkind_np(3) . pthread_resume_all_np(3) . pthread_resume_np(3) . pthread_set_name_np(3) . pthread_suspend_all_np(3) . pthread_suspend_np(3) . pthread_switch_add_np(3) . pthread_switch_delete_np(3) MFC after: 3 days
2003-02-13 22:10:10 +00:00
.Sh AUTHORS
mdoc(7) police: Scheduled sweep.
2003-02-24 22:53:26 +00:00
This manual page was written by
use .Mt to mark up email addresses consistently (part6) PR: 191174 Submitted by: Franco Fichtner <franco at lastsummer.de>
2014-06-23 08:27:27 +00:00
.An Alexey Zelkin Aq Mt phantom@FreeBSD.org .
Reference in New Issue Copy Permalink