Differential D16702 Diff 46621 share/man/man3/pthread_set_name_np.3

Changeset View

Standalone View

share/man/man3/pthread_set_name_np.3

	Show All 18 Lines
	.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)			.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY			.\" 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			.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	.\" SUCH DAMAGE.			.\" SUCH DAMAGE.
	.\"			.\"
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd December 2, 2016			.Dd August 12, 2018
	.Dt PTHREAD_SET_NAME_NP 3			.Dt PTHREAD_SET_NAME_NP 3
	.Os			.Os
	.Sh NAME			.Sh NAME
				.Nm pthread_get_name_np ,
	.Nm pthread_set_name_np			.Nm pthread_set_name_np
	.Nd set the thread name			.Nd set and retrieve the thread name
	.Sh LIBRARY			.Sh LIBRARY
	.Lb libpthread			.Lb libpthread
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.In pthread_np.h			.In pthread_np.h
	.Ft void			.Ft void
				.Fn pthread_get_name_np "pthread_t thread" "char *name" "size_t len"
				.Ft void
	.Fn pthread_set_name_np "pthread_t thread" "const char *name"			.Fn pthread_set_name_np "pthread_t thread" "const char *name"
	.Sh DESCRIPTION			.Sh DESCRIPTION
	The			The
	.Fn pthread_set_name_np			.Fn pthread_set_name_np
	function applies a copy of the given			function applies a copy of the given
	.Fa name			.Fa name
	to the given			to the given
	.Fa thread .			.Fa thread .
				.Pp
				The
				.Fn pthread_get_name_np
				retrieves the
				bjkUnsubmitted Done Inline Actions "function" bjk: "function"
				.Fa name
				associated with
				.Fa thread .
				If
				.Fn pthread_set_name_np
				was not previously called for
				.Fa thread ,
				the buffer pointed to by
				.Fa name
				will be empty.
	.Sh ERRORS			.Sh ERRORS
	Because of the debugging nature of this function, all errors that may			Because of the debugging nature of these functions, all errors that may
	appear inside are silently ignored.			appear inside are silently ignored.
	.Sh SEE ALSO			.Sh SEE ALSO
	.Xr thr_set_name 2			.Xr thr_set_name 2
				.Sh STANDARDS
				.Fn pthread_set_name_np
				and
				.Fn pthread_get_name_np
				functions are non-standard extensions.
				bjkUnsubmitted Done Inline Actions No "functions" here. bjk: No "functions" here.
				pluknetUnsubmitted Not Done Inline Actions Please note that this duplicates what's already (perhaps, vaguely) documented in pthread(3)'s STANDARDS section: The functions with the pthread_ prefix and _np suffix are non-portable extensions to POSIX threads. pluknet: Please note that this duplicates what's already (perhaps, vaguely) documented in pthread(3)'s…
				kibAuthorUnsubmitted Not Done Inline Actions Yes, but what do you want me to change there ? I do not see a harm in repeating this information. kib: Yes, but what do you want me to change there ? I do not see a harm in repeating this…
				pluknetUnsubmitted Not Done Inline Actions Just a FYI, I see no problem here. pluknet: Just a FYI, I see no problem here.
	.Sh AUTHORS			.Sh AUTHORS
	This manual page was written by			This manual page was written by
	.An Alexey Zelkin Aq Mt phantom@FreeBSD.org .			.An Alexey Zelkin Aq Mt phantom@FreeBSD.org .