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)