modules/portlib/src/main/native/thread/shared/hythreadinspect.c File Reference

---

Detailed Description

#include "threaddef.h"

Functions
hythread_monitor_t VMCALL	hythread_monitor_walk (hythread_monitor_t monitor)
	Walk all active monitors.
void *VMCALL	hythread_tls_get (hythread_t thread, hythread_tls_key_t key)
	Get a thread's thread local storage (TLS) value.
UDATA VMCALL	hythread_get_priority (hythread_t thread)
	Return a thread's scheduling priority.
UDATA VMCALL	hythread_get_flags (hythread_t thread, hythread_monitor_t *blocker)
	Return a thread's flags.
char *VMCALL	hythread_monitor_get_name (hythread_monitor_t monitor)
	Return a monitor's name.

---

Function Documentation

UDATA VMCALL hythread_get_flags	(	hythread_t	thread,
		hythread_monitor_t *	blocker
	)

Return a thread's flags.

Parameters:

[in]	thread	(non-NULL)
[in]	blocker	if non-NULL, will be set to the monitor on which the thread is blocked (if any)

Returns:

flags

UDATA VMCALL hythread_get_priority

(

hythread_t

thread

)

Return a thread's scheduling priority.

Parameters:

[in]

thread

(non-NULL)

Returns:

scheduling priority

See also:

hythread_create, hythread_set_priority

char* VMCALL hythread_monitor_get_name

(

hythread_monitor_t

monitor

)

Return a monitor's name.

Parameters:

[in]

monitor

(non-NULL)

Returns:

pointer to the monitor's name (may be NULL)

See also:

hythread_monitor_init_with_name

hythread_monitor_t VMCALL hythread_monitor_walk

(

hythread_monitor_t

monitor

)

Walk all active monitors.

Parameters:

[in]

monitor

If NULL, the first monitor is returned and the monitor pool is locked (thread lib is globally locked) If non-NULL, the next monitor is returned.

Returns:

a pointer to a monitor, or NULL if all monitors walked (and thread lib is globally unlocked).

Note:

As this is currently implemented, this must be called to walk ALL monitors. It can't be used to look for a specific monitor and then quit.

void* VMCALL hythread_tls_get	(	hythread_t	thread,
		hythread_tls_key_t	key
	)

Get a thread's thread local storage (TLS) value.

Parameters:

[in]	thread	a thread
[in]	key	key to have TLS value returned (value returned by hythread_tls_alloc)

Returns:

pointer to location of TLS or NULL on failure.

---