Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for pset_destroy (opensolaris section 2)

pset_create(2)				   System Calls 			   pset_create(2)

NAME
       pset_create, pset_destroy, pset_assign - manage sets of processors

SYNOPSIS
       #include <sys/pset.h>

       int pset_create(psetid_t *newpset);

       int pset_destroy(psetid_t pset);

       int pset_assign(psetid_t pset, processorid_t cpu, psetid_t *opset);

DESCRIPTION
       These functions control the creation and management of sets of processors.  Processor sets
       allow a subset of the system's processors to be set aside for exclusive use  by	specified
       LWPs  and  processes. The binding of LWPs and processes to processor sets is controlled by
       pset_bind(2).

       The pset_create() function creates an empty processor set that contains no processors.  On
       successful return, newpset will contain the ID of the new processor set.

       The  pset_destroy()  function  destroys	the processor set pset, releasing its constituent
       processors and processes. If pset is PS_MYID, the processor set to  which  the  caller  is
       bound is destroyed.

       The  pset_assign() function assigns the processor cpu to the processor set pset. A proces-
       sor that has been assigned to a processor set will run only LWPs and processes  that  have
       been  explicitly  bound to that processor set, unless another LWP requires a resource that
       is only available on that processor.

       On successful return, if opset is non-null, opset will contain the processor set ID of the
       former processor set of the processor.

       If pset is PS_NONE, pset_assign() releases processor cpu from its current processor set.

       If pset is PS_QUERY, pset_assign() makes no change to processor sets, but returns the cur-
       rent processor set ID of processor cpu in opset.

       If pset is PS_MYID, processor cpu is assigned to the processor set  to  which  the  caller
       belongs.  If the caller does not belong to a processor set, processor cpu is released from
       its current processor set.

       These functions are restricted to privileged processes, except for pset_assign() when pset
       is PS_QUERY.

RETURN VALUES
       Upon  successful completion, these functions return 0. Otherwise, -1 is returned and errno
       is set to indicate the error.

ERRORS
       These functions will fail if:

       EBUSY	  The processor could not be moved to the specified processor set.

       EFAULT	  The location pointed to by newpset was not writable by the user, or  the  loca-
		  tion pointed to by opset was not NULL and not writable by the user.

       EINVAL	  The  specified  processor  does  not exist, the specified processor  is not on-
		  line, or an invalid processor set was specified.

       ENOMEM	  There was insufficient space for pset_create to create a new processor set.

       ENOTSUP	  The pools facility is active. See pooladm(1M)  and  pool_set_status(3POOL)  for
		  information about enabling and disabling the pools facility.

       EPERM	  The {PRIV_SYS_RES_CONFIG} privilege is not asserted in the effective set of the
		  calling process.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Committed 		   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Async-Signal-Safe 	   |
       +-----------------------------+-----------------------------+

SEE ALSO
       pooladm(1M),  psradm(1M),   psrinfo(1M),   psrset(1M),	p_online(2),   processor_bind(2),
       pset_bind(2),  pset_info(2),  pool_set_status(3POOL),  pset_getloadavg(3C), attributes(5),
       privileges(5)

NOTES
       The processor set type of PS_SYSTEM is no longer supported.

       Processors with LWPs bound to them using processor_bind(2) cannot be  assigned  to  a  new
       processor set. If  this is attempted, pset_assign() will fail and set errno to EBUSY.

SunOS 5.11				   22 Feb 2008				   pset_create(2)


All times are GMT -4. The time now is 04:47 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password