1 PSYNC(3PROC)           Process Control Library Functions          PSYNC(3PROC)
   2 
   3 NAME
   4      Psync, Lsync - synchronize cached tracing flags and modifications
   5 
   6 LIBRARY
   7      Process Control Library (libproc, -lproc)
   8 
   9 SYNOPSIS
  10      #include <libproc.h>
  11 
  12      void
  13      Psync(struct ps_prochandle *P);
  14 
  15      void
  16      Lsync(struct ps_lwphandle *L);
  17 
  18 DESCRIPTION
  19      The Psync() function synchronizes modifications to the process handle P
  20      back to the underlying active process.  The Psync() function ensures that
  21      any outstanding process holds, register modifications, signal injections,
  22      and modifications to the various fault and system call tracing flags are
  23      taken care of.
  24 
  25      Normally this function is not required as other library routines take
  26      care of synchronizing this state out to the process when it is required.
  27      If the underlying /proc file system routines are used outside of the
  28      library, calling this function may be required.
  29 
  30      The Psync() function is only meaningful for active processes.  It will do
  31      nothing on process handles that refer to core files, zombie processes,
  32      and ELF objects.
  33 
  34      The Lsync() function is equivalent to the Psync() function, except rather
  35      than operating on the entire process and its representative thread, it
  36      instead operates on the thread handle L.
  37 
  38 INTERFACE STABILITY
  39      Uncommitted
  40 
  41 MT-LEVEL
  42      See LOCKING in libproc(3LIB).
  43 
  44 SEE ALSO
  45      libproc(3LIB), Pfault(3PROC), Pputareg(3PROC), Psetfault(3PROC),
  46      Psetsignal(3PROC), Psetsysentry(3PROC), Psetsysexit(3PROC),
  47      Psignal(3PROC), Psysentry(3PROC), Psysexit(3PROC), proc(4)
  48 
  49 illumos                          May 11, 2016                          illumos