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 PSETFAULT 3PROC 16.Os 17.Sh NAME 18.Nm Psetfault 19.Nd set fault tracing flags 20.Sh SYNOPSIS 21.Lb libproc 22.In libproc.h 23.Ft void 24.Fo Psetfault 25.Fa "struct ps_prochandle *P" 26.Fa "const fltset_t *set" 27.Fc 28.Sh DESCRIPTION 29The 30.Fn Psetfault 31function sets the fault tracing flags on the process handle 32.Fa P 33to 34.Fa set . 35It replaces any existing fault tracing flags on the process. These 36flags indicate which faults cause execution of the thread to stop. 37Allowing another tool, such as a debugger, to act upon the process. 38For more information on faults and the 39.Sy fltset_t 40structure see the 41.Sy PCSFAULT 42section in 43.Xr proc 4 . 44The current fault set for the process may be obtained through the 45.Xr Pfault 3PROC 46function. 47.Pp 48Note, only active processes may have their fault set updated. Process 49handles that refer to core files, zombie processes, and files do not 50have fault tracing flags and this function is a no-op on them. 51.Sh INTERFACE STABILITY 52.Sy Uncommitted 53.Sh MT-LEVEL 54See 55.Sy LOCKING 56in 57.Xr libproc 3LIB . 58.Sh SEE ALSO 59.Xr libproc 3LIB , 60.Xr Pfault 3PROC , 61.Xr proc 4 62