met_ds_alloc_stats(D3) met_ds_alloc_stats(D3)
NAME
met_ds_alloc_stats - allocate a disk statistics structure
SYNOPSIS
#include <sys/types.h>
#include <sys/ddi.h>
met_disk_stats_t *
met_ds_alloc_stats(char *prefix, int unit, ulong size, uint flags)
Arguments
prefix Points to a string containing the prefix for the
device.
unit Unit number for a particular drive (used with prefix
in constructing the device name).
size The size of the device, either in cylinders, if this
information is available, or in DEV_BSIZE blocks.
flags Indicates whether size is cylinders or blocks and
also whether the driver provides histogram
collection data.
DESCRIPTION
met_ds_alloc_stats is used to allocate a disk statistics
structure; disk drivers must call met_ds_alloc_stats for each
drive.
Return Values
A pointer to a met_disk_stats_t statistics structure.
USAGE
The driver usually calls this routine from its init routine,
but in the case of dynamically loadable drivers, the call
might be made from the driver load routine, if it does not
call the init routine.
The flags parameter indicates whether size is cylinders or
blocks and also indicates whether the driver provides
histogram collection data. flags values are constructed by
OR-ing flags from the following list:
MET_DS_CYL
size is given in terms of cylinders
Copyright 1994 Novell, Inc. Page 1
met_ds_alloc_stats(D3) met_ds_alloc_stats(D3)
MET_DS_BLK
size is given in terms of DEV_BSIZE blocks
MET_DS_NO_ACCESS_HIST
The driver does not provide information for updating the
cylinder access and seek distance histograms. That is,
it does not provide met_ds_hist_stats(D3) with either
the cylinder or block number that the request accessed.
MET_DS_NO_RESP_HIST
The driver does not provide information for the response
time histogram. That is, it does not provide
met_ds_hist_stats with the request's start and end
times. If the driver does not call met_ds_hist_stats,
both MET_DS_NO_ACCESS_HIST and MET_DS_NO_RESP_HIST
should be set.
Level
Base only.
Synchronization Constraints
Can sleep.
Driver-defined basic locks, read/write locks, and sleep locks
may not be held across calls to this function.
REFERENCES
met_ds_hist_stats(D3)
NOTICES
Portability
All processors
Applicability
ddi: 5, 5mp, 6, 6mp, 7, 7mp
Copyright 1994 Novell, Inc. Page 2