nsg_get_pids(3)nsg_get_pids(3)NAMEnsg_get_pids - Return a list of a NUMA Scheduling Group's process iden‐
tifiers (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 receiv‐
ing 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 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 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 structure;
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 fol‐
lowing 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)