Metrics

Metrics allow a driver to gather performance information. DDI provides support for metrics for disk and network adapter card devices.

Metrics for disk devices

Metrics for disk devices are implemented using the following in the target driver for the disk:

met_ds_alloc_stats(D3)

allocate a disk statistics structure.

met_ds_dealloc_stats(D3)

deallocate a disk statistics structure.

met_ds_dequeued(D3)

update disk structures after a failed attempt to put a requrest on the queue.

met_ds_hist_stats(D3)

update disk access and responce time histograms when a request completes.

met_ds_iodone(D3)

update disk statistics when a read or write request completes.

met_ds_queued(D3)

update disk statistics when a read or write request is added to the queue.

Metrics for network adapter card devices

Statistical metrics for network adapter cards gather the information that is reported through the netstat command.

The MDI statistics gathering capabilities are implemented through the following:

MACIOC_GETSTAT(7mdi)

return statistical information

MACIOC_SETSTAT(7mdi)

modify statistical information

MACIOC_CLRSTAT(7mdi)

clear statistical information

mac_stats_eth(D4mdi)

Ethernet statistics structure

mac_stats_tr(D4mdi)

IEEE 802.5 token passing ring statistics structure

mac_stats_fddi(D4mdi)

ANSI Fiber Distributed Data Interface (FDDI) statistics structure

Metrics for non-MDI network adapter cards written for DDI versions prior to version 8 are implemented using the following.

ifstats_attach(D3)

register a network interface statistics structure

ifstats_detach(D3)

unregister a network interface statistics structure

ifstats(D4)

network interface statistics structure