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 PSYNC 3PROC 16 .Os 17 .Sh NAME 18 .Nm Psync , 19 .Nm Lsync 20 .Nd synchronize cached tracing flags and modifications 21 .Sh SYNOPSIS 22 .Lb libproc 23 .In libproc.h 24 .Ft void 25 .Fo Psync 26 .Fa "struct ps_prochandle *P" 27 .Fc 28 .Ft void 29 .Fo Lsync 30 .Fa "struct ps_lwphandle *L" 31 .Fc 32 .Sh DESCRIPTION 33 The 34 .Fn Psync 35 function synchronizes modifications to the process handle 36 .Fa P 37 back to the underlying active process. 38 The 39 .Fn Psync 40 function ensures that any outstanding process holds, register 41 modifications, signal injections, and modifications to the various fault 42 and system call tracing flags are taken care of. 43 .Pp 44 Normally this function is not required as other library routines take 45 care of synchronizing this state out to the process when it is required. 46 If the underlying /proc file system routines are used outside of the 47 library, calling this function may be required. 48 .Pp 49 The 50 .Fn Psync 51 function is only meaningful for active processes. 52 It will do nothing on process handles that refer to core files, zombie 53 processes, and ELF objects. 54 .Pp 55 The 56 .Fn Lsync 57 function is equivalent to the 58 .Fn Psync 59 function, except rather than operating on the entire process and its 60 representative thread, it instead operates on the thread handle 61 .Fa L . 62 .Sh INTERFACE STABILITY 63 .Sy Uncommitted 64 .Sh MT-LEVEL 65 See 66 .Sy LOCKING 67 in 68 .Xr libproc 3LIB . 69 .Sh SEE ALSO 70 .Xr libproc 3LIB , 71 .Xr Pfault 3PROC , 72 .Xr Pputareg 3PROC , 73 .Xr Psetfault 3PROC , 74 .Xr Psetsignal 3PROC , 75 .Xr Psetsysentry 3PROC , 76 .Xr Psetsysexit 3PROC , 77 .Xr Psignal 3PROC , 78 .Xr Psysentry 3PROC , 79 .Xr Psysexit 3PROC , 80 .Xr proc 4