NAME    [Toc]    [Back]

       nsg_get_pids  - Return a list of a NUMA Scheduling Group's
       process identifiers (libnuma library)

SYNOPSIS    [Toc]    [Back]

       #include <numa.h>

       int nsg_get_pids(
               nsgid_t nsg,
               pid_t *pidlist,
               int numpids );

PARAMETERS    [Toc]    [Back]

       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
       pidlist.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Functions: nsg_attach_pid(3), nsg_get(3), nsg_get_nsgs(3),
       numa_intro(3)

       Files: numa_types(4)



                                                  nsg_get_pids(3)