get_info(9r)															      get_info(9r)

NAME

       get_info - General: Returns system-specific information

SYNOPSIS

       #include <devdriver.h>

       u_int get_info(
	       struct item_list *item_list );

ARGUMENTS

       Specifies a linked list of information requests.

DESCRIPTION

       The  get_info  routine  returns	system-specific  data assigned to the hardware platform that the driver operates on. For example, a device
       driver might request system-specific information for the following Alpha hardware platforms: DEC 3000 Model 300 AXP Workstation,  DEC  3000
       Model 500 AXP Workstation, and DEC 4000 Model 610 AXP System.

       The  get_info  routine checks the function code that you pass in the function member of the item_list data structure. If the hardware plat-
       form that the driver operates on supports the system item associated with this function code, get_info returns the system-specific data for
       the  system  item  in  the output_data member of the item_list structure. For example, get_info returns the TURBOchannel clock speed in the
       output_data member of the item_list structure if you specify the constant GET_TC_SPEED in the function member of the item_list structure.

       The get_info routine then performs the identical checks for the rest of the item_list structures in the linked list.

NOTES

       The get_info routine is a generic interface that maps to a hardware platform-specific interface that actually returns the assigned CPU-spe-
       cific data for the specified CPU. Using this routine to obtain CPU-specific information makes the driver more portable across different CPU
       architectures and different CPU types within the same architecture.

RETURN VALUES

       The return value from the get_info routine depends on the following issues: The hardware platform supports get_info

	      In this case, get_info returns the value TRUE.  The hardware platform does not support get_info

	      In this case, get_info returns the value NOT_SUPPORTED.

       If get_info returns the value TRUE, it returns one of the following values in the rtn_status member of the item_list data structure:  Indi-
       cates  that  the  hardware  platform that the driver currently operates on supports the requested system item.  Indicates that the hardware
       platform that the driver operates on does not support the requested system item.

SEE ALSO

       Routines: do_config(9r), get_config(9r)

       Data Structures: item_list(9s)

																      get_info(9r)