General Programming Concepts: Writing and Debugging Programs

Trace Hook IDs: 1CF through 211

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

1CF : HKWD DD C327DD

This event is recorded by the 3270 Connection Adapter device driver.

Recorded Data

Event:

C327DD entry_open: errno: errno devno: devno rwflag: rwflag chan: chan ext: ext

C327DD exit_open: errno: errno devno: devno

C327DD entry_close: errno: errno devno: devno chan: chan

C327DD exit_close: errno: errno devno: devno

C327DD entry_read: errno: errno devno: devno

C327DD exit_read: errno: errno devno: devno

C327DD entry_write: errno: errno devno: devno uiop: uiop chan: chan ext: ext

C327DD exit_write: errno: errno devno: devno

C327DD entry_ioctl: errno: errno devno: devno op: ioctl op flag: ioctl flag chan: chan ext: ext

C327DD exit_ioctl: errno: errno devno: devno

C327DD entry_select: errno: errno devno: devno event: event chan: chan

C327DD exit_select: errno: errno devno: devno

C327DD entry_config: errno: errno devno: devno op: config op

C327DD exit_config: errno: errno devno: devno

C327DD entry_mpx: errno: errno devno: devno name: name chan: chan

C327DD exit_mpx: errno: errno devno: devno name: name chan: chan oflag: mpx flag

errno: errno	Error number
devno: devno	Major and minor device number
rwflag: rwflag	Open flags
chan: chan	Channel
ext: ext	Extension
uiop: uiop	uio structure pointer
event: event	Event specified in the select or poll subroutine
op: ioctl op	Command code specified in the ioctl subroutine
flag: ioctl flag	Argument code specified in the ioctl subroutine
op: config op	Command code specified in the config subroutine
name: name	Path-name extension of the multiplex channel to be allocated **oflag: mpx flag** Unused.

1D1 : HKWD RAS ERRLG

This event is recorded by the /dev/error file.

Recorded Data

Event:

ERRLG erropen: errno

ERRLG errclose: errno

ERRLG errioctl: errno device name ERRIOC_STOP

ERRLG errioctl: errno device name ERRIOC_SYNC

ERRLG errread: bad erec_length length bytes

ERRLG errread: errno

ERRLG errwrite: errno

ERRLG errput

ERRLG errput: buffer overflow: state=state

ERRLG errdd: lockl from value already locked by process

ERRLG errdd: unlockl from value not locked

ERRLG errdemon: cannot write to errlog. error id=error id

errno	Error number
device name	Device name
length	Length
state=state	Possible values:

RDOPEN

SLEEP

STOP

SYNC

process	Process name and ID
lockl from value	Routine that called the lockl subroutine
unlockl from value	Routine that called the unlockl subroutine **error id=error id** Error identifier.

1D2 : HKWD RAS DUMP

This event is recorded by the dump device driver.

Recorded Data

Event:

DUMP dmpopen : errno device name

DUMP dmpioctl : errno device name DMPSET_PRIM

DUMP dmpioctl : errno device name DMPSET_SEC

DUMP dmpioctl : errno device name DMPNOW_PRIM

DUMP dmpioctl : errno device name DMPNOW_SEC

DUMP dmpdump : DUMPINIT device name

DUMP dmpdump : DUMPSTART device name

DUMP dmpdump : DUMPWRITE device name

DUMP dmpdump : DUMPEND device name

DUMP dmpdump : DUMPTERM device name

DUMP dmpdump : DUMPQUERY device name

DUMP dmpadd : calling func is function

DUMP dmp : return: errno

DUMP dmpdel : calling func is function

DUMP dmpdel : return: errno

DUMP dmp_do : PRIMARY

DUMP dmp_do : SECONDARY

DUMP dmp_do : return: errno

DUMP dmpwrcdt : ptr=wrcdt ptr length=wrcdtlength

DUMP dump_op : return: errno

DUMP dmpnull : DUMPINIT

DUMP dmpnull : DUMPSTART

DUMP dmpnull : DUMPWRITE

DUMP dmpnull : DUMPEND

DUMP dmpnull : DUMPTERM

DUMP dmpnull : DUMPQUERY

DUMP dmpfile : DUMPINIT

DUMP dmpfile : DUMPSTART

DUMP dmpfile : DUMPWRITE

DUMP dmpfile : DUMPEND

DUMP dmpfile : DUMPTERM

DUMP dmpfile : DUMPQUERY

errno	Error number
device name	Name of dump device
function	Name of function calling the dmp_add subroutine or dmp_del subroutine
ptr=wrcdt ptr	Pointer to Component Dump Table to be written **length=wrcdt length** Length of Component Dump Table to be written.

1F0 : HKWD SYSC SETTIMER

This event is recorded by the settimer subroutine.

Recorded Data

settimer timer_type timer type
	**timer_type timer type** Type of timer.

200 : HKWD KERN RESUME

This event is recorded by the resume subroutine.

Recorded Data

resume process name
resume interrupt process mst=mst
process name	Process name of the resumed thread.
mst	MST of the resumed thread.

20E: HKWD KERN LOCKL

This event is recorded by the lockl kernel service.

Recorded Data

lockl lock address=lock address lock value=lock value return address=return address flags=flags
lock address	Address of the lock word
lock value	Content of the lock word
return address	Return address of the caller flags Flags parameter.

20F: HKWD KERN UNLOCKL

This event is recorded by the unlockl kernel service.

Recorded Data

unlockl lock address=lock address lock value=lock value return address=return address
lock address	Address of the lock word
lock value	Content of the lock word return address Return address of the caller.

211 : HKWD NFS VOPSRW

This event is recorded to the read/write vnop op for NFS client.

Recorded Data

Event:

NFS_READ filename count=count offset=offset sid=sid	Client NFS read call entry
NFS_WRITE filename count=count offset=offset sid=sid	Client NFS write call entry *filename* File path name **count=count offset=offset sid=sid**