[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

General Programming Concepts:
Writing and Debugging Programs

Trace Hook IDs: 301 through 315

The following trace hook IDs are stored in the /usr/include/sys/trchkid.h file.

301: HKWD KERN ASSERTWAIT

This event is recorded by the e_assert_wait kernel service.

Recorded Data

e_assert_wait: tid=tid anchor=anchor flag=flag lr=lr
tid Thread ID of the calling kernel thread.
anchor The event_word parameter; the anchor to the list of kernel threads waiting on this event.
flag The interruptible parameter.
lr Value of the link register, specifying the return address of the service.

302: HKWD KERN CLEARWAIT

This event is recorded by the e_clear_wait kernel service.

Recorded Data

e_clear_wait: tid=tid anchor=anchor result=result lr=lr
tid The tid parameter; the thread ID of the kernel thread to be awakened.
anchor Anchor to the event list where the target thread is sleeping.
result The result parameter; the value to return to the awkened thread.
lr Value of the link register, specifying the return address of the service.

303: HKWD KERN THREADBLOCK

This event is recorded by the e_block_thread kernel service.

Recorded Data

e_block_thread: tid=tid anchor=anchor t_flags=t_flags lr=lr
tid Thread ID of the calling kernel thread.
anchor Anchor to the event list where the kernel thread will sleep.
t_flags Flags of the kernel thread.
lr Value of the link register, specifying the return address of the service.

304: HKWD KERN EMPSLEEP

This event is recorded by the e_mpsleep kernel service.

Recorded Data

e_mpsleep: tid=tid anchor=anchor timeout=timeout lock=lock flags=flags lr=lr
tid Thread ID of the calling kernel thread.
anchor The event_word parameter; the anchor to the list of kernel threads waiting on this event.
timeout The timeout parameter; the timeout for the sleep.
lock The lock_word parameter; the lock (simple or complex) to unlock by the kernel service.
flags The flags parameter; the lock and signal handling options.
lr Value of the link register, specifying the return address of the service.

305: HKWD KERN EWAKEUPONE

This event is recorded by the e_wakeup_one kernel service.

Recorded Data

e_wakeup_one: tid=tid anchor=anchor lr=lr
tid Thread ID of the calling kernel thread.
anchor The event_word parameter; the anchor to the list of kernel threads waiting on this event.
lr Value of the link register, specifying the return address of the service.

306: HKWD SYSC CRTHREAD

This event is recorded by the thread_create system call.

Recorded Data

thread_create: pid=pid tid=tid priority=priority policy=policy
pid Process ID of the calling kernel thread's process.
tid Thread ID of the calling kernel thread.
priority Priority of the new kernel thread.
policy Scheduling policy of the new kernel thread.

307: HKWD KERN KTHREADSTART

This event is recorded by the kthread_start kernel service.

Recorded Data

kthread_start: pid=pid tid=tid priority=priority policy=policy func=func
pid Process ID of the calling kernel thread's process.
tid The tid parameter; the thread ID of the kernel thread to start.
priority Priority of the new kernel thread.
policy Scheduling policy of the new kernel thread.
func The i_func parameter, the address of the new kernel thread's entry-point routine.

308 : HKWD SYSC TERMTHREAD

This event is recorded by the thread_terminate system call.

Recorded Data

thread_terminate: pid=pid tid=tid
pid Process ID of the calling kernel thread's process.
tid Thread ID of the calling kernel thread.

309 : HKWD KERN KSUSPEND

This event is recorded by the ksuspend subroutine. This subroutine is used internally by the system and is undocumented.

Recorded Data

ksuspend: tid=tid p_suspended=suspended p_active=active
tid Thread ID of the calling kernel thread.
suspended Number of suspended kernel threads in the process.
active Number of active (suspendable) kernel threads in the process.

310 : HKWD SYSC THREADSETSTATE

This event is recorded by the thread_setstate system call.

Recorded Data

thread_setstate: tid=tid t_state=t_state t_flags=t_flags priority=priority policy=policy
tid Thread ID of the target kernel thread.
t_state Current state of the kernel thread. Possible values:

NONE

IDLE

RUN

SLEEP

SWAP

STOP

ZOMB
t_flags New flags of the kernel thread.
priority New priority of the kernel thread.
policy New scheduling policy of the kernel thread.

311 : HKWD SYSC THREADTERM ACK

This event is recorded by the thread_terminate_ack system call.

Recorded Data

thread_terminate_ack: current_tid=crt_tid target_tid=targ_tid
crt_tid Thread ID of the calling kernel thread.
targ_tid Thread ID of the target kernel thread.

312 : HKWD SYSC THREADSETSCHED

This event is recorded by the thread_setsched system call.

Recorded Data

thread_setsched: pid=pid tid=tid priority=priority policy=policy
pid Process ID of the calling kernel thread's process.
tid The tid parameter; the thread ID of the target kernel thread.
priority The priority parameter; the priority to set.
policy The policy parameter; the scheduling policy to set.

313 : HKWD KERN TIDSIG

This event is recorded by the tidsig subroutine. This subroutine is used internally by the system and is undocumented.

Recorded Data

tidsig: pid=pid tid=tid signal=signal lr=lr
pid Process ID of the calling kernel thread's process.
tid Thread ID of the calling kernel thread.
signal Symbolic name of the delivered signal.
lr Value of the link register, specifying the return address of the routine.

314 : HKWD KERN WAITLOCK

This event is recorded by the wait_on_lock subroutine. This subroutine is used internally by the system and is undocumented.

Recorded Data

wait_on_lock: pid=pid tid=tid lockaddr=lockaddr
pid Process ID of the calling kernel thread's process.
tid Thread ID of the calling kernel thread.
lockaddr Address of the lock.

315 : HKWD KERN WAKEUPLOCK

This event is recorded by the wakeup_lock subroutine. This subroutine is used internally by the system and is undocumented.

Recorded Data

wakeup_lock: lockaddr=lockaddr waiters=waiters
lockaddr Address of the lock.
waiters Number of kernel threads remaining sleeping on the lock.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]