.\" $NetBSD: pthread_getname_np.3,v 1.4 2010/07/09 07:31:01 jruoho Exp $ .\" .\" Copyright (c)2007 YAMAMOTO Takashi, .\" 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. .\" .\" ------------------------------------------------------------ .Dd July 9, 2010 .Dt PTHREAD_GETNAME_NP 3 .Os .Sh NAME .Nm pthread_getname_np .Nd get and set descriptive name of a thread .\" ------------------------------------------------------------ .Sh LIBRARY .Lb libpthread .\" ------------------------------------------------------------ .Sh SYNOPSIS .In pthread.h .Ft int .Fn pthread_getname_np "pthread_t thread" "char *name" "size_t len" .Ft int .Fn pthread_setname_np "pthread_t thread" "const char *name" "void *arg" .\" ------------------------------------------------------------ .Sh DESCRIPTION The .Fn pthread_getname_np function obtains the descriptive name of a thread. It takes the following arguments: .Bl -tag -width target -offset indent .It Fa thread The thread whose descriptive name will be obtained. .It Fa name The buffer to be filled with the descriptive name of the thread. .It Fa len The size of the buffer .Fa name in bytes. .El .Pp The .Fn pthread_setname_np function sets the descriptive name of a thread. It takes the following arguments: .Bl -tag -width target -offset indent .It Fa thread The thread whose descriptive name will be set. .It Fa name The .Xr printf 3 format string to be used to construct the descriptive name of the thread. The resulted descriptive name should be shorter than .Dv PTHREAD_MAX_NAMELEN_NP . .It Fa arg The .Xr printf 3 argument used with .Fa name . .El .\" ------------------------------------------------------------ .Sh RETURN VALUES Both functions return 0 on success. Otherwise, an error number is returned to indicate the error. .\" ------------------------------------------------------------ .Sh COMPATIBILITY Both functions are non-standard extensions. .\" ------------------------------------------------------------ .Sh ERRORS Both functions may fail if: .Bl -tag -width Er .It Bq Er EINVAL Invalid parameter. .It Bq Er ESRCH Non-existent .Fa thread . .El .Pp The .Fn pthread_setname_np function may also fail if: .Bl -tag -width Er .It Bq Er ENOMEM There was insufficient memory for the operation. .El .Sh SEE ALSO .Xr pthread_attr_get_np 3 , .Xr pthread_attr_getname_np 3 names.dholland 2011-08-26Use __dead and __printflike instead of __attribute__.dholland 2010-03-22rename text() to wrtext(), aligning it with most other output routines,mrg 2009-08-12sprinkle staticdholland 2008-05-03Rename MKPRIVATELIB to LIBISPRIVATE, to make it clearer that this islukem 2007-12-15convert __attribute__s to applicable cdefs.h macrosperry 2006-03-22Coverity CID 558: && should be obviously ||christos 2006-03-18Coverity CID 1230: Remove spurious close().christos 2006-03-18Coverity CID 1294: Avoid negative variable used as index.christos 2006-02-25Use MKPRIVATELIB instead of NOLINKLIB/NOMAN/NOPIC/NOLINT.simonb 2005-07-01KNF and WARNS=3 fixesjmc 2004-04-23s/the the/the/ (only in sources that aren't regularly imported fromsimonb 2004-01-27Remove uses of __P.jsm 2003-08-07Move UCB-licensed code from 4-clause to 3-clause licence.agc 2002-09-18some makefile de-lintinglukem 2001-12-12MKfoo=no -> NOfoo=tv 1999-10-04update after change to return value of tputs() third argumentlukem 1999-09-08Add `__noreturn__' and `__unused__' attributes where appropriate tojsm 1999-07-28This patch fixes a remaining relic of the backgammon(6) "executehubertf 1999-07-26This patch adds to backgammon(6) a couple of noreturn attributeshubertf 1999-07-26This patch makes backgammon(6) check that, if you use the -s option tohubertf 1999-07-26This adds a check for memory allocation failure to one place inhubertf 1999-03-13set MKLINT=no. noted by NAKAJIMA Yoshihiro <nakayosh@kcn.ne.jp>lukem 1999-02-13convert from NOxxx= to MKxxx=no.lukem 1999-02-10tgetent() handles const correctly in currenthubertf 1999-02-10The patch below makes the game backgammon(6) use `const' wherehubertf 1998-09-15Fix args processing of backgammon and teachgammon, closes pr 5345 byfrueauf 1998-09-13remove x bit from save files (PR#6077)hubertf 1998-09-13Remove unused function and mark non-returning ones(PR#6076, #6144 by Joseph M...hubertf 1998-09-13Remove unused function (PR#6076 by Joseph Myers <jsm28@cam.ac.uk>)hubertf 1998-09-11fix typo, as per PR#5867hubertf 1998-08-29Use symbolic names for signals(!), open(2)-constants, ...hubertf 1997-10-14define global vars with `extern' in "back.h", and only define once inlukem 1997-10-14use <termcap.h>lukem 1997-10-11common_source -> common, and GC some garbage variables.mycroft 1997-10-11Don't install this library, we only need this during the build.veego 1997-10-10KNF & WARNSify, and only compile common_source once/* (compiles 25% faster)lukem