Print this page
6534 Improve processor_bind(2) EINVAL description
Reviewed by: Richard Lowe <richlowe@richlowe.net>
Reviewed by: Garrett D'Amore <garrett@damore.org>


  64        bound.  If the calling process does not have permission to change all
  65        of the specified LWPs, the bindings of the LWPs for which it does have
  66        permission will be changed even though an error is returned.
  67 
  68 
  69        Processor bindings are inherited across fork(2) and exec(2).
  70 
  71 RETURN VALUES
  72        Upon successful completion, 0 is returned.  Otherwise, -1 is returned
  73        and  errno is set to indicate the error.
  74 
  75 ERRORS
  76        The processor_bind() function will fail if:
  77 
  78        EFAULT
  79                   The location pointed to by  obind was not NULL and not
  80                   writable by the user.
  81 
  82 
  83        EINVAL
  84                   The specified processor is not on-line, or the idtype
  85                   argument was not P_PID, P_LWPID, P_PROJID, P_TASKID, P_CTID,
  86                   or P_ZONEID.
  87 
  88                   The caller is in a non-global zone, the pools facility is
  89                   active, and the processor is not a member of the zone's
  90                   pool's processor set.
  91 


  92 

  93        ENOTSUP
  94                   Binding a system process to a processor set is not
  95                   supported.
  96 
  97 
  98        EPERM
  99                   The {PRIV_PROC_OWNER} privilege is not asserted in the
 100                   effective set of the calling process and its real or
 101                   effective user ID does not match the real or effective user
 102                   ID of one of the LWPs being bound.
 103 
 104 
 105        ESRCH
 106                   No processes, LWPs, or tasks were found to match the
 107                   criteria specified by idtype and  id.
 108 
 109 
 110 ATTRIBUTES
 111        See attributes(5) for descriptions of the following attributes:
 112 
 113 
 114 
 115 
 116        +--------------------+-------------------+
 117        |  ATTRIBUTE TYPE    |  ATTRIBUTE VALUE  |
 118        +--------------------+-------------------+
 119        |Interface Stability | Committed         |
 120        +--------------------+-------------------+
 121        |MT-Level            | Async-Signal-Safe |
 122        +--------------------+-------------------+
 123 
 124 SEE ALSO
 125        pooladm(1M), psradm(1M), psrinfo(1M), zoneadm(1M), exec(2), fork(2),
 126        p_online(2), pset_bind(2), sysconf(3C), process(4), project(4),
 127        attributes(5), privileges(5)
 128 
 129 
 130 
 131                                 March 13, 2009               PROCESSOR_BIND(2)


  64        bound.  If the calling process does not have permission to change all
  65        of the specified LWPs, the bindings of the LWPs for which it does have
  66        permission will be changed even though an error is returned.
  67 
  68 
  69        Processor bindings are inherited across fork(2) and exec(2).
  70 
  71 RETURN VALUES
  72        Upon successful completion, 0 is returned.  Otherwise, -1 is returned
  73        and  errno is set to indicate the error.
  74 
  75 ERRORS
  76        The processor_bind() function will fail if:
  77 
  78        EFAULT
  79                   The location pointed to by obind was not NULL and not
  80                   writable by the user.
  81 
  82 
  83        EINVAL
  84                   The processor is not on-line.


  85 
  86                   The LWP is bound to a processor set or resource pool for
  87                   which the processor is not a member.

  88 
  89                   The idtype argument is not P_PID, P_LWPID, P_PROJID,
  90                   P_TASKID, P_CTID, or P_ZONEID.
  91 
  92 
  93        ENOTSUP
  94                   Binding a system process to a processor set is not
  95                   supported.
  96 
  97 
  98        EPERM
  99                   The {PRIV_PROC_OWNER} privilege is not asserted in the
 100                   effective set of the calling process and its real or
 101                   effective user ID does not match the real or effective user
 102                   ID of one of the LWPs being bound.
 103 
 104 
 105        ESRCH
 106                   No processes, LWPs, or tasks were found to match the
 107                   criteria specified by idtype and id.
 108 
 109 
 110 ATTRIBUTES
 111        See attributes(5) for descriptions of the following attributes:
 112 
 113 
 114 
 115 
 116        +--------------------+-------------------+
 117        |  ATTRIBUTE TYPE    |  ATTRIBUTE VALUE  |
 118        +--------------------+-------------------+
 119        |Interface Stability | Committed         |
 120        +--------------------+-------------------+
 121        |MT-Level            | Async-Signal-Safe |
 122        +--------------------+-------------------+
 123 
 124 SEE ALSO
 125        pooladm(1M), psradm(1M), psrinfo(1M), zoneadm(1M), exec(2), fork(2),
 126        p_online(2), pset_bind(2), sysconf(3C), process(4), project(4),
 127        attributes(5), privileges(5)
 128 
 129 
 130 
 131                                December 27, 2015             PROCESSOR_BIND(2)