nsg_get_pids(3) Library Functions Manual nsg_get_pids(3)
NAME
nsg_get_pids - Return a list of a NUMA Scheduling Group's process identifiers (libnuma library)
SYNOPSIS
#include <numa.h>
int nsg_get_pids(
nsgid_t nsg,
pid_t *pidlist,
int numpids );
PARAMETERS
Specifies the NUMA Scheduling Group (NSG). Specifies an array receiving the process identifiers of the specified NSG. Specifies the maxi-
mum number of pid_t entries in pidlist.
DESCRIPTION
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 argu-
ment 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 called.
RESTRICTIONS
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 struc-
ture; or the calling process must have read permissions to the NSG.
RETURN VALUES
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.
ERRORS
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.
SEE ALSO
Functions: nsg_attach_pid(3), nsg_get(3), nsg_get_nsgs(3), numa_intro(3)
Files: numa_types(4)
nsg_get_pids(3)
