Changeset View
Changeset View
Standalone View
Standalone View
head/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 | |||||
function retrieves the | |||||
.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 | |||||
are non-standard extensions. | |||||
.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 | ||||
and | |||||
An Yuri Pankov Aq Mt yuripv@yuripv.net . |