.IX \f4iomapin\fP(D3DK)

NAME

iomapin − map an I/O address (device). 

SYNOPSIS

#include <sys/types.h>
#include <sys/buf.h>
#include <sys/iosystm.h>
caddr_t iomapin(unsigned int bus, addr_t addr,
int len);

ARGUMENTS

busI/O bus where device resides. 

addrAddress on bus. 

lenAmount to be mapped in. 

DESCRIPTION

The iomapin function is obsolete.  Drivers should use niomapin, instead.

The iomapin function is used to gain access to the memory areas associated with a device.  All of the necessary virtual and physical address mappings required to access the I/O are set up, and the mapped valued of the argument I/O address is returned.  bus is the I/O bus where the device resides (for example, VME_A16 or VME_A32). 

RETURN VALUE

The address used to access the device that is mapped in.  This is a virtual address and may not be guaranteed to be mapped one-to-one with physical memory. 

LEVEL

Base. 

NOTES

This function must not be called when any driver-defined basic locks and read/write locks are held. 

SEE ALSO

ioprobe(D3DK), niomapin(D3DK)

DDI/DKI