1.\" 2.\" This file and its contents are supplied under the terms of the 3.\" Common Development and Distribution License ("CDDL"), version 1.0. 4.\" You may only use this file in accordance with the terms of version 5.\" 1.0 of the CDDL. 6.\" 7.\" A full copy of the text of the CDDL should have accompanied this 8.\" source. A copy of the CDDL is also available via the Internet at 9.\" http://www.illumos.org/license/CDDL. 10.\" 11.\" 12.\" Copyright 2015 Joyent, Inc. 13.\" 14.Dd May 11, 2016 15.Dt LFREE 3PROC 16.Os 17.Sh NAME 18.Nm Lfree 19.Nd free a control handle to a thread 20.Sh SYNOPSIS 21.Lb libproc 22.In libproc.h 23.Ft "void" 24.Fo Lfree 25.Fa "struct ps_lwphandle *L" 26.Fc 27.Sh DESCRIPTION 28The 29.Fn Lfree 30function releases all control resources associated with the handle 31.Fa L . 32After 33.Fn Lfree , 34calls to other 35.Sy libproc 36routines which leverage information from the handle 37.Fa L 38will no longer work as the handle has been invalidated. 39.Pp 40The state of the thread controlled by 41.Fa L 42is not affected by the call to 43.Fn Lfree . 44The thread's state will not transition from running to stopped or 45vice-versa. It will retain its state prior to the call to 46.Fn Lfree . 47.Sh INTERFACE STABILITY 48.Sy Uncommitted 49.Sh MT-LEVEL 50.Sy MT-Safe 51.Sh SEE ALSO 52.Xr libproc 3LIB , 53.Xr Lgrab 3PROC 54