*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> nsg_get_pids (3)              



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

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

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),

       Files: numa_types(4)

[ Back ]
 Similar pages
Name OS Title
nsg_detach_pid Tru64 Attaches a process to, or detaches a process from a NUMA Scheduling Group (libnuma library)
nsg_attach_pid Tru64 Attaches a process to, or detaches a process from a NUMA Scheduling Group (libnuma library)
nsg_init Tru64 Look up or create a NUMA Scheduling Group (libnuma library)
nsg_destroy Tru64 Destroys a NUMA Scheduling Group (libnuma library)
nsg_get Tru64 Query status of a NUMA Scheduling Group (libnuma library)
nsg_set Tru64 Set NUMA Scheduling Group owner and permissions (libnuma library)
nsg_get_nsgs Tru64 Returns a list NUMA Scheduling Groups (libnuma library)
pthread_nsg_get Tru64 Gets the list of threads in a NUMA Scheduling Group (libpthread library)
numa_scheduling_groups Tru64 HP Tru64 UNIX NUMA Scheduling Groups description (libnuma library)
numa_query_pid Tru64 Returns NUMA-related information for the specified process identifier (libnuma library)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service