Index for Section 3

Alphabetical listing for D

Bottom of page

destroy_pset(3)
NAME
  destroy_pset - Destroys a processor set

SYNOPSIS
  #include <sys/types.h>
  #include <sys/processor.h>

  int destroy_pset(
	  int pset_id,
	  [1 | 0] );

LIBRARY
  Pset Library (libpset)

  Mach Library (libmach)

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.

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.

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

FILES
  /var/adm/wtmp

SEE ALSO
  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