pio_badaddr(D3X)

NAME
     pio_badaddr - test for valid input bus address
     pio_badaddr_val - test for valid input bus address and return value

SYNOPSIS
     #include <sys/types.h>
     #include <sys/ddi.h>
     #include <sys/pio.h>

     int pio_badaddr(piomap_t* piomap, iopaddr_t iopaddr, int size);
     int pio_badaddr_val (piomap_t* piomap, iopaddr_t iopaddr, int size, void *ptr);

   Arguments
     piomap
          A PIO map returned from pio_mapalloc(D3X).

     iopaddr
          The I/O bus address to be probed.

     size The size in bytes to probe the I/O bus address, 1, 2, or 4.

     ptr  Address of a variable of the appropriate size (char, short, or int)
          into which the value read is placed.

DESCRIPTION
     Typically these functions are called from a I/O bus device driver's
     init(D2) or edtinit(D2) function to determine whether a device is present
     in the system.

     Call pio_badaddr to determine whether you can read a specified bus
     address.  If you are also going to use the value returned from that
     address, use pio_badaddr_val, thus saving one uncached read to fetch the
     value.

     Use pio_wbadaddr(D3X) to validate a bus address for output.

NOTES
     Passing an invalid size will result in a system panic.

     It is possible that the pio_badaddr_val(D3X) function may change or be
     removed in the future.

     These routines may not be called from an interrupt handler or from
     routines that may be called from an interrupt handler.

   Return Values
     Both functions return 0 when the address is valid, and nonzero when it is
     invalid.

   See Also
     pio_bcopyin(Da3x), pio_mapalloc(D3X), pio_wbadaddr(D3X).