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
       returned by a successful create_pset() call.  A second argument may be required if there are threads or processors assigned to the  proces-
       sor 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  pro-
       cessor 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) delim off

																   destroy_pset(3)