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

pset_idSpecifies the identification number for the processor set that you want to destroy.   The pset_id processor set identification number is returned by a successful create_pset() call. 

<number>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 processor 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 error. 

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)