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, u_int ∗numcpus, processorid_t ∗cpulist);

DESCRIPTION

pset_info returns information on the processor set pset.

If type is non-NULL, then on successful completion the type of the processor set will be stored in the location pointed to by type. Processor set types can have the following values:

PS_SYSTEM The processor set was created by the system. Processor sets of this type cannot be modified or removed by the user, but LWPs and processes can be bound to them using pset_bind(2).

PS_PRIVATE The processor set was created by pset_create(2) and can be modified by pset_assign(2) and removed by pset_destroy(2). LWPs and processes can also be bound to this processor set using pset_bind.

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 buffer where a list of processors assigned to the processor set is to be stored, and numcpus points to the maximum number of processor ID’s 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.

RETURN VALUES

pset_info returns 0 if successful; otherwise, −1 is returned and errno is set to reflect the error.

ERRORS

EINVAL An invalid processor set ID was specified.

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

Museum