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.