nsg_get_pids - Return a list of a NUMA Scheduling Group's
process identifiers (libnuma library)
int numpids );
Specifies the NUMA Scheduling Group (NSG). Specifies an
array receiving the process identifiers of the specified
NSG. Specifies the maximum number of pid_t entries in
The nsg_get_pids() function returns a list of process IDs
of processes attached to the NSG in the buffer pointed to
by pidlist. The argument numpids specifies the number of
process IDs that can be accommodated in the buffer. The
list is terminated by a NULL entry. The required size of
the buffer can be obtained from the nsg_nattach member of
the nsgid_ds structure returned by the nsg_get() function.
As always, on a dynamically changing system, the number of
entries may be different by the time nsg_get_pids() is
The effective user ID of the calling process must be equal
to the value of nsg_perm.cuid or nsg_perm.uid in the associated
nsgid_ds structure; or the calling process must
have read permissions to the NSG.
Success. However, if errno is set to E2BIG on a successful
return, more processes than numpids were available. Failure.
In this case, errno is set to indicate the error.
If the nsg_get_pids() function fails, it sets errno to one
of the following values for the specified condition: The
calling process does not have read permission. The
pidlist argument specifies an invalid address. The NSG
argument does not specify a valid NSG identifier.
Functions: nsg_attach_pid(3), nsg_get(3), nsg_get_nsgs(3),
[ Back ]