destroy_pset man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

destroy_pset(3)						       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
       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 procesā€
       sor 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)

							       destroy_pset(3)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net