General Programming Concepts: Writing and Debugging Programs

Trace Hook IDs: 1C8 through 1CE

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

1C8 : HKWD DD PPDD

The event is recorded by the parallel printer device driver.

Recorded Data

Event:

PPDD entry_open: errno: errno devno: devno rwflag: rwflag chan: chan ext: ext flags: open flags

PPDD exit_open: errno: errno devno: devno

PPDD entry_close: errno: errno devno: devno

PPDD exit_close: errno: errno devno: devno

PPDD entry_read: errno: errno devno: devno

PPDD exit_read: errno: errno devno: devno

PPDD entry_write: errno: errno devno: devno resid: resid iovcnt: iovcnt offset: offset fmode: fmode

PPDD exit_write: errno: errno devno: devno

PPDD entry_ioctl: errno: errno devno: devno op: ioctl op flag: dev flag chan: 0 ext: 0

PPDD exit_ioctl: errno: errno devno: devno

errno: errno	Error number
devno: devno	Major and minor device number
rwflag: rwflag	Passed into the device driver to indicate how the device is being used
chan: chan	Channel
ext: ext	Extension
op: ioctl op	Command used in ioctl
flag: dev flag	Current status of the device driver
flags: open flags	Device flags at open
resid: resid	Count left to be sent out
offset: offset	Offset into data buffer
iovcnt: iovcnt	Number of output buffers **fmode: fmode** Type of open.

1C9 : HKWD DD CDDD

This event is recorded by the cd-rom device driver.

Recorded Data

Event:

CDDD entry_open: errno: errno devno: devno rwflag: rwflag chan: chan ext: ext

CDDD exit_open: errno: errno devno: devno

CDDD entry_close: errno: errno devno: devno

CDDD exit_close: errno: errno devno: devno

CDDD entry_read: errno: errno devno: devno

CDDD exit_read: errno: errno devno: devno

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

CDDD exit_ioctl: errno: errno devno: devno

CDDD entry_config: errno: errno devno: devno op: config op

CDDD exit_config: errno: errno devno: devno

CDDD entry_strategy: errno: errno devno: devno bp: bp flags: strategy flags block: block bcount: bcount

CDDD exit_strategy: errno: errno devno: devno

CDDD entry_bstart: errno: errno devno: devno bp: bp pblock: pblock bcount: bcount bflags

CDDD exit_bstart: errno: errno devno: devno

CDDD entry_iodone: errno: errno devno: devno

CDDD exit_iodone: errno: errno devno: devno

CDDD iodone: device name bp: bp

errno: errno	Error number
devno: devno	Major and minor device number
rwflag: rwflag	Mode of open
chan: chan	Channel
ext: ext	Extension
op: ioctl op	ioctl operation to perform
flag: ioctl flag	Memory address
op: config op	Configuration operation to perform
bp: bp	Buffer pointer
flags: strategy flags	Buffer flags from buf structure
block: block	Block number on device
bcount: bcount	Number of bytes to transfer
pblock: pblock	Block number on device *bflags* Buffer flags are defined in the sys/buf.h file.

1CA : HKWD DD TAPEDD

This event is recorded by the tape device driver.

Recorded Data

Event:

TAPEDD entry_open: errno: errno devno: devno rwflag: rwflag chan: chan ext: ext

TAPEDD exit_open: errno: errno devno: devno

TAPEDD entry_close: errno: errno devno: devno

TAPEDD exit_close: errno: errno devno: devno

TAPEDD entry_read: errno: errno devno: devno

TAPEDD exit_read: errno: errno devno: devno

TAPEDD entry_write: errno: errno devno: devno

TAPEDD exit_write: errno: errno devno: devno

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

TAPEDD exit_ioctl: errno: errno devno: devno

TAPEDD entry_config: errno: errno devno: devno op: config op

TAPEDD exit_config: errno: errno devno: devno

TAPEDD entry_cstart: errno: 0 devno: devno command: cstart cmd baddress: baddress bcount: bcount

TAPEDD exit_cstart: errno: errno devno: devno

TAPEDD entry_iodone: errno: 0 devno: devno command: iodone cmd baddress: baddress bcount: bcount

TAPEDD exit_iodone: errno: errno devno: devno

TAPEDD iodone: device name bp: bp

errno: errno	Error number
devno: devno	Major and minor device number
rwflag: rwflag	Possible values:
FREAD	Device opened read-only
FWRITE	Device opened read-write
chan: chan	Channel
ext: ext	Extension
op: ioctl op	ioctl operation
flag: ioctl flag	Address of users argument structure
op: config op	Possible values:
CFG_INIT	Configures the device
CFT_TERM	Unconfigures the device
bcount: bcount	Number of bytes to transfer
command: cstart cmd	Low-order byte contains SCSI command issued to the drive
baddress: baddress	Buffer address where information is transferred to and from the device; zero for commands that do not transfer data **command: iodone cmd Low-order byte contains SCSI command issued to the drive bp:** bp Buffer pointer.

1CD : HKWD DD ENTDD

This event is recorded by the ethernet device handler to track the various phases of data transfer within the device handler.

Recorded Data

Event:

Ethernet: enque kernel data device name mbuf=mbuf count=count channel=channel

Ethernet: enque user data device name mbuf=mbuf count=count channel=channel

Ethernet: receive overflow device name mbuf=mbuf count=count channel=channel

Ethernet: transmit done device name mbuf=mbuf count=count channel=channel

Ethernet: return form read device name mbuf=mbuf count=count channel=channel

Ethernet: write device name mbuf=mbuf count=count channel=channel

Ethernet: transmit interrupt device name mbuf=mbuf count=count channel=channel

Ethernet: receive interrupt device name mbuf=mbuf count=count channel=channel

device name	The /dev entry point for this device
mbuf=mbuf	Address of the mbuf that contains the user data
count=count	Number of bytes of user data to be transferred **channel=channel** Channel number of the process that opened the device.

1CE : HKWD DD TOKDD

This event is recorded by the token ring device driver.

Recorded Data

Event:

Token Ring: enque kernel data device name mbuf=mbuf count=count channel=channel

Token Ring: enque user data device name mbuf=mbuf count=count channel=channel

Token Ring: receive overflow device name mbuf=mbuf count=count channel=channel

Token Ring: transmit done device name mbuf=mbuf count=count channel=channel

Token Ring: return form read device name mbuf=mbuf count=count channel=channel

Token Ring: write device name mbuf=mbuf count=count channel=channel

Token Ring: transmit interrupt device name mbuf=mbuf count=count channel=channel

Token Ring: receive interrupt device name mbuf=mbuf count=count channel=channel

device name	The /dev entry point for this device
mbuf=mbuf	Address of the mbuf which contains the user data
count=count	Number of bytes of user data to be transferred **channel=channel** Channel number of the process that opened the device.