getinfo(9E)

NAME

getinfo − get device driver information

SYNOPSIS

#include <sys/ddi.h>
#include <sys/sunddi.h>

int prefixgetinfo(dev_info_t ∗dip, ddi_info_cmd_t cmd,
void ∗arg, void ∗∗resultp);

ARGUMENTS

dip Do not use.

cmd Command argument − valid command values are DDI_INFO_DEVT2DEVINFO and DDI_INFO_DEVT2INSTANCE.

arg Command specific argument.

resultp Pointer to where the requested information is stored.

INTERFACE LEVEL

Solaris DDI specific (Solaris DDI). This entry point is required. You must write it.

DESCRIPTION

getinfo() should return the pointer associated with arg when cmd is set to DDI_INFO_DEVT2DEVINFO , or it should return the instance number associated with arg when cmd is set to DDI_INFO_DEVT2INSTANCE. Note that the instance number is often encoded as bits in the minor number.

RETURN VALUES

getinfo() should return:

DDI_SUCCESS
on success.

DDI_FAILURE
on failure.

EXAMPLES

/∗ARGSUSED∗/
static int

rd_getinfo(dev_info_t ∗dip, ddi_info_cmd_t infocmd, void ∗arg, void ∗∗result)

{
/∗ Note that in this simple example
∗ the minor number is the instance
∗ number.
∗/
devstate_t ∗sp;
        int error = DDI_FAILURE;
         switch (infocmd) {
        case DDI_INFO_DEVT2DEVINFO:
                if ((sp = ddi_get_soft_state(statep,
                    getminor((dev_t) arg))) != NULL) {
                        ∗resultp = sp->devi;
                        error = DDI_SUCCESS;
                } else
                        ∗result = NULL;
                break;
         case DDI_INFO_DEVT2INSTANCE:
                ∗resultp = (void ∗) getminor((dev_t) arg);
                error = DDI_SUCCESS;
                break;
        }
         return (error);
}

Museum