pthread_nsg_get man page on DigitalUNIX

Printed from http://www.polarhome.com/service/man/?qf=pthread_nsg_get&af=0&tf=2&of=DigitalUNIX

pthread_nsg_get(3)					    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	 argu‐
       ment  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 structure;
       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)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net