dg_pthread_group_get_lwp_group_id(3T)



SDK R4.11                              dg_pthread_group_get_lwp_group_id(3T)


NAME
       dgpthreadgroupgetlwpgroupid - translate a thread group ID to an
       LWP group ID

SYNOPSIS
       #include <pthread.h>
       #include <sys/dglwp.h>

       dglwpgroupidt
       dgpthreadgroupgetlwpgroupid(dgpthreadgroupt threadgroup);

   where:
       threadgroup
              Thread group ID to be translated

DESCRIPTION
       This function returns the kernel-level LWP group ID corresponding to
       the thread group ID given by threadgroup.

       In DG/UX, every thread group has a corresponding kernel-level LWP
       group.  Hence it is possible to retrieve the LWP group ID for a given
       thread group ID.

       LWP group IDs are typically used in the CPU affinity-related calls,
       such as dgcpusetaffinity(3T).

DIAGNOSTICS
   Returns
       The dgpthreadgroupgetlwpgroupid() function returns the
       corresponding LWP group ID.

SEE ALSO
       dgpthreadgroupcreate(3T), dgpthreadgroupself(3T),
       dgcpusetaffinity(3T), dgcpugetaffinity(3T).

NOTES
       In the current DG/UX implementation, the thread group ID is the same
       as the corresponding LWP group ID.  However, applications should not
       make any assumptions about this relationship holding up in the
       future.

       Refer to <sys/intd6pthread.h>, <sys/dglwp.h>, <sys/dgcpu.h>,
       and dgpthreadgroupself(3T) NOTES for a more detailed discussion on
       proper use of thread group IDs and LWP group IDs.


Licensed material--property of copyright holder(s)
Museum
