|
|
HP-UX Reference > Ppset_destroy(2)HP-UX 11i Version 2: December 2007 Update |
|
NAMEpset_destroy() — destroy a processor set DESCRIPTIONThe pset_destroy() function destroys the processor set pset, releasing all constituent processors and processes by default. The processors and processes are reassigned to the system default processor set. Once destroyed, the pset identifier becomes available for new processor sets that may be created in the future. The behavior when attempting to destroy a non-empty processor set may be controlled by changing the PSET_ATTR_NONEMPTY attribute of the processor set through the pset_setattr() function. See pset_getattr(2). The following values are supported for the PSET_ATTR_NONEMPTY attribute:
If the threads and processes being reassigned to the default processor set have some binding to a processor or a locality domain in the pset being destroyed, their binding is reassigned to a processor or a locality domain in the system default processor set. A user with the PSET privilege or a user with WRITE permission on the pset may destroy the processor set pset. The system default processor set PS_DEFAULT may never be destroyed. Security RestrictionsSome or all of the actions associated with this system call require the PSET privilege. Processes owned by the superuser have this privilege. Processes owned by other users may have this privilege, depending on system configuration. See privileges(5) for more information about privileged access on systems that support fine-grained privileges. EXAMPLESDestroy a processor set with the processor set ID of pset. #include <sys/pset.h> int ret; psetid_t pset; if ((ret = pset_destroy(pset)) < 0) { perror("pset_destroy"); } RETURN VALUEpset_destroy returns zero on successful completion. Otherwise, -1 is returned and errno is set to indicate the error. ERRORSpset_destroy fails if one or more of the following is true:
|
|