Content-type: text/html Man page of destroy_pset

destroy_pset

Section: C Library Functions (3)
Index Return to Main Contents
 

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


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
EXAMPLES
RETURN VALUES
FILES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:32 GMT, October 02, 2010