Trace Hook IDs: 001 through 10A

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

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.