Manual Page Result
0
Command: destroy_pset | Section: 3 | Source: Digital UNIX | File: destroy_pset.3.gz
destroy_pset(3) Library Functions Manual destroy_pset(3)
NAME
destroy_pset - Destroys a processor set
LIBRARY
Pset Library (libpset.a)
Mach Library (libmach.a)
SYNOPSIS
#include <sys/types.h> #include <sys/processor.h>
int destroy_pset(
int pset_id, [1 | 0]);
PARAMETERS
Specifies the identification number for the processor set that you want
to destroy. The pset_id processor set identification number is re-
turned by a successful create_pset() call. A second argument may be
required if there are threads or processors assigned to the processor
set. A value of 1 will force the destruction of the pset. A value of
0 will not force destruction automatically but will first prompt the
user.
DESCRIPTION
The destroy_pset function destroys a processor set. A processor that
belongs to a destroyed processor set is returned to the default proces-
sor set. You must have root privileges.
EXAMPLES
The following is example code for pset_destroy.c using the destroy_pset
call: retval = destroy_pset(pset_id, 0);
if (retval == PROCESSOR_SET_ACTIVE) {
printf ("processor set %d has active ", pset_id);
printf ("processors/tasks/threads assigned to it.0);
printf ("destroy anyway? (y/n): ");
while ((char)c != 'y' && (char)c != 'n')
c = getchar();
if ((char)c == 'y') {
retval = destroy_pset(pset_id, 1);
if (retval != KERN_SUCCESS) {
print_pset_error(retval);
RETURN VALUES
If the destroy_pset function succeeds, it returns a zero (0). If it
fails, it returns a negative number. Use this number and the
print_pset_error(3) function to print a message that describes the er-
ror.
Processor set destruction is logged in the /var/adm/wtmp file.
FILES
/var/adm/wtmp
RELATED INFORMATION
create_pset(3), assign_cpu_to_pset(3), assign_pid_to_pset(3),
print_pset_error(3), processor_sets(4), pset_create(1) delim off
destroy_pset(3)