Index for Section 9

Alphabetical listing for B

Bottom of page

busphys_to_iohandle(9r)
NAME
  busphys_to_iohandle - General: Converts a valid bus physical address to an
  I/O handle base

SYNOPSIS
  io_handle_t busphys_to_iohandle(
	  u_long addr,
	  int flags,
	  struct controller *ctlr_p );

ARGUMENTS
  addr
      Specifies the bus physical address that you want busphys_to_iohandle to
      translate into an I/O handle base.

  flags
      Specifies flags to indicate the address space in which the bus physical
      address that you pass to the addr argument resides. You can pass one of
      the following address space flag values:

      BUS_MEMORY
	      The address is from the bus memory. In this case,
	      busphys_to_iohandle converts the bus physical address to a
	      sparse memory I/O handle base.

      BUS_IO  The address is from the bus I/O memory. In this case,
	      busphys_to_iohandle converts the bus physical address to a
	      sparse I/O handle base.

      DENSE_MEMORY
	      The address is from dense space. In this case,
	      busphys_to_iohandle converts the bus physical address to a
	      dense memory base.

  ctlr_p
      Specifies a pointer to the controller structure associated with the
      controller that connects to this device. The busphys_to_iohandle
      interface uses the controller structure pointer to obtain any hardware
      resource-related information.

DESCRIPTION
  The busphys_to_iohandle interface converts a valid bus physical address to
  an I/O handle base that a device driver uses to perform I/O copy
  operations. The form of this address is CPU specific.






NOTES
  The busphys_to_iohandle interface is a generic interface that maps to a
  bus-specific	interface that actually converts the bus physical address to
  an I/O handle base. Using this interface to convert the bus physical
  address makes the device driver more portable across different bus
  architectures.

RETURN VALUES
  Upon successful completion, busphys_to_iohandle returns the I/O handle base
  associated with the bus physical address. If busphys_to_iohandle cannot
  convert the bus physical address into an I/O handle base, it returns a
  value of -1.

SEE ALSO
  Kernel Interfaces: io_copyin(9r), io_copyio(9r), io_copyout(9r),
  iohandle_to_phys(9r)

Index for Section 9

Alphabetical listing for B

Top of page