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

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



NAME    [Toc]    [Back]

       nsg_get_nsgs - Returns a list NUMA Scheduling Groups (libnuma

SYNOPSIS    [Toc]    [Back]

       #include <numa.h>

       int nsg_get_nsgs(
               nsgid_t *nsgidlist,
               int numnsgs );

PARAMETERS    [Toc]    [Back]

       Points to an array that receives the NUMA Scheduling Group
       (NSG)   identifiers.   Specifies  the  maximum  number  of
       nsgid_t entries in nsgidlist.

DESCRIPTION    [Toc]    [Back]

       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 different by
       the time it is used for the numnsgs argument to the second
       nsg_get_nsgs() call.

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 each NSG. If the caller does not
       have the proper permission, that NSG will not be  reported
       in nsgidlist.

RETURN VALUES    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Functions: nsg_attach_pid(3), nsg_get(3), nsg_get_pids(3),

       Files: numa_types(4)

[ Back ]
 Similar pages
Name OS Title
numa_scheduling_groups Tru64 HP Tru64 UNIX NUMA Scheduling Groups description (libnuma library)
nsg_get_pids Tru64 Return a list of a NUMA Scheduling Group's process identifiers (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)
numa_query_pid Tru64 Returns NUMA-related information for the specified process identifier (libnuma library)
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)
pthread_nsg_get Tru64 Gets the list of threads in a NUMA Scheduling Group (libpthread library)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service