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 PSTATUS 3PROC 16.Os 17.Sh NAME 18.Nm Pstatus 19.Nd obtain process status structure 20.Sh SYNOPSIS 21.Lb libproc 22.In libproc.h 23.Ft "const pstatus_t *" 24.Fo Pstatus 25.Fa "struct ps_prochandle *P" 26.Fc 27.Sh DESCRIPTION 28The 29.Fn Pstatus 30function returns the status information about the process handle 31.Fa P . 32The 33.Sy pstatus_t 34structure is defined in 35.Xr proc 4 36and contains information about the process including its flags, the 37number of threads, the size of the stack, and more. 38.Pp 39The returned pointer is only valid as long as the process handle 40.Fa P 41is valid. 42After a call to 43.Xr Prelease 3PROC , 44the returned data pointer is invalid. 45.Sh RETURN VALUES 46The 47.Fn Pstatus 48function always returns a pointer to the process's status. 49.Sh INTERFACE STABILITY 50.Sy Uncommitted 51.Sh MT-LEVEL 52See 53.Sy LOCKING 54in 55.Xr libproc 3LIB . 56.Sh SEE ALSO 57.Xr libproc 3LIB , 58.Xr Prelease 3PROC , 59.Xr proc 4 60