solaris Man Page: ddi

Man Pages

Back to Software Index BORDER=0

Manpage Top Level

ddi_getb(9F) manual page Table of Contents

Name

ddi_getb, ddi_getw, ddi_getl, ddi_getll - read data from the mapped memory address, device register or allocated DMA memory address

Synopsis

#include <sys/ddi.h>
#include <sys/sunddi.h>

uchar_t ddi_getb(ddi_acc_handle_t handle, uchar_t *dev_addr);

ushort_t ddi_getw(ddi_acc_handle_t handle, ushort_t *dev_addr);

ulong_t ddi_getl(ddi_acc_handle_t handle, ulong_t *dev_addr);

unsigned long long ddi_getll(ddi_acc_handle_t handle, unsigned long long *dev_addr);

Arguments

handle: The data access handle returned from setup calls, such as ddi_regs_map_setup(9F) .
dev_addr: Base device address.

Description

The ddi_getb(), ddi_getw(), ddi_getl(), and ddi_getll() functions read 8 bits, 16 bits, 32 bits and 64 bits of data, respectively, from the device address, dev_addr.

Each individual datum will automatically be translated to maintain a consistent view between the host and the device based on the encoded information in the data access handle. The translation may involve byte-swapping if the host and the device have incompatible endian characteristics.

Return Values

These functions return the value read from the mapped address.

Context

These functions can be called from user, kernel, or interrupt context.