Index Index for
Section 9
Index Alphabetical
listing for I
Bottom of page Bottom of
page		 

item_list(9s)


NAME

  item_list - General: Contains hardware platform-specific information


SYNOPSIS

  __________________________________
  Member Name	  Data Type
  __________________________________
  function	  u_long
  out_flags	  u_int
  in_flags	  u_int
  rtn_status	  u_long
  next_function	  struct item_list *
  input_data	  u_long
  output_data	  u_long
  __________________________________


MEMBERS

  function
      Stores the function code that represents the system item for which you
      want to obtain specific information. See the DESCRIPTION section for
      the constants you can pass to the function member.

  out_flags
      Stores flags for output data. This member is for future use.

  in_flags
      Stores flags for input data. This member is for future use.

  rtn_status
      Stores the status code for the function code you passed to the function
      member. See the DESCRIPTION section for the constants to which the
      get_info interface can set this member.

  next_function
      Specifies a pointer to the next item_list structure in the linked list.
      This item_list structure stores the function code that represents the
      next system item for which you want to obtain specific information. You
      set this member to the value NULL to indicate the last item_list
      structure in the linked list.

  input_data
      Specifies a pointer to input data for the function associated with the
      function code that you specified in the function member.

  output_data
      Stores the specific information for the system item associated with the
      function code that you passed to the function member. The get_info
      interface returns CPU-specific values to the output_data member. These
      values are for the function associated with the function code that you
      specified in the function member.








DESCRIPTION

  The item_list data structure contains platform-specific information. Device
  drivers obtain this platform-specific information by calling the get_info
  kernel interface.

  You can pass one of the following constants, defined in <devdriver.h>, to
  the function member:

  GET_TC_SPEED
	      Requests that get_info return the TURBOchannel bus clock speed
	      (in kilohertz) for this system. For example, get_info returns
	      250 for a 25-megahertz clock speed. You pass this constant only
	      if a TURBOchannel bus is hardwired to the hardware platform.

  MOP_SYSID   Requests that get_info return the MOP system ID for the system
	      on which the driver operates.

  CONSOLE_2_DEV
	      Requests that get_info return the controller number associated
	      with the controller that the system booted from. The get_info
	      interface locates this controller by traversing the array of
	      bus data structures.

  DEV_2_CONSOLE
	      Requests that get_info return the boot device string for the
	      console. The get_info kernel interface constructs the boot
	      device string from information contained in the devget data
	      structure.

  DEV_2_USER  Requests that get_info return the string that a user enters at
	      the console terminal to boot the system.

  The get_info kernel interface can set this member to one of the following
  status codes:

  INFO_RETURNED
	      The CPU platform that the driver operates on supports the
	      system item associated with the function code you passed to the
	      function member. This value indicates that the system item
	      returned by get_info to the output_data member is valid.

  NOT_SUPPORTED
	      The CPU platform that the driver operates on does not support
	      the system item associated with the function code you passed to
	      the function member; or, the CPU platform does not support the
	      get_info kernel interface.


FILES

  <io/common/devdriver.h>










SEE ALSO

  Kernel Interfaces: get_info(9r)

Index Index for
Section 9
Index Alphabetical
listing for I
Top of page Top of
page