.\"
.\" This file and its contents are supplied under the terms of the
.\" Common Development and Distribution License ("CDDL"), version 1.0.
.\" You may only use this file in accordance with the terms of version
.\" 1.0 of the CDDL.
.\"
.\" A full copy of the text of the CDDL should have accompanied this
.\" source.  A copy of the CDDL is also available via the Internet at
.\" http://www.illumos.org/license/CDDL.
.\"
.\"
.\" Copyright 2015 Joyent, Inc.
.\"
.Dd May 11, 2016
.Dt LPSINFO 3PROC
.Os
.Sh NAME
.Nm Lpsinfo
.Nd get process ps information
.Sh SYNOPSIS
.Lb libproc
.In libproc.h
.Ft "const lwpsinfo_t *"
.Fo Lpsinfo
.Fa "struct ps_lwphandle *L"
.Fc
.Sh DESCRIPTION
The
.Fn Lpsinfo
function returns the thread handle
.Fa L Ns 's
.Xr ps 1
information.
The
.Sy lwpsinfo_t
structure that is returned is defined in
.Xr proc 5
and is valid until a subsequent call to
.Xr Lfree 3PROC .
.Sh RETURN VALUES
Upon successful completion, the
.Fn Lpsinfo
function returns a pointer to the thread's ps information.
Otherwise,
.Dv NULL
is returned to indicate that it could not be found.
.Sh INTERFACE STABILITY
.Sy Uncommitted
.Sh MT-LEVEL
See
.Sy LOCKING
in
.Xr libproc 3LIB .
.Sh SEE ALSO
.Xr ps 1 ,
.Xr libproc 3LIB ,
.Xr Lfree 3PROC ,
.Xr proc 5