Index for Section 3

Alphabetical listing for D

Bottom of page

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
  pset_id   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.

  <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)

Index for Section 3

Alphabetical listing for D

Top of page