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

General Programming Concepts: Writing and Debugging Programs


Trace Hook IDs: 001 through 10A

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

001 : HKWD TRACE TRCON

This event is recorded by the trcon ioctl of the /dev/systrcctl file.

Recorded Data

TRACE ON channel channel number

channel channel number Trace channel number:

0 System event trace
1-7 Generic trace channels.

002 : HKWD TRACE TRCOFF

This event is recorded by the trcoff ioctl of the /dev/systrcctl file.

Recorded Data

TRACE OFF channel channel number

channel channel number Trace channel number:

0 System event trace
1-7 Generic trace channels.

003 : HKWD TRACE HEADER

This event is used to record the timestamp and the system information that appear at the top of the trace report.

Recorded Data

timestamp System system name Machine machine id Internet Address internet address

timestamp Date and time the trace log was created
System system name Operating system name, release, and version
Machine machine id The machine ID
Internet Address internet address The Internet address of this machine.

004 : HKWD TRACE NULL

This hook ID is used to provide a template for formatting events for which the trace hook ID is 000.

Recorded Data

TRACEID IS ZERO hookword=hookword file=file name index=value

hookword=hookword The contents of the hook word
file=file name The trace log file pathname
index=value The offset into the trace log file of the event.

005 : HKWD TRACE LWRAP

The trace daemon records this hook ID each time the trace log file wraps.

Recorded Data

LOGFILE WRAPAROUND count

Wraparound count Number of times log file has wrapped.

006 : HKWD TRACE TWRAP

This event is recorded by the trchk and trcgen subroutines each time the trace buffer wraps.

Recorded Data

TRACEBUFFER Wraparound count value missed entries

Wraparound count Number of times trace buffer has wrapped
value missed entries Number of entries overwritten.

007 : HKWD TRACE UNDEFINED

This hook ID is used to provide a template for formatting undefined events. Events in the trace log file for which there is no template defined in the /etc/trcfmt file are formatted using this template.

Recorded Data

UNDEFINED TRACE ID idx offset traceid trace id hookword hookword type hook type hookdata data

idx offset Offset of event into the trace log file
traceid trace id Trace hook ID of undefined event
hookword hookword The contents of the hook word for the event
type hook type The hook type (0-7)
hookdata data The data recorded for the event is printed in hexadecimal.

100 : HKWD KERN FLIH

This event is recorded by the First Level Interrupt Handler in the event of a first-level interrupt. Return from FLIH is recorded by hook ID 200 : HKWD KERN RESUME.

Recorded Data

Type of interrupt:

Machine Check

Data Access Page Fault

Instruction Page Fault

I/O Interrupt

Alignment Error

Program Check

Floating Point Unavailable

101 : HKWD KERN SVC

This event is recorded by SVC handler on entry to a subroutine.

Recorded Data

Name of the subroutine.

102 : HKWD KERN SLIH

This event is recorded by the Second Level Interrupt Handler in the event of a second-level interrupt. Return from SLIH is recorded by hook ID 103 : HKWD KERN SLIHRET.

Recorded Data

The name of the SLIH function.

103 : HKWD KERN SLIHRET

This event ID is recorded by the Second Level Interrupt Handler on return from a second-level interrupt.

Recorded Data

return from slih

104 : HKWD KERN SYSCRET

This event is recorded by the SVC handler on return from a subroutine.

Recorded Data

return from subroutine error errno

subroutine Name of the subroutine
error errno If errno is nonzero, the value of the errno global variable is printed.

105 : HKWD KERN LVM

This event is recorded by the Logical Volume Manager for selected events.

Recorded Data

Event:

LVM relocingblk bp=value pblock=value relblock=value Encountered relocated block

bp=value
Buffer pointer

pblock=value
Physical block number

relblock=value
Relocated block number.
LVM oldbadblk bp=value pblock=value state=value bflags Bad block waiting to be relocated

bp=value Buffer pointer
pblock=value Physical block number
state=value State of the physical volume
bflags Buffer flags are defined in the sys/buf.h file.

LVM badblkdone bp=value Block relocation complete

bp=value Buffer pointer.

LVM newbadblk bp=value badblock=value error=value bflags New bad block found

bp=value Buffer pointer
badblock=value Block number of bad block
error=value System error number (the errno global variable)
bflags Buffer flags are defined in the sys/buf.h file.

LVM swreloc bp=value status=value error=value retry=value Software relocating bad block

bp=value Buffer pointer
status=value Bad block directory entry status
error=value System error number (the errno global variable)
retry=value Relocation entry count.

LVM resyncpp bp=value bflags Resyncing Logical Partition mirrors

bp=value Buffer pointer
bflags Buffer flags are defined in the sys/buf.h file.

LVM open device name flags=value Open

device name Name of the device
flags=value Open file mode.

LVM close device name Close

device name Name of the device.

LVM read device name ext=value Read

device name Name of the device
ext=value Extension parameters.

LVM write device name ext=value Write

device name Name of the device
ext=value Extension parameters.

LVM ioctl device name cmd=value arg=value ioctl

device name Name of the device
cmd=value ioctl command
arg=value ioctl arguments.

106 : HKWD KERN DISPATCH

This event is recorded by the dispatcher when a process thread is dispatched.

Recorded Data

dispatch process name process id

process name Name of the dispatched process
process id Process ID of the dispatched process.

dispatch cmd=process name pid=process id tid=thread id priority=priority old_tid=old thread id old_priority=old priority
dispatch scheduler
process name Process name of the dispatched thread.
process id Process ID of the dispatched thread.
thread id Thread ID of the dispatched thread.
priority Priority of the dispatched thread.
old thread id Thread ID of the thread that dispatches.
old priority Priority of the thread that dispatches.

107 : HKWD LFS LOOKUP

This event is recorded by the lookuppn kernel service.

Recorded Data

lookuppn pathname

pathname Path name of the current file.

108 : HKWD SYSC LFS

This event is recorded by the file system related subroutines.

Recorded Data

Event:

access file mode access subroutine
fchmod file mode fchmod subroutine
chown file name uid=value gid=value chown subroutine
fchown file name uid=value gid=value fchown subroutine
chownx file name uid=value gid=value chownx subroutine
fchownx file name uid=value gid=value fchownx subroutine
ftruncate file name to length ftruncate subroutine
truncate file name to length truncate subroutine
ioctlx file name cmd=value ioctlx subroutine
lockfx file name start=value length=value whence=value lockfx subroutine
mknod file name file mode mknod subroutine
fsync file name fsync subroutine
readx (fd,buf,count) file name readx subroutine
writex (fd,buf,count) file name writex subroutine
openx file name fd=value file mode openx subroutine

file name
File path name

uid=value
User ID

gid=value
Group ID

fd=value
File descriptor

file mode
File mode

to length
Length to truncate to

cmd=value
ioctl operation

start=value
Starting offset

length=value
Length to lock

whence=value
Type of lock

(fd,buf,count)
File descriptor, buffer pointer, and count.

10A : HKWD KERN PFS

This event is recorded by the kernel physical file system for selected events.

Recorded Data

Event:

PFS rdwr (vp, ip)=(vp, ip) filename

PFS readi VA.S=value bcount=value ip=value filename

PFS writei VA.S=value bcount=value ip=value filename

(vp, ip)=(vp, ip)

vp v_node pointer
ip i_node pointer
filename File path name
VA.S=value Segment ID that maps the file
bcount=value Byte count.


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