Query: pthread_nsg_get
OS: osf1
Section: 3
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
pthread_nsg_get(3) Library Functions Manual pthread_nsg_get(3)NAMEpthread_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 );PARAMETERSSpecifies 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.DESCRIPTIONThe 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.RESTRICTIONSThe 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 VALUESSuccess. 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.ERRORSNone.SEE ALSOFunctions: nsg_attach_pid(3), nsg_get(3), numa_intro(3), pthread_nsg_attach(3) Files: numa_types(4) pthread_nsg_get(3)