unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

pset_info(2)                     System Calls                     pset_info(2)



NAME
       pset_info - get information about a processor set

SYNOPSIS
       #include <sys/pset.h>

       int  pset_info(psetid_t pset, int *type, uint_t *numcpus, processorid_t
       *cpulist);

DESCRIPTION
       The pset_info() function returns information on the processor set pset.

       If type is non-null, then on successful completion the type of the pro-
       cessor  set will be stored in the location pointed to by type. The only
       type supported for active processor sets is PS_PRIVATE.

       If numcpus is non-null, then on successful  completion  the  number  of
       processors  in the processor set will be stored in the location pointed
       to by numcpus.

       If numcpus and cpulist are both non-null, then cpulist points to a buf-
       fer  where  a list of processors assigned to the processor set is to be
       stored, and numcpus points to the maximum number of processor  IDs  the
       buffer can hold. On successful completion, the list of processors up to
       the maximum buffer size is stored in the buffer pointed to by cpulist.

       If pset is PS_NONE, the list of processors not assigned to any  proces-
       sor  set  will  be  stored in the buffer pointed to by cpulist, and the
       number of such processors will be stored in the location pointed to  by
       numcpus.  The location pointed to by type will be set to PS_NONE.

       If  pset  is  PS_MYID,  the  processor  list  and  number of processors
       returned will be those of the processor set  to  which  the  caller  is
       bound.  If  the caller is not bound to a processor set, the result will
       be equivalent to setting pset to PS_NONE.

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

ERRORS
       The pset_info() function will fail if:

       EFAULT          The  location  pointed  to by type, numcpus, or cpulist
                       was not null and not writable by the user.



       EINVAL          An invalid processor set ID was specified.

                       The caller is in a non-global zone, the pools  facility
                       is  active,  and  the  processor is not a member of the
                       zone's pool's processor set.



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


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE Interface StabilityStable
       MT-LevelAsync-Signal-Safe


SEE ALSO
       pooladm(1M), psrinfo(1M), psrset(1M),  zoneadm(1M),  processor_info(2),
       pset_assign(2),    pset_bind(2),    pset_create(2),    pset_destroy(2),
       pset_getloadavg(3C), attributes(5)

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



SunOS 5.10                        28 Jun 2004                     pset_info(2)