8158 Want named threads API
9857 proc manpages should have LIBRARY section

          --- old/usr/src/man/man3proc/Psetzoneid.3proc.man.txt
          +++ new/usr/src/man/man3proc/Psetzoneid.3proc.man.txt
   1    1  PSETZONEID(3PROC)      Process Control Library Functions     PSETZONEID(3PROC)
   2    2  
   3    3  NAME
   4    4       Psetzoneid - change processes zone id
   5    5  
   6      -SYNOPSIS
        6 +LIBRARY
   7    7       Process Control Library (libproc, -lproc)
        8 +
        9 +SYNOPSIS
   8   10       #include <libproc.h>
   9   11  
  10   12       int
  11   13       Psetzoneid(struct ps_prochandle *P, zoneid_t zoneid);
  12   14  
  13   15  DESCRIPTION
  14   16       The Psetzoneid() function moves the process handle P into the zone
  15   17       specified by zoneid.  A process that is in the non-global zone may only
  16   18       move between the global zone and its original zone.  A process that is in
  17   19       the global zone may not use this interface to enter a non-global zone.

  18   20       This function will fail if called from a non-global zone.  This function
  19   21       only manipulates the processes credentials.
  20   22  
  21   23       Care should be taken when moving a process around temporarily, such that
  22   24       if the process that is manipulating P dies, it does not cause P to resume
  23   25       running while still in the global zone.  It is suggested that the PR_KLC
  24   26       flag is set with Psetflags(3PROC) which will cause the process to
  25   27       terminate if the process that holds P unexpectedly terminates.  See
  26   28       proc(4) for more information on the PR_KLC flag.
  27   29  
  28   30       Note, only active processes may change their zone.  It is an error to
  29   31       call this function on process handles that correspond to core files,
  30   32       zombie processes, or files.
  31   33  
  32   34  RETURN VALUES
  33   35       Upon successful completion, the Psetzoneid() function returns 0 and
  34   36       changes the zone for P.  Otherwise, -1 is returned and errno is set.
  35   37  
  36   38  ERRORS
  37   39       For a full list of possible errors see the DIAGNOSTICS section in
  38   40       proc(4).
  39   41  
  40   42       The Psetzoneid() function will fail if:
  41   43  
  42   44       EINVAL             zoneid does not correspond to an existing zone or the
  43   45                          zone id is not the global zone or the original zone of
  44   46                          P.
  45   47  
  46   48       EPERM              The caller does not hold the required privileges for
  47   49                          zone configuration.
  48   50  
  49   51  INTERFACE STABILITY
  50   52       Uncommitted
  51   53  
  52   54  MT-LEVEL
  53   55       See LOCKING in libproc(3LIB).
  54   56  
  55   57  SEE ALSO
  56   58       libproc(3LIB), proc(4), privileges(5), zones(5)
  57   59  
  58   60  illumos                          May 11, 2016                          illumos

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX