mpctl.2 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

mpctl(2) mpctl(2)

default, optimal policy in determining where the newly created LWP will be

launched. The existing binding of the LWP is not changed. The ldom argument

is ignored.

To change the processor assignment, locality domain assignment, or launch policy of another process, the

caller must either have the same effective user ID as the target process, or have the

PRIV_MPCTL

privilege.

Security Restrictions

Some or all of the actions associated with this system call require the

MPCTL privilege. Processes owned

by the superuser have this privilege. Processes owned by other users may have this privilege, depending

on system conﬁguration. See privileges (5) for more information about privileged access on systems that

support ﬁne-grained privileges.

RETURN VALUES

mpctl() fails, -1 is returned. If

mpctl is successful, the value returned is as speciﬁed for that

command/option.

NOTE: In some cases a negative number other than

-1 may be returned that indicates a successful

return.

ERRORS

In general,

mpctl() fails if one or more of the following is true:

[EACCES] pid or lwpid identiﬁes a process or LWP that is not visible to the calling thread.

[EINVAL] request is an illegal number.

[EINVAL] request is MPC_GETNEXTSPU

or MPC_GETNEXTSPU_SYS and spu identiﬁes the

last processor. Or request is

MPC_GETNEXTLDOM

or MPC_GETNEXTLDOM_SYS

and ldom identiﬁes the last locality domain. Or request is

MPC_GETNEXTPROXIMATESPU

or MPC_GETNEXTPROXIMATESPU_SYS

and spu

identiﬁes the last proximate spu.

[EINVAL] request is

MPC_GETNUMPROXIMATESPUS

MPC_GETNUMPROXIMATESPUS_SYS

or MPC_GETFIRSTPROXIMATESPU

MPC_GETFIRSTPROXIMATESPU_SYS

and spu is not enabled.

[EINVAL] request is to bind a process or an LWP to a processor or locality domain that is not

in the processor set of the speciﬁed process or LWP.

[EPERM] request is

MPC_SETPROCESS

, MPC_SETPROCESS_FORCE,orMPC_SETLDOM,

spu is not

MPC_SPUNOCHANGE

or MPC_LDOMNOCHANGE, pid identiﬁes another

process, and the caller does not have the same effective user ID of the target process

or does not have the

PRIV_MPCTL privilege.

[EPERM] request is

MPC_SETPROCESS_RR

, MPC_SETPROCESS_FILL,

MPC_SETPROCESS_PACKED, MPC_SETPROCESS_LEASTLOAD

MPC_SETPROCESS_RR_TREE, MPC_SETPROCESS_FILL_TREE

,or

MPC_SETPROCESS_NONE, pid identiﬁes another process, and the caller does not

have the same effective user ID of the target process, or does not have the

PRIV_MPCTL privilege.

[ESRCH] pid or lwpid identiﬁes a process or LWP that does not exist.