pthread_nsg_get(3)					     Library Functions Manual						pthread_nsg_get(3)

NAME

       pthread_nsg_get - Gets the list of threads in a NUMA Scheduling Group (libpthread library)

SYNOPSIS

       #include <numa.h>

       int pthread_nsg_get(
	       nsgid_t nsg,
	       pthread_t *list,
	       long size );

PARAMETERS

       Specifies the NUMA Scheduling Group (NSG) from which to retrieve the list of threads.  Specifies the address of the array of thread identi-
       fiers where the list of threads will be written.  Specifies the size (in number of thread identifiers) of  the  array  where  the  list	of
       threads will be written.

DESCRIPTION

       The  pthread_nsg_get()  returns	into the buffer pointed to by list an array of nsg_thread structures containing the process ids and thread
       indexes for all threads attached to the specified NSG. The list argument specifies the number of nsg_thread structures that the array  must
       accommodate.

       To  obtain  the	value  for  size,  the	application  can  first  call pthread_nsg_get() with list set to null and read in the value of the
       nsg_nthread member in the nsgid_ds structure that the call returns.  On the second call to  pthread_nsg_get(),  the  application  uses  the
       nsg_nthread value for size and includes the appropriate value for list.

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.  Failure. In this case, the returned integer indicates the type of error. Possible errors are as follows: The calling process does
       not have read permission on the NSG.  The nsg argument does not specify a valid NSG identifier, or the nsg argument is not a valid address.

ERRORS

       None.

SEE ALSO

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

       Files: numa_types(4)

																pthread_nsg_get(3)