DG/UX R4.11MU05                        dg_pthread_group_get_lwp_group_id(3T)


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

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

       dg_lwp_group_id_t
       dg_pthread_group_get_lwp_group_id(dg_pthread_group_t thread_group);

   where:
       thread_group
              Thread group ID to be translated

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

       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 dg_cpu_set_affinity(3T).

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

SEE ALSO
       dg_pthread_group_create(3T), dg_pthread_group_self(3T),
       dg_cpu_set_affinity(3T), dg_cpu_get_affinity(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/_int__d6_pthread.h>, <sys/dg_lwp.h>, <sys/dg_cpu.h>,
       and dg_pthread_group_self(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)