Man Pages

---

Back to Software Index  Manpage Top Level

Name

Synopsis

#include <sys/types.h>
#include <sys/processor.h>
#include <sys/procset.h>

Description

The LWP or set of LWP s specified by idtype and id are bound to the processor specified by processorid. Additionally, if obind is not NULL , the processorid_t variable pointed to by obind will be set to the previous binding of one of the specified LWP s, or to PBIND_NONE if the selected LWP was not bound.

If idtype is P_PID , the binding effects all LWP s of the process with process ID (PID ) id.

If idtype is P_LWPID , the binding effects the LWP of the current process with LWP ID id.

If id is P_MYID , the specified LWP or process is the current one.

If processorid is PBIND_NONE , the processor bindings of the specified LWP s are cleared.

If processorid is PBIND_QUERY , the processor bindings are not changed.

The effective user of the calling process must be super-user, or its real or effective user ID must match the real or effective user ID of the LWP s being bound. If the calling process does not have permission to change all of the specified LWP s, the bindings of the LWP s for which it does have permission will be changed even though an error is returned.

Return Values

processor_bind returns 0 if successful; otherwise, -1 is returned and errno is set to reflect the error.

Errors

ESRCH

No processes or LWP s were found to match the criteria specified by idtype and id.

EINVAL

An non-existent or offline processor was specified.

EINVAL

idtype was not P_PID or P_LWPID .

EFAULT

The location pointed to by obind was not NULL and not writable by the user.

EPERM

The effective user of the calling process is not super-user, and its real or effective user ID does not match the real or effective user ID of one of the LWP s being bound.

See Also

Table of Contents

• Name
• Synopsis
• Description
• Return Values
• Errors
• See Also