Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

nsg_get_nsgs(3) [osf1 man page]

nsg_get_nsgs(3) 					     Library Functions Manual						   nsg_get_nsgs(3)

NAME
nsg_get_nsgs - Returns a list NUMA Scheduling Groups (libnuma library) SYNOPSIS
#include <numa.h> int nsg_get_nsgs( nsgid_t *nsgidlist, int numnsgs ); PARAMETERS
Points to an array that receives the NUMA Scheduling Group (NSG) identifiers. Specifies the maximum number of nsgid_t entries in nsgidlist. DESCRIPTION
The nsg_get_nsgs() function returns a list of NSGs that are active on the system in the buffer pointed to by nsgidlist. The argument numnsgs specifies the number of nsgid_t entries that can be accommodated in the buffer. The list is terminated by a NULL entry. The required size of the buffer can be obtained by first calling nsg_get_nsgs() with a numnsgs set to zero. In this case, the number of NSGs active on the system will be reported in nsgidlist[0]. As always, on a dynamically changing system, the number of entries may be dif- ferent by the time it is used for the numnsgs argument to the second nsg_get_nsgs() call. 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 each NSG. If the caller does not have the proper permission, that NSG will not be reported in nsgidlist. RETURN VALUES
Success. However, if the errno is set to E2BIG, more NSGs than numnsgs were available. Failure. In this case, errno is set to indicate the error. ERRORS
If the nsg_get_nsgs() function fails, it sets errno to the following value for the specified condition: The nsgidlist argument points to an invalid address. SEE ALSO
Functions: nsg_attach_pid(3), nsg_get(3), nsg_get_pids(3), numa_intro(3) Files: numa_types(4) nsg_get_nsgs(3)

Check Out this Related Man Page

nsg_get_pids(3) 					     Library Functions Manual						   nsg_get_pids(3)

NAME
nsg_get_pids - Return a list of a NUMA Scheduling Group's process identifiers (libnuma library) SYNOPSIS
#include <numa.h> int nsg_get_pids( nsgid_t nsg, pid_t *pidlist, int numpids ); PARAMETERS
Specifies the NUMA Scheduling Group (NSG). Specifies an array receiving the process identifiers of the specified NSG. Specifies the maxi- mum number of pid_t entries in pidlist. DESCRIPTION
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 argu- ment 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
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. 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
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
Functions: nsg_attach_pid(3), nsg_get(3), nsg_get_nsgs(3), numa_intro(3) Files: numa_types(4) nsg_get_pids(3)
Man Page